# Count the tenant's connections (no rows)

> Count the tenant's connections (no rows): CustomDomain™ API reference in the connections group. Covers parameters, request body, responses and error codes.

Source: https://docs.customdomain.ai/docs/api-reference/connections/countConnections

## `GET https://api.customdomain.ai/v1/connections:count`

The tenant's connection histogram, computed server-side in one grouped query. Use this instead of paging `GET /connections` when you only need totals (dashboards, quota meters, per-application domain counts). The numbers are exact regardless of how many connections the tenant has.

`by_status` carries only statuses that actually occur: an absent key means **zero**, never "unknown". Optional `?app_id=` / `?status=` narrow the aggregate exactly as they narrow the list; a `status` outside the enum is rejected with **400**.

API key only: this is a tenant-wide aggregate, so a per-application widget JWT cannot read it.

### Authentication

`apiKey`

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `app_id` | query | string | no |  |
| `status` | query | `pending`, `propagating`, `live`, `failed` | no |  |

### Responses

| Status | Description |
| --- | --- |
| `200` | Connection counts |
| `400` | Error envelope: {code, title, details}. |
| `401` | Error envelope: {code, title, details}. |

### `200` response body

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `total` | integer | yes |  |
| `by_status` | object | yes |  |
| `by_application` | array of object | yes |  |

The full specification is served at `GET https://api.customdomain.ai/v1/openapi.json`.