API Documentation
- Quickstart Guide
- Changelog
- POSTRun Benefit Verification
- GETRetrieve Benefit Verification
- POSTCancel Benefit Verification
- POSTSend Prior Authorization
- GETRetrieve Prior Authorization
- POSTAuthorize Provider
- POSTCheck Clinical Qualification
- GETRetrieve Clinical Qualification
- POSTCheck Prior Authorization Status
- POSTSubmit Patient Enrollment
- Authentication
- Webhooks
Retrieve Clinical Qualification (On Roadmap)
curl --request GET \
--url https://api.develophealth.ai/clinical-qualification/{id} \
--header 'Authorization: Bearer <token>'{
"status": "success",
"data": {
"id": "cq_sdkfj3f",
"object": "clinical_qualification",
"diagnoses": [
{
"code": "E66.9"
}
],
"evidence": [
{
"content": {
"bmi_value": 32,
"date_measured": "2023-11-10"
},
"date_created": "2023-11-10T10:15:00",
"title": "BMI Chart"
},
{
"content": {
"medication_name": "Metformin",
"response": "No significant weight loss"
},
"date_created": "2023-11-10T10:15:00",
"title": "Previous Medication History"
}
],
"patient": {
"address": {
"street": "123 Health St.",
"city": "Wellness",
"state_province": "CA",
"zip_postal_code": "12345",
"country": "USA"
},
"date_of_birth": "1980-01-01",
"email": "[email protected]",
"first_name": "John",
"last_name": "Doe",
"gender": "male",
"internal_id": "123456",
"phone": "123-456-7890"
},
"insurance": [
{
"scanned_content": {
"client_name": "Company",
"group_number": "12345678",
"member_name": "John Doe",
"member_number": "12345678",
"payer_name": "United",
"plan_name": "Plus Plan",
"rx_bin": "123456",
"rx_group": "ADV",
"rx_pcn": "FAC"
},
"discrete_content": {},
"url": "https://example.com/insurance_doc"
},
{
"scanned_content": {
"error": "Unable to extract information from card"
},
"discrete_content": {},
"url": "https://example.com/insurance_doc2"
}
],
"drugs": [
{
"days_supply": 30,
"quantity": 2,
"directions": "Inject subcutaneously once a week",
"drug_name": "Wegovy",
"strength": "0.25 mg/0.5 mL (0.25 mg dose)",
"dose_form": "injectable",
"dispense_unit": "milliliter",
"route_of_administration": "subcutaneous"
},
{
"days_supply": 28,
"quantity": 1,
"directions": "Inject subcutaneously once a week",
"drug_name": "Ozempic",
"strength": "0.5 mg/dose",
"dose_form": "injectable",
"dispense_unit": "applicator",
"route_of_administration": "subcutaneous"
},
{
"days_supply": 28,
"quantity": 4,
"directions": "Inject subcutaneously once a week",
"drug_name": "Zepbound",
"strength": "1 mg/dose",
"dose_form": "injectable",
"dispense_unit": "applicator",
"route_of_administration": "subcutaneous"
}
],
"provider": {
"address": {
"street": "456 Care Blvd.",
"city": "Healtown",
"state_province": "CA",
"zip_postal_code": "67890",
"country": "USA"
},
"fax": "987-654-3211",
"first_name": "Alice",
"last_name": "Smith",
"npi": "1234567890",
"phone": "987-654-3210"
},
"questionnaires": [
{
"questions": [
{
"answer": "I usually eat a balanced diet and exercise 3 times a week.",
"question": "Please describe your current diet and exercise routine."
},
{
"answer": "Yes, I have tried metformin without significant results.",
"question": "Have you previously tried other weight loss medications?"
}
],
"date_created": "2023-11-01T08:00:00"
}
],
"visit_notes": [
{
"content": "Patient presents with a BMI of 32, indicating obesity. Recommended to start Wegovy for weight management.",
"date_created": "2023-11-10T10:00:00"
}
],
"results": [
{
"drug": {
"days_supply": 30,
"quantity": 2,
"directions": "Inject subcutaneously once a week",
"drug_name": "Wegovy",
"strength": "0.25 mg/0.5 mL (0.25 mg dose)",
"dose_form": "injectable",
"dispense_unit": "milliliter",
"route_of_administration": "subcutaneous"
},
"status": "qualified",
"unqualified_reasons": []
},
{
"drug": {
"days_supply": 28,
"quantity": 4,
"directions": "Inject subcutaneously once a week",
"drug_name": "Zepbound",
"strength": "1 mg/dose",
"dose_form": "injectable",
"dispense_unit": "applicator",
"route_of_administration": "subcutaneous"
},
"status": "qualified",
"unqualified_reasons": []
},
{
"drug": {
"days_supply": 28,
"quantity": 1,
"directions": "Inject subcutaneously once a week",
"drug_name": "Ozempic",
"strength": "0.5 mg/dose",
"dose_form": "injectable",
"dispense_unit": "applicator",
"route_of_administration": "subcutaneous"
},
"status": "unqualified",
"unqualified_reasons": [
{
"description": "The patient does not have a diagnosis of type 2 diabetes."
}
]
}
]
}
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Response
Represents the response structure for a GET /prior-authorization/:id request.
This class extends the generic ApiResponse, specifically tailored to handle responses related to clinical qualifications. It primarily includes the data attribute, which holds detailed information about the benefit verification process and its results.
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
Clinical diagnoses for the patient in ICD-10 format. i.e. 'E66.9'
Represents a medical diagnosis with a code and description.
ICD-10 code for the diagnosis. i.e. 'E66.9'
Demographic information for the patient
The patient's postal address
Street address of residence.
1City of residence.
1State or province of residence.
1ZIP or postal code part of the address.
1Country of residence.
1Additional street address information.
The patient's date of birth
The patient's first name
1The patient's last name
1The 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.
1The patient's email address
The patient's phone number
Array of insurance documents.
An object containing details that were extracted from the insurance card images provided in the creation request.
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.
An object containing manually-provided insurance details from the creation request.
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.
If applicable, 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
Represents a medication prescribed by a healthcare provider.
The number of days the prescription will be expected to last.
The quantity of the medication.
Instructions on how the medication should be taken.
1The name of the medication.
1The strength of the medication.
1The form of the medication.
tablet, capsule, suspension, cream, solution, ointment, suppository, inhaler, liquid, powder, injectable, patch, gel, lozenge, concentrate, film The unit of measurement for the medication.
milliliter, liter, gram, milligram, microgram, unit, tablet, capsule, patch, inhaler, applicator, pack, vial, film 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.
1City of residence.
1State or province of residence.
1ZIP or postal code part of the address.
1Country of residence.
1Additional street address information.
The provider's first name.
1The provider's last name.
1The provider's NPI.
1The provider's fax number.
The provider's phone number.
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.
1The name of the medication.
1The strength of the medication.
1The form of the medication.
tablet, capsule, suspension, cream, solution, ointment, suppository, inhaler, liquid, powder, injectable, patch, gel, lozenge, concentrate, film The unit of measurement for the medication.
milliliter, liter, gram, milligram, microgram, unit, tablet, capsule, patch, inhaler, applicator, pack, vial, film 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.
Represents the reason why a drug is not eligible for a clinical qualification check.
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.
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 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.
Represents an item of evidence, which can include an associated digital asset.
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'
File asset containing the evidence.
Detailed content of the evidence, which varies based on the type of evidence.
Information about the pharmacy where the prescription will be filled.
The name of the pharmacy.
1Represents a postal address.
Street address of residence.
1City of residence.
1State or province of residence.
1ZIP or postal code part of the address.
1Country of residence.
1Additional street address information.
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.
Represents a single question, as part of a questionnaire.
The answer to the question.
1The question to be answered.
1Optional 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 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.
Represents a note made during a patient visit.
The content of the visit note.
1The 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 title of the visit note. This is optional and can be used to give the note a meaningful name, such as 'Initial Consultation'.
1curl --request GET \
--url https://api.develophealth.ai/clinical-qualification/{id} \
--header 'Authorization: Bearer <token>'{
"status": "success",
"data": {
"id": "cq_sdkfj3f",
"object": "clinical_qualification",
"diagnoses": [
{
"code": "E66.9"
}
],
"evidence": [
{
"content": {
"bmi_value": 32,
"date_measured": "2023-11-10"
},
"date_created": "2023-11-10T10:15:00",
"title": "BMI Chart"
},
{
"content": {
"medication_name": "Metformin",
"response": "No significant weight loss"
},
"date_created": "2023-11-10T10:15:00",
"title": "Previous Medication History"
}
],
"patient": {
"address": {
"street": "123 Health St.",
"city": "Wellness",
"state_province": "CA",
"zip_postal_code": "12345",
"country": "USA"
},
"date_of_birth": "1980-01-01",
"email": "[email protected]",
"first_name": "John",
"last_name": "Doe",
"gender": "male",
"internal_id": "123456",
"phone": "123-456-7890"
},
"insurance": [
{
"scanned_content": {
"client_name": "Company",
"group_number": "12345678",
"member_name": "John Doe",
"member_number": "12345678",
"payer_name": "United",
"plan_name": "Plus Plan",
"rx_bin": "123456",
"rx_group": "ADV",
"rx_pcn": "FAC"
},
"discrete_content": {},
"url": "https://example.com/insurance_doc"
},
{
"scanned_content": {
"error": "Unable to extract information from card"
},
"discrete_content": {},
"url": "https://example.com/insurance_doc2"
}
],
"drugs": [
{
"days_supply": 30,
"quantity": 2,
"directions": "Inject subcutaneously once a week",
"drug_name": "Wegovy",
"strength": "0.25 mg/0.5 mL (0.25 mg dose)",
"dose_form": "injectable",
"dispense_unit": "milliliter",
"route_of_administration": "subcutaneous"
},
{
"days_supply": 28,
"quantity": 1,
"directions": "Inject subcutaneously once a week",
"drug_name": "Ozempic",
"strength": "0.5 mg/dose",
"dose_form": "injectable",
"dispense_unit": "applicator",
"route_of_administration": "subcutaneous"
},
{
"days_supply": 28,
"quantity": 4,
"directions": "Inject subcutaneously once a week",
"drug_name": "Zepbound",
"strength": "1 mg/dose",
"dose_form": "injectable",
"dispense_unit": "applicator",
"route_of_administration": "subcutaneous"
}
],
"provider": {
"address": {
"street": "456 Care Blvd.",
"city": "Healtown",
"state_province": "CA",
"zip_postal_code": "67890",
"country": "USA"
},
"fax": "987-654-3211",
"first_name": "Alice",
"last_name": "Smith",
"npi": "1234567890",
"phone": "987-654-3210"
},
"questionnaires": [
{
"questions": [
{
"answer": "I usually eat a balanced diet and exercise 3 times a week.",
"question": "Please describe your current diet and exercise routine."
},
{
"answer": "Yes, I have tried metformin without significant results.",
"question": "Have you previously tried other weight loss medications?"
}
],
"date_created": "2023-11-01T08:00:00"
}
],
"visit_notes": [
{
"content": "Patient presents with a BMI of 32, indicating obesity. Recommended to start Wegovy for weight management.",
"date_created": "2023-11-10T10:00:00"
}
],
"results": [
{
"drug": {
"days_supply": 30,
"quantity": 2,
"directions": "Inject subcutaneously once a week",
"drug_name": "Wegovy",
"strength": "0.25 mg/0.5 mL (0.25 mg dose)",
"dose_form": "injectable",
"dispense_unit": "milliliter",
"route_of_administration": "subcutaneous"
},
"status": "qualified",
"unqualified_reasons": []
},
{
"drug": {
"days_supply": 28,
"quantity": 4,
"directions": "Inject subcutaneously once a week",
"drug_name": "Zepbound",
"strength": "1 mg/dose",
"dose_form": "injectable",
"dispense_unit": "applicator",
"route_of_administration": "subcutaneous"
},
"status": "qualified",
"unqualified_reasons": []
},
{
"drug": {
"days_supply": 28,
"quantity": 1,
"directions": "Inject subcutaneously once a week",
"drug_name": "Ozempic",
"strength": "0.5 mg/dose",
"dose_form": "injectable",
"dispense_unit": "applicator",
"route_of_administration": "subcutaneous"
},
"status": "unqualified",
"unqualified_reasons": [
{
"description": "The patient does not have a diagnosis of type 2 diabetes."
}
]
}
]
}
}