---
title: "List recordings"
method: GET
path: "/recordings"
tags: ["Recordings"]
---

# List recordings

`GET /recordings`

## Request

- Base URL: `https://app.italic.com/api/v2`
- URL: `https://app.italic.com/api/v2/recordings`
- Auth: HTTP bearer

Required permission: recordings:read.

## Query parameters

- `type` 'clip' | 'memo'
- `q` string
- `deviceId` string
- `status` 'pending' | 'transcribing' | 'ready' | 'no_speech' | 'failed'
- `from` integer
- `to` integer
- `cursor` string
- `limit` integer

## Response `200`

Success. Writes without read permission return an ID and revision only.

- RecordingList
  - `recordings` Recording[], required
    - `id` string, required
    - `type` 'clip' | 'memo', required
    - `title` string, required
    - `transcript` string, required
    - `summary` string, required
    - `recordedAt` integer, required
    - `updatedAt` integer, required
    - `revision` integer, required
    - `status` 'pending' | 'transcribing' | 'ready' | 'no_speech' | 'failed', required
    - `pinned` boolean, required
    - `audio` object[], required
      - `clientId` string, required
      - `fileId` string, required
    - `deviceId` string
    - `externalId` string
  - `nextCursor` string, nullable, required

## Other responses

- `default`: Request failed. Errors include a stable code and a readable message.

---

[API](https://skmtc.dev/italic/apis/italic-api.md) - [All operations](https://skmtc.dev/italic/apis/italic-api/llms.txt) - [OpenAPI document](https://skmtc.dev/italic/apis/italic-api/revisions/2fbe2cf16fe3?raw)