API FAQS

AUTHENTICATION & AUTHORIZATION

• What type of authentication does the API use?
• Why am I receiving a 401 Unauthorized error?
• How should I include the API Authorization Key and where does it differ from the Symmetric Signing Key?

CLINIC & PHARMACIES

• Where does the Clinic ID come from?
• Do I need to create a clinician ID?
• What happens if a pharmacy isn’t configured for a specific medication?
• How is pharmacy selection handled?

DIGITAL SIGNATURES

• How are digital signatures generated and verified?
• Can I rotate or reset the signing key?
• Why does my order fail with a duplicate clinician email error?
• How should the email field be handled when creating a clinician if our system does not collect provider email addresses?

DOSING INSTRUCTIONS

• Do you pass dosing instruction templates through the API?
• Can doctors enter custom dosing instructions?
• What happens if dosing instructions are changed from the common templates?

ENVIRONMENT DIFFERENCES

• Why are certain products available in the production but not in the test environment?
• Why is the clinician creation process now failing with a duplicate email error when it used to work?

PRESCRIPTION & API ERRORS

• What does the SOMETHING_WRONG error mean?
• What’s the correct way to format the shipping method in an API request?
• How do I know if a medication is configured with a pharmacy before sending an order?

PRESCRIPTION ITEMS & DETAILS

• Should I include externalId for each prescription item in my order?
• How can I track individual prescription items if externalId is not returned?
• Will the API support externalId for prescription items in the future?
• What is a prescription "item" and why does each prescription contain items?
• How can I view the drug list and information in the staging environment?
• Why is the drug list dynamic?

See all 7 articles

ORDER SUBMISSION & TRACKING

• Do I need to include the clinicId in the request body?
• What information is required in the order submission?
• How are clinicians matched in the system?
• How can I cancel an order?
• Can I use my own order ID when submitting an order?
• What do the different prescription order statuses mean?

See all 7 articles

TROUBLESHOOTING

• Technical Issue Walkthrough: Clinic Not Found (Staging)
• What should I do if I get a 400 Bad Request?
• How can I test my integration before going live?
• Can I submit multiple prescriptions in one request?
• Why am I seeing a duplicate email error when creating a clinician, and how can it be fixed?