curl --request GET \
  --url https://api.maxcare.ai/v4/appointments/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'X-Organization-Id: <x-organization-id>'

import requests

url = "https://api.maxcare.ai/v4/appointments/{id}"

headers = {
    "X-Organization-Id": "<x-organization-id>",
    "Authorization": "Bearer <token>"
}

response = requests.get(url, headers=headers)

print(response.text)

const options = {
  method: 'GET',
  headers: {'X-Organization-Id': '<x-organization-id>', Authorization: 'Bearer <token>'}
};

fetch('https://api.maxcare.ai/v4/appointments/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.maxcare.ai/v4/appointments/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "X-Organization-Id: <x-organization-id>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.maxcare.ai/v4/appointments/{id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-Organization-Id", "<x-organization-id>")
	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.maxcare.ai/v4/appointments/{id}")
  .header("X-Organization-Id", "<x-organization-id>")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.maxcare.ai/v4/appointments/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-Organization-Id"] = '<x-organization-id>'
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "code": "success",
  "data": {
    "id": "apt_e5f6a7b8c9d04e1f2a3b4c5d6e7f8a9b",
    "scheduledStartDate": "2025-01-20T09:00:00.000Z",
    "scheduledEndDate": "2025-01-20T09:30:00.000Z",
    "status": "confirmed",
    "createdBy": {
      "ehrUserId": "4417",
      "name": "Jordan Testwell",
      "userId": "usr_0f1e2d3c4b5a69788796a5b4c3d2e1f0",
      "at": "2026-10-21T14:05:12.000Z"
    },
    "bookingOrigin": null,
    "billIds": [
      "bil_9a8b7c6d5e4f3a2b1c0de9f8a7b6c5d4"
    ],
    "encounterId": "nte_a1b2c3d4e5f64a7b8c9d0e1f2a3b4c5d",
    "integrationStatus": "CHECKED_IN",
    "isNewPatient": false,
    "instanceId": "ins_3a7b9c1d2e4f45a68b0c1d2e3f4a5b6c",
    "reasonForVisit": "Biologic injection follow-up",
    "isCosmetic": false,
    "facilityId": "fac_b2c3d4e5f6a74b8c9d0e1f2a3b4c5d6e",
    "createdAt": "2025-01-15T09:30:00.000Z",
    "lastSyncedAt": "2025-01-16T04:12: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",
      "masterPatientId": "mpt_3f1c8a2e9b7d4c6a8e2f1a3b5c7d9e0f",
      "duplicatePatientIds": []
    },
    "provider": {
      "id": "prv_d4e5f6a7b8c94d0e1f2a3b4c5d6e7f8a",
      "firstName": "James",
      "lastName": "Wilson",
      "displayFirstName": "Dr. James",
      "displayLastName": "Wilson, MD",
      "roles": [
        "Physician",
        "Surgeon"
      ],
      "username": "jwilson",
      "individualNpi": "1234567890",
      "npiSource": "ehr",
      "canFinalize": true,
      "canCosign": false,
      "createdAt": "2024-06-01T08:00:00.000Z",
      "updatedAt": "2025-02-10T16:45:00.000Z"
    },
    "appointmentType": {
      "externalId": "6054",
      "name": "Follow-up, established",
      "abbreviation": "EST",
      "durationMinutes": 15
    },
    "cancelReason": {
      "externalId": "CR00000001",
      "name": "Patient cancelled"
    },
    "externalId": "<string>",
    "syncStatus": "pending",
    "lastError": "auth_error",
    "retryCount": 0,
    "nextRetryAt": "<string>",
    "writtenBy": {
      "resolvedBy": "personal_connector"
    },
    "bookingSource": {
      "system": "dcc-online-booking",
      "bookingReference": "BK-2026-000123",
      "campaignId": "google-gbp-flint",
      "url": "https://book.dccderm.com/l/flint?utm_source=gbp"
    }
  }
}

{
  "code": "bad_request",
  "message": "'id' must be a valid UUID",
  "trace_id": "550e8400-e29b-41d4-a716-446655440000"
}

{
  "code": "unauthorized",
  "message": "Invalid or missing API key",
  "trace_id": "550e8400-e29b-41d4-a716-446655440000"
}

{
  "code": "forbidden",
  "message": "Insufficient scope",
  "trace_id": "550e8400-e29b-41d4-a716-446655440000"
}

{
  "code": "not_found",
  "message": "Resource not found",
  "trace_id": "550e8400-e29b-41d4-a716-446655440000"
}

{
  "code": "rate_limit_exceeded",
  "message": "Rate limit exceeded. Maximum 1000 requests per 60 seconds.",
  "trace_id": "550e8400-e29b-41d4-a716-446655440000"
}