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

# Get Calls

`GET /v1/calls/`

Retrieve list of calls for your organization.

- Only public calls are returned (all private calls are excluded)
- Results are sorted by start time in descending order (newest first)

## Query parameters

- `participant_email` string, nullable — A participant's email to filter by (case insensitive). Only calls with this participant will be shown.
- `start_time_from` string, date-time, nullable — Filter calls starting from this time (UTC ISO 8601)
- `start_time_to` string, date-time, nullable — Filter calls starting up to this time (UTC ISO 8601)
- `title_filter` string, nullable — Query to filter calls by call title.
- `tag_ids` string[], nullable — Filter calls by tag IDs. Only calls with at least one of the specified tags will be returned.
- `cursor` string, nullable — Cursor for pagination
- `limit` integer — Number of items per page
- `direction` 'next' | 'prev' — Pagination direction

## Response `200`

Successful Response

- PaginatedResponseCallPreview
  - `data` CallPreview[], required
    - `id` string, required
    - `title` string, required
    - `companies` CompanyPreview[]
      - `name` string, nullable
      - `domain` string, required
    - `participants` ParticipantPreview[]
      - `name` string, nullable
      - `email` string, nullable
      - `id` integer, required
    - `start_time` string, date-time, required
    - `duration` integer, nullable
    - `status` CallStatus, required
      - `code` unknown, required
    - `tags` CallTagPreview[]
      - `id` string, required
      - `name` string, required
      - `description` string, nullable
      - `group` string, nullable
  - `pagination` CursorPagination, required — Cursor-based pagination.
    - `next_cursor` string, nullable
    - `previous_cursor` string, nullable

## Other responses

- `401` — Unauthorized - Invalid or missing API key
- `422` — Validation Error

---

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