Error Reference

Error Format

Every error includes three tiers:

{
  "error": {
    "type": "invalid_date_range",
    "message": "start_date must be before end_date",
    "display_message": "The date range is invalid.",
    "suggestion": "Swap: start_date=2026-03-10&end_date=2026-03-17",
    "param": "start_date",
    "docs_url": "https://suna.health/docs/api/errors"
  }
}

Error Types