Skip to content

HTTP error response

Jump to bottom
Raphaël Balet edited this page Feb 16, 2026 · 1 revision 
{
  "error": {
    "type": "VALIDATION",
    "code": "VALIDATION_FAILED",
    "message": "Validation error",    
    "issues": [
      {
        "code": "VALIDATION_FIELD_INVALID_FORMAT",
        "path": ["email"],
        "message": "Email is invalid"
      },
      {
        "code": "VALIDATION_FIELD_TOO_SHORT",
        "path": ["password"],
        "meta": { "min": 8 }
      }
    ],
    "traceId": "req_9f3a"
  }
}

Error Code

<DOMAIN>_<CATEGORY>_<DETAIL>

Authentification & Autorisation (AUTH)

  • AUTH_UNAUTHORIZED
  • AUTH_FORBIDDEN
  • AUTH_INVALID_CREDENTIALS
  • AUTH_TOKEN_EXPIRED
  • AUTH_TOKEN_INVALID
  • AUTH_REFRESH_TOKEN_INVALID
  • AUTH_ACCOUNT_DISABLED
  • AUTH_ACCOUNT_LOCKED
  • AUTH_OAUTH_PROVIDER_ERROR
  • AUTH_SESSION_EXPIRED

Validation (VALIDATION)

  • VALIDATION_FAILED
  • VALIDATION_INVALID_PAYLOAD
  • VALIDATION_MISSING_FIELD
  • VALIDATION_INVALID_TYPE
  • VALIDATION_FIELD_REQUIRED
  • VALIDATION_FIELD_INVALID_FORMAT
  • VALIDATION_FIELD_TOO_SHORT
  • VALIDATION_FIELD_TOO_LONG
  • VALIDATION_FIELD_TOO_SMALL
  • VALIDATION_FIELD_TOO_LARGE
  • VALIDATION_FIELD_NOT_ALLOWED
  • VALIDATION_FIELD_NOT_UNIQUE
  • VALIDATION_FIELD_OUT_OF_RANGE
  • VALIDATION_FIELD_ENUM_INVALID

Domain (DOMAIN)

  • RESOURCE_NOT_FOUND
  • RESOURCE_ALREADY_EXISTS
  • RESOURCE_CONFLICT
  • RESOURCE_LOCKED
  • RESOURCE_DELETED
  • USER_NOT_FOUND
  • USER_ALREADY_EXISTS
  • USER_EMAIL_ALREADY_USED
  • USER_USERNAME_ALREADY_USED
  • USER_INVALID_STATE
  • ORDER_NOT_FOUND
  • ORDER_ALREADY_PAID
  • ORDER_OUT_OF_STOCK
  • PAYMENT_FAILED
  • PAYMENT_DECLINED
  • PAYMENT_PROVIDER_ERROR

Conflicts (CONFLICT)

  • CONFLICT_VERSION_MISMATCH
  • CONFLICT_DUPLICATE_ENTRY
  • CONFLICT_INVALID_STATE_TRANSITION

Rate Limiting & Quotas (RATE_LIMIT)

  • RATE_LIMIT_EXCEEDED
  • QUOTA_EXCEEDED

System & Infrastructure (SYSTEM)

  • SYSTEM_INTERNAL_ERROR
  • SYSTEM_DEPENDENCY_FAILURE
  • SYSTEM_TIMEOUT
  • SYSTEM_DATABASE_ERROR
  • SYSTEM_CACHE_ERROR
  • SYSTEM_IO_ERROR
  • SYSTEM_CONFIGURATION_ERROR

API & Protocole (API)

  • API_NOT_FOUND
  • API_METHOD_NOT_ALLOWED
  • API_UNSUPPORTED_MEDIA_TYPE
  • API_BAD_REQUEST
  • API_VERSION_NOT_SUPPORTED

Clone this wiki locally