What should I do if I'm getting an error?

Any time you make a request to the API, you should receive a JSON response. If you don’t receive the expected output, the JSON contains an error key with a message value describing the error.

To retrieve the error from our API:

  1. Make a GET request to fetch the transcript details:
curl https://api.assemblyai.com/v2/transcript/<transcript_id> \
-H "Authorization: <apiKey>"

The response will include an error key with details about what went wrong:

{
"status": "error",
"error": "Download error, unable to access file at https://example.com/audio.mp3",
...
}
  1. Check our Common Errors Guide for solutions to frequently encountered errors and how to resolve them.

  2. Still stuck? Contact our support team at support@assemblyai.com. Please include your transcript ID, the audio file/URL you’re trying to transcribe, and the JSON response from our server so we can help you faster.