# showings_stats

> Get aggregate statistics for showings: total count, upcoming count, counts by status, counts by type.

<!-- Source: https://docs.actuallycare.com/tools/showings/showings_stats -->

Get aggregate statistics for showings: total count, upcoming count, counts by status, counts by type. Use this for dashboard metrics. Does NOT return individual records - use [`showings_list`](/tools/showings/showings_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 showings did I run this month, broken down by status?"
- "Give me my year-to-date showing counts and how many are upcoming."

## Safety

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