Skip to main content
GET
/
appointments
List appointments
curl --request GET \
  --url https://api.maxcare.ai/v4/appointments \
  --header 'Authorization: Bearer <token>' \
  --header 'X-Organization-Id: <x-organization-id>'
{
  "code": "success",
  "data": {
    "appointments": [
      {
        "id": "apt_e5f6a7b8c9d04e1f2a3b4c5d6e7f8a9b",
        "scheduledStartDate": "2025-01-20T09:00:00.000Z",
        "scheduledEndDate": "2025-01-20T09:30:00.000Z",
        "status": "confirmed",
        "isNewPatient": false,
        "facilityId": "fac_b2c3d4e5f6a74b8c9d0e1f2a3b4c5d6e",
        "createdAt": "2025-01-15T09:30:00.000Z",
        "patient": {
          "id": "pat_c56103bcd39c46d39f3138dd2b5e05f6",
          "mrn": "MRN-10042",
          "firstName": "Sarah",
          "lastName": "Johnson",
          "middleName": "Marie",
          "gender": "Female",
          "dateOfBirth": "1985-03-15",
          "email": "sarah.johnson@email.com",
          "phone": "(555) 123-4567",
          "createdAt": "2024-08-15T09:30:00.000Z",
          "updatedAt": "2025-01-20T14:22:00.000Z"
        },
        "provider": {
          "id": "prv_d4e5f6a7b8c94d0e1f2a3b4c5d6e7f8a",
          "firstName": "James",
          "lastName": "Wilson",
          "displayFirstName": "Dr. James",
          "displayLastName": "Wilson, MD",
          "roles": [
            "Physician",
            "Surgeon"
          ],
          "username": "jwilson",
          "individualNpi": "1234567890",
          "canFinalize": true,
          "canCosign": false,
          "createdAt": "2024-06-01T08:00:00.000Z",
          "updatedAt": "2025-02-10T16:45:00.000Z"
        }
      }
    ],
    "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

dateFrom
string

Filter appointments from this date (ISO 8601)

Example:

"2025-01-01"

dateTo
string

Filter appointments up to this date (ISO 8601)

Example:

"2025-12-31"

statuses
string[]

Comma-separated list of statuses to filter by

facilityId
string

Filter by facility ID

patientId
string

Filter by patient ID

sortBy
enum<string>

Sort field

Available options:
scheduledStartDate,
lastSyncedAt,
status
sortOrder
enum<string>

Sort direction

Available options:
asc,
desc

Response

Success

code
string
required

Response code

Example:

"success"

data
object
required