Errors

​

Status code classes

• 2xx: request completed successfully.
• 4xx: client input, auth, or permissions issue.
• 5xx: server-side failure.

​

Typical error payload

{
  "error": {
    "code": "invalid_request",
    "message": "Missing required field: phoneNumber"
  }
}

​

Common remediation path

1. Validate required fields and value formats.
2. Confirm bearer token and access role.
3. Retry with request ID correlation in logs.
4. Escalate with full request/response samples.