Error Handling

FutPicks APIs use HTTP status codes plus structured problem details where applicable.

Common status codes

Status	Meaning
400	Invalid request or unsupported filter
401	Missing, expired, or invalid credentials
403	Authenticated but not entitled
404	Resource not found
409	Conflict, often idempotency or state related
422	Valid JSON but semantically invalid command
429	Rate limit exceeded
500	Server error

Problem details

{
  "type": "https://futpicks.com/problems/validation-error",
  "title": "Validation Error",
  "status": 400,
  "detail": "Unsupported sort field.",
  "instance": "/api/v1/data/signals"
}

Clients should log type, status, and instance, then display a user-safe message. Do not expose raw response bodies to end users when they may contain internal diagnostics.