---
title: "Check Recorder Status"
method: GET
path: "/recorder/status/{token}"
tags: ["Recorder/Survey"]
---

# Check Recorder Status

`GET /recorder/status/{token}`

## Request

- Base URL: `https://api.speakai.co/v1`
- URL: `https://api.speakai.co/v1/recorder/status/{token}`
- Auth: API key in header `x-speakai-key` and API key in header `x-access-token`

Reveals whether recorder is publically open or password-protected

## Path parameters

- `token` string, required

## Response `200`

OK

- object
  - `status` string
  - `data` object
    - `isSecure` boolean: True when the recorder is password-protected, so the page must collect a password and call POST /v1/recorder/verify before recording. False when the recorder is open to anyone with the link.
    - `email` string: Email address of the user who owns the recorder.
    - `userId` string: Id of the user who owns the recorder.
    - `companyId` string: Id of the company the recorder belongs to.
    - `isExpired` boolean: Carries the recorder's disabled flag. It is always false on a 200, because a disabled recorder returns 404 with 'Embedded Recorder is disabled!' before the payload is built.
    - `name` string: Recorder name, shown as the heading on the recording page unless the recorder hides the title.
    - `description` string: Recorder description, shown under the heading unless the recorder hides the description.
    - `bucketId` string: Storage bucket the recording is uploaded to. It comes from the company's subscription and falls back to speakai-storage-us-east-1 when the subscription does not name one.
    - `meta` object: Branding and capture settings for the recording page. It carries the recorder's own meta, with primaryColor, logo, backgroundImg and fontFamily falling back to the company's branding when the recorder leaves them empty, customCSS sanitized before it is returned, hideImages defaulting to false, and isFooter from the subscription's recorder features. isFooter true renders the Speak footer at the bottom of the recording page, and is false for accounts whose plan includes recorder customization. S3 logo and background URLs are rewritten to their CloudFront address.
    - `minDuration` integer: Shortest recording the recorder accepts, in seconds.
    - `maxDuration` integer: Longest recording the recorder accepts, in seconds.
    - `sourceLanguage` string: Transcription language code the recorder is set to, such as en-US, or multi for a recorder that expects more than one language in the same recording. Open the live transcription socket with this value: a client that assumes en-US instead drops the sentences spoken in the recorder's other languages.

## Other responses

- `404`: Not Found

---

[API](https://skmtc.dev/speakai/apis/speak-ai-api.md) · [All operations](https://skmtc.dev/speakai/apis/speak-ai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/speakai/apis/speak-ai-api/revisions/52d777e6d46e?raw)