---
title: "List calls"
method: GET
path: "/api/v1/outbound/calls"
tags: ["Outbound Calls"]
---

# List calls

`GET /api/v1/outbound/calls`

## Request

- Base URL: `https://api.callnode.io`
- URL: `https://api.callnode.io/api/v1/outbound/calls`
- Auth: API key in header `X-Api-Key` and API key in header `X-Timestamp` and API key in header `X-Signature`

Returns your outbound calls, newest first, with cursor pagination.

## Query parameters

- `status` 'originating' | 'ringing' | 'answered' | 'completed' | 'failed' | 'canceled'
- `limit` integer
- `cursor` string

## Response `200`

A page of calls.

- object
  - `calls` Call[]
    - `callId` string
    - `status` 'originating' | 'ringing' | 'answered' | 'completed' | 'failed' | 'canceled'
    - `from` string: Plus sign followed by 7–15 digits.
    - `to` string: The destination as requested — an E.164 number, a `sip:` URI, or an extension (trunk form).
    - `createdAt` string, date-time
    - `originatedAt` string, date-time, nullable
    - `answeredAt` string, date-time, nullable
    - `endedAt` string, date-time, nullable
    - `durationSecs` integer, nullable
    - `costUsd` string, nullable: Decimal string, e.g. "0.04".
    - `failureCode` string, nullable: Why the call failed. `no_answer`, `busy`, `carrier_rejected`, `invalid_number`, `cancelled`, `max_duration_exceeded`, or — for SIP destinations — `invalid_destination`, `endpoint_unreachable`, `endpoint_rejected`.
    - `sipTrunkId` string, nullable: The trunk used for this call. Null for PSTN calls and direct-URI SIP calls.
    - `sipUri` string, nullable: The normalized SIP URI actually dialed. Null for PSTN calls.
    - `phoneBookExempt` boolean: True when the call was placed outside the 8am–9pm window to a number in the account's Phone Book, so no tcpaOverride was needed.
    - `metadata` object
  - `nextCursor` string, nullable: Pass as `cursor` to fetch the next page. Null on the last page.

## Other responses

- `401`: Missing, unknown, or badly signed credentials — check the HMAC and the timestamp skew.
- `429`: Rate limit exceeded. See the rate-limit response headers.

---

[API](https://skmtc.dev/callnode/apis/callnode-outbound-api.md) · [All operations](https://skmtc.dev/callnode/apis/callnode-outbound-api/llms.txt) · [OpenAPI document](https://skmtc.dev/callnode/apis/callnode-outbound-api/revisions/c7da6ad06509?raw)