Skip to main content
All error responses share a consistent JSON body: 
{
  "status": 422,
  "code": "VALIDATION_ERROR",
  "detail": "One or more fields failed validation.",
  "errors": [
    "dba_name is required",
    "tax_id must be 9 digits"
  ]
}
FieldTypeDescription
statusnumberThe HTTP status code repeated in the body
codestringA machine-readable error code
detailstringA human-readable description of the error
errorsstring[]Per-field validation messages (present on 422 responses only)

​
Status codes

CodeMeaningCommon cause
400Bad RequestMalformed request syntax or invalid JSON
401UnauthorizedMissing or invalid API key
403ForbiddenValid credentials but insufficient permissions for the resource
404Not FoundThe requested resource ID does not exist
409ConflictResource already exists or conflicts with existing data
422Unprocessable EntityRequest was well-formed but failed field-level validation
503Service UnavailableThe service is temporarily unavailable — retry with backoff