Skip to main content
GET
/
appointments
/
{id}
Get appointment by ID
curl --request GET \
  --url https://api.maxcare.ai/v4/appointments/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'X-Organization-Id: <x-organization-id>'
{
  "code": "success",
  "data": {
    "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"
    }
  }
}

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

Path Parameters

id
string
required

Appointment ID

Response

Success

code
string
required

Response code

Example:

"success"

data
object
required