# engagements_stats

> Get aggregate statistics for vendor engagements: total count, counts by status, counts by vendor type, counts by engagement type, upcoming engagements count.

<!-- Source: https://docs.actuallycare.com/tools/engagements/engagements_stats -->

Get aggregate statistics for vendor engagements: total count, counts by status, counts by vendor type, counts by engagement type, upcoming engagements count. Use this for dashboard metrics. Does NOT return individual records - use [`engagements_list`](/tools/engagements/engagements_list) for that.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `period` | enum | No | Time period for stats (default: 1_month) · One of: `1_day`, `1_week`, `1_month`, `3_months`, `1_year`, `ytd`, `all` |

## Example prompts

- "How many vendor engagements did I complete this month, broken down by type?"
- "How many upcoming meetings do I have on the books versus cancelled this month?"

## Safety

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