API Documentation
Codeforces Home
API Reference

Codeforces

Codeforces is a competitive programming platform that hosts regular contests and provides a wide range of problems for programmers to solve.

Back to Platforms Refresh Docs
5
Platforms
22
Endpoints
ACTIVE
Platform Status

Endpoint Overview

A template-style view of the available API surface for this platform.

22 total

endpoints

GET
GET /api/codeforces/endpoints

List every exposed Codeforces endpoint.

Route Name
endpoints
Action
endpoints
Method
GET
GET
Query Params
Headers
Edit params, headers, or the URL itself, then send the request to inspect the live response.
Waiting to send a request.
READY
Press “Send Request” to call this endpoint.

health

GET
GET /api/codeforces/health

Check Codeforces API availability.

Route Name
health
Action
health
Method
GET
GET
Query Params
Headers
Edit params, headers, or the URL itself, then send the request to inspect the live response.
Waiting to send a request.
READY
Press “Send Request” to call this endpoint.

api

GET
GET /api/codeforces/api

Pass through any Codeforces API method.

Route Name
api
Action
api
Method
GET
Try this endpoint
Query Parameters
method string required
Codeforces API method name
Example: contest.list
gym boolean optional
Include gym contests (if applicable)
Example: false
GET
Query Params
Headers
Edit params, headers, or the URL itself, then send the request to inspect the live response.
Waiting to send a request.
READY
Press “Send Request” to call this endpoint.

contests

GET
GET /api/codeforces/contests

List contests, including gym contests when requested.

Route Name
contests
Action
contests
Method
GET
Try this endpoint
Query Parameters
gym boolean optional
Include gym contests
Example: false
GET
Query Params
Headers
Edit params, headers, or the URL itself, then send the request to inspect the live response.
Waiting to send a request.
READY
Press “Send Request” to call this endpoint.

standings

GET
GET /api/codeforces/contests/{contestId}/standings

Fetch contest standings.

Route Name
standings
Action
standings
Method
GET
Try this endpoint
Path Parameters
contestId integer required
Contest ID
Example: 1234
Query Parameters
from integer optional
Starting position (1-indexed)
Example: 1
count integer optional
Number of results
Example: 20
showUnofficial boolean optional
Include unofficial participants
Example: false
GET
Query Params
Headers
Edit params, headers, or the URL itself, then send the request to inspect the live response.
Waiting to send a request.
READY
Press “Send Request” to call this endpoint.

contest.status

GET
GET /api/codeforces/contests/{contestId}/status

Fetch contest submissions.

Route Name
contest.status
Action
contestStatus
Method
GET
Try this endpoint
Path Parameters
contestId integer required
Contest ID
Example: 1234
Query Parameters
from integer optional
Starting position
Example: 1
count integer optional
Number of results
Example: 20
GET
Query Params
Headers
Edit params, headers, or the URL itself, then send the request to inspect the live response.
Waiting to send a request.
READY
Press “Send Request” to call this endpoint.

rating-changes

GET
GET /api/codeforces/contests/{contestId}/rating-changes

Fetch rating changes for a contest.

Route Name
rating-changes
Action
ratingChanges
Method
GET
Try this endpoint
Path Parameters
contestId integer required
Contest ID
Example: 1234
GET
Query Params
Headers
Edit params, headers, or the URL itself, then send the request to inspect the live response.
Waiting to send a request.
READY
Press “Send Request” to call this endpoint.

hacks

GET
GET /api/codeforces/contests/{contestId}/hacks

Fetch contest hacks.

Route Name
hacks
Action
contestHacks
Method
GET
Try this endpoint
Path Parameters
contestId integer required
Contest ID
Example: 1234
Query Parameters
from integer optional
Starting position
Example: 1
count integer optional
Number of results
Example: 20
GET
Query Params
Headers
Edit params, headers, or the URL itself, then send the request to inspect the live response.
Waiting to send a request.
READY
Press “Send Request” to call this endpoint.

profiles

GET
GET /api/codeforces/profiles

Fetch multiple profiles by handle list.

Route Name
profiles
Action
profiles
Method
GET
Try this endpoint
Query Parameters
handles string required
Comma-separated handles
Example: tourist,gennady.korotkevich
GET
Query Params
Headers
Edit params, headers, or the URL itself, then send the request to inspect the live response.
Waiting to send a request.
READY
Press “Send Request” to call this endpoint.

profile

GET
GET /api/codeforces/profiles/{handle}

Fetch a single profile.

Route Name
profile
Action
profile
Method
GET
Try this endpoint
Path Parameters
handle string required
User handle
Example: tourist
GET
Query Params
Headers
Edit params, headers, or the URL itself, then send the request to inspect the live response.
Waiting to send a request.
READY
Press “Send Request” to call this endpoint.

submissions

GET
GET /api/codeforces/profiles/{handle}/submissions

Fetch a user submission history.

Route Name
submissions
Action
submissions
Method
GET
Try this endpoint
Path Parameters
handle string required
User handle
Example: tourist
Query Parameters
from integer optional
Starting position
Example: 1
count integer optional
Number of results
Example: 20
GET
Query Params
Headers
Edit params, headers, or the URL itself, then send the request to inspect the live response.
Waiting to send a request.
READY
Press “Send Request” to call this endpoint.

ratings

GET
GET /api/codeforces/profiles/{handle}/ratings

Fetch user rating history.

Route Name
ratings
Action
ratings
Method
GET
Try this endpoint
Path Parameters
handle string required
User handle
Example: tourist
GET
Query Params
Headers
Edit params, headers, or the URL itself, then send the request to inspect the live response.
Waiting to send a request.
READY
Press “Send Request” to call this endpoint.

user.status

GET
GET /api/codeforces/profiles/{handle}/status

Fetch user submissions.

Route Name
user.status
Action
userStatus
Method
GET
Try this endpoint
Path Parameters
handle string required
User handle
Example: tourist
Query Parameters
from integer optional
Starting position
Example: 1
count integer optional
Number of results
Example: 20
GET
Query Params
Headers
Edit params, headers, or the URL itself, then send the request to inspect the live response.
Waiting to send a request.
READY
Press “Send Request” to call this endpoint.

blogs

GET
GET /api/codeforces/profiles/{handle}/blogs

Fetch blog entries authored by a user.

Route Name
blogs
Action
userBlogEntries
Method
GET
Try this endpoint
Path Parameters
handle string required
User handle
Example: tourist
GET
Query Params
Headers
Edit params, headers, or the URL itself, then send the request to inspect the live response.
Waiting to send a request.
READY
Press “Send Request” to call this endpoint.

user.rated-list

GET
GET /api/codeforces/user/rated-list

Fetch the rated users list.

Route Name
user.rated-list
Action
userRatedList
Method
GET
Try this endpoint
Query Parameters
activeOnly boolean optional
Only active users
Example: false
includeRetired boolean optional
Include retired users
Example: false
GET
Query Params
Headers
Edit params, headers, or the URL itself, then send the request to inspect the live response.
Waiting to send a request.
READY
Press “Send Request” to call this endpoint.

user.friends

GET
GET /api/codeforces/user/friends

Fetch the current user friends list.

Route Name
user.friends
Action
userFriends
Method
GET
Try this endpoint
Query Parameters
onlyOnline boolean optional
Only online friends
Example: false
GET
Query Params
Headers
Edit params, headers, or the URL itself, then send the request to inspect the live response.
Waiting to send a request.
READY
Press “Send Request” to call this endpoint.

problems

GET
GET /api/codeforces/problems

Fetch problemset metadata.

Route Name
problems
Action
problems
Method
GET
Try this endpoint
Query Parameters
tags string optional
Comma-separated problem tags
Example: dp,greedy
GET
Query Params
Headers
Edit params, headers, or the URL itself, then send the request to inspect the live response.
Waiting to send a request.
READY
Press “Send Request” to call this endpoint.

problems.recent-status

GET
GET /api/codeforces/problems/recent-status

Fetch recent problemset submissions.

Route Name
problems.recent-status
Action
problemsRecentStatus
Method
GET
Try this endpoint
Query Parameters
count integer optional
Number of results (max 100)
Example: 20
GET
Query Params
Headers
Edit params, headers, or the URL itself, then send the request to inspect the live response.
Waiting to send a request.
READY
Press “Send Request” to call this endpoint.

blog.view

GET
GET /api/codeforces/blog-entries/{blogEntryId}

Fetch a blog entry.

Route Name
blog.view
Action
blogEntryView
Method
GET
Try this endpoint
Path Parameters
blogEntryId integer required
Blog entry ID
Example: 123456
GET
Query Params
Headers
Edit params, headers, or the URL itself, then send the request to inspect the live response.
Waiting to send a request.
READY
Press “Send Request” to call this endpoint.

blog.comments

GET
GET /api/codeforces/blog-entries/{blogEntryId}/comments

Fetch blog entry comments.

Route Name
blog.comments
Action
blogEntryComments
Method
GET
Try this endpoint
Path Parameters
blogEntryId integer required
Blog entry ID
Example: 123456
GET
Query Params
Headers
Edit params, headers, or the URL itself, then send the request to inspect the live response.
Waiting to send a request.
READY
Press “Send Request” to call this endpoint.

group.is-manager

GET
GET /api/codeforces/group/is-manager

Check whether handles manage a group.

Route Name
group.is-manager
Action
groupIsManager
Method
GET
Try this endpoint
Query Parameters
handles string required
Comma-separated handles
Example: tourist
groupCode string optional
Group code to check
GET
Query Params
Headers
Edit params, headers, or the URL itself, then send the request to inspect the live response.
Waiting to send a request.
READY
Press “Send Request” to call this endpoint.

recent-actions

GET
GET /api/codeforces/recent-actions

Fetch recent Codeforces actions.

Route Name
recent-actions
Action
recentActions
Method
GET
Try this endpoint
Query Parameters
maxCount integer optional
Maximum number of actions
Example: 100
GET
Query Params
Headers
Edit params, headers, or the URL itself, then send the request to inspect the live response.
Waiting to send a request.
READY
Press “Send Request” to call this endpoint.