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

Create Practitioner

Request

Creates a new practitioner (doctor or veterinarian) in the system. This endpoint is used to onboard practitioners by collecting their personal, professional, and contact information.

Notes:

  • All required fields must be provided and valid
  • assigned_clinic must reference an existing clinic UUID
  • Validation errors will return descriptive messages for each field
Security
ApiKeyAuth
Bodyapplication/jsonrequired
first_namestringrequired

Practitioner's first name

Example: "Sarah"
last_namestringrequired

Practitioner's last name

Example: "Johnson"
emailstring(email)required

Practitioner's email address

Example: "dr.johnson@partnerclinic.com"
phonestring

Practitioner's phone number

Example: "+1-555-0123"
npi_numberstringrequired

National Provider Identifier (10 digits)

Example: "1234567890"
dea_numberstring

DEA registration number

Example: "FJ1234563"
license_numberstring

State medical license number

Example: "MD-12345"
license_statestring

State of licensure (2-letter code)

Example: "CA"
signature_imagestring

Base64 encoded signature image

assigned_clinicstring(uuid)required

UUID of the clinic to assign this practitioner

Example: "550e8400-e29b-41d4-a716-446655440000"
curl -i -X POST \
  https://docs.novamed.care/_mock/openapi-partner/api/external/practitioner \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: YOUR_API_KEY_HERE' \
  -d '{
    "first_name": "Sarah",
    "last_name": "Johnson",
    "email": "dr.johnson@partnerclinic.com",
    "phone": "+1-555-0123",
    "npi_number": "1234567890",
    "dea_number": "FJ1234563",
    "license_number": "MD-12345",
    "license_state": "CA",
    "signature_image": "base64_encoded_image_string",
    "assigned_clinic": "550e8400-e29b-41d4-a716-446655440000"
  }'

Responses

Practitioner created successfully

Bodyapplication/json
successboolean
Example: true
dataobject
messagestring
Example: "Practitioner created successfully"
Response
application/json
{ "success": true, "data": { "practitioner_id": "660e8400-e29b-41d4-a716-446655440001" }, "message": "Practitioner created successfully" }

Patients

Patient registration and management

Operations

Medication Requests

Medication order management

Operations

Refills

Prescription refill request management

Operations

Webhooks

Webhook configuration for receiving event notifications

Operations