# partners_stats

> Get aggregate statistics for vendor partners: total count, counts by status, counts by tier, counts by vendor type, active vs churned ratio.

<!-- Source: https://docs.actuallycare.com/tools/partners/partners_stats -->

Get aggregate statistics for vendor partners: total count, counts by status, counts by tier, counts by vendor type, active vs churned ratio. Use this for dashboard metrics. Does NOT return individual records - use [`partners_list`](/tools/partners/partners_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 active versus churned partners do I have this year?"
- "Break down my partner roster by vendor type and tier."

## Safety

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