---
title: "GET /api/calls/{call_id}"
method: GET
path: "/api/calls/{call_id}"
---

# GET /api/calls/{call_id}

`GET /api/calls/{call_id}`

## Request

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

Status, open questions, live transcript and, once finished, the outcome and cost of a call. With wait_seconds it waits for something to change (a new question, the call finishing) before answering. Takes a scheduled id (sched_...) too. Free.

## Path parameters

- `call_id` string, required

## Query parameters

- `wait_seconds` integer

## Response `200`

The call (with scheduled when it came from a schedule), or a schedule not dialed yet

- object
  - `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[]

## Other responses

- `400`: Request failed
- `401`: Request failed
- `404`: 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)