Skip to main content
GET
/
notes
List patient notes
curl --request GET \
  --url https://api.maxcare.ai/v2/notes \
  --header 'Authorization: Bearer <token>' \
  --header 'X-Organization-Id: <x-organization-id>'
{
  "code": "success",
  "data": {
    "notes": [
      {
        "id": "3cc73cb6-9c59-403c-a910-8af6c5693b25",
        "version": 3,
        "visitDate": "2026-03-20 18:30:00+00",
        "status": "awaiting_sign",
        "aiStatus": "issues_found",
        "aiIssueCount": 2,
        "patient": {
          "id": "8de03039-3a9e-417a-b2b3-a8b8df183631",
          "mrn": "MRN-10042",
          "firstName": "Sarah",
          "lastName": "Johnson",
          "middleName": "Marie",
          "gender": "Female",
          "dateOfBirth": "1985-03-15",
          "email": "sarah.johnson@email.com",
          "phone": "(555) 123-4567",
          "avatar": "https://s3.amazonaws.com/bucket/patients-avatars/org/avatar.jpg?X-Amz-...",
          "createdAt": "2024-08-15T09:30:00.000Z",
          "updatedAt": "2025-01-20T14:22:00.000Z"
        },
        "facility": {
          "id": "b2c3d4e5-f6a7-4b8c-9d0e-1f2a3b4c5d6e",
          "name": "West LA Dermatology",
          "timezone": "America/Los_Angeles",
          "specialty": "Dermatology",
          "isVisible": true,
          "organizationNpi": "1234567890",
          "createdAt": "2024-05-01T10:00:00.000Z",
          "updatedAt": "2025-01-15T12:30:00.000Z"
        },
        "ehrType": "modmed",
        "assignedProviders": [
          {
            "id": "d4e5f6a7-b8c9-4d0e-1f2a-3b4c5d6e7f8a",
            "firstName": "James",
            "lastName": "Wilson",
            "displayFirstName": "Dr. James",
            "displayLastName": "Wilson, MD",
            "username": "jwilson",
            "roles": [
              "Physician"
            ],
            "individualNpi": "1234567890",
            "canFinalize": true,
            "canCosign": false,
            "hidden": false,
            "roleType": "PRIMARY_PROVIDER"
          }
        ],
        "createdAt": "2026-03-20 18:35:10.209452+00",
        "updatedAt": "2026-03-23 03:15:47.285+00",
        "soapNote": {}
      }
    ],
    "pagination": {
      "page": 1,
      "pageSize": 100,
      "totalCount": 250,
      "totalPages": 3
    }
  }
}

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.

Authorizations

Authorization
string
header
required

Marketplace API key

Headers

X-Organization-Id
string
required

Target clinic organization ID

Query Parameters

patientId
string

Filter by patient ID (UUID)

Example:

"8de03039-3a9e-417a-b2b3-a8b8df183631"

facilityId
string

Filter by facility ID (UUID)

Example:

"a1b2c3d4-5678-4abc-9def-0123456789ab"

providerId
string

Filter by assigned provider ID (UUID) — returns notes where this provider is assigned in any role

Example:

"d4e5f6a7-b8c9-4d0e-1f2a-3b4c5d6e7f8a"

dateFrom
string

Filter notes with visit date on or after this date (ISO 8601)

Example:

"2025-01-01"

dateTo
string

Filter notes with visit date on or before this date (ISO 8601)

Example:

"2025-12-31"

status
string

Filter by workflow status (comma-separated)

Example:

"synced,awaiting_sign"

aiStatus
string

Filter by AI status (comma-separated)

Example:

"issues_found,success"

includeSoapNote
boolean

Include SOAP note content (requires read:soap_notes scope)

Example:

"false"

Response

Success

code
string
required

Response code

Example:

"success"

data
object
required