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

# List Calls

`GET /api/v1/calls`

## Request

- Base URL: `https://api.dialogbrain.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.dialogbrain.com/api/v1/calls`
- Auth: none declared

List the workspace's calls, newest first, with status, duration and outcome.

## Query parameters

- `thread_id` string, nullable: Only calls on this thread (as delivered in session.completed). A string, not a number: Meet sessions carry non-numeric refs.
- `since` string, nullable: ISO timestamp lower bound on started_at.
- `until` string, nullable: ISO timestamp upper bound on started_at.
- `with_recording` boolean: Only calls that have a stored recording.
- `limit` integer
- `offset` integer

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/dialogbrain/apis/dialogbrain-v2-api-gateway.md) · [All operations](https://skmtc.dev/dialogbrain/apis/dialogbrain-v2-api-gateway/llms.txt) · [OpenAPI document](https://skmtc.dev/dialogbrain/apis/dialogbrain-v2-api-gateway/revisions/77bef09a9209?raw)
