Retrieve a prior authorization
Return a single prior authorization by id, including nested patient, payor, providers, location, service block, result block, and attached files (with signed URLs).
Authorizations
Path Parameters
Query Parameters
Relations to inline in the response. Repeatable, e.g. ?expand[]=files&expand[]=servicing_location.
Allowed expand values for the single-resource PA endpoint (GET /{id}).
requesting_provider, servicing_provider, servicing_location, files Response
Successful Response
Response schema for a prior authorization record.
Authorization type.
assessment, treatment, reassessment, reassessment_and_treatment Lifecycle state of a prior authorization.
pending, submitted, information_needed, decided, cancelled Patient this authorization belongs to; use it to open the patient record. Demographics submitted on this PA are the frozen patient_* fields below.
Patient first name as submitted on this authorization. Frozen at create time — not updated when the patient record changes.
Patient last name as submitted on this authorization. Frozen at create time.
Patient date of birth (YYYY-MM-DD) as submitted on this authorization. Frozen at create time.
Payor outcome on a decided authorization.
approved, partially_approved, denied, no_authorization_required Appeal lifecycle. An appeal STARTS from a denied or partially_approved decision; the terminal states below outlive it, because a won appeal is exactly one whose decision is no longer a denial.
NULL is meaningful: it means no appeal decision has been made yet — the caller hasn't yet asked for one. Setting any value below is an explicit commitment that someone is (or isn't) pursuing the appeal:
requested — an appeal has been requested; work has not started. appealing — Solum is actively working the appeal. appeal_approved — terminal, won outright. appeal_partially_approved — terminal, won in part (payor granted less than requested). appeal_denied — terminal, lost. not_appealing — terminal, operator decided not to pursue.
The won/partial/lost outcomes mirror the granularity of
PriorAuthorizationDecisionEnum: a payor that grants less than was
requested on appeal has partially granted it.
requested, appealing, appeal_approved, appeal_partially_approved, appeal_denied, not_appealing Rationale captured when an appeal was requested. Null when no appeal has been requested.
Appeal case/reference number issued by the payor. Null until the payor assigns one.
Requester availability windows captured when an appeal was requested. Null when none provided.
Member id as submitted on this authorization. Frozen at create time.
Insurance partner id (from the insurances catalog) as submitted on this authorization. Frozen at create time.
Plan display name for this PA's payor, frozen at create time. Null ⇒ display the insurance's canonical name.
Nested insurance partner ({id, name}) for the FROZEN snapshot.
Resolved from the payor_insurance relationship, which loads regardless of
the insurance's is_active flag — so a PA submitted under a since-
deactivated insurance still carries its name for display.
Credentialing-record id of the requesting provider. Always present unless the provider record was later removed (FK is ON DELETE SET NULL).
Credentialing-record id of the servicing provider. Null when the servicing provider is the same as the requesting provider or unset.
Company-location id where services are rendered. Null when unset.
Business entity (organization) this authorization belongs to. Null when unset.
Expanded requesting-provider object. Present ONLY when requested via expand[]=requesting_provider; null otherwise. Use requesting_provider_id for the reference.
Expanded servicing-provider object. Present ONLY when requested via expand[]=servicing_provider; null otherwise.
Expanded servicing-location object. Present ONLY when requested via expand[]=servicing_location; null otherwise.
Nested user (created_by) in response.
Service request details returned in the response.
See PriorAuthorizationResultResponse for the rationale on validation_alias.
Payor decision details. Populated only when status is decided.
Uses validation_alias (not alias) so the alias only applies to input
(reading the parent PA's result_start_date etc. columns via
from_attributes). Output uses the field name; otherwise FastAPI's
response_model_by_alias=True default would leak the column-prefixed
name onto the wire and the frontend would see resultStartDate after
transformFromAPI instead of the expected startDate.
Attached files with signed download URLs. Present ONLY on GET /{id} with expand[]=files; always null on the list endpoint (use file_count there). Signed URLs are minted only when this is expanded.
Number of attached files. Always present (a cheap aggregate); independent of expand.
When the appeal was submitted to the payor; set when the appeal first becomes active. Null when no appeal has been submitted.
Last time staff followed up with the payor on this authorization's status. Null until the first follow-up.
Date this authorization should be submitted to the payor. When set in the future, the request is held out of the active review queue until that date. Null when no scheduled date is set.
True when the clinic has marked this authorization done (it leaves the default list). Derived from completed_at.
When the authorization was marked done. Null while outstanding.
Id of the user who marked it done. Null while outstanding.
The user who marked it done (Solum staff identity is masked for customer viewers). Null while outstanding.
Why the authorization was cancelled. Null unless the authorization is cancelled.
duplicate_already_submitted, no_longer_needed, submitted_directly_to_payor, patient_no_longer_active, entered_in_error, other Free-text detail captured with the cancellation reason. Null when none was provided.
When the authorization was cancelled. Null unless the authorization is cancelled.