Contacts

List contacts

List contacts.

GET

/business/contacts

List contacts

curl --request GET \
  --url 'https://api-example.kickcall.ai/api/v1/business/contacts?page=1&per_page=25&filter%5Bphone_number%5D=%3Cstring%3E&filter%5Bcategory%5D=general' \
  --header 'Authorization: Bearer <token>'

{
  "data": [
    {
      "associated_records": [
        {
          "first_name": "Vishal",
          "id": 55,
          "last_name": "Garg"
        }
      ],
      "business_id": 286,
      "calls_count": 4,
      "category": "general",
      "chats_count": 1,
      "created_at": "2026-09-01T10:00:00.000Z",
      "id": 1201,
      "latest_interaction_id": 22702,
      "location_id": 340,
      "phone_number": "+14166706230"
    }
  ],
  "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: Contacts.

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

filter[phone_number]stringquery

filter[category]enum<string>query

Available options: general, spam, vip

Response

OK — Paginated contacts

dataobject[]

Show child attributes

linksobject

Show child attributes

metaobject

Show child attributes

Still need help? Ask the team