Error Codes

All errors return a JSON object with an error field containing message and code.

Error Response Format

{"error":{"message":"Invalid API key.","code":401}}

HTTP Status Codes

Code	Meaning	Common Causes
`400`	Bad Request	Missing required fields, invalid Content-Type
`401`	Unauthorized	Missing or invalid API key
`402`	Payment Required	Insufficient balance
`404`	Not Found	Job not found, invalid route
`413`	Payload Too Large	Audio file exceeds 95 MB limit
`429`	Rate Limited	Too many requests. See Rate Limits
`500`	Server Error	Internal processing failure

401: Verify your API key is correct and not revoked in the Dashboard
402: Top up your balance at voxparse.com/dashboard
413: Compress audio or split into smaller segments. Max file size is 95 MB
429: Implement exponential backoff. Check the retry_after field in the response