---
title: "Get a recording"
method: GET
path: "/recordings/{id}"
tags: ["Recordings"]
---

# Get a recording

`GET /recordings/{id}`

## Request

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

Required permission: recordings:read.

## Path parameters

- `id` string, required

## Response `200`

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

- RecordingResult
  - `recording` union, required
    - Recording
      - `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
    - object
      - `id` string, required
      - `revision` integer, required
  - `replayed` boolean

## 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)