# appointments_list

> Search for appointments by date range, status, or text.

<!-- Source: https://docs.actuallycare.com/tools/appointments/appointments_list -->

Search for appointments by date range, status, or text. Use to answer calendar questions or to find an appointment's ID before updating or cancelling it (for today's schedule, [`appointments_today`](/tools/appointments/appointments_today) is faster). Returns IDs only by default for efficiency; use the fields parameter to include additional data. Response includes relatedIds.contactIds for chainable operations.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `query` | string | No | Search term — matches against title and location (case-insensitive partial match) |
| `start_date` | string | No | Start date to filter from (YYYY-MM-DD) |
| `end_date` | string | No | End date to filter to (YYYY-MM-DD) |
| `appointment_type` | enum | No | Filter by appointment type · One of: `buyer_consultation`, `lender_prequalification`, `listing_appointment`, `showing`, `property_tour`, `client_meeting`, `inspection`, `appraisal`, `signing`, `final_walkthrough`, `call`, `other`, `open_house`, `escrow_deadline`, `owner_blackout`, `escrow_service` |
| `status` | enum | No | Filter by appointment status · One of: `scheduled`, `completed`, `cancelled`, `no_show` |
| `fields` | array of enum | No | Field groups to include. Empty/omitted = IDs only. Options: basic (id, title, type, status), schedule (times, location), contacts (contact name), full (all fields). · Values: `basic`, `schedule`, `contacts`, `full` |
| `limit` | string | No | Max results. Use a number (e.g. "25") or "all". Default: 10. "all" and any value above 200 are capped at 200 server-side. |

## Example prompts

- "What showings do I have on the calendar next week?"
- "Find all my scheduled inspections between June 15 and June 30."

## Safety

**Read-only.** This tool never changes your data — it only looks things up. Safe to run anytime.

## Previous name

This tool was previously published as `list_appointments`. Call it by its current name — legacy names are kept here for reference and old links redirect, but they are not callable.