# Count contacts

**GET** `/contacts/count`

Returns the tenant's contact count for a navigation/dashboard badge. This is independent
of any list filters; the archived query parameter selects which bucket to count.

Authentication: bearerAuth
Required scopes: `contact:list`
Allowed roles: `owner`, `admin`, `agent`
Authorization: Count contacts in the caller's contact scope.

## Parameters

- `archived` (query boolean, optional) - Omit or pass false for non-archived count; pass true for archived-bucket count.

## Responses

- `200`: Contact count
- `default`: Error