Quickstart

This walkthrough uses synthetic patient data and a sandbox-only mock_result. You will create a benefit verification, retrieve it by ID, and interpret the result. You need a terminal with curl and access to a sandbox organization.

1. Get a sandbox token

Ask your Develop Health contact for a sandbox organization, then create an API token for that organization. Set DEVELOP_HEALTH_SANDBOX_TOKEN to the token in your terminal environment. Keep it on your server and out of source control.

Use the sandbox organization’s token. Sandbox and production use the same base URL; the token determines the organization. Production requests reject mock_result.

2. Create a benefit verification

Save the following as bv-request.json. The NPI is illustrative; use your configured sandbox test provider if your workflow requires one.

{
  "patient": {
    "internal_id": "sandbox-patient-001",
    "first_name": "Jamie",
    "last_name": "Example",
    "date_of_birth": "1990-01-15",
    "gender": "female",
    "address": {
      "street": "123 Example Street",
      "city": "San Francisco",
      "state_province": "CA",
      "zip_postal_code": "94107"
    }
  },
  "provider": {
    "first_name": "Alex",
    "last_name": "Example",
    "npi": "1234567893",
    "address": {
      "street": "456 Example Avenue",
      "city": "San Francisco",
      "state_province": "CA",
      "zip_postal_code": "94107"
    }
  },
  "insurance_content": {
    "member_number": "SANDBOX001",
    "rx_bin": "012345",
    "rx_pcn": "TESTPCN",
    "rx_group": "TESTGROUP",
    "payer_name": "Example Health Plan",
    "plan_name": "Example Pharmacy Plan"
  },
  "drugs": [
    {
      "ndc": "00169450514",
      "quantity": 4
    }
  ],
  "preferred_processing_mode": "standard",
  "mock_result": {
    "status": "completed",
    "case": "drugs_covered__prior_auth_not_required__has_copay"
  }
}

Submit the request:

curl https://api.develophealth.ai/benefit-verification \
  -H "Authorization: Bearer $DEVELOP_HEALTH_SANDBOX_TOKEN" \
  -H "Content-Type: application/json" \
  --data-binary @bv-request.json

On success, copy the returned data.id. A successful response means the request was accepted. The verification result is retrieved separately. If the request is rejected, check the response format and errors and the BV error codes.

3. Retrieve the result

Set BV_ID to the data.id from the create response, then run:

curl "https://api.develophealth.ai/benefit-verification/$BV_ID" \
  -H "Authorization: Bearer $DEVELOP_HEALTH_SANDBOX_TOKEN"

Read data.status. If it is pending, wait a few seconds and retrieve the same ID again. When it is completed, read data.patient_coverage_status and each item in data.drugs. For this mock scenario, each requested drug is covered, does not require prior authorization, and has a copay. Inspect these fields in each drug result:

Field	What to read
`coverage`	Whether the medication is covered
`prior_authorization_required`	Whether a PA is needed
`copay` / `copay_options`	The returned cost information, when available

These are simulated benefits for integration testing. Do not use them to make decisions about a real patient’s coverage. If the status is failed, inspect data.error; if it is cancelled, no coverage result is expected. See statuses and error codes for the complete lifecycle and result handling.

Next steps

Create a benefit verification with your own request shape.
Receive and verify webhooks to process results without repeated GET requests.
Test in the sandbox with other coverage and failure scenarios.
Create a prior authorization to try a prior authorization workflow.

Start here

Benefit verification

Prior authorization

Integration

1. Get a sandbox token

2. Create a benefit verification

3. Retrieve the result

Next steps

​1. Get a sandbox token

​2. Create a benefit verification

​3. Retrieve the result

​Next steps

1. Get a sandbox token

2. Create a benefit verification

3. Retrieve the result

Next steps