Skip to content

Filter by Contest Type

Get contests filtered by type.

Endpoint

http
GET /contests/type/:type

Authentication

Not required - Public endpoint

Parameters

Path Parameters

ParameterTypeRequiredDescription
typestringYesContest type

Contest Types

Codeforces

  • CF - Codeforces Round
  • IOI - IOI-style
  • ICPC - ICPC-style

LeetCode

  • WEEKLY - Weekly Contest
  • BIWEEKLY - Biweekly Contest

CodeChef

  • LONG - Long Challenge
  • COOK_OFF - Cook-Off
  • LUNCH_TIME - Lunchtime
  • STARTERS - Starters

AtCoder

  • ABC - Beginner Contest
  • ARC - Regular Contest
  • AGC - Grand Contest
  • AHC - Heuristic Contest

Examples

bash
# Codeforces rounds
curl http://localhost:3000/contests/type/CF

# LeetCode weekly
curl http://localhost:3000/contests/type/WEEKLY

# AtCoder ABC
curl http://localhost:3000/contests/type/ABC

Response

Returns array of contests with specified type, sorted by start time.

json
[
  {
    "id": "507f1f77bcf86cd799439011",
    "name": "Weekly Contest 380",
    "platform": "leetcode",
    "type": "WEEKLY",
    "startTime": "2024-02-16T02:30:00.000Z",
    "endTime": "2024-02-16T04:00:00.000Z",
    "isActive": true
  }
]

Notes

  • Maximum 50 results
  • Only active contests
  • Types are platform-specific

Built with ❤️ for competitive programmers worldwide.