Skip to main content

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

Next Steps