---
title: "Read a recording's check"
method: GET
path: "/api/recordings/{id}"
---

# Read a recording's check

`GET /api/recordings/{id}`

## Request

- Base URL: `https://www.toma.com`
- URL: `https://www.toma.com/api/recordings/{id}`
- Auth: none required

For the /record page while the background check runs (x-recording-token header). status is analyzing until the check ends. A checked recording with no findings is then approved automatically, with every moment accepted. Otherwise it is needs_review: analyzed is false when no model could check it, and secret is true when a credential is on screen, which blocks approval.

## Path parameters

- `id` string, required

## Response `200`

The recording's status and what the check found.

- object
  - `id` string
  - `status` 'uploading' | 'analyzing' | 'needs_review' | 'approved' | 'failed'
  - `analyzed` boolean: False while analyzing, or when no model could check it.
  - `findings` integer: Things that may be private on screen or in the audio.
  - `secret` boolean: A credential is on screen; approval is refused.
  - `moments` integer: Moments that sound like requirements.
  - `review` object, nullable: What to review before approving: seconds, webcam, analyzed, summary, findings, moments, acceptedMoments, approved (as on DraftRecording). Null while analyzing.

## Other responses

- `401`: The link is invalid or was replaced, or its draft was posted.
- `404`: This link has no recording with that id.

---

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