# appointments_stats

> Get aggregate statistics for all appointments: counts by status (scheduled/completed/cancelled), upcoming appointments within 7 days, and total counts by type.

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

Get aggregate statistics for all appointments: counts by status (scheduled/completed/cancelled), upcoming appointments within 7 days, and total counts by type. Use this for dashboard metrics and scheduling overview. Does NOT return individual appointment records - use [`appointments_list`](/tools/appointments/appointments_list) for that.

## Parameters

_This tool takes no parameters — just ask._

## Example prompts

- "How many appointments do I have coming up in the next seven days?"
- "Give me a breakdown of my completed versus cancelled appointments this month."

## Safety

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