Error codes

Every error has the same envelope. Read error.code in your code, show error.message to people, and quote error.request_id to support.

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Validation failed",
    "param": "amount",
    "request_id": "6f1c0e8a-2d1b-4c5e-9f7a-3b2d1c0e8a6f",
    "doc_url": "https://docs.watenga.africa/developers/errors#VALIDATION_ERROR",
    "details": { "issues": [{ "path": "amount", "message": "Amount must be a decimal string" }] }
  }
}

• request_id is also the X-Request-ID response header. The SDKs put it on their error object (requestId / request_id).
• param names the request field a validation error is about (snake_case in API version 2026-10-29); every issue is in details.issues.
• doc_url links to the code's row below.

Error reference

All 198 codes the API answers, generated from the API itself. HTTP statuses are the ones the code is answered with.