Skip to navigation

Create a managed prior authorization

Queues a managed prior-authorization request for review and payer-portal submission. A 202 response means the request was received; it does not mean it was submitted to the payer.

Authentication

AuthorizationBearer
Send your Taiga API key as a Bearer token. Create and manage keys in the Taiga developer portal.

Request

This endpoint expects an object.
COMMUNITY_SUPPORTSobjectRequired

A CalAIM Community Supports referral. It names a member and a service and carries no diagnosis codes, procedure codes, place of service, service facility, rendering provider, or plan of care: the payer’s Community Supports intake has no such fields, and the DHCS ECM and Community Supports HCPCS codes belong on the resulting claim rather than on this request.

OR
OCCUPATIONAL_THERAPYobjectRequired

An outpatient therapy authorization request. The API still accepts a body with service_type omitted and treats it as PHYSICAL_THERAPY, for compatibility with integrations that predate Community Supports; new integrations should always send it.

OR
OTHERobjectRequired

An outpatient therapy authorization request. The API still accepts a body with service_type omitted and treats it as PHYSICAL_THERAPY, for compatibility with integrations that predate Community Supports; new integrations should always send it.

OR
PHYSICAL_THERAPYobjectRequired

An outpatient therapy authorization request. The API still accepts a body with service_type omitted and treats it as PHYSICAL_THERAPY, for compatibility with integrations that predate Community Supports; new integrations should always send it.

OR
SPEECH_THERAPYobjectRequired

An outpatient therapy authorization request. The API still accepts a body with service_type omitted and treats it as PHYSICAL_THERAPY, for compatibility with integrations that predate Community Supports; new integrations should always send it.

Response

Idempotent replay
billing_provider_npistringformat: "^\d{10}$"
coverage_idstring
Existing patient coverage. Taiga resolves payer, plan, member, and routing details from this coverage.
diagnosis_codeslist of strings
external_idstring<=100 characters

Partner-generated idempotency key. Replays with an identical body return the existing request; a different body returns 409.

patient_idstring
place_of_service_codestringformat: "^\d{2}$"

Two-digit CMS place-of-service code for the requested care.

plan_of_careobject
Requested treatment window, visits, frequency, and evaluation date.
rendering_provider_npistringformat: "^\d{10}$"
Rendering therapist NPI. This NPI must be in the partner organization's scope.
request_typeenumDefaults to INITIAL

REAUTHORIZATION also requires previous_authorization. INITIAL is used for a new patient, condition, or payer-defined new episode.

Allowed values:
service_facility_idstring
service_lineslist of objects

Requested CPT/HCPCS codes. Procedure-level units and dates are optional when the plan_of_care supplies the visit-level request.

service_typeenumDefaults to PHYSICAL_THERAPY
Allowed values:
supporting_documentslist of objects

Existing uploaded document IDs with semantic types. Upload the file first: POST /images/v1 returns an id, a version and a signed_url; PUT the bytes to that signed_url; then PUT /images/v1/{id}/{version} with status UPLOADED, where the version segment is the current version plus 1 (so 1 for a freshly created image). Use the image id as document_id. Documents are optional at intake; missing payer-required documents produce NEEDS_INFORMATION.

test_modeboolean
urgencyenumDefaults to ROUTINE

URGENT requires urgency_reason and should only be used when the payer’s expedited-review standard is met.

Allowed values:
created_atdatetime
idstring
last_status_atdatetime
payer_idstring
payer_namestring
statusenum
updated_atdatetime
clinical_informationobject or nullOptional
clinical_notesstring or nullOptional
contactobject or nullOptional
ordering_providerobject or nullOptional
payer_specific_fieldsmap from strings to strings or doubles or booleans or any or lists of anyOptionalDefaults to {}

Escape hatch for payer questions discovered during requirements review. Use stable snake_case keys supplied by Taiga.

previous_authorizationobject or nullOptional
referring_providerobject or nullOptional
requesting_provider_npistring or nullOptionalformat: "^\d{10}$"
therapy_attestationsobjectOptionalDefaults to {}
urgency_reasonstring or nullOptional
approved_unit_typestring or nullOptional
approved_unitsinteger or nullOptional
authorized_service_lineslist of objectsOptional
determined_atdatetime or nullOptional
effective_datedate or nullOptional
expiration_datedate or nullOptional
plan_namestring or nullOptional
plan_typestring or nullOptional
portal_reference_numberstring or nullOptional
prior_authorization_numberstring or nullOptional
requirements_checked_atdatetime or nullOptional
status_messagestring or nullOptional
submission_channelenum or nullOptional
Allowed values:
submission_destinationstring or nullOptional
submitted_atdatetime or nullOptional

Errors

400
Bad Request Error
401
Unauthorized Error
404
Not Found Error
409
Conflict Error
503
Service Unavailable Error