Customers

List businesses

List businesses.

GET

/agency/businesses

List businesses

curl --request GET \
  --url 'https://api-example.kickcall.ai/api/v1/agency/businesses?page=1&per_page=25&sort=%3Cstring%3E' \
  --header 'Authorization: Bearer <token>'

{
  "data": [
    {
      "account_status": "active",
      "address": {
        "city": "Toronto",
        "country": "CA",
        "platform_language": "en",
        "postal_code": "M5V 2T6",
        "state": "ON",
        "street_address": "100 Main St",
        "time_zone": "America/Toronto"
      },
      "agents_count": 3,
      "avatar_url": null,
      "business_plan_id": 12,
      "created_at": "2025-06-01T15:00:00.000Z",
      "email": "ops@acme.example",
      "id": 286,
      "industry": "healthcare",
      "legal_name": "Acme Dental Inc.",
      "locations_count": 2,
      "name": "Acme Dental",
      "niche": "dental",
      "phone": "+14165550100",
      "uid": "biz_acme",
      "website": "https://acme.example"
    }
  ],
  "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: Agency portal. Auth: Agency JWT or agency API key (Authorization: Bearer or X-Api-Key). Resource: Businesses.

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

sortstringquery

Response

OK — Paginated businesses

dataobject[]

Show child attributes

linksobject

Show child attributes

metaobject

Show child attributes

Still need help? Ask the team