API key & integration

OPTIONAL

For clinics that want coverage verdicts inside their own HIS or EMR. Manual entry, file ingest, and this API are one continuum — the portal keeps working exactly as it does now whether you integrate or not.

API KEYS

nj_live_••••••••••••••••••••••••••••

ENVIRONMENT: production
CHECKS THIS CYCLE: 142
CREDITS DRAWN: 142
CREATED: 12 Aug 2026

Keys are revealed once at creation. API checks draw from the same credit balance as the portal. Mocked in this demo.

INTEGRATION GUIDE

BASE URL · LIVE: https://api.najeb.ai/v1
BASE URL · SANDBOX: https://sandbox.api.najeb.ai/v1
AUTH HEADER: Authorization: Bearer <key>
RATE LIMIT: 60 req/min · burst 120

POST /v1/pbm/checks HTTP/1.1
Host: api.najeb.ai
Authorization: Bearer nj_live_••••••••••••
Content-Type: application/fhir+json

{
  "resourceType": "Bundle",
  "type": "collection",
  "entry": [
    { "resource": { "resourceType": "Patient",
        "identifier": [{ "system": "nid", "value": "1049231770" }] } },
    { "resource": { "resourceType": "Condition",
        "code": { "coding": [{ "system": "icd-10-am", "code": "I48.0" }] } } },
    { "resource": { "resourceType": "MedicationRequest",
        "medicationCodeableConcept": {
          "coding": [{ "system": "sfda", "code": "8901234-01" }] },
        "dispenseRequest": { "quantity": { "value": 30 },
          "expectedSupplyDuration": { "value": 30, "unit": "d" } } } }
  ]
}

Send a FHIR bundle with Patient, Condition and MedicationRequest — the same three resources the file-ingest path reads.
Batch bundles with multiple encounters return 202 Accepted and post verdicts to your webhook as each one resolves.
Error codes mirror the portal's validation: 422 for a missing required field, 409 for an unresolvable patient, 402 when the credit balance is empty.