api

Create Copay Request

Generate a Copay Request to retrieve copay information on a patient's prescription(s). We can support multiple insurances on a copay request

post/api/v1/copay_request

Request body

prescriptionsstring[]

Patient's prescriptions.

insurance_tokenstring[]
metadatastring

Customer-side identifier to reference the Copay Request in Customer system

patient_tokenstring required

Patient token

notesstring

Additional information customer wishes to convey relating to this Copay Request

ship_to_statestring

State prescription is being shipped to as 2 letter abbreviation

patient_payment_type'cash' | 'insurance'

Whether to run with insurance (must be provided) or as cash

Example request

{
  "prescriptions": [
    {
      "prescription_token": "z3q2jr",
      "quantity": 8.7,
      "days_supply": 30,
      "patient_consent": {
        "consent_statement": "Patient Bruce Banner consented that Truepill pharmacy will bill their insurance in order to provide a fill of Medication Sildenafil 10mg for a quantity of 10.",
        "patient_name": "Bruce Banner",
        "consent_provided_by": "Hulk",
        "item": "sildenafil 10mg",
        "consent_method": "VERBAL",
        "consent_date": " 2021-01-25 15:17:51.000Z",
        "consent_type": "INSURANCE"
      },
      "claim_overrides": [
        {
          "insurance_token": "adcbc795028c009d",
          "prior_authorization_number": "ABC123",
          "submission_clarification_code": "4"
        },
        {
          "insurance_token": "75539ed9ffb86f38",
          "other_coverage_code": "8"
        }
      ]
    },
    "b5q3t2",
    "h3r55c"
  ],
  "insurance_token": [
    "skhsyq83rkd3uht9",
    "ubqfc1a0a17hjb1c",
    "oi4aafwcsv5zzvvj"
  ],
  "metadata": "cfe146",
  "patient_token": "4526d90a",
  "notes": "This is a note",
  "ship_to_state": "CA"
}

Response

Accepted

Changes