Guides
Errors
Error format, codes and what to do about each.
Errors use standard HTTP status codes and a JSON body with a stable code. Match on code, not on message.
| Code | Status | What to do |
|---|---|---|
invalid_api_key | 401 | Check the key; it may be revoked or expired. |
insufficient_balance | 402 | Add funds to the balance. |
monthly_limit_exceeded | 402 | Raise the organization's or the key's monthly limit. |
unsupported_format | 400 | Convert to WAV, FLAC, MP3, M4A or OGG. |
file_too_long | 400 | Split the recording into parts of up to 4 hours. |
download_failed | 400 | Make sure the url is public and does not expire. |
job_not_found | 404 | Check the ID and the organization of the key. |
rate_limited | 429 | Wait for Retry-After seconds, then retry. |
internal_error | 500 | Retry. If it repeats, contact support with the request ID. |