Skip to main content
GET
/
appointments
Get Appointments
curl --request GET \
  --url https://api.usecobalt.com/v1/appointments \
  --header 'access_token: <api-key>' \
  --header 'client_id: <api-key>' \
  --header 'client_secret: <api-key>'
{
  "success": true,
  "results": {
    "appointments": [
      {
        "id": "<string>",
        "datetime": "<string>",
        "patient_name": "<string>",
        "mrn": "<string>",
        "status": "<string>",
        "duration": 123,
        "appointment_type": "<string>"
      }
    ]
  }
}

Authorizations

​
client_id
string
header
required
​
client_secret
string
header
required
​
access_token
string
header
required

Query Parameters

​
start_date
string<date>
required

The start of the date range (ISO 8601 format)

​
end_date
string<date>
required

The end of the date range (ISO 8601 format)

​
patient_mrn
string

The mrn of the patient to filter appointments by

​
patient_name
string

The name of the patient to filter appointments by (case-insensitive, partial match)

​
patient_phone
string

The phone number of the patient to filter appointments by

​
status
string

Only include appointments with the given status

​
include_note
enum<string>

Indicate whether progress notes should be included when available

Available options:
true,
false
​
include_schedule_blocks
enum<string>

Indicate whether schedule blocks (eg. Lunch Break) should be included

Available options:
true,
false
​
appointment_mode
enum<string>

Filter by office or telemedicine appointments

Available options:
office,
telemedicine
​
provider_ehr_id
string

Filter appointments by provider EHR ID

​
location_ehr_id
string

Filter appointments by location EHR ID

​
appointment_type
string

Filter appointments by appointment type (e.g., "New Patient", "Follow Up", "Annual Checkup")

​
secondary_provider_ehr_id
string

Filter appointments by secondary provider EHR ID

Response

200 - application/json

Successful response

​
success
boolean
​
results
object