Error Response Format
All Enterprise API v2 errors return a consistent JSON structure:HTTP Status Codes
Error Codes
invalid_api_key
HTTP 401 - Missing or invalid API key
insufficient_scope
HTTP 403 - API key lacks required scope
validation_error
HTTP 400 - Request validation failed
resource_not_found
HTTP 404 - Resource does not exist
duplicate_name
HTTP 409 - Webhook name already exists within your organization
rate_limited
HTTP 429 - Too many requests
Limits
Tips
Use Webhooks Over Polling
Instead of polling for retrieval status, set up webhooks to receive real-time notifications when a request changes, needs action, or has records or invoices ready.Handle Partial Failures
When uploading multiple documents, track which uploads succeed/fail individually rather than treating the batch as all-or-nothing.Getting Help
If you encounter persistent errors, contact support at contact@tavrn.ai with:- Timestamp
- Full error response
- Steps to reproduce