Skip to main content
API docs by Redocly

Data API (4)

Download OpenAPI specification:Download

License: Property of FACEIT LTD

This API provide access to FACEIT's data

Championships

Retrieve all championships of a game

Retrieve all championships of a game

Authorizations:
key
query Parameters
game
required
string

The id of the game

type
string
Enum: "all" "upcoming" "ongoing" "past"

Kind of matches to return. Can be all(default), upcoming, ongoing or past

offset
integer >= 0
Default: 0

The starting item position

limit
integer [ 1 .. 10 ]
Default: 10

The number of items to return

Responses

Response samples

Content type
application/json
{
  • "end": 0,
  • "items": [
    ],
  • "start": 0
}

Retrieve championship details

Retrieve championship details

Authorizations:
key
path Parameters
championship_id
required
string

The id of the championship

query Parameters
expanded
Array of strings unique
Items Enum: "organizer" "game"

List of entity names to expand in request

Responses

Response samples

Content type
application/json
{
  • "anticheat_required": true,
  • "avatar": "string",
  • "background_image": "string",
  • "championship_id": "string",
  • "championship_start": 0,
  • "checkin_clear": 0,
  • "checkin_enabled": true,
  • "checkin_start": 0,
  • "cover_image": "string",
  • "current_subscriptions": 0,
  • "description": "string",
  • "faceit_url": "string",
  • "featured": true,
  • "full": true,
  • "game_data": {
    },
  • "game_id": "string",
  • "id": "string",
  • "join_checks": {
    },
  • "name": "string",
  • "organizer_data": {
    },
  • "organizer_id": "string",
  • "prizes": [
    ],
  • "region": "string",
  • "rules_id": "string",
  • "schedule": {
    },
  • "screening": {
    },
  • "seeding_strategy": "string",
  • "slots": 0,
  • "status": "string",
  • "stream": {
    },
  • "subscription_end": 0,
  • "subscription_start": 0,
  • "subscriptions_locked": true,
  • "substitution_configuration": {
    },
  • "total_groups": 0,
  • "total_prizes": 0,
  • "total_rounds": 0,
  • "type": "string"
}

Retrieve all matches of a championship

Retrieve all matches of a championship

Authorizations:
key
path Parameters
championship_id
required
string

The id of the championship

query Parameters
type
string
Enum: "all" "upcoming" "ongoing" "past"

Kind of matches to return. Can be all(default), upcoming, ongoing or past

offset
integer >= 0
Default: 0

The starting item position

limit
integer [ 1 .. 100 ]
Default: 20

The number of items to return

Responses

Response samples

Content type
application/json
{
  • "end": 0,
  • "items": [
    ],
  • "start": 0
}

Retrieve all results of a championship

Retrieve all results of a championship

Authorizations:
key
path Parameters
championship_id
required
string

The id of the championship

query Parameters
offset
integer >= 0
Default: 0

The starting item position

limit
integer [ 1 .. 100 ]
Default: 20

The number of items to return

Responses

Response samples

Content type
application/json
{
  • "end": 0,
  • "items": [
    ],
  • "start": 0
}

Retrieve all subscriptions of a championship

Retrieve all subscriptions of a championship

Authorizations:
key
path Parameters
championship_id
required
string

The id of the championship

query Parameters
offset
integer >= 0
Default: 0

The starting item position

limit
integer [ 1 .. 10 ]
Default: 10

The number of items to return

Responses

Response samples

Content type
application/json
{}

Games

Retrieve details of all games on FACEIT

Retrieve details of all games on FACEIT

Authorizations:
key
query Parameters
offset
integer >= 0
Default: 0

The starting item position

limit
integer [ 1 .. 100 ]
Default: 20

The number of items to return

Responses

Response samples

Content type
application/json
{
  • "end": 0,
  • "items": [
    ],
  • "start": 0
}

Retrieve details of all matchmakings of a game on FACEIT

Retrieve details of all matchmakings of a game on FACEIT

Authorizations:
key
path Parameters
game_id
required
string
Example: cs2

The id of the game

query Parameters
region
string
Example: region=EU

The region of the matchmakings

offset
integer >= 0
Default: 0

The starting item position

limit
integer [ 1 .. 100 ]
Default: 20

The number of items to return

Responses

Response samples

Content type
application/json
{
  • "end": 0,
  • "items": [
    ],
  • "start": 0
}

Retrieve game details

Retrieve game details

Authorizations:
key
path Parameters
game_id
required
string

The id of the game

Responses

Response samples

Content type
application/json
{
  • "assets": {
    },
  • "game_id": "string",
  • "long_label": "string",
  • "order": 0,
  • "parent_game_id": "string",
  • "platforms": [
    ],
  • "regions": [
    ],
  • "short_label": "string"
}

Retrieve the details of the parent game, if the game is region-specific

Retrieve the details of the parent game, if the game is region-specific

Authorizations:
key
path Parameters
game_id
required
string

The id of the game

Responses

Response samples

Content type
application/json
{
  • "assets": {
    },
  • "game_id": "string",
  • "long_label": "string",
  • "order": 0,
  • "parent_game_id": "string",
  • "platforms": [
    ],
  • "regions": [
    ],
  • "short_label": "string"
}

Retrieve queues by filters on FACEIT

Retrieve queues by filters on FACEIT. Available only for game developers and queue owners(organizers)

Authorizations:
key
path Parameters
game_id
required
string
Example: csgo

The id of the game

query Parameters
entity_type
required
string
Example: entity_type=hub

The type of the entity

entity_id
required
string

The id of the entity

offset
integer >= 0
Default: 0

The starting item position

limit
integer [ 1 .. 20 ]
Default: 20

The number of items to return

Responses

Response samples

Content type
application/json
{
  • "end": 0,
  • "items": [
    ],
  • "start": 0
}

Retrieve details of a queue on FACEIT

Retrieve details of a queue on FACEIT. Available only for game or queue owners(organizers)

Authorizations:
key
path Parameters
game_id
required
string
Example: cs2

The id of the game

queue_id
required
string

The id of the queue

Responses

Response samples

Content type
application/json
{
  • "adminTool": true,
  • "anticheatRequired": true,
  • "calculateElo": true,
  • "captainSelection": "string",
  • "checkIn": {
    },
  • "entityId": "string",
  • "entityType": "string",
  • "fbiManagement": true,
  • "game": "string",
  • "groupSimilar": true,
  • "id": "string",
  • "joinType": {
    },
  • "lastModified": "2019-08-24T14:15:22Z",
  • "maxSkill": 0,
  • "minSkill": 0,
  • "noOfPlayers": 0,
  • "open": true,
  • "organizerId": "string",
  • "paused": true,
  • "queueAlgorithm": {
    },
  • "queueName": "string",
  • "region": "string",
  • "state": "string",
  • "verifiedMatching": true
}

Retrieve queue bans on FACEIT

Retrieve queue bans on FACEIT. Available only for game or queue owners(organizers)

Authorizations:
key
path Parameters
game_id
required
string
Example: eu

The id of the game

queue_id
required
string

The id of the queue

query Parameters
offset
integer >= 0
Default: 0

The starting item position

limit
integer [ 1 .. 100 ]
Default: 20

The number of items to return

Responses

Response samples

Content type
application/json
{
  • "end": 0,
  • "items": [
    ],
  • "start": 0
}

Retrieve queues by region on FACEIT

Retrieve queues by region on FACEIT. Available only for game developers

Authorizations:
key
path Parameters
game_id
required
string
Example: csgo

The id of the game

region_id
required
string
Example: eu

The id of the region

query Parameters
offset
integer >= 0
Default: 0

The starting item position

limit
integer [ 1 .. 20 ]
Default: 20

The number of items to return

Responses

Response samples

Content type
application/json
{
  • "end": 0,
  • "items": [
    ],
  • "start": 0
}

Hubs

Retrieve hub details

Retrieve hub details

Authorizations:
key
path Parameters
hub_id
required
string

The id of the hub

query Parameters
expanded
Array of strings unique
Items Enum: "organizer" "game"

List of entity names to expand in request

Responses

Response samples

Content type
application/json
{
  • "avatar": "string",
  • "background_image": "string",
  • "chat_room_id": "string",
  • "cover_image": "string",
  • "description": "string",
  • "faceit_url": "string",
  • "game_data": {
    },
  • "game_id": "string",
  • "hub_id": "string",
  • "join_permission": "string",
  • "max_skill_level": 0,
  • "min_skill_level": 0,
  • "name": "string",
  • "organizer_data": {
    },
  • "organizer_id": "string",
  • "players_joined": 0,
  • "region": "string",
  • "rule_id": "string"
}

Retrieve all matches of a hub

Retrieve all matches of a hub

Authorizations:
key
path Parameters
hub_id
required
string

The id of the hub

query Parameters
type
string
Enum: "all" "upcoming" "ongoing" "past"

Kind of matches to return. Can be all(default), upcoming, ongoing or past

offset
integer >= 0
Default: 0

The starting item position

limit
integer [ 1 .. 100 ]
Default: 20

The number of items to return

Responses

Response samples

Content type
application/json
{
  • "end": 0,
  • "items": [
    ],
  • "start": 0
}

Retrieve all members of a hub

Retrieve all members of a hub

Authorizations:
key
path Parameters
hub_id
required
string

The id of the hub

query Parameters
offset
integer [ 0 .. 1000 ]
Default: 0

The starting item position

limit
integer [ 1 .. 50 ]
Default: 50

The number of items to return

Responses

Response samples

Content type
application/json
{
  • "end": 0,
  • "items": [
    ],
  • "start": 0
}

Retrieve all roles members can have in a hub

Retrieve all roles members can have in a hub

Authorizations:
key
path Parameters
hub_id
required
string

The id of the hub

query Parameters
offset
integer [ 0 .. 1000 ]
Default: 0

The starting item position

limit
integer [ 1 .. 50 ]
Default: 50

The number of items to return

Responses

Response samples

Content type
application/json
{
  • "end": 0,
  • "items": [
    ],
  • "start": 0
}

Retrieve rules of a hub

Retrieve rules of a hub

Authorizations:
key
path Parameters
hub_id
required
string

The id of the hub

Responses

Response samples

Content type
application/json
{
  • "body": "string",
  • "game": "string",
  • "name": "string",
  • "organizer": "string",
  • "rule_id": "string"
}

Retrieve statistics of a hub

Retrieve statistics of a hub

Authorizations:
key
path Parameters
hub_id
required
string

The id of the hub

query Parameters
offset
integer >= 0
Default: 0

The starting item position

limit
integer [ 1 .. 100 ]
Default: 20

The number of items to return

Responses

Response samples

Content type
application/json
{
  • "game_id": "string",
  • "players": [
    ]
}

Leaderboards

Retrieve all leaderboards of a championship

Retrieve all leaderboards of a championship

Authorizations:
key
path Parameters
championship_id
required
string

The id of the championship

query Parameters
offset
integer >= 0
Default: 0

The starting item position

limit
integer [ 1 .. 100 ]
Default: 20

The number of items to return

Responses

Response samples

Content type
application/json
{
  • "end": 0,
  • "items": [
    ],
  • "start": 0
}

Retrieve group ranking of a championship

Retrieve group ranking of a championship

Authorizations:
key
path Parameters
championship_id
required
string

The id of the championship

group
required
integer

A group of the championship

query Parameters
offset
integer >= 0
Default: 0

The starting item position

limit
integer [ 1 .. 100 ]
Default: 20

The number of items to return

Responses

Response samples

Content type
application/json
{
  • "end": 0,
  • "items": [
    ],
  • "leaderboard": {
    },
  • "start": 0
}

Retrieve all leaderboards of a hub

Retrieve all leaderboards of a hub

Authorizations:
key
path Parameters
hub_id
required
string

The id of the hub

query Parameters
offset
integer >= 0
Default: 0

The starting item position

limit
integer [ 1 .. 100 ]
Default: 20

The number of items to return

Responses

Response samples

Content type
application/json
{
  • "end": 0,
  • "items": [
    ],
  • "start": 0
}

Retrieve all time ranking of a hub

Retrieve all time ranking of a hub

Authorizations:
key
path Parameters
hub_id
required
string

The id of the hub

query Parameters
offset
integer >= 0
Default: 0

The starting item position

limit
integer [ 1 .. 100 ]
Default: 20

The number of items to return

Responses

Response samples

Content type
application/json
{
  • "end": 0,
  • "items": [
    ],
  • "leaderboard": {
    },
  • "start": 0
}

Retrieve seasonal ranking of a hub

Retrieve seasonal ranking of a hub

Authorizations:
key
path Parameters
hub_id
required
string

The id of the hub

season
required
integer

A season of the hub

query Parameters
offset
integer >= 0
Default: 0

The starting item position

limit
integer [ 1 .. 100 ]
Default: 20

The number of items to return

Responses

Response samples

Content type
application/json
{
  • "end": 0,
  • "items": [
    ],
  • "leaderboard": {
    },
  • "start": 0
}

Retrieve ranking from a leaderboard id

Retrieve ranking from a leaderboard id

Authorizations:
key
path Parameters
leaderboard_id
required
string

The id of the leaderboard

query Parameters
offset
integer >= 0
Default: 0

The starting item position

limit
integer [ 1 .. 100 ]
Default: 20

The number of items to return

Responses

Response samples

Content type
application/json
{
  • "end": 0,
  • "items": [
    ],
  • "leaderboard": {
    },
  • "start": 0
}

Retrieve a players ranking in a leaderboard

Retrieve a players ranking in a leaderboard

Authorizations:
key
path Parameters
leaderboard_id
required
string

The id of the leaderboard

player_id
required
string

The id of the player

Responses

Response samples

Content type
application/json
{
  • "current_streak": 0,
  • "draw": 0,
  • "lost": 0,
  • "played": 0,
  • "player": {
    },
  • "points": 0,
  • "position": 0,
  • "win_rate": 0,
  • "won": 0
}

Leagues

Retrieve details of a league of a matchmaking on FACEIT

Retrieve details of a league of a matchmaking on FACEIT

Authorizations:
key
path Parameters
league_id
required
string

The id of the league

Responses

Response samples

Content type
application/json
{
  • "divisions": [
    ],
  • "game": "string",
  • "id": "string",
  • "min_matches": 0,
  • "region": "string",
  • "season": {
    }
}

Retrieve details of a season of a league on FACEIT

Retrieve details of a season of a league on FACEIT

Authorizations:
key
path Parameters
league_id
required
string
Example: 6e7daaee-8b9d-4fbf-86c4-361fa7e579fc

The id of the league

season_id
required
integer
Example: 1

The id of the season

Responses

Response samples

Content type
application/json
{
  • "divisions": [
    ],
  • "season": {
    }
}

Retrieve details of a player for a given league and season on FACEIT

Retrieve details of a player for a given league and season on FACEIT

Authorizations:
key
path Parameters
league_id
required
string
Example: 6e7daaee-8b9d-4fbf-86c4-361fa7e579fc

The id of the league

season_id
required
integer
Example: 1

The id of the season

player_id
required
string
Example: 6e7daaee-8b9d-4fbf-86c4-361fa7e579fc

The id of the player

Responses

Response samples

Content type
application/json
{
  • "division_name": "string",
  • "division_tier": "string",
  • "division_type": "string",
  • "leaderboard_id": "string",
  • "points": 0,
  • "position": 0
}

Matches

Retrieve match details

Retrieve match details

Authorizations:
key
path Parameters
match_id
required
string

The id of the match

Responses

Response samples

Content type
application/json
{
  • "best_of": 0,
  • "broadcast_start_time": 0,
  • "broadcast_start_time_label": "string",
  • "calculate_elo": true,
  • "chat_room_id": "string",
  • "competition_id": "string",
  • "competition_name": "string",
  • "competition_type": "string",
  • "configured_at": 0,
  • "demo_url": [
    ],
  • "detailed_results": [
    ],
  • "faceit_url": "string",
  • "finished_at": 0,
  • "game": "string",
  • "group": 0,
  • "match_id": "string",
  • "organizer_id": "string",
  • "region": "string",
  • "results": {
    },
  • "round": 0,
  • "scheduled_at": 0,
  • "started_at": 0,
  • "status": "string",
  • "teams": {
    },
  • "version": 0,
  • "voting": null
}

Retrieve statistics of a match

Retrieve statistics of a match

Authorizations:
key
path Parameters
match_id
required
string

The id of the match

Responses

Response samples

Content type
application/json
{
  • "rounds": [
    ]
}

Matchmakings

Retrieve details of a matchmaking of a game on FACEIT

Retrieve details of a matchmaking of a game on FACEIT

Authorizations:
key
path Parameters
matchmaking_id
required
string

The id of the matchmaking

Responses

Response samples

Content type
application/json
{
  • "game": "string",
  • "icon": "string",
  • "id": "string",
  • "league_id": "string",
  • "long_description": "string",
  • "name": "string",
  • "queues": [
    ],
  • "region": "string",
  • "short_description": "string"
}

Organizers

Retrieve organizer details from name

Retrieve organizer details from name

Authorizations:
key
query Parameters
name
required
string

The name of the organizer

Responses

Response samples

Content type
application/json
{
  • "avatar": "string",
  • "cover": "string",
  • "description": "string",
  • "facebook": "string",
  • "faceit_url": "string",
  • "followers_count": 0,
  • "name": "string",
  • "organizer_id": "string",
  • "twitch": "string",
  • "twitter": "string",
  • "type": "string",
  • "vk": "string",
  • "website": "string",
  • "youtube": "string"
}

Retrieve organizer details

Retrieve organizer details

Authorizations:
key
path Parameters
organizer_id
required
string

The id of the organizer

Responses

Response samples

Content type
application/json
{
  • "avatar": "string",
  • "cover": "string",
  • "description": "string",
  • "facebook": "string",
  • "faceit_url": "string",
  • "followers_count": 0,
  • "name": "string",
  • "organizer_id": "string",
  • "twitch": "string",
  • "twitter": "string",
  • "type": "string",
  • "vk": "string",
  • "website": "string",
  • "youtube": "string"
}

Retrieve all championships of an organizer

Retrieve all championships of an organizer

Authorizations:
key
path Parameters
organizer_id
required
string

The id of the organizer

query Parameters
offset
integer >= 0
Default: 0

The starting item position

limit
integer [ 1 .. 100 ]
Default: 20

The number of items to return

Responses

Response samples

Content type
application/json
{
  • "end": 0,
  • "items": [
    ],
  • "start": 0
}

Retrieve all games an organizer is involved with

Retrieve all games an organizer is involved with

Authorizations:
key
path Parameters
organizer_id
required
string

The id of the organizer

Responses

Response samples

Content type
application/json
{
  • "end": 0,
  • "items": [
    ],
  • "start": 0
}

Retrieve all hubs of an organizer

Retrieve all hubs of an organizer

Authorizations:
key
path Parameters
organizer_id
required
string

The id of the organizer

query Parameters
offset
integer [ 0 .. 1000 ]
Default: 0

The starting item position

limit
integer [ 1 .. 50 ]
Default: 50

The number of items to return

Responses

Response samples

Content type
application/json
{
  • "end": 0,
  • "items": [
    ],
  • "start": 0
}

Retrieve all tournaments of an organizer

Retrieve all tournaments of an organizer

Authorizations:
key
path Parameters
organizer_id
required
string

The id of the organizer

query Parameters
type
string
Enum: "past" "upcoming"

Kind of tournament. Can be upcoming(default) or past

offset
integer >= 0
Default: 0

The starting item position

limit
integer [ 1 .. 100 ]
Default: 20

The number of items to return

Responses

Response samples

Content type
application/json
{
  • "end": 0,
  • "items": [
    ],
  • "start": 0
}

Players

Retrieve player details

Retrieve player details

Authorizations:
key
query Parameters
nickname
string

The nickname of the player on FACEIT

game
string

A game on FACEIT

game_player_id
string

The ID of a player on game's platform

Responses

Response samples

Content type
application/json
{
  • "activated_at": "2019-08-24T14:15:22Z",
  • "avatar": "string",
  • "country": "string",
  • "cover_featured_image": "string",
  • "cover_image": "string",
  • "faceit_url": "string",
  • "friends_ids": [
    ],
  • "games": {
    },
  • "infractions": null,
  • "membership_type": "string",
  • "memberships": [
    ],
  • "new_steam_id": "string",
  • "nickname": "string",
  • "platforms": {
    },
  • "player_id": "string",
  • "settings": {
    },
  • "steam_id_64": "string",
  • "steam_nickname": "string",
  • "verified": true
}

Retrieve player details

Retrieve player details

Authorizations:
key
path Parameters
player_id
required
string

The id of the player

Responses

Response samples

Content type
application/json
{
  • "activated_at": "2019-08-24T14:15:22Z",
  • "avatar": "string",
  • "country": "string",
  • "cover_featured_image": "string",
  • "cover_image": "string",
  • "faceit_url": "string",
  • "friends_ids": [
    ],
  • "games": {
    },
  • "infractions": null,
  • "membership_type": "string",
  • "memberships": [
    ],
  • "new_steam_id": "string",
  • "nickname": "string",
  • "platforms": {
    },
  • "player_id": "string",
  • "settings": {
    },
  • "steam_id_64": "string",
  • "steam_nickname": "string",
  • "verified": true
}

Retrieve all bans of a player

Retrieve all bans of a player

Authorizations:
key
path Parameters
player_id
required
string

The id of the player

query Parameters
offset
integer >= 0
Default: 0

The starting item position

limit
integer [ 1 .. 100 ]
Default: 20

The number of items to return

Responses

Response samples

Content type
application/json
{
  • "end": 0,
  • "items": [
    ],
  • "start": 0
}

Retrieve statistics of a player for a given amount of matches

Retrieve statistics of a player for a given amount of matches

Authorizations:
key
path Parameters
player_id
required
string

The id of the player

game_id
required
string
Example: csgo

A game on FACEIT

query Parameters
offset
integer [ 0 .. 200 ]
Default: 0

The starting item position

limit
integer [ 1 .. 100 ]
Default: 20

The number of items to return

from
integer

Used to filter the dataset by date (minimum). Expected value is date ("items.stats.Match Finished At") in epoch milliseconds.

to
integer

Used to filter the dataset by date (maximum). Expected value is date ("items.stats.Match Finished At") in epoch milliseconds.

Responses

Response samples

Content type
application/json
{
  • "end": 0,
  • "items": [
    ],
  • "start": 0
}

Retrieve all matches of a player

Retrieve all matches of a player

Authorizations:
key
path Parameters
player_id
required
string

The id of the player

query Parameters
game
required
string

A game on FACEIT

from
integer >= 0

The timestamp (Unix time) as lower bound of the query. 1 month ago if not specified

to
integer >= 0

The timestamp (Unix time) as higher bound of the query. Current timestamp if not specified

offset
integer [ 0 .. 1000 ]
Default: 0

The starting item position

limit
integer [ 1 .. 100 ]
Default: 20

The number of items to return

Responses

Response samples

Content type
application/json
{
  • "end": 0,
  • "from": 0,
  • "items": [
    ],
  • "start": 0,
  • "to": 0
}

Retrieve all hubs of a player

Retrieve all hubs of a player

Authorizations:
key
path Parameters
player_id
required
string

The id of the player

query Parameters
offset
integer [ 0 .. 1000 ]
Default: 0

The starting item position

limit
integer [ 1 .. 50 ]
Default: 50

The number of items to return

Responses

Response samples

Content type
application/json
{
  • "end": 0,
  • "items": [
    ],
  • "start": 0
}

Retrieve statistics of a player

Retrieve statistics of a player

Authorizations:
key
path Parameters
player_id
required
string

The id of the player

game_id
required
string

A game on FACEIT

Responses

Response samples

Content type
application/json
{
  • "game_id": "string",
  • "lifetime": {
    },
  • "player_id": "string",
  • "segments": [
    ]
}

Retrieve all teams of a player

Retrieve all teams of a player

Authorizations:
key
path Parameters
player_id
required
string

The id of the player

query Parameters
offset
integer >= 0
Default: 0

The starting item position

limit
integer [ 1 .. 100 ]
Default: 20

The number of items to return

Responses

Response samples

Content type
application/json
{}

Retrieve all tournaments of a player

Retrieve all tournaments of a player

Authorizations:
key
path Parameters
player_id
required
string

The id of the player

query Parameters
offset
integer >= 0
Default: 0

The starting item position

limit
integer [ 1 .. 100 ]
Default: 20

The number of items to return

Responses

Response samples

Content type
application/json
{
  • "end": 0,
  • "items": [
    ],
  • "start": 0
}

Rankings

Retrieve global ranking of a game

Retrieve global ranking of a game

Authorizations:
key
path Parameters
game_id
required
string

The id of the game

region
required
string

A region of a game

query Parameters
country
string

A country code (ISO 3166-1)

offset
integer >= 0
Default: 0

The starting item position

limit
integer [ 1 .. 100 ]
Default: 20

The number of items to return

Responses

Response samples

Content type
application/json
{
  • "end": 0,
  • "items": [
    ],
  • "start": 0
}

Retrieve user position in the global ranking of a game

Retrieve user position in the global ranking of a game

Authorizations:
key
path Parameters
game_id
required
string

The id of the game

region
required
string

A region of a game

player_id
required
string

The id of a player

query Parameters
country
string

A country code (ISO 3166-1)

limit
integer [ 1 .. 100 ]
Default: 20

The number of items to return

Responses

Response samples

Content type
application/json
{
  • "end": 0,
  • "items": [
    ],
  • "position": 0,
  • "start": 0
}

Search

Search for championships

Search for championships

Authorizations:
key
query Parameters
name
required
string

The name of a championship on FACEIT

game
string

A game on FACEIT

region
string

A region of the game

type
string
Enum: "all" "upcoming" "ongoing" "past"

Kind of competitions to return

offset
integer >= 0
Default: 0

The starting item position

limit
integer [ 1 .. 100 ]
Default: 20

The number of items to return

Responses

Response samples

Content type
application/json
{
  • "end": 0,
  • "items": [
    ],
  • "start": 0
}

Search for clans

Search for clans

Authorizations:
key
query Parameters
name
required
string

The name of a clan on FACEIT

game
string

A game on FACEIT

region
string

A region of the game

offset
integer >= 0
Default: 0

The starting item position

limit
integer [ 1 .. 100 ]
Default: 20

The number of items to return

Responses

Response samples

Content type
application/json
{
  • "end": 0,
  • "items": [
    ],
  • "start": 0
}

Search for hubs

Search for hubs

Authorizations:
key
query Parameters
name
required
string

The name of a hub on FACEIT

game
string

A game on FACEIT

region
string

A region of the game

offset
integer >= 0
Default: 0

The starting item position

limit
integer [ 1 .. 100 ]
Default: 20

The number of items to return

Responses

Response samples

Content type
application/json
{
  • "end": 0,
  • "items": [
    ],
  • "start": 0
}

Search for organizers

Search for organizers

Authorizations:
key
query Parameters
name
required
string

The name of a organizer on FACEIT

offset
integer >= 0
Default: 0

The starting item position

limit
integer [ 1 .. 100 ]
Default: 20

The number of items to return

Responses

Response samples

Content type
application/json
{
  • "end": 0,
  • "items": [
    ],
  • "start": 0
}

Search for players

Search for players

Authorizations:
key
query Parameters
nickname
required
string

The nickname of a player on FACEIT

game
string

A game on FACEIT

country
string

A country code (ISO 3166-1)

offset
integer >= 0
Default: 0

The starting item position

limit
integer [ 1 .. 100 ]
Default: 20

The number of items to return

Responses

Response samples

Content type
application/json
{
  • "end": 0,
  • "items": [
    ],
  • "start": 0
}

Search for teams

Search for teams

Authorizations:
key
query Parameters
nickname
required
string

The nickname of a team on FACEIT

game
string

A game on FACEIT

offset
integer >= 0
Default: 0

The starting item position

limit
integer [ 1 .. 100 ]
Default: 20

The number of items to return

Responses

Response samples

Content type
application/json
{
  • "end": 0,
  • "items": [
    ],
  • "start": 0
}

Search for tournaments

Search for tournaments

Authorizations:
key
query Parameters
name
required
string

The name of a tournament on FACEIT

game
string

A game on FACEIT

region
string

A region of the game

type
string
Enum: "all" "upcoming" "ongoing" "past"

Kind of competitions to return

offset
integer >= 0
Default: 0

The starting item position

limit
integer [ 1 .. 100 ]
Default: 20

The number of items to return

Responses

Response samples

Content type
application/json
{
  • "end": 0,
  • "items": [
    ],
  • "start": 0
}

Teams

Retrieve team details

Retrieve team details

Authorizations:
key
path Parameters
team_id
required
string

The id of the team

Responses

Response samples

Content type
application/json
{}

Retrieve statistics of a team

Retrieve statistics of a team

Authorizations:
key
path Parameters
team_id
required
string

The id of the team

game_id
required
string

A game on FACEIT

Responses

Response samples

Content type
application/json
{
  • "game_id": "string",
  • "lifetime": {
    },
  • "segments": [
    ],
  • "team_id": "string"
}

Retrieve tournaments of a team

Retrieve tournaments of a team

Authorizations:
key
path Parameters
team_id
required
string

The id of the team

query Parameters
offset
integer >= 0
Default: 0

The starting item position

limit
integer [ 1 .. 100 ]
Default: 20

The number of items to return

Responses

Response samples

Content type
application/json
{
  • "end": 0,
  • "items": [
    ],
  • "start": 0
}

Tournaments

Retrieve tournaments v1 (no longer used)

Retrieve tournaments v1 (no longer used). Please refer to the Championships controller to retrieve tournaments v2

Authorizations:
key
query Parameters
game
string

A game on FACEIT

region
string

A region of the game

offset
integer >= 0
Default: 0

The starting item position

limit
integer [ 1 .. 100 ]
Default: 20

The number of items to return

Responses

Response samples

Content type
application/json
{
  • "end": 0,
  • "items": [
    ],
  • "start": 0
}

Retrieve tournament details

Retrieve tournament details

Authorizations:
key
path Parameters
tournament_id
required
string

The id of the tournament

query Parameters
expanded
Array of strings unique
Items Enum: "organizer" "game"

List of entity names to expand in request

Responses

Response samples

Content type
application/json
{
  • "anticheat_required": true,
  • "best_of": null,
  • "calculate_elo": true,
  • "competition_id": "string",
  • "cover_image": "string",
  • "custom": true,
  • "description": "string",
  • "faceit_url": "string",
  • "featured_image": "string",
  • "game_data": {
    },
  • "game_id": "string",
  • "invite_type": "string",
  • "match_type": "string",
  • "max_skill": 0,
  • "membership_type": "string",
  • "min_skill": 0,
  • "name": "string",
  • "number_of_players": 0,
  • "number_of_players_checkedin": 0,
  • "number_of_players_joined": 0,
  • "number_of_players_participants": 0,
  • "organizer_data": {
    },
  • "organizer_id": "string",
  • "prize_type": "string",
  • "region": "string",
  • "rounds": [
    ],
  • "rule": "string",
  • "started_at": 0,
  • "status": "string",
  • "substitutes_allowed": 0,
  • "substitutions_allowed": 0,
  • "team_size": 0,
  • "total_prize": null,
  • "tournament_id": "string",
  • "voting": null,
  • "whitelist_countries": [
    ]
}

Retrieve brackets of a tournament

Retrieve brackets of a tournament

Authorizations:
key
path Parameters
tournament_id
required
string

The id of the tournament

Responses

Response samples

Content type
application/json
{
  • "game": "string",
  • "matches": [
    ],
  • "name": "string",
  • "rounds": [
    ],
  • "status": "string"
}

Retrieve all matches of a tournament

Retrieve all matches of a tournament

Authorizations:
key
path Parameters
tournament_id
required
string

The id of the tournament

query Parameters
offset
integer >= 0
Default: 0

The starting item position

limit
integer [ 1 .. 100 ]
Default: 20

The number of items to return

Responses

Response samples

Content type
application/json
{
  • "end": 0,
  • "items": [
    ],
  • "start": 0
}

Retrieve all teams of a tournament

Retrieve all teams of a tournament

Authorizations:
key
path Parameters
tournament_id
required
string

The id of the tournament

query Parameters
offset
integer >= 0
Default: 0

The starting item position

limit
integer [ 1 .. 100 ]
Default: 20

The number of items to return

Responses

Response samples

Content type
application/json
{
  • "checked_in": [
    ],
  • "finished": [
    ],
  • "joined": [
    ],
  • "started": [
    ]
}