Documentation

API Reference

Complete reference for the ARXIO Health Clinical Decision Support API. All endpoints require authentication and return JSON responses.

On This Page

Authentication

All API requests must include your API key in the X-API-Key header.

Header
X-API-Key: arx_live_your_api_key_here

Security: Never expose your API key in client-side code. Always make API calls from your backend server.

Base URL

https://api.arxio.health

Rate Limiting

Rate limits are applied per API key on a daily basis. Limits reset at midnight UTC.

PlanDaily LimitBurst Rate
Free100 requests/day10 requests/minute
Pro10,000 requests/day100 requests/minute
EnterpriseUnlimitedCustom

Rate limit headers are included in every response:

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 87
X-RateLimit-Reset: 1710374400

Endpoints

POST/v1/clinical-review

Clinical Review

Submit a patient profile and new prescription for comprehensive drug utilization review. Returns safety flags across 6 categories: drug interactions, allergy screening, dose range validation, patient profile analysis, duplicate therapy detection, and prescriber credential verification.

Request Body

application/json
{
  "patient": {
    "age": 72,
    "weight_kg": 68,
    "sex": "M",
    "allergies": ["sulfa", "penicillin"],
    "conditions": ["atrial_fibrillation", "hypertension"],
    "medications": ["warfarin", "lisinopril", "metoprolol"]
  },
  "new_rx": {
    "drug": "metronidazole",
    "dose": "500mg",
    "frequency": "TID",
    "duration_days": 10,
    "indication": "bacterial_infection",
    "prescriber_npi": "1234567893"
  }
}

Response

200 OK
{
  "status": "flagged",
  "severity": "high",
  "flags": [
    {
      "category": "drug_interaction",
      "severity": "high",
      "drugs": ["warfarin", "metronidazole"],
      "description": "Warfarin + Metronidazole: significantly increased bleeding risk due to CYP2C9 inhibition",
      "recommendation": "Monitor INR closely. Consider dose reduction of warfarin by 25-50%."
    },
    {
      "category": "allergy_screening",
      "severity": "clear",
      "description": "No known cross-reactivity with patient allergens"
    },
    {
      "category": "dose_range",
      "severity": "info",
      "description": "500mg TID is within standard adult dosing range"
    },
    {
      "category": "patient_profile",
      "severity": "moderate",
      "description": "Patient age 72: consider renal function assessment for dose adjustment"
    },
    {
      "category": "duplicate_therapy",
      "severity": "clear",
      "description": "No therapeutic duplication detected"
    },
    {
      "category": "prescriber_credentials",
      "severity": "clear",
      "description": "NPI 1234567893 is valid and active"
    }
  ],
  "prescriber_valid": true,
  "reviewed_at": "2026-03-13T14:30:00Z"
}

Code Examples

curl -X POST https://api.arxio.health/v1/clinical-review \
  -H "X-API-Key: arx_live_abc123" \
  -H "Content-Type: application/json" \
  -d '{
    "patient": {
      "age": 72,
      "weight_kg": 68,
      "allergies": ["sulfa"],
      "medications": ["warfarin", "lisinopril"]
    },
    "new_rx": {
      "drug": "metronidazole",
      "dose": "500mg",
      "frequency": "TID",
      "prescriber_npi": "1234567893"
    }
  }'
POST/v1/prescribe-assist

Prescribe-Assist

AI-powered prescription generation. Provide a diagnosis and patient context to receive complete Rx suggestions with dosing, frequency, duration, and safety notes.

Request Body

application/json
{
  "diagnosis": "urinary_tract_infection",
  "patient": {
    "age": 34,
    "weight_kg": 70,
    "sex": "F",
    "allergies": ["penicillin"],
    "medications": ["oral_contraceptive"],
    "conditions": []
  },
  "preferences": {
    "generic_preferred": true,
    "route": "oral"
  }
}

Response

200 OK
{
  "suggestions": [
    {
      "rank": 1,
      "drug": "nitrofurantoin",
      "brand": "Macrobid",
      "dose": "100mg",
      "frequency": "BID",
      "duration_days": 5,
      "route": "oral",
      "ndc": "52427-0285-01",
      "safety_notes": [
        "No known interactions with current medications",
        "Safe with oral contraceptives",
        "Take with food to reduce GI side effects"
      ],
      "rationale": "First-line for uncomplicated UTI. No penicillin cross-reactivity."
    },
    {
      "rank": 2,
      "drug": "trimethoprim-sulfamethoxazole",
      "brand": "Bactrim DS",
      "dose": "800/160mg",
      "frequency": "BID",
      "duration_days": 3,
      "route": "oral",
      "ndc": "00781-1764-01",
      "safety_notes": [
        "May reduce efficacy of oral contraceptives",
        "Monitor for sulfa sensitivity"
      ],
      "rationale": "Alternative first-line. Shorter course but sulfa component noted."
    }
  ],
  "generated_at": "2026-03-13T14:31:00Z"
}

Code Examples

curl -X POST https://api.arxio.health/v1/prescribe-assist \
  -H "X-API-Key: arx_live_abc123" \
  -H "Content-Type: application/json" \
  -d '{
    "diagnosis": "urinary_tract_infection",
    "patient": {
      "age": 34, "sex": "F",
      "allergies": ["penicillin"],
      "medications": ["oral_contraceptive"]
    },
    "preferences": { "generic_preferred": true }
  }'
GET/v1/drugs/{ndc}

Drug Lookup by NDC

Retrieve detailed drug information by National Drug Code. Returns complete monograph data including dosing, contraindications, and interactions.

Response

200 OK
{
  "ndc": "00087-6060-05",
  "name": "metformin",
  "brand": "Glucophage",
  "dosage_form": "tablet",
  "strength": "500mg",
  "therapeutic_class": "biguanide",
  "schedule": "Rx",
  "manufacturer": "Bristol-Myers Squibb",
  "indications": ["type_2_diabetes"],
  "contraindications": [
    "severe_renal_impairment",
    "metabolic_acidosis",
    "diabetic_ketoacidosis"
  ],
  "common_interactions": [
    "alcohol",
    "iodinated_contrast_agents",
    "cimetidine"
  ],
  "max_daily_dose": "2550mg",
  "pregnancy_category": "B"
}

Code Examples

curl "https://api.arxio.health/v1/drugs/00087-6060-05" \
  -H "X-API-Key: arx_live_abc123"
GET/v1/npi/validate/{npi}

NPI Validation

Validate a National Provider Identifier using Luhn-10 checksum verification and NPPES Registry lookup. Returns provider details if valid.

Response

200 OK
{
  "npi": "1234567893",
  "valid": true,
  "luhn_valid": true,
  "nppes_match": true,
  "provider": {
    "first_name": "JANE",
    "last_name": "SMITH",
    "credential": "MD",
    "entity_type": "individual",
    "taxonomy": "207R00000X",
    "taxonomy_description": "Internal Medicine",
    "state": "CA",
    "status": "active",
    "enumeration_date": "2008-04-15"
  }
}

Code Examples

curl "https://api.arxio.health/v1/npi/validate/1234567893" \
  -H "X-API-Key: arx_live_abc123"