Errors

Responses use a JSON envelope.

{
  "success": false,
  "error": "Validation Error",
  "errors": {
    "id_external": ["The id external field is required."]
  }
}

Common Status Codes

Status	Meaning
200	Existing resource returned or updated.
201	Resource accepted or created.
400	Business operation failed.
401	Authentication failed.
403	Authenticated key cannot access a business context.
404	Resource or supported endpoint not found.
422	Validation failed or invoice quota was exceeded.
500	Unexpected server error.
503	Temporary service protection response. Respect Retry-After when present.

Treat 422 responses as business errors that require payload or account changes before retrying.