- Documentation
- API Reference
- Platform Guide
- Quickstart Guide
- Changelog
- POSTRun Benefit Verification
- GETRetrieve Benefit Verification
- POSTSend Prior Authorization
- GETRetrieve Prior Authorization
- POSTCheck Clinical Qualification
- GETRetrieve Clinical Qualification
- POSTCheck Prior Authorization Status
- POSTSubmit Patient Enrollment
- Authentication
- Webhooks
API Documentation
Retrieve Clinical Qualification (On Roadmap)
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Authorizations
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Path Parameters
Response
success
An instance of GetClinicalQualificationResponseData containing detailed information about the prior auth, or None if no such data is available.
The ID of this clinical qualification
The type of object. This will always be 'clinical_qualification', from this endpoint, but this can be helpful for differentiating between different types of objects when parsing webhook responses.
clinical_qualification
Clinical diagnoses for the patient in ICD-10 format. i.e. 'E66.9'
ICD-10 code for the diagnosis. i.e. 'E66.9'
A collection of evidence items supporting the authorization request. Any other supporting evidence that doesn't fit into one of the explicitly declared fields above can be added here.
Detailed content of the evidence, which varies based on the type of evidence.
The date and time (if available) when the evidence was created. This is important for ensuring we have an accurate timeline of the patient's history.
Title of the evidence. This will be shown to users in the platform UI so it's recommended to give it a name that would be meaningful to them, such as 'Intake Form'
Demographic information for the patient
The patient's postal address
Street address of residence.
Additional street address information.
City of residence.
State or province of residence.
ZIP or postal code part of the address.
Country of residence.
The patient's date of birth
The patient's email address
The patient's first name
The patient's last name
The patient's gender
male
, female
, other
, not_specified
Your internal ID for this patient. This is used for linking all of the requests for a given patient.
The patient's phone number
Array of insurance documents.
Insurance card scanned content.
The client/employer name.
The group number on the card.
The member name on the card.
The member number on the card.
The payer name on the card. This field is not normalized, so the same plan may have different names depending on the way it appears on the card. i.e. 'United Healthcare', 'United', 'United Health' could all appear
The plan name on the card. This field is not normalized, so the same plan may have different names depending on the way it appears on the card
The Rx BIN number on the card.
The Rx group number on the card.
The Rx PCN number on the card.
Error message if we were unable to extract information from the card.
The Base64 encoded insurance card image you send in the request is stored on our servers. A signed URL to the image is returned here. This URL has a short expiry time, so you should download the image immediately after receiving it if you want to view the asset.
Information regarding the potential prescriptions this clinical qualification check should be run for
The number of days the prescription will be expected to last.
The quantity of the medication.
Instructions on how the medication should be taken.
The name of the medication.
The strength of the medication.
The form of the medication.
tablet
, capsule
, suspension
, cream
, solution
, ointment
, suppository
, inhaler
, liquid
, powder
, injectable
, patch
, gel
, lozenge
, concentrate
The unit of measurement for the medication.
milliliter
, liter
, gram
, milligram
, microgram
, unit
, tablet
, capsule
, patch
, inhaler
, applicator
, pack
, vial
The route of administration for the medication.
oral
, subcutaneous
, intravenous
, intramuscular
, topical
, inhalation
, nasal
, ophthalmic
, otic
, rectal
, vaginal
, transdermal
, buccal
, sublingual
An optional dictionary containing additional information related to the drug or future prescription.
Details of the healthcare provider who created the prescription.
The provider's postal address.
Street address of residence.
Additional street address information.
City of residence.
State or province of residence.
ZIP or postal code part of the address.
Country of residence.
The provider's fax number.
The provider's first name.
The provider's last name.
The provider's NPI.
The provider's phone number.
Information about the pharmacy where the prescription will be filled.
The name of the pharmacy.
Represents a postal address.
Street address of residence.
Additional street address information.
City of residence.
State or province of residence.
ZIP or postal code part of the address.
Country of residence.
list of questionnaires. This is the best place to send structured Q&A format data, such as intake forms, etc.
A list of questions included in the questionnaire.
The answer to the question.
Optional list of choices for the question. If provided, the answer must be one of the choices. It's important to include this list of choices for any multiple choice question. This allows our AI to know what a user has effectively said 'no' to by picking another option. I.e. for a question 'Do you have any of the following conditions: Diabetes, Heart Disease, Cancer, None of the above' if the user answers 'None of the above' we can infer that they don't have any of those conditions. Without the choices list we would have no way of knowing that.
The question to be answered.
The date and time when the questionnaire was answered. This is important for ensuring we have an accurate timeline of the patient's history.
list of visit notes.
The title of the visit note. This is optional and can be used to give the note a meaningful name, such as 'Initial Consultation'.
The content of the visit note.
The date and time (if available) when the visit note was created. This is important for ensuring we have an accurate timeline of the patient's history.
The results of the clinical qualification for each of the drugs.
The drug this clinical qualification is for.
The number of days the prescription will be expected to last.
The quantity of the medication.
Instructions on how the medication should be taken.
The name of the medication.
The strength of the medication.
The form of the medication.
tablet
, capsule
, suspension
, cream
, solution
, ointment
, suppository
, inhaler
, liquid
, powder
, injectable
, patch
, gel
, lozenge
, concentrate
The unit of measurement for the medication.
milliliter
, liter
, gram
, milligram
, microgram
, unit
, tablet
, capsule
, patch
, inhaler
, applicator
, pack
, vial
The route of administration for the medication.
oral
, subcutaneous
, intravenous
, intramuscular
, topical
, inhalation
, nasal
, ophthalmic
, otic
, rectal
, vaginal
, transdermal
, buccal
, sublingual
An optional dictionary containing additional information related to the drug or future prescription.
The status of the clinical qualification for this prescription.
pending
, qualified
, unqualified
, unknown
If the status is ineligible, the reason(s) why. More structured fields will be added to this model in the future.
Reason for ineligibility. This is a free text field that could include any text.