Common Error Responses (Onboarding)

Code	Meaning	Description
400	Bad Request	Invalid parameters
401	Unauthorized	Missing or invalid token
402	Payment Required	Payment or payout setup required
403	Forbidden	Action not allowed at current step
404	Not Found	Resource not found
409	Conflict	Email or handle already exists
413	Payload Too Large	Uploaded file exceeds size limit
422	Unprocessable Entity	Validation errors
429	Too Many Requests	Rate limit exceeded
500	Internal Server Error	Unexpected server failure

Example: Validation error (422)

{
  "status": "error",
  "code": 422,
  "errors": [
    { "field": "password", "message": "Password must be at least 8 characters" },
    { "field": "handle", "message": "Handle can only contain letters, numbers, and underscores" }
  ]
}

Example: Step access error (403)

{
  "status": "error",
  "code": 403,
  "message": "You must complete Step 3 before accessing Step 4"
}