> ## 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.

# Max AI Developer Docs

> Build healthcare integrations with the Max AI Public API

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.

<CardGroup cols={3}>
  <Card title="Getting Started" icon="rocket" href="/guides/getting-started">
    Create your developer account, build your first app, and make your first API call.
  </Card>

  <Card title="Authentication" icon="key" href="/guides/authentication">
    Learn about API key authentication and required headers.
  </Card>

  <Card title="Scopes" icon="shield-halved" href="/guides/scopes">
    Understand the permission model that controls data access.
  </Card>
</CardGroup>

<CardGroup cols={3}>
  <Card title="OAuth Authorization" icon="right-left" href="/guides/oauth">
    Authenticate Max AI users in your standalone app.
  </Card>

  <Card title="App Development" icon="code" href="/guides/app-development">
    Use the app template, SDK packages, and CLI to build your app.
  </Card>

  <Card title="Error Handling" icon="triangle-exclamation" href="/guides/errors">
    Handle errors gracefully with structured error responses.
  </Card>
</CardGroup>

## 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

```bash theme={null}
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"
```

```json theme={null}
{
  "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
    }
  }
}
```