---
title: "List all calls"
method: GET
path: "/calls"
tags: ["Calls"]
---

# List all calls

`GET /calls`

Retrieve a paginated list of calls.

## Query parameters

- `page` integer
- `per_page` integer

## Headers

- `Intercom-Version` '1.0' | '1.1' | '1.2' | '1.3' | '1.4' | '2.0' | '2.1' | '2.2' | '2.3' | '2.4' | '2.5' | '2.6' | '2.7' | '2.8' | '2.9' | '2.10' | '2.11' | '2.12' | '2.13' | '2.14' — Intercom API version.</br>By default, it's equal to the version set in the app package.

## Response `200`

successful

- CallList — A paginated list of calls.
  - `type` string — String representing the object's type. Always has the value `list`.
  - `data` Call[] — A list of calls.
    - `type` string — String representing the object's type. Always has the value `call`.
    - `id` string — The id of the call.
    - `conversation_id` string, nullable — The id of the conversation associated with the call, if any.
    - `admin_id` string, nullable — The id of the admin associated with the call, if any.
    - `contact_id` string, nullable — The id of the contact associated with the call, if any.
    - `state` string — The current state of the call.
    - `initiated_at` union
      - string, date-time — A date and time following the ISO8601 notation.
      - integer — A date and time as UNIX timestamp notation.
    - `answered_at` union
      - string, date-time — A date and time following the ISO8601 notation.
      - integer — A date and time as UNIX timestamp notation.
    - `ended_at` union
      - string, date-time — A date and time following the ISO8601 notation.
      - integer — A date and time as UNIX timestamp notation.
    - `created_at` union
      - string, date-time — A date and time following the ISO8601 notation.
      - integer — A date and time as UNIX timestamp notation.
    - `updated_at` union
      - string, date-time — A date and time following the ISO8601 notation.
      - integer — A date and time as UNIX timestamp notation.
    - `recording_url` string, uri, nullable — API URL to download or redirect to the call recording if available.
    - `transcription_url` string, uri, nullable — API URL to download or redirect to the call transcript if available.
    - `call_type` string — The type of call.
    - `direction` string — The direction of the call.
    - `ended_reason` string, nullable — The reason for the call end, if applicable.
    - `phone` string, nullable — The phone number involved in the call, in E.164 format.
    - `fin_recording_url` string, uri, nullable — API URL to the AI Agent (Fin) call recording if available.
    - `fin_transcription_url` string, uri, nullable — API URL to the AI Agent (Fin) call transcript if available.
  - `total_count` integer — Total number of items available.
  - `pages` CursorPages, nullable — Cursor-based pagination is a technique used in the Intercom API to navigate through large amounts of data. A "cursor" or pointer is used to keep track of the current position in the result set, allowing the API to return the data in small chunks or "pages" as needed.
    - `type` 'pages' — the type of object `pages`.
    - `page` integer — The current page
    - `next` StartingAfterPaging, nullable
      - `per_page` integer — The number of results to fetch per page.
      - `starting_after` string, nullable — The cursor to use in the next request to get the next page of results.
    - `per_page` integer — Number of results per page
    - `total_pages` integer — Total number of pages

## Other responses

- `401` — Unauthorized

---

[API](https://skmtc.net/intercom/apis/intercom-api.md) · [All operations](https://skmtc.net/intercom/apis/intercom-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/intercom/intercom-api/revisions/9517e80f2642/schema)