Errors

DVS uses a standard error envelope:

{
  "error_code": "071-403-document-type-not-allowed",
  "message": "Provider does not have access to the requested document type",
  "additional_information": {
    "document_type": "OPME",
    "country_code": "BR",
    "agreement_code": "BRADESCO_xxx"
  }
}

Catalog

4xx — Client errors

Status	error_code	Meaning
400	071-400	Generic bad request
401	071-401	Missing or invalid Bearer token
403	071-403	Lacks required authority
403	071-403-document-type-not-allowed	No access to the requested (document_type, country, agreement)
403	071-403-tenant-mismatch	Cross-tenant access attempt
403	071-403-classifier-not-allowed	Requested classifier_slug not available to your tenant
404	071-404	Resource not found
404	071-404-no-rules-configured	No rule set exists for the document type
409	071-409	Conflict (generic)
409	071-409-idempotency-mismatch	Same Idempotency-Key with a different body
413	071-413-file-too-large	Inline file exceeds size limit
422	071-422	Validation error (Pydantic)
422	071-422-unknown-document-type	document_type not in catalog
422	071-422-agreement-required	Multiple agreements available; specify one
422	071-422-ssrf-blocked	External URL blocked by security policy
422	071-422-mime-not-allowed	MIME type not in allowlist
422	071-422-s3-url-not-allowed	S3 URL not in allowlisted bucket
429	071-429	Rate or quota limit exceeded

5xx — Server errors

Status	error_code	Meaning
500	071-500	Unexpected internal error
500	071-500-no-default-classifier	Config invalid for your tenant — contact OSIGU
502	071-502-classifier-upstream	Classification engine upstream failed after retries
502	071-502-extraction-failed	Document extraction failed after upstream retries
503	071-503-globally-paused	Global circuit breaker is active
503	071-503-extraction-paused	Extraction hourly cap reached
504	071-504-sync-timeout	Sync request exceeded processing budget; poll for result

Retry strategy

See Handle Errors for the full retry policy.