Open Swagger Docs

CodeChef Stats API Documentation

FastAPI REST API for public CodeChef profile data. This API exposes separate endpoints for profile information, heatmap activity, and rating history.

Upstream CodeChef responses are cached in memory and API routes are rate-limited per client IP.
Dashboard Profile Example Heatmap Example Rating Example

GET/profile/{handle}

+

Returns core profile information for a CodeChef user.

handle Required CodeChef username.
{
  "success": true,
  "status": 200,
  "handle": "tourist",
  "profile": {
    "profile": "https://...",
    "name": "tourist",
    "currentRating": 2500,
    "highestRating": 2700,
    "countryFlag": "https://...",
    "countryName": "Belarus",
    "globalRank": 12,
    "countryRank": 1,
    "stars": "7 stars"
  }
}
Try endpoint

GET/heatmap/{handle}

+

Returns daily submission heatmap entries for the user.

handle Required CodeChef username.
view Optional. Use all, last_365, or year.
year Optional. Required when view=year.
{
  "success": true,
  "status": 200,
  "handle": "tourist",
  "view": "last_365",
  "year": null,
  "availableYears": [2026, 2025, 2024],
  "firstActiveDate": "2024-01-01",
  "lastActiveDate": "2026-01-12",
  "heatMap": [
    {"date": "2024-01-01", "value": 2}
  ]
}
Try endpoint

GET/rating/{handle}

+

Returns contest rating history data for the user.

handle Required CodeChef username.
{
  "success": true,
  "status": 200,
  "handle": "tourist",
  "ratingData": [
    {"name": "JAN24", "rating": 1900}
  ]
}
Try endpoint