---
title: "GET /api/calls"
method: GET
path: "/api/calls"
---

# GET /api/calls

`GET /api/calls`

## Request

- Base URL: `https://call4.me`
- URL: `https://call4.me/api/calls`
- Auth: HTTP bearer

Recent calls, newest first (without transcripts), and scheduled calls that have not dialed yet. Free.

## Query parameters

- `limit` integer

## Response `200`

The calls

- object
  - `calls` object[], required
    - `id` string, required
    - `status` 'queued' | 'dialing' | 'in_progress' | 'completed' | 'no_answer' | 'busy' | 'failed' | 'canceled', required
    - `finished` boolean, required: true once the call ended and its recap is written; poll until then
    - `direction` 'outbound' | 'inbound', required
    - `business` string, required
    - `number` string, required
    - `calling_number` string, nullable, required: the call4me number that rings the user when they join
    - `goal` string, nullable, required
    - `outcome` object, nullable, required
      - `result` string, required
      - `summary` string, required
      - `details` object
    - `open_questions` object[], required: the business is waiting on the line: answer right away
      - `id` string, required
      - `question` string, required
    - `answered_questions` object[], required
      - `question` string, required
      - `answer` string, required
    - `talk_minutes` integer, required
    - `cost` string, required
    - `cost_cents` integer, required: billed so far, in US cents; final once finished
    - `ended` string, nullable, required: who ended the call and why
    - `error` string, nullable, required
    - `created_at` string, required
    - `transcript` string[]
  - `scheduled` object[], required
    - `id` string, required
    - `status` 'pending' | 'dialing' | 'placed' | 'failed' | 'canceled', required
    - `business` string, required
    - `number` string, required
    - `call_at` string, required
    - `call_id` string, nullable, required: the call it became, once dialed

## Other responses

- `401`: Request failed

---

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