Prescriptions

Create Single/multiple prescriptions for a patients in one call

💊 Prescription Creation — Field Reference

This endpoint allows the creation of single or multiple prescriptions for a patient in one API call.

Each prescription in the request array is processed individually, enabling efficient handling of bulk prescription submissions.

The system validates each prescription and returns a comprehensive response indicating the success or failure of each entry.

🛡️ Security

Headers

Field	Type	Description	Required
x-api-key	String	API Key for authentication	Y
clinicId	String	Clinic ID in header overrides route parameter	Y

📄 Field Details

⚕️💊 Prescription Info

Field	Type	Description	Required
ext_tracking_id	String	Unique tracking ID in the external system; used for callbacks if provided.	N
patientId	String	Patient ID returned during patient creation.	Y
external_patient_id	String	External patient ID from the source system; used if provided.	N
npi	String	Prescriber’s NPI number.	Y
ndc	String	NDC of the drug; validated against drug catalog.	Y
isControlledDrug	boolean	Indicates if the drug is controlled. false for non-controlled drugs.	Y
dea	String	Required only if isControlledDrug is true.	Y/N
sig	String	Prescription directions.	Y
quantity	Number	Must be a positive integer.	Y
days_supply	Number	Must be a positive integer.	Y
refills	Number	Optional; positive integer; 0 = no refills.	N
notes	String	Optional additional notes.	N
isSubAllowed	boolean	Indicates if substitution is allowed; defaults to false if not provided.	Y
isAutoFlow	boolean	Controls auto-order creation. Defaults to true.	N
prescriberSig	String	Prescriber’s signature — optional for electronic prescriptions.	N
rxAttachment	File/Base64	Optional attachment (e.g., scanned Rx).	N
rxCreateDate	String	ISO-8601 date the prescription was created.	Y
rxTransmitDate	String	ISO-8601 transmit date; defaults to current date if not provided.	N

⚠️ Notes & Limits

Notice	Details
Required Objects	Unless specified, all objects are required.
Validation	All field-level, boolean, date, and clinic/API checks are applied before processing.
Unsupported	isControlledDrug = true is not currently supported; fields included for future use.

⛔Possible Errors

Status Code	Error	Description	Solution
401	Authentication Failed	Invalid API key or clinicId combination	Correct combination of ClinicId and API key to be provided
404	Validation Failed	PATIENT_NOT_FOUND	Patient Id is not found in the system.
409	Validation Failed	PATIENT_CLINIC_MISMATCH	Patient does not belong to the clinic provided.
409	Validation failed	PRESCRIBER_CLINIC_MISMTACH	Prescriber does not belong to the specified clinic
500	Validation failed	Drug with NDC starting with 999991090 not found (first 9 digits, ignoring dashes)	NDC should be valid and it is validated against drug catalog

POST

prescriptions

create

curl --request POST \
  --url https://apidev.epiqconnect.com/prescriptions/create \
  --header 'Content-Type: application/json' \
  --header 'clinicId: <clinicid>' \
  --header 'x-api-key: <x-api-key>' \
  --data '
{
  "patientId": "3a4b8a88-83e9-4ebd-ba62-dcbd218583ab",
  "external_patient_id": "PAT-2025-001",
  "address": {
    "address1": "465 W President George Bush Hwy",
    "address2": "Suite 240",
    "city": "Richardson",
    "state": "TX",
    "zipCode": "75080",
    "country": "US"
  },
  "prescriptions": [
    {
      "external_tracking_id": "RX-2025-001",
      "ndc": "12345-6789-01",
      "npi": "1234567890",
      "days_supply": 30,
      "quantity": 30,
      "sig": "Take one tablet by mouth once daily",
      "refills": 2,
      "isControlledDrug": false,
      "notes": "Patient reports no side effects with previous prescription",
      "isSubAllowed": true,
      "isAutoFlow": true,
      "rxCreateDate": "2025-10-06T10:00:00",
      "rxTransmitDate": "2025-10-06T10:00:00",
      "dea": "",
      "rxAttachment": "",
      "prescriberSig": ""
    },
    {
      "external_tracking_id": "RX-2025-002",
      "ndc": "98765-4321-02",
      "npi": "1234567890",
      "days_supply": 30,
      "quantity": 60,
      "sig": "Take two tablets by mouth once daily with food",
      "refills": 0,
      "isControlledDrug": true,
      "dea": "AB1234563",
      "rxAttachment": "base64EncodedPrescriptionHere",
      "prescriberSig": "base64EncodedSignatureHere",
      "notes": "Patient aware of potential side effects",
      "isSubAllowed": false,
      "isAutoFlow": true,
      "rxCreateDate": "2025-10-06T10:00:00",
      "rxTransmitDate": "2025-10-06T10:00:00"
    }
  ]
}
'

{
  "statusCode": 201,
  "message": "All prescriptions created successfully",
  "summary": {
    "total": 2,
    "successCount": 2,
    "failureCount": 0
  },
  "success": [
    {
      "index": 0,
      "prescription": {
        "prescriptionId": "9594641e-1204-4af4-a51a-988c3ba26a81",
        "cartItemId": "9594641e-1204-4af4-a51a-988c3ba26a81",
        "patientId": "3a4b8a88-83e9-4ebd-ba62-dcbd218583ab",
        "clinicId": "3b47a23f-9080-4a2e-a4fa-654d9aa76e80",
        "prescriberId": "14b8f448-4081-7002-acaa-f14c4994917b"
      },
      "orders": {
        "orderIds": [
          "27920f00-68eb-45c0-92ef-9035ef416e8f"
        ],
        "prescriptionIds": [
          "9594641e-1204-4af4-a51a-988c3ba26a81"
        ]
      },
      "messages": {
        "prescription": "Prescription added successfully",
        "order": "Order(s) created successfully"
      }
    },
    {
      "index": 1,
      "prescription": {
        "prescriptionId": "45535eb5-ef0e-4ca9-862b-fbe7add7d41e",
        "cartItemId": "45535eb5-ef0e-4ca9-862b-fbe7add7d41e",
        "patientId": "3a4b8a88-83e9-4ebd-ba62-dcbd218583ab",
        "clinicId": "3b47a23f-9080-4a2e-a4fa-654d9aa76e80",
        "prescriberId": "14b8f448-4081-7002-acaa-f14c4994917b"
      },
      "orders": {
        "orderIds": [
          "0086572b-c34e-40af-a05b-0054837892b0"
        ],
        "prescriptionIds": [
          "45535eb5-ef0e-4ca9-862b-fbe7add7d41e"
        ]
      },
      "messages": {
        "prescription": "Prescription added successfully",
        "order": "Order(s) created successfully"
      }
    }
  ],
  "errors": []
}

Headers

clinicId

string

required

Clinic identifier

x-api-key

string

required

API Key for authentication

Body

application/json

patientId

string

required

Unique PatientID of the patient

Example:

"3a4b8a88-83e9-4ebd-ba62-dcbd218583ab"

external_patient_id

string

required

External patient ID in source system

Example:

"PAT-2025-001"

address

object

required

Patient address information

Show child attributes

address.address1

string

required

First line of the address.

Example:

"465 W President George Bush Hwy"

address.address2

string

required

Second line of the address.

Example:

"Suite 240"

address.city

string

required

City.

Example:

"Richardson"

address.state

string

required

State.

Example:

"TX"

address.zipCode

string

required

Zip code.

Example:

"75080"

address.country

string

required

Country.

Example:

"US"

Example:

{
  "address1": "465 W President George Bush Hwy",
  "address2": "Suite 240",
  "city": "Richardson",
  "state": "TX",
  "zipCode": "75080",
  "country": "USA"
}

prescriptions

object[]

required

Array of prescription entries to be created for this patient

Show child attributes

prescriptions.external_tracking_id

string

required

External tracking ID for the prescription in source system.

Example:

"RX-2025-001"

prescriptions.ndc

string

required

NDC code for the drug. Mandatory.

Example:

"12345-6789-01"

prescriptions.npi

string

required

NPI number of the prescriber (10 digits). Mandatory.

Example:

"1234567890"

prescriptions.days_supply

number

required

Days supply for the prescription.

Example:

30

prescriptions.quantity

number

required

Quantity prescribed.

Example:

30

prescriptions.sig

string

required

Prescription instructions (sig). Mandatory.

Example:

"Take one tablet by mouth once daily"

prescriptions.refills

number

required

Number of refills.

Example:

2

prescriptions.isControlledDrug

boolean

required

Is this a controlled drug?

Example:

false

prescriptions.isSubAllowed

boolean

required

Is substitution allowed?

Example:

true

prescriptions.isAutoFlow

boolean

required

If true, the prescription will automatically flow to Order. If false, allows cancellation before processing.

Example:

true

prescriptions.rxCreateDate

string

required

Prescription creation date in ISO 8601 format.

Example:

"2025-10-06T10:00:00"

prescriptions.rxTransmitDate

string

required

Prescription transmit date in ISO 8601 format.

Example:

"2025-10-06T10:00:00"

prescriptions.notes

string

Additional notes.

Example:

"Patient reports no side effects"

prescriptions.dea

string

DEA number of the prescriber (required if isControlledDrug is true).

Example:

"AB1234563"

prescriptions.rxAttachment

string

Base64 encoded prescription attachment (required if isControlledDrug is true).

Example:

"base64EncodedPrescriptionHere"

prescriptions.prescriberSig

string

Base64 encoded prescriber signature (required if isControlledDrug is true).

Example:

"base64EncodedSignatureHere"

Example:

[
  {
    "external_tracking_id": "RX-2025-001",
    "ndc": "12345-6789-01",
    "npi": "1234567890",
    "days_supply": 30,
    "quantity": 30,
    "sig": "Take one tablet by mouth once daily",
    "refills": 2,
    "isControlledDrug": false,
    "notes": "Patient reports no side effects with previous prescription",
    "isSubAllowed": true,
    "isAutoFlow": true,
    "rxCreateDate": "2025-10-06T10:00:00",
    "rxTransmitDate": "2025-10-06T10:00:00",
    "dea": "",
    "rxAttachment": "",
    "prescriberSig": ""
  }
]

Response

Prescriptions added successfully.

Fill Order This endpoint is used to fill an order for prescriptions that were created with isAutoFlow=false. When isAutoFlow is false during prescription creation, orders are not created automatically and must be filled explicitly using this endpoint. Provide the clinicId, apiKey, and prescriptionIds for the prescriptions you wish to fill. Only prescriptions with isAutoFlow=false are eligible for this operation.

⌘I

curl --request POST \
  --url https://apidev.epiqconnect.com/prescriptions/create \
  --header 'Content-Type: application/json' \
  --header 'clinicId: <clinicid>' \
  --header 'x-api-key: <x-api-key>' \
  --data '
{
  "patientId": "3a4b8a88-83e9-4ebd-ba62-dcbd218583ab",
  "external_patient_id": "PAT-2025-001",
  "address": {
    "address1": "465 W President George Bush Hwy",
    "address2": "Suite 240",
    "city": "Richardson",
    "state": "TX",
    "zipCode": "75080",
    "country": "US"
  },
  "prescriptions": [
    {
      "external_tracking_id": "RX-2025-001",
      "ndc": "12345-6789-01",
      "npi": "1234567890",
      "days_supply": 30,
      "quantity": 30,
      "sig": "Take one tablet by mouth once daily",
      "refills": 2,
      "isControlledDrug": false,
      "notes": "Patient reports no side effects with previous prescription",
      "isSubAllowed": true,
      "isAutoFlow": true,
      "rxCreateDate": "2025-10-06T10:00:00",
      "rxTransmitDate": "2025-10-06T10:00:00",
      "dea": "",
      "rxAttachment": "",
      "prescriberSig": ""
    },
    {
      "external_tracking_id": "RX-2025-002",
      "ndc": "98765-4321-02",
      "npi": "1234567890",
      "days_supply": 30,
      "quantity": 60,
      "sig": "Take two tablets by mouth once daily with food",
      "refills": 0,
      "isControlledDrug": true,
      "dea": "AB1234563",
      "rxAttachment": "base64EncodedPrescriptionHere",
      "prescriberSig": "base64EncodedSignatureHere",
      "notes": "Patient aware of potential side effects",
      "isSubAllowed": false,
      "isAutoFlow": true,
      "rxCreateDate": "2025-10-06T10:00:00",
      "rxTransmitDate": "2025-10-06T10:00:00"
    }
  ]
}
'

{
  "statusCode": 201,
  "message": "All prescriptions created successfully",
  "summary": {
    "total": 2,
    "successCount": 2,
    "failureCount": 0
  },
  "success": [
    {
      "index": 0,
      "prescription": {
        "prescriptionId": "9594641e-1204-4af4-a51a-988c3ba26a81",
        "cartItemId": "9594641e-1204-4af4-a51a-988c3ba26a81",
        "patientId": "3a4b8a88-83e9-4ebd-ba62-dcbd218583ab",
        "clinicId": "3b47a23f-9080-4a2e-a4fa-654d9aa76e80",
        "prescriberId": "14b8f448-4081-7002-acaa-f14c4994917b"
      },
      "orders": {
        "orderIds": [
          "27920f00-68eb-45c0-92ef-9035ef416e8f"
        ],
        "prescriptionIds": [
          "9594641e-1204-4af4-a51a-988c3ba26a81"
        ]
      },
      "messages": {
        "prescription": "Prescription added successfully",
        "order": "Order(s) created successfully"
      }
    },
    {
      "index": 1,
      "prescription": {
        "prescriptionId": "45535eb5-ef0e-4ca9-862b-fbe7add7d41e",
        "cartItemId": "45535eb5-ef0e-4ca9-862b-fbe7add7d41e",
        "patientId": "3a4b8a88-83e9-4ebd-ba62-dcbd218583ab",
        "clinicId": "3b47a23f-9080-4a2e-a4fa-654d9aa76e80",
        "prescriberId": "14b8f448-4081-7002-acaa-f14c4994917b"
      },
      "orders": {
        "orderIds": [
          "0086572b-c34e-40af-a05b-0054837892b0"
        ],
        "prescriptionIds": [
          "45535eb5-ef0e-4ca9-862b-fbe7add7d41e"
        ]
      },
      "messages": {
        "prescription": "Prescription added successfully",
        "order": "Order(s) created successfully"
      }
    }
  ],
  "errors": []
}

Overview

Patients

Prescribers

Prescriptions

Create Single/multiple prescriptions for a patients in one call

🛡️ Security

Headers

📄 Field Details

⚕️💊 Prescription Info

⚠️ Notes & Limits

⛔Possible Errors

Headers

Body

Response