---
title: "Get all calls for the clinic"
method: GET
path: "/calls/all"
tags: ["Calls"]
---

# Get all calls for the clinic

`GET /calls/all`

Retrieves the AI-coordinator calls for the clinic determined by the provided API key.

Each call includes call-level metadata (times, caller, review status, AI summary) and its full `interactions` transcript. Results are ordered most recent first and paginated with `pageSize` and `pageToken`.

To page through results, pass the `nextPageToken` returned by the previous response as the `pageToken` of the next request. When `hasMore` is `false`, there are no further pages.

## Query parameters

- `pageSize` integer
- `pageToken` string

## Response `200`

Calls retrieved successfully

- CallsResponse
  - `calls` Call[]
    - `id` string — The unique identifier of the call.
    - `startedAt` string, date-time — ISO 8601 timestamp when the call started.
    - `endedAt` string, date-time — ISO 8601 timestamp when the call ended.
    - `callerPhoneNumber` string — Phone number the call originated from.
    - `isReviewed` boolean
    - `hasCalledBefore` boolean
    - `totalNumberOfPreviousCalls` integer
    - `summary` string — AI-generated summary of the call.
    - `interactions` Interaction[] — Ordered transcript of the call.
      - `speaker` 'ai-agent' | 'patient' — Who produced the message.
      - `text` string — The transcribed text of the interaction.
  - `nextPageToken` string — Token for fetching the next page. Null when there are no more results.
  - `hasMore` boolean — Whether there are more results available.
  - `totalCount` integer — Number of calls in the current page.

## Other responses

- `401` — Unauthorized - Invalid or missing API key
- `429` — Too Many Requests - Rate limit exceeded
- `500` — Internal server error

---

[API](https://skmtc.dev/mdhub/apis/mdhub-api.md) · [All operations](https://skmtc.dev/mdhub/apis/mdhub-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/mdhub/mdhub-api/revisions/ee7fca23d80b/schema)