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

# List Calls

`GET /calls/`

List all calls for the current user's customer.

Returns calls ordered by created_at descending (newest first).
By default, test calls are excluded. Set include_test_calls=true to include them.

## Query parameters

- `limit` integer
- `offset` integer
- `include_test_calls` boolean

## Response `200`

Successful Response

- CallResponse[]
  - `call_id` string, uuid, required
  - `customer_id` string, uuid, required
  - `case_id` string, uuid, nullable, required
  - `created_at` string, date-time, required
  - `phone_number` string, nullable, required
  - `system_phone_number` string, nullable, required
  - `duration_seconds` integer, nullable, required
  - `direction` string, required
  - `channel` string, nullable
  - `status` string, required
  - `caller_client_status` string, nullable, required
  - `is_test` boolean, required
  - `transferred` boolean, required
  - `call_sid` string, nullable, required
  - `forwarded_call_sid` string, nullable, required
  - `session_id` string, nullable, required
  - `start_time` string, date-time, nullable, required
  - `end_time` string, date-time, nullable, required
  - `caller_name` string, nullable, required
  - `caller_email` string, nullable, required
  - `has_error` boolean, required
  - `error_description` string, nullable, required
  - `errors` object[], nullable
  - `quality_score` string, nullable, required
  - `quality_reason` string, nullable, required
  - `goal_accomplished` boolean, nullable, required
  - `goal_reason` string, nullable, required
  - `caller_hung_up` boolean, nullable, required
  - `billable` boolean, nullable
  - `hit_voicemail` boolean, nullable
  - `call_provider` string, nullable — Voice agent provider: 'pipecat', 'vapi', or 'ringcentral' (null means pipecat/legacy)
  - `cnam_caller_name` string, nullable — Caller ID name from Twilio CNAM lookup (display only - may be account holder, not actual caller)
  - `cnam_caller_type` string, nullable — Caller type from CNAM: 'CONSUMER' or 'BUSINESS'
  - `next_call_id` string, uuid, nullable
  - `previous_call_id` string, uuid, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/openintake/apis/fastapi.md) · [All operations](https://skmtc.dev/openintake/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/openintake/fastapi/revisions/4a81645b59f6/schema)