Count the tenant's connections (no rows)
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 (sk_live_… / sk_test_…), stored hashed. 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"}