Get Patients With Appointments Now

curl --request GET \
  --url https://api.decodahealth.com/notes/patients-with-appointments-now \
  --header 'API-KEY: <api-key>' \
  --header 'TENANT: <tenant>'

[
  {
    "id": "<string>",
    "firstName": "<string>",
    "lastName": "<string>",
    "appointmentStart": "2023-11-07T05:31:56Z",
    "appointmentEnd": "2023-11-07T05:31:56Z",
    "dateOfBirth": "<string>",
    "phoneNumber": "<string>",
    "email": "<string>",
    "appointmentType": "<string>",
    "appointmentTitle": "<string>"
  }
]

Notes

Get Patients With Appointments Now

Get patients who have appointments with a specific provider within a time window around the current time.

This endpoint finds appointment events where:

The appointment is scheduled within the specified time window (minutes_before to minutes_after from now)
The specified provider is an attendee of the appointment
Returns patient details combined with their appointment information

Useful for finding patients who are currently in appointments or have upcoming/recent appointments with a provider (e.g., for creating notes during or after appointments).

Args: provider_id: ID of the provider to find appointments for minutes_before: How many minutes before current time to include (default: 30) minutes_after: How many minutes after current time to include (default: 60)

Returns: List of patients with their appointment details in the specified time window

GET

notes

patients-with-appointments-now

Get Patients With Appointments Now

curl --request GET \
  --url https://api.decodahealth.com/notes/patients-with-appointments-now \
  --header 'API-KEY: <api-key>' \
  --header 'TENANT: <tenant>'

[
  {
    "id": "<string>",
    "firstName": "<string>",
    "lastName": "<string>",
    "appointmentStart": "2023-11-07T05:31:56Z",
    "appointmentEnd": "2023-11-07T05:31:56Z",
    "dateOfBirth": "<string>",
    "phoneNumber": "<string>",
    "email": "<string>",
    "appointmentType": "<string>",
    "appointmentTitle": "<string>"
  }
]

Headers

TENANT

string

required

The tenant you are making this request on behalf of

API-KEY

string

required

Your api key

Query Parameters

provider_id

string

required

minutes_before

integer

default:30

minutes_after

integer

default:60

Response

Successful Response

string

required

firstName

string

required

lastName

string

required

appointmentStart

string<date-time>

required

appointmentEnd

string<date-time>

required

dateOfBirth

string | null

phoneNumber

string | null

appointmentType

string | null

appointmentTitle

string | null

Get Notes Get Prefilled Answers