zoxaAI
Homepage
API ReferenceInbound Bindings

List bindings

GET /api/v1/telephony/inbound/bindings — paginated list of registered inbound phone numbers.

GET /api/v1/telephony/inbound/bindings

Query parameters

ParamTypeDefaultNotes
limitint (1..200)50
offsetint (≥0)0

Response

{
  "items": [
    {
      "id": 5,
      "provider": "vobiz",
      "phoneNumber": "+917971542879",
      "webhookUrl": "https://dashboard.zoxa.ai/api/v1/telephony/run",
      "lastCallAt": "2026-06-15T09:14:00Z",
      "createdAt":  "2026-06-10T08:00:00Z",
      "updatedAt":  "2026-06-15T09:14:00Z"
    }
  ],
  "total": 3,
  "limit": 50,
  "offset": 0
}

Credentials and agentSnapshot are not included in the list — fetch detail with GET /telephony/inbound/bindings/{id}.

Examples

curl https://dashboard.zoxa.ai/api/v1/telephony/inbound/bindings \
  -H "X-API-Key: zsk_..."

Errors

StatusdetailWhen
400"No organization selected"Auth missing org.

Inbound Bindings overview

How API-first inbound bindings work — registration, lookup, mutation, and deregistration.

Get a binding

GET /api/v1/telephony/inbound/bindings/{id} — full detail including credentials and agent snapshot.

On this page

Query parametersResponseExamplesErrors