---
title: "List WhatsApp calls"
method: GET
path: "/v1/whatsapp/calls"
tags: ["WhatsApp"]
---

# List WhatsApp calls

`GET /v1/whatsapp/calls`

## Request

- Base URL: `https://api.pyai.com`
- URL: `https://api.pyai.com/v1/whatsapp/calls`
- Auth: one of:
  - HTTP bearer
  - API key in header `x-api-key`

## Query parameters

- `limit` integer

## Response `200`

Calls, newest first

- object
  - `object` string
  - `data` WhatsAppCall[]
    - `object` string
    - `id` string
    - `number_id` string
    - `wa_call_id` string, nullable: Meta's call id (wacid...).
    - `direction` 'inbound' | 'outbound'
    - `user` string
    - `agent_id` string, nullable
    - `status` 'ringing' | 'accepted' | 'connected' | 'completed' | 'failed' | 'rejected' | 'no_answer' | 'terminated'
    - `failure_reason` string, nullable
    - `started_at` integer, nullable: Unix ms.
    - `connected_at` integer, nullable: Unix ms.
    - `ended_at` integer, nullable: Unix ms.
    - `duration_seconds` integer, nullable
    - `created_at` integer
    - `updated_at` integer

## Other responses

- `401`: Missing or invalid API key (`code: unauthorized`)

---

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