Referral authorization

The Referral authorization feature allows the user to interface with a patient's authorizations and referrals. Authorizations and referrals are attached to specific patient insurance policies; multiple authorizations and referrals can be added to a specific policy. Authorizations and referrals are identified using an authorization or referral number.

Was this information helpful? Yes | No Thank you for your feedback! What went wrong? Incomplete or incorrect information | Irrelevant Content | Others
Submit
Submit referral-authorizations
POST
/v1/{practiceid}/patients/{patientid}/referralauths
Adds new referral authorizations for a specific patient
Was this information helpful? Yes | No Thank you for your feedback! What went wrong? Incomplete or incorrect information | Irrelevant Content | Others
Submit
Try in Postman

Input Parameters

Expand all

required

practiceid integer practiceid
patientid integer patientid
Content-Type string Content type of the payload

Output Parameters

Expand all
referralauthid integer The ID of the referral authorization created.
success string True if the API was successfully processed.
Example Code
Get referral-authorizations
GET
/v1/{practiceid}/patients/{patientid}/referralauths
Retrieves the list of authorizations and referrals for a specific patient
Was this information helpful? Yes | No Thank you for your feedback! What went wrong? Incomplete or incorrect information | Irrelevant Content | Others
Submit
Try in Postman

Input Parameters

Expand all

required

practiceid integer practiceid
patientid integer patientid
insuranceid integer The insurance ID.
showexpired boolean If set, results will include expired authorizations/referrals. This defaults to false.
limit integer Number of entries to return (default 1000, max 10000)Please note that this endpoint has a different default and max than normal.
offset integer Starting point of entries; 0-indexed

Output Parameters

Expand all
ansinamecode string This is the ANSI name and code for this referring provider's specialty.
ansispecialtycode string The ANSI specialty code for this referring provider.
appointmentids array The appointment ID associated with this authorization.
diagnosiscode string The diagnosis code(s).
enddate string The date the authorization/referral is no longer effective.
expired string Flag that specifies whether or not the authorization/referral is expired.
icd10diagnosiscode string The ICD-10 diagnosis code(s).
noreferralrequired string If set to true, then the insurance authorization number is not required.
note string The note attached to the authorization/referral.
notestoprovider string The notes for the provider.
procedurecode string The procedure code(s).
referralauthid integer The referral/authorization ID.
referralauthnumber string The referral authorization number. If this is passed in, then the REFERRINGPROVIDERID is required. This input can by bypassed with the NOREFERRALREQUIRED parameter.
referralauthtype string Determines whether the form is an AUTHORIZATION or REFERRAL.
referralauthunits string The unit (VISITS, UNITS) of count for this authorization/referral.
referredtoproviderid integer The referred-to provider ID.
referringproviderid integer The referring provider ID.
specialty string A friendly name for this provider's specialty.
specialtyid integer The specialty ID.
startdate string The starting date the authorization/referral is effective.
visitsapproved integer The number of visits/units approved. Please see field REFERRALAUTHUNITS for the type.
visitsleft integer The number of visits/units remaining. Please see field REFERRALAUTHUNITS for the type.
Example Code
Update single referral-authorization
PUT
/v1/{practiceid}/patients/{patientid}/referralauths/{referralauthid}
Modifies an existing record for specific referral authorizations
Was this information helpful? Yes | No Thank you for your feedback! What went wrong? Incomplete or incorrect information | Irrelevant Content | Others
Submit
Try in Postman

Input Parameters

Expand all

required

referralauthid integer referralauthid
practiceid integer practiceid
patientid integer patientid
Content-Type string Content type of the payload

Request Body

Expand all

Output Parameters

Expand all
referralauthid integer The ID of the referral authorization created.
success string True if the API was successfully processed.
Example Code