---
title: "Get call status"
method: GET
path: "/v1/calls/{call_id}"
tags: ["Calls"]
---

# Get call status

`GET /v1/calls/{call_id}`

## Request

- Base URL: `https://voice-api.kata.ai`
- URL: `https://voice-api.kata.ai/v1/calls/{call_id}`
- Auth: API key in header `X-Partner-Key`
- TypeScript: <https://skmtc.dev/kata/apis/kata-voice-api/docs/v1/calls/:call_id/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `call_id` string, required

## Response `200`

Call

- Call
  - `call_id` string
  - `status` string: `dialing`, `connected`, `ended`, `no_answer`, `failed`; test sessions start as `test-session-started`
  - `detail` string: Reason for a `failed` call
  - `started_at` string, date-time
  - `ended_at` string, date-time

## Other responses

- `401`: Missing, unknown or revoked partner key
- `404`: No such call for this tenant

---

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