Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.maxcare.ai/llms.txt

Use this file to discover all available pages before exploring further.

Build powerful healthcare integrations with Max AI. Access patient records, appointments, billing, claims, notes, emails, phone numbers, inventory, and more through a simple REST API. Max AI has live connections with many EHRs, giving you a unified interface to access clinics’s underlying data without the hassle of maintaining non homogeneous EHR interfaces. The Max AI API lets marketplace apps connect to clinic data securely, with granular permission scopes and a consistent JSON response format.

Getting Started

Create your developer account, build your first app, and make your first API call.

Authentication

Learn about API key authentication and required headers.

Scopes

Understand the permission model that controls data access.

OAuth Authorization

Authenticate Max AI users in your standalone app.

App Development

Use the app template, SDK packages, and CLI to build your app.

Error Handling

Handle errors gracefully with structured error responses.

​
Base URL

All API requests use the following base URL: 
https://api.maxcare.ai/v3
For staging/testing: 
https://api.maxcare.dev/v3

​
Quick Example

curl -X GET "https://api.maxcare.ai/v3/patients" \
  -H "Authorization: Bearer max_prd_ak_SBA...01S" \
  -H "X-Organization-Id: 7e2c8cfe-b7a9-4deb-986d-e7012589e72b"

{
  "code": "success",
  "data": {
    "patients": [
      {
        "id": "pat_c56103bcd39c46d39f3138dd2b5e05f6",
        "mrn": "MM0000000005",
        "firstName": "Max",
        "lastName": "Test",
        "middleName": null,
        "gender": "Male",
        "dateOfBirth": "1989-09-06",
        "email": null,
        "phone": null,
        "createdAt": "2026-03-16 00:30:03.23454+00",
        "updatedAt": "2026-03-16 00:30:03.23454+00"
      }
    ],
    "pagination": {
      "page": 1,
      "pageSize": 100,
      "totalCount": 1503,
      "totalPages": 16
    }
  }
}