---
title: "Get Patients With Appointments Now"
method: GET
path: "/notes/patients-with-appointments-now"
tags: ["provider", "scribe", "note"]
---

# Get Patients With Appointments Now

`GET /notes/patients-with-appointments-now`

## Request

- Base URL: `https://docs.decodahealth.com` (the document declares no server; this is the origin it was published from)
- URL: `https://docs.decodahealth.com/notes/patients-with-appointments-now`
- Auth: none declared. Required headers: `TENANT`, `API-KEY`
- TypeScript: <https://skmtc.dev/decodahealth/apis/decoda-api/docs/notes/patients-with-appointments-now/get.ts> (a function with typed inputs; its response is checked against the schema)

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

This endpoint finds appointment events where:
1. The appointment is scheduled within the specified time window (minutes_before to minutes_after from now)
2. The specified provider is an attendee of the appointment
3. 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

## Query parameters

- `provider_id` string, required
- `minutes_before` integer
- `minutes_after` integer

## Headers

- `TENANT` string, required
- `API-KEY` string, required

## Response `200`

Successful Response

- PatientWithAppointmentDetail[]
  - `id` string, required
  - `firstName` string, required
  - `lastName` string, required
  - `dateOfBirth` string, nullable
  - `phoneNumber` string, nullable
  - `email` string, nullable
  - `appointmentStart` string, date-time, required
  - `appointmentEnd` string, date-time, required
  - `appointmentType` string, nullable
  - `appointmentTitle` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/decodahealth/apis/decoda-api.md) - [All operations](https://skmtc.dev/decodahealth/apis/decoda-api/llms.txt) - [OpenAPI document](https://skmtc.dev/decodahealth/apis/decoda-api/revisions/4ab18c80f9e9?raw)