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.
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.
Authorization
apiKey Long-lived tenant API key, cd_live_… (production) or cd_test_… (staging, development), stored hashed. Keys created before the switch to cd_ start with sk_live_… / sk_test_… and are still accepted. Scoped to the owning application's tenant.
In: header
Query Parameters
Value in
- "pending"
- "propagating"
- "live"
- "failed"
Response Body
application/json
application/json
application/json
curl -X GET "https://example.com/connections:count"{ "total": 0, "by_status": { "property1": 0, "property2": 0 }, "by_application": [ { "application_id": "string", "total": 0, "by_status": { "property1": 0, "property2": 0 } } ]}{ "code": "string", "title": "string", "details": "string"}{ "code": "string", "title": "string", "details": "string"}