# contacts_stats

> Get aggregate statistics for all contacts: counts by status (homeowner/non_homeowner), counts by role (sphere/lead/client), and total portfolio value.

<!-- Source: https://docs.actuallycare.com/tools/contacts/contacts_stats -->

Get aggregate statistics for all contacts: counts by status (homeowner/non_homeowner), counts by role (sphere/lead/client), and total portfolio value. Use this for dashboard metrics and network analysis. Does NOT return individual contact records - use [`contacts_list`](/tools/contacts/contacts_list) for that.

## Parameters

_This tool takes no parameters — just ask._

## Example prompts

- "How many homeowners versus non-homeowners are in my contact database?"
- "Break down my contacts by sphere, lead, and client and show total portfolio value."

## Safety

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