Authorizations

Payer authorizations: how many units of a service a payer has approved for a patient, and over what dates.

Endpoints

The Authorization object

object
stringread-only

String representing the object's type. Always authorization.

id
stringread-only

Unique identifier of the authorization.

patientId
string | nullmax length 64

The patient the authorization covers.

payerName
string | nullmax length 200

The payer that issued it.

authorizationNumber
string | nullmax length 100

The payer's authorization number.

serviceType
string | nullmax length 100

Service authorized.

procedureCode
string | nullmax length 20

Procedure (HCPCS) code billed against it.

modifiers
string | nullmax length 50

Procedure code modifiers, comma separated.

startDate
string · date | null

First date the authorization covers.

endDate
string · date | null

Last date the authorization covers.

authorizedUnits
integer | nullmin 0

Units approved.

unitType
string | nullmax length 50

What a unit is, in the payer's words.

unitBasis
string | null

Whether units count time, visits or days.

One ofTimeVisitsDaysnull
minutesPerUnit
integer | nullmin 1

For time-based units, minutes in one unit.

usedUnits
integer | nullread-only

Units used so far.

remainingUnits
integer | nullread-only

Units left.

frequency
string | nullmax length 100

Frequency the payer approved.

placeOfService
string | nullmax length 10

Place-of-service code.

status
string | null

Whether the authorization is in effect.

One ofActiveExpiredPendingRenewalnull
notes
string | nullmax length 20000

Notes.

createdAt
string · date-time | nullread-only

When the authorization was created.

updatedAt
string · date-time | nullread-only

When the authorization was last changed.