Interactions

List interactions for an agent

List interactions for an agent.

GET

/business/locations/{location_id}/agents/{agent_id}/interactions

curl --request GET \
  --url 'https://api-example.kickcall.ai/api/v1/business/locations/{location_id}/agents/{agent_id}/interactions?page=1&per_page=25&sort=%3Cstring%3E&filter%5Bdirection%5D=inbound&filter%5Binteraction_type%5D=call&filter%5Bstatus%5D=%3Cstring%3E' \
  --header 'Authorization: Bearer <token>'

{
  "data": [
    {
      "agent_id": 980,
      "channel": "Interactions::Phone",
      "created_at": "2026-10-22T18:00:02.000Z",
      "direction": "inbound",
      "disconnection_reason": "user_hangup",
      "duration_in_seconds": 372.5,
      "id": 22702,
      "interaction_type": "call",
      "source_info": "+14166706230",
      "start_at": "2026-10-22T18:00:00.000Z",
      "status": "completed",
      "test": false
    }
  ],
  "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: Interactions.

Authorizations

Authorizationstringheaderrequired

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

Path Parameters

location_idintegerrequired

agent_idintegerrequired

Query Parameters

pageintegerquerydefault:1

Required range: 1 <= x

per_pageintegerquerydefault:25

Required range: 1 <= x <= 100

sortstringquery

Sort field, optionally prefixed with - for descending.

filter[direction]enum<string>query

Available options: inbound, outbound

filter[interaction_type]enum<string>query

Available options: call, chat

filter[status]stringquery

Response

OK — Paginated interactions

dataobject[]

Show child attributes

linksobject

Show child attributes

metaobject

Show child attributes

Still need help? Ask the team