> For the complete documentation index, see [llms.txt](https://docs.bird.com/api/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.bird.com/api/voice-api/transcriptions-api/get-a-transcription.md).

# Get a Transcription

In order to retrieve a transcription metada, you can use the following endpoint.

## Get transcription

> Get transcription

```json
{"openapi":"3.0.3","info":{"title":"Voice","version":"v1"},"tags":[],"servers":[{"url":"https://api.bird.com","description":"Production API"}],"security":[{"accessKey":[]}],"components":{"securitySchemes":{"accessKey":{"description":"Uses the Authorization header: 'AccessKey ' followed by your access key token (e.g., 'Authorization: AccessKey AbCdEfGhIjKlMnOpQrStUvWxYzAbCdEfGhIj')","scheme":"AccessKey","type":"http"}},"schemas":{"Transcription":{"type":"object","additionalProperties":false,"properties":{"id":{"$ref":"#/components/schemas/transcriptionId"},"recordingId":{"$ref":"#/components/schemas/recordingId"},"status":{"$ref":"#/components/schemas/TranscriptionStatus"},"stereo":{"type":"boolean"},"locale":{"$ref":"#/components/schemas/SupportedLocales"},"url":{"type":"string"},"summary":{"type":"string"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","recordingId","status","stereo","locale","createdAt","updatedAt"]},"transcriptionId":{"title":"Transcription ID","description":"The ID for the transcription.","type":"string","format":"uuid"},"recordingId":{"title":"Recording ID","description":"The ID for the recording.","type":"string","format":"uuid"},"TranscriptionStatus":{"type":"string","enum":["accepted","ongoing","available","absent","failed"]},"SupportedLocales":{"type":"string","format":"locale-bcp47","default":"en-US","enum":["ar-AE","ar-SA","cmn-CN","cy-GB","da-DK","de-CH","de-DE","el-GR","en-AU","en-GB","en-GB-WLS","en-IE","en-IN","en-NZ","en-US","en-ZA","es-ES","es-MX","es-US","fr-CA","fr-FR","he-IL","hi-IN","id-ID","is-IS","it-IT","ja-JP","ko-KR","ms-MY","nb-NO","nl-NL","pl-PL","pt-BR","pt-PT","ro-RO","ru-RU","sv-SE","ta-IN","te-IN","th-TH","tr-TR","vi-VN","zh-CN","zh-HK","zh-TW","arb","af-ZA","bn-IN","ca-ES","cmn-TW","cs-CZ","fi-FI","fil-PH","gu-IN","hu-HU","kn-IN","lt-LT","lv-LV","ml-IN","mr-IN","pa-IN","sk-SK","sr-RS","uk-UA","yue-HK","no-NO"]},"Error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string","minLength":5},"message":{"type":"string","minLength":5}}}},"responses":{"Error":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string","minLength":5},"message":{"type":"string","minLength":5},"details":{"type":"object","additionalProperties":true}}}}}}}},"paths":{"/workspaces/{workspaceId}/transcriptions/{transcriptionId}":{"get":{"summary":"Get transcription","description":"Get transcription","operationId":"getTranscription","tags":["voice-transcriptions"],"responses":{"200":{"description":"The transcription metadata","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Transcription"}}}},"307":{"description":"The transcription file"},"404":{"$ref":"#/components/responses/Error"},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}}}
```

{% tabs %}
{% tab title="Request" %}

```
curl "/workspaces/{workspaceId}/transcriptions/{channelId}" \
     -H 'Authorization: AccessKey YOUR_SECRET_TOKEN'
```

{% endtab %}

{% tab title="Response" %}

```
{
  "id": "7f1e9ce1-95db-4a39-80f4-9bde69908c53",
  "recordingId": "5b74ee9e-9d45-473a-82cd-f1f7feea6bbd",
  "status": "available",
  "stereo": false,
  "locale": "en-US",
  "url": "https://regional--voice-recordings--637323691990--euw1.s3.eu-west-1.amazonaws.com/workspaceID%218bc02f53-87ac-48d2-b4fd-c2cf856a305f/sourceID%2150fa2203-66c2-4820-864a-1a8002952f4e/7f1e9ce1-95db-4a39-80f4-9bde69908c53.json?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=ASIAZIY3TY7LBTBZCS45%2F20231024%2Feu-west-1%2Fs3%2Faws4_request&X-Amz-Date=20231024T130534Z&X-Amz-Expires=600&X-Amz-Security-Token=IQoJb3JpZ2luX2VjEBwaCWV1LXdlc3QtMSJHMEUCIBch4MlGQu3ErdIzwknxkM0z23Clo79heSynPWNzU7jeAiEA%2F9fuYlS5yImmZ%2FN53KEmG2dEENZFbPfoNkrdPj%2BExHMq7QMIRRABGgw2MzczMjM2OTE5OTAiDCSO0vsLR5UJ%2BOYdrirKAzCu4U7saMI%2FVJDauiWwesWmbhSYCt1LdcULqH4AqrKk1I700LcFzBTQ1HPjfbLDyM169KlHgY%2Fdw51lvvRt7vqynvho2Vwk6CQoNYNk2%2FORr07phUNtKZgxi%2FbD5cgvRz2upRixYdqST7CoDdN1QsSEz43jS9ka5vGHKZV3OvBXmCKElk9QU5557xIppybAbcQ6sCXssfEkcKsLpKaiLN8nN%2FRGJ6kyWriih41NaoNRv6ykPiqpQJtAIvEtRx19iY98vj%2Bg06TMKuzBXp%2FcLXI3KlUpVTBZRYetCNC7Kf5lpg2amyK9FNW14OPc9hArFkG%2F%2Fah7bj0KJJaink3Lu1m2A61DhkiQeqnUeY5tGTgh4vdEZT20%2BiNwMWI7UGErcesbcqQJnCm3oTwbbalsOIDfiPcYt1dKvjW0FJeclFY935sAIJiARlcCud%2BcNf96LtUc%2Bp3cMI1jTzbXec4YK%2BXMjYUczTpQ%2F%2BvHEeNdJkv9af%2B3hwMineFvtcW3e3r7dfmFYD5moZh91Ykj2N35RQ7Vvyvnb%2B4tax43j%2BUpOjth9sMZHo3bjgGpkYVc1mBOGtrSrQPANyQXKCIIS6YIOvFegGCeCU5ntkFnMJLe3qkGOqUBJRIHI%2BL5lnQl6U0i1YtFD9GI8B9O6M%2FLfdOkZLG7FWX0cpCoQtDVCKxQya5tQclGr5DasMadT5CWRQQTxgiCkQNxZLV%2FsnUVxPuVW%2Bxw9%2BnPZ%2BKzkSJ3zacSVhby2AUeZCMc5AkboJX0a4%2FnJ5%2FhULZtruZF0cwGHl69nCLTT1OLrj3%2FarCgYkyaRZyjlaz4zNulyBGqy%2BPkDP8xVKRPEGotlBHf&X-Amz-SignedHeaders=host&x-id=GetObject&X-Amz-Signature=f4f9aa1ffaf2653b4b2ba9aa7fc786a3f74f0c662d9bee1aa5077587d63b70b6",
  "createdAt": "2023-10-23T15:55:38.888Z",
  "updatedAt": "2023-10-23T15:55:47.439Z"
}
```

{% endtab %}
{% endtabs %}

{% hint style="info" %}
To get the transcription content you use the endpoint for your preferred format:

* GET /workspaces/{workspaceId}/transcriptions/{transcriptionId}.json
* GET /workspaces/{workspaceId}/transcriptions/{transcriptionId}.srt
* GET /workspaces/{workspaceId}/transcriptions/{transcriptionId}.vtt
* GET /workspaces/{workspaceId}/transcriptions/{transcriptionId}.txt
  {% endhint %}