Telephony

List phone numbers for the business

List phone numbers for the business.

GET

/business/phone_numbers

curl --request GET \
  --url 'https://api-example.kickcall.ai/api/v1/business/phone_numbers?page=1&per_page=25' \
  --header 'Authorization: Bearer <token>'

{
  "data": [
    {
      "agent_id": 980,
      "agent_name": "Alex",
      "capabilities": {
        "sms": true,
        "voice": true
      },
      "country_code": "US",
      "id": 501,
      "location_name": "Downtown",
      "phone_number": "+14165550111",
      "provider": "bandwidth",
      "status": "active"
    }
  ],
  "links": {
    "first": "https://api-example.kickcall.ai/api/v1/...?...&page=1",
    "last": "https://api-example.kickcall.ai/api/v1/...?...&page=1",
    "next": null,
    "prev": null,
    "self": "https://api-example.kickcall.ai/api/v1/...?...&page=1"
  },
  "meta": {
    "count": 1,
    "total_count": 1,
    "total_pages": 1
  }
}

Audience: Business portal. Auth: Business/agency JWT or API key; usually header Business-Id. Resource: Telephony.

Authorizations

Authorizationstringheaderrequired

JWT from OTP login, or business/agency API key string.

Query Parameters

pageintegerquerydefault:1

Required range: 1 <= x

per_pageintegerquerydefault:25

Required range: 1 <= x <= 100

Response

OK — Paginated phone numbers

dataobject[]

Show child attributes

linksobject

Show child attributes

metaobject

Show child attributes

Still need help? Ask the team