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

# List outbound calls

`GET /outbound-calls`

## Request

- Base URL: `https://vocenya.com/api/public/v1`
- URL: `https://vocenya.com/api/public/v1/outbound-calls`
- Auth: HTTP bearer

Your outbound AI calls, newest first: the ones you queued and those from speed-to-lead,
campaigns and agents.

## Query parameters

- `status` string
- `source` 'speed_to_lead' | 'agent_dial' | 'campaign' | 'api': | | |---| | `speed_to_lead` <br/> The AI calls back someone who just asked to be contacted. | | `agent_dial` <br/> A GH Live agent dials a number by hand from the workspace. | | `campaign` <br/> The AI works through a client's campaign contact list. | | `api` <br/> The client's own system queued an AI call through the public API or platform MCP server. |
- `phone_number` string
- `since` string, date-time
- `until` string, date-time
- `per_page` integer
- `cursor` string, nullable

## Response `200`

Paginated set of `OutboundCallResource`

- object
  - `data` OutboundCallResource[], required
    - `id` integer, required
    - `livemode` boolean, required: `true` for live data, `false` for test data (created with a `vk_test_` key).
    - `source` 'speed_to_lead' | 'agent_dial' | 'campaign' | 'api', required: | | |---| | `speed_to_lead` <br/> The AI calls back someone who just asked to be contacted. | | `agent_dial` <br/> A GH Live agent dials a number by hand from the workspace. | | `campaign` <br/> The AI works through a client's campaign contact list. | | `api` <br/> The client's own system queued an AI call through the public API or platform MCP server. |
    - `purpose` 'marketing' | 'informational', required: Why an outbound call is made. Telemarketing needs prior express written consent for AI voices.
    - `status` 'queued' | 'scheduled' | 'blocked' | 'connecting_agent' | 'dialing' | 'in_progress' | 'completed' | 'no_answer' | 'voicemail' | 'failed', required
    - `contact_name` string, nullable, required
    - `phone_number` string, required
    - `blocked_reason` string, nullable, required: Why the call was blocked or delayed, as a code.
    - `blocked_reason_message` string, nullable, required: Why the call was blocked or delayed, in words.
    - `scheduled_for` string, nullable, required: When a delayed call is due to ring (calling hours, daily limit).
    - `attempts` integer, required
    - `answered_at` string, nullable, required
    - `answered_by` 'human' | 'machine' | 'unknown', required: Who the carrier's answering machine detection heard pick up an outbound AI call. Null when detection gave no result.
    - `voicemail_left_at` string, nullable, required: When the AI finished leaving a message on voicemail, under the account's "leave a message" setting.
    - `ended_at` string, nullable, required
    - `duration_seconds` integer, nullable, required
    - `summary` string, nullable: The AI's summary of the call. Not included for HIPAA-mode accounts.
    - `transcript` object[], nullable: The conversation, turn by turn. Only on `GET /outbound-calls/{id}`, and never for HIPAA-mode accounts.
      - `role` string, required
      - `text` string, required
    - `created_at` string, nullable, required
  - `links` object, required
    - `first` string, nullable, required
    - `last` string, nullable, required
    - `prev` string, nullable, required
    - `next` string, nullable, required
  - `meta` object, required
    - `path` string, nullable, required: Base path for paginator generated URLs.
    - `per_page` integer, required: Number of items shown per page.
    - `next_cursor` string, nullable, required: The "cursor" that points to the next set of items.
    - `prev_cursor` string, nullable, required: The "cursor" that points to the previous set of items.

## Other responses

- `401`: The API key is missing, invalid, expired or revoked.
- `403`: The key does not have the `outbound:read` scope.
- `422`: Validation error
- `429`: Too many requests for this key. Wait for the `Retry-After` seconds.

---

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