Skip to content

NovaMed Partner API (1.0.0)

The NovaMed Partner API enables healthcare partners to integrate with NovaMed for patient care management, prescription fulfillment, and order tracking.

Authentication: All requests require an x-api-key header with your API key.

Base URLs:

  • Development: https://novamed-feapidev.stackmod.info
  • Production: https://feapi.novamed.care

For detailed guides, see the Getting Started documentation.

Download OpenAPI description
Overview
Languages
Servers
Mock server
https://docs.novamed.care/_mock/openapi-partner/
Development environment
https://novamed-feapidev.stackmod.info/
Production environment
https://feapi.novamed.care/

Practitioners

Manage practitioners (doctors, veterinarians) in the system

Operations

Patients

Patient registration and management

Operations

Medication Requests

Medication order management

Operations

Create Medication Request

Request

Create a new medication request for a patient. This endpoint initiates the prescription and fulfillment process.

Notes:

  • Patient and practitioner must already exist in the system
  • Medication details must be valid
  • The request will be validated against the clinic's available medications
Security
ApiKeyAuth
Bodyapplication/jsonrequired
clinic_idstring(uuid)required

UUID of the clinic

Example: "550e8400-e29b-41d4-a716-446655440000"
patient_idstring(uuid)required

UUID of the patient

Example: "770e8400-e29b-41d4-a716-446655440002"
practitioner_idstring(uuid)required

UUID of the prescribing practitioner

Example: "660e8400-e29b-41d4-a716-446655440001"
medication_namestringrequired

Name of the medication

Example: "Testosterone Cypionate"
medication_strengthstring

Medication strength/concentration

Example: "200mg/ml"
quantityintegerrequired

Quantity to dispense

Example: 1
refillsinteger

Number of refills authorized

Example: 3
days_supplyinteger

Days supply per fill

Example: 30
instructionsstring

Dosing instructions for the patient

Example: "Inject 0.5ml (100mg) intramuscularly twice weekly"
curl -i -X POST \
  https://docs.novamed.care/_mock/openapi-partner/api/external/medication-request \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: YOUR_API_KEY_HERE' \
  -d '{
    "clinic_id": "550e8400-e29b-41d4-a716-446655440000",
    "patient_id": "770e8400-e29b-41d4-a716-446655440002",
    "practitioner_id": "660e8400-e29b-41d4-a716-446655440001",
    "medication_name": "Testosterone Cypionate",
    "medication_strength": "200mg/ml",
    "quantity": 1,
    "refills": 3,
    "days_supply": 30,
    "instructions": "Inject 0.5ml (100mg) intramuscularly twice weekly"
  }'

Responses

Medication request created successfully

Bodyapplication/json
successboolean
Example: true
dataobject
messagestring
Example: "Medication request created successfully"
Response
application/json
{ "success": true, "data": { "medication_request_id": "880e8400-e29b-41d4-a716-446655440003" }, "message": "Medication request created successfully" }

Refills

Prescription refill request management

Operations

Webhooks

Webhook configuration for receiving event notifications

Operations