Skribby
API Reference

Get Recording

GET/recording/{id}
https://platform.skribby.io/api/v1/recording/{id}

Retrieve information about a specific recording, including its transcription status and transcript (if available).

Path Parameters

NameTypeDescription
idrequired
string<uuid>Recording ID

Responses

Returns Recording
idstring<uuid>

Unique recording identifier

statusstring

Current status of the recording

Allowed values:
transcribingfinishedfailed
webhook_urlstring<uri> | null

Webhook URL for receiving status updates. Refer to the Webhooks section for details on webhook format and available events.

recording_urlstring<uri> | null

URL to the original recording file

recording_available_untilstring<date-time> | null

When the recording will be deleted

langstring | null

Language specified when creating the recording

detected_langstring | null

Language detected from the audio

transcriptTranscriptSegment[]

Transcript segments

transcription_modelstring

Model used for transcription

eventsEvent[]

List of processing events

profanity_filterboolean

Whether profanity filter was enabled

custom_vocabularystring[]

Words or phrases provided when creating meeting bot for transcription model

created_atstring<date-time>

When the recording was uploaded

Request

curl -X GET \
  "https://platform.skribby.io/api/v1/recording/{id}" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Response

200 OKapplication/json
{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "status": "transcribing",
  "webhook_url": null,
  "recording_url": null,
  "recording_available_until": null,
  "lang": null,
  "detected_lang": null,
  "transcript": [
    {
      "start": 4,
      "end": 5.62,
      "speaker": 0,
      "speaker_name": "John Doe",
      "potential_speaker_names": null,
      "confidence": 0.9980372,
      "transcript": "This is a quick test.",
      "utterances": [
        null
      ]
    }
  ]
}