Returns a list of comments to the specified blog entry.
| Parameter | Description |
|---|---|
| blogEntryId (Required) | Id of the blog entry. It can be seen in blog entry URL. For example: /blog/entry/79 |
Return value: A list of Comment objects.
Example: https://mirror.codeforces.com/api/blogEntry.comments?blogEntryId=79
Returns blog entry.
| Parameter | Description |
|---|---|
| blogEntryId (Required) | Id of the blog entry. It can be seen in blog entry URL. For example: /blog/entry/79 |
Return value: Returns a BlogEntry object in full version.
Example: https://mirror.codeforces.com/api/blogEntry.view?blogEntryId=79
Returns list of hacks in the specified contests. Full information about hacks is available only after some time after the contest end. During the contest user can see only own hacks.
| Parameter | Description |
|---|---|
| contestId (Required) | Id of the contest. It is not the round number. It can be seen in contest URL. For example: /contest/566/status |
| asManager | Boolean. If set to true, the response will contain information available to contest managers. Otherwise, the response will contain only the information available to the participants. You must be a contest manager to use it. |
Return value: Returns a list of Hack objects.
Example: https://mirror.codeforces.com/api/contest.hacks?contestId=566
Returns information about all available contests.
| Parameter | Description |
|---|---|
| gym | Boolean. If true — than gym contests are returned. Otherwide, regular contests are returned. |
| groupCode | Group code (e.g., sfSJn5pz1a) is used to filter contests. You need to log in with an account that has at least read access to the group. |
Return value: Returns a list of Contest objects. If this method is called not anonymously, then all available contests for a calling user will be returned too, including mashups and private gyms.
Example: https://mirror.codeforces.com/api/contest.list?gym=true
Returns rating changes after the contest.
| Parameter | Description |
|---|---|
| contestId (Required) | Id of the contest. It is not the round number. It can be seen in contest URL. For example: /contest/566/status |
Return value: Returns a list of RatingChange objects.
Example: https://mirror.codeforces.com/api/contest.ratingChanges?contestId=566
Returns the contest description and standings.
For gym and mashup contests, this method is available only through an authenticated API request from a user who can view the contest. Optional parameters may be used to page or filter the returned standings.
For regular contests, ordinary and anonymous users can request standings only for public contests, and only by an anonymous GET request with exactly one query parameter: contestId. Use https://mirror.codeforces.com/api/contest.standings?contestId=<id>.
In this regular contest mode, the response contains the full official public standings only. Do not specify from, count, handles, room, showUnofficial, participantTypes, API authentication parameters, or any other parameters. Non-public regular contests and regular contests with hidden standings are not available through this public mode.
| Parameter | Description |
|---|---|
| contestId (Required) | Id of the contest. It is not the round number. It can be seen in contest URL. For example: /contest/566/status |
| asManager | Boolean. If set to true, the response will contain information available to contest managers. Otherwise, the response will contain only the information available to the participants. You must be a contest manager to use it. |
| from | 1-based index of the standings row to start the ranklist. |
| count | Number of standing rows to return. |
| handles | Semicolon-separated list of handles. No more than 10000 handles is accepted. |
| room | If specified, than only participants from this room will be shown in the result. If not — all the participants will be shown. |
| showUnofficial | If true than all participants (virtual, out of competition) are shown. Otherwise, only official contestants are shown. |
| participantTypes | Comma-separated list of participant types without spaces. Possible values: CONTESTANT, PRACTICE, VIRTUAL, MANAGER, OUT_OF_COMPETITION. Only participants with the specified types will be displayed. |
Return value: Returns object with three fields: "contest", "problems" and "rows". Field "contest" contains a Contest object. Field "problems" contains a list of Problem objects. Field "rows" contains a list of RanklistRow objects.
Example: https://mirror.codeforces.com/api/contest.standings?contestId=566
Returns submissions for specified contest. Optionally can return submissions of specified user.
| Parameter | Description |
|---|---|
| contestId (Required) | Id of the contest. It is not the round number. It can be seen in contest URL. For example: /contest/566/status |
| asManager | Boolean. If set to true, the response will contain information available to contest managers. Otherwise, the response will contain only the information available to the participants. You must be a contest manager to use it. |
| handle | Codeforces user handle. |
| from | 1-based index of the first submission to return. |
| count | Number of returned submissions. |
| includeSources | Specifies whether to include source codes in the output. Available only when using asManager and if the user has manager permissions for the contest. |
Return value: Returns a list of Submission objects, sorted in decreasing order of submission id.
Example: https://mirror.codeforces.com/api/contest.status?contestId=566&from=1&count=10
Returns whether the specified users are managers of the given group. This method is available only to authorized API users.
| Parameter | Description |
|---|---|
| groupCode (Required) | Group code. |
| handles (Required) | Semicolon-separated list of handles. No more than 10000 handles is accepted. |
Return value: A map from user handles to boolean values indicating whether each user is a manager of the group.
Returns all problems from problemset. Problems can be filtered by tags.
| Parameter | Description |
|---|---|
| tags | Semicilon-separated list of tags. |
| problemsetName | Custom problemset's short name, like 'acmsguru' |
Return value: Returns two lists. List of Problem objects and list of ProblemStatistics objects.
Example: https://mirror.codeforces.com/api/problemset.problems?tags=implementation
Returns recent submissions.
| Parameter | Description |
|---|---|
| count (Required) | Number of submissions to return. Can be up to 1000. |
| problemsetName | Custom problemset's short name, like 'acmsguru' |
Return value: Returns a list of Submission objects, sorted in decreasing order of submission id.
Example: https://mirror.codeforces.com/api/problemset.recentStatus?count=10
Returns recent actions.
| Parameter | Description |
|---|---|
| maxCount (Required) | Number of recent actions to return. Can be up to 100. |
Return value: Returns a list of RecentAction objects.
Example: https://mirror.codeforces.com/api/recentActions?maxCount=30
The system.status method provides a real-time health check (Health Check) of the system’s core infrastructure and processing pipeline. It returns the current availability status of internal services and key performance metrics (throughput) from the last 5 minutes.
| Parameter | Description |
|---|
Return value: Returns a JSON object representing the real-time health status of core infrastructure components and system throughput metrics for the last 5 minutes.
Example: https://mirror.codeforces.com/api/system.status
Returns a list of all user's blog entries.
| Parameter | Description |
|---|---|
| handle (Required) | Codeforces user handle. |
Return value: A list of BlogEntry objects in short form.
Example: https://mirror.codeforces.com/api/user.blogEntries?handle=Fefer_Ivan
Returns authorized user's friends. Using this method requires authorization.
| Parameter | Description |
|---|---|
| onlyOnline | Boolean. If true — only online friends are returned. Otherwise, all friends are returned. |
Return value: Returns a list of strings — users' handles.
Example: https://mirror.codeforces.com/api/user.friends?onlyOnline=true
Returns information about one or several users.
| Parameter | Description |
|---|---|
| handles (Required) | Semicolon-separated list of handles. No more than 10000 handles is accepted. |
| checkHistoricHandles | Boolean, the default value is true. If this flag is enabled, then use the history of handle changes when searching for a user. |
Return value: Returns a list of User objects for requested handles, in same order as in parameters.
Example: https://mirror.codeforces.com/api/user.info?handles=DmitriyH;Fefer_Ivan&checkHistoricHandles=false
Returns the list users who have participated in at least one rated contest.
| Parameter | Description |
|---|---|
| activeOnly | Boolean. If true then only users, who participated in rated contest during the last month are returned. Otherwise, all users with at least one rated contest are returned. |
| includeRetired | Boolean. If true, the method returns all rated users, otherwise the method returns only users, that were online at last month. |
| contestId | Id of the contest. It is not the round number. It can be seen in contest URL. For example: /contest/566/status |
Return value: Returns a list of User objects, sorted in decreasing order of rating.
Example: https://mirror.codeforces.com/api/user.ratedList?activeOnly=true&includeRetired=false
Returns rating history of the specified user.
| Parameter | Description |
|---|---|
| handle (Required) | Codeforces user handle. |
Return value: Returns a list of RatingChange objects for requested user.
Example: https://mirror.codeforces.com/api/user.rating?handle=Fefer_Ivan
Returns submissions of specified user.
| Parameter | Description |
|---|---|
| handle (Required) | Codeforces user handle. |
| from | 1-based index of the first submission to return. |
| count | Number of returned submissions. |
| includeSources | Specifies whether source codes should be included in the output. This option is only available when requested for your own account. |
Return value: Returns a list of Submission objects, sorted in decreasing order of submission id.
Example: https://mirror.codeforces.com/api/user.status?handle=Fefer_Ivan&from=1&count=10
