Errors - Numpay Docs

Status codes

Status	Meaning
`200`	Success
`201`	Created
`400`	Invalid input (validation failed, missing field, bad format)
`401`	Missing or invalid Bearer token
`403`	Authenticated, but not allowed to act on this resource
`404`	Resource not found (user, transaction, request, deposit)
`409`	Conflict: the wallet address already belongs to another user
`429`	Rate limit exceeded
`500`	Internal server error
`502`	Upstream error from NEAR Intents
`503`	NEAR deposits aren’t configured on this server

Error bodies

User and transaction endpoints use message, and include zod issues when validation fails:

{
  "message": "Invalid input",
  "errors": [
    { "code": "too_small", "minimum": 10, "path": ["phoneNumber"], "message": "String must contain at least 10 character(s)" }
  ]
}

Request and NEAR endpoints use error:

{ "error": "Amount must be between 1 and 10000 USDC." }