---
title: "Count the tenant's connections (no rows)"
method: GET
path: "/connections:count"
tags: ["Connections"]
---

# Count the tenant's connections (no rows)

`GET /connections:count`

## Request

- Base URL: `https://api.customdomain.ai/v1`
- URL: `https://api.customdomain.ai/v1/connections:count`
- Auth: HTTP bearer

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.

## Query parameters

- `app_id` string
- `status` 'pending' | 'propagating' | 'live' | 'failed'

## Response `200`

Connection counts

- object
  - `total` integer, required
  - `by_status` object, required
  - `by_application` object[], required
    - `application_id` string, required
    - `total` integer, required
    - `by_status` object, required

## Other responses

- `400`: Error envelope: {code, title, details}.
- `401`: Error envelope: {code, title, details}.

---

[API](https://skmtc.dev/customdomain/apis/customdomain-control-plane-api.md) · [All operations](https://skmtc.dev/customdomain/apis/customdomain-control-plane-api/llms.txt) · [OpenAPI document](https://skmtc.dev/customdomain/apis/customdomain-control-plane-api/revisions/34d89cb7a7cd?raw)