Custom Domain docs
API referenceConnections

Count the tenant's connections (no rows)

GET
/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.

AuthorizationBearer <token>

Long-lived tenant API key (sk_live_… / sk_test_…), stored hashed. Scoped to the owning application's tenant.

In: header

Query Parameters

app_id?string
status?string

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"}