Skip to navigation

Get a prior authorization

Authentication

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

Path parameters

idstringRequired

Response

Request
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

401
Unauthorized Error
404
Not Found Error