Skip to main content
Common error codes:
  • invalid_request (400)
  • unauthorized (401)
  • forbidden (403)
  • not_found (404)
  • conflict (409)
  • service_unavailable (503)
All responses use a consistent envelope by default: { ok, data, summary, errors[], next }. Set X-Open-Responses: 1 to receive Open Responses-style outputs.

Open Responses error shape (optional)

When X-Open-Responses: 1 is set, errors return the Open Responses error object:
{
  "error": {
    "type": "invalid_request",
    "code": "invalid_request",
    "param": "walletAddress",
    "message": "walletAddress required to create a new mapping"
  }
}