Build powerful healthcare applications with our comprehensive REST API. Integrate clinical documentation, AI-powered transcription, and medical coding into your workflows.

Getting Started

The Mena Health API allows you to programmatically access our AI medical scribe capabilities, enabling seamless integration with your existing EHR systems and clinical workflows.

1. Get API Key

Request access credentials from your account dashboard

2. Authenticate

Use OAuth 2.0 or API key authentication for secure access

3. Make Requests

Start sending requests to our RESTful endpoints

Authentication

All API requests require authentication. Include your API key in the request header:

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Core Endpoints

POST

/api/v1/transcribe

Submit audio recordings for AI-powered medical transcription

Request Body:

{
  "audio_url": "https://example.com/recording.mp3",
  "template_id": "general-consultation",
  "patient_context": {
    "age": 45,
    "gender": "female",
    "chief_complaint": "chest pain"
  }
}

Response:

{
  "transcription_id": "txn_abc123",
  "status": "completed",
  "clinical_note": {
    "chief_complaint": "Patient reports chest pain...",
    "history_present_illness": "...",
    "assessment": "...",
    "plan": "..."
  },
  "codes": {
    "icd10": ["I20.9", "R07.9"],
    "cpt": ["99213"]
  },
  "processing_time_ms": 1850
}

GET

/api/v1/notes/:id

Retrieve a clinical note by ID

Response:

{
  "note_id": "note_xyz789",
  "patient_id": "pat_123456",
  "created_at": "2025-11-01T10:30:00Z",
  "status": "signed",
  "content": { ... },
  "metadata": {
    "physician": "Dr. Smith",
    "specialty": "cardiology",
    "encounter_type": "outpatient"
  }
}

GET

/api/v1/templates

List available clinical note templates

Response:

{
  "templates": [
    {
      "id": "general-consultation",
      "name": "General Consultation",
      "specialty": "primary-care",
      "sections": ["chief_complaint", "hpi", "ros", "exam", "assessment", "plan"]
    },
    {
      "id": "cardiology-followup",
      "name": "Cardiology Follow-up",
      "specialty": "cardiology",
      "sections": ["interval_history", "medications", "vitals", "assessment", "plan"]
    }
  ]
}

POST

/api/v1/coding/suggest

Get ICD-10 and CPT code suggestions based on clinical note

Request Body:

{
  "clinical_note": "Patient presents with acute chest pain...",
  "encounter_type": "outpatient_visit"
}

Response:

{
  "suggested_codes": {
    "icd10": [
      {
        "code": "I20.9",
        "description": "Angina pectoris, unspecified",
        "confidence": 0.92
      }
    ],
    "cpt": [
      {
        "code": "99214",
        "description": "Office visit, established patient, moderate complexity",
        "confidence": 0.95
      }
    ]
  }
}

Rate Limits

Standard Tier

• 100 requests per minute
• 10,000 requests per day
• Max file size: 100MB

Enterprise Tier

• 1,000 requests per minute
• Unlimited daily requests
• Max file size: 500MB

Error Codes

Code	Description
400	Bad Request - Invalid request parameters
401	Unauthorized - Invalid or missing API key
403	Forbidden - Insufficient permissions
404	Not Found - Resource does not exist
429	Too Many Requests - Rate limit exceeded
500	Internal Server Error - Something went wrong on our end

SDKs & Libraries

Python SDK

Install via pip and integrate with your Python applications

pip install mena-health-api

Node.js SDK

Use npm to add Mena to your Node.js projects

npm install @mena/health-api

REST API

Direct HTTP requests from any programming language

https://api.menahealth.com

Ready to Get Started?

Contact our team to request API access and start building powerful healthcare integrations with Mena Health.

Request API Access