Skip to main content

Errors

Errors follow the application/problem+json format.

Example​

{
  "type": "https://iris.fololo.io/docs/errors/validation-error",
  "title": "Validation failed",
  "status": 400,
  "traceId": "00-2f0b7b8a4d3f90b1d9b0a1c8f2f7b9d1-1f2e3d4c5b6a7f8e-00",
  "errors": {
    "walletAddress": ["Wallet address is required."],
    "blockchainNetwork": ["Supported networks: ethereum, polygon, bsc, bitcoin"]
  }
}

Common statuses​

  • 400 for invalid input
  • 401 for missing or invalid API keys
  • 404 for missing resources
  • 409 for conflicts (duplicate or already verified)
  • 429 for rate limits
  • 500 for unexpected errors