PandaScore REST API (2.11.1)

Download OpenAPI specification:Download

Introduction

Whether you're looking to build an official Pandascore integration for your service, or you just want to build something awesome, we can help you get started.

The API works over the HTTPS protocol, and is accessed from the api.pandascore.co domain.

  • The current endpoint is https://api.pandascore.co.
  • All data is sent and received as JSON by default.
  • Blank fields are included with null values instead of being omitted.
  • All timestamps are returned in ISO-8601 format

Events hierarchy

The PandaScore API allows you to access data about eSports events by using a certain structure detailed below.

Leagues

Leagues are the top level events. They don't have a date and represent a regular competition. A League is composed of one or several series.
Some League of Legends leagues are: EU LCS, NA LCS, LCK, etc.
Some Dota 2 leagues are: ESL One, GESC, The International, PGL, etc.

Series

A Serie represents an occurrence of a league event.
The EU LCS league has two series per year: spring 2017, summer 2017, spring 2016, summer 2016 etc.
Some Dota2 Series examples would be: Changsha Major, Open Bucharest, Frankfurt, i-League Invitational etc.

Tournaments

Tournaments groups all the matches of a serie under "stages" and "groups".
The tournaments of the EU LCS of summer 2017 are: Group A, Group B, Playoffs, etc.
Some Dota 2 tournaments are: Group A, Group B, Playoffs, etc.

Matches

Finally we have matches which have two players or teams (depending on the played videogame) and several games (the rounds of the match).
Matches of the group A in the EU LCS of summer 2017 are: G2 vs FNC, MSF vs NIP, etc.
Matches of the group A in the ESL One, Genting tournamnet are: Lower Round 1, Quarterfinal, Upper Final, etc.

Please note that some matches may be listed as "TBD vs TBD" if the matchup is not announced yet, for example the date of the Final match is known but the quarterfinal is still being played.
Structure

Access tokens

The authentication on the Pandascore API works with access tokens.

All developers need to create an account before getting started, in order to get an access token. The access token should not be shared.

Your token can be found and regenerated from your dashboard.

The access token can be passed in the URL with the token query string parameter, or in the Authorization: Bearer header field.

Formats

The API currently supports the JSON format by default.

Other formats may be added depending on user needs.

Pagination

The Pandascore API paginates all resources on the index method.

Requests that return multiple items will be paginated to 50 items by default. You can specify further pages with the page[number] parameter. You can also set a custom page size (up to 100) with the page[size] parameter.

The Link HTTP response header contains pagination data with first, previous, next and last raw page links when available, under the format

Link: <https://api.pandascore.co/{Resource}?page=X+1>; rel="next", <https://api.pandascore.co/{Resource}?page=X-1>; rel="prev", <https://api.pandascore.co/{Resource}?page=1>; rel="first", <https://api.pandascore.co/{Resource}?page=X+n>; rel="last"

There is also:

  • A X-Page header field, which contains the current page.
  • A X-Per-Page header field, which contains the current pagination length.
  • A X-Total header field, which contains the total count of items across all pages.

Filtering

The filter query parameter can be used to filter a collection by one or several fields for one or several values. The filter parameter takes the field to filter as a key, and the values to filter as the value. Multiples values must be comma-separated (,).

For example, the following is a request for all the champions with a name matching Twitch or Brand exactly, but only with 21 armor:

GET /lol/champions?filter[name]=Brand,Twitch&filter[armor]=21&token=YOUR_ACCESS_TOKEN

Range

The range parameter is a hash that allows filtering fields by an interval. Only values between the given two comma-separated bounds will be returned. The bounds are inclusive.

For example, the following is a request for all the champions with hp within 500 and 1000:

GET /lol/champions?range[hp]=500,1000&token=YOUR_ACCESS_TOKEN

Search

The search parameter is a bit like the filter parameter, but it will return all results where the values contain the given parameter.

Note: this only works on strings. Searching with integer values is not supported and filter or range parameters may be better suited for your needs here.

For example, to get all the champions with a name containing "twi":

# curl -sg -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' 'https://api.pandascore.co/lol/champions?search[name]=twi' | jq -S '.[].name'
"Twitch"
"Twisted Fate"

Sorting

All index endpoints support multiple sort fields with comma-separation (,); the fields are applied in the order specified.

The sort order for each field is ascending unless it is prefixed with a minus (U+002D HYPHEN-MINUS, β€œ-β€œ), in which case it is descending.

For example, GET /lol/champions?sort=attackdamage,-name&token=YOUR_ACCESS_TOKEN will return all the champions sorted by attack damage. Any champions with the same attack damage will then be sorted by their names in descending alphabetical order.

Rate limiting

Depending on your current plan, you will have a different rate limit. Your plan and your current request count are available on your dashboard.

With the free plan, you have a limit of 1000 requests per hour, others plans have a limit of 4000 requests per hour. The number of remaining requests is available in the X-Rate-Limit-Remaining response header.

Your API key is included in all the examples on this page, so you can test any example right away. Only you can see this value.

Authentication

BearerToken

Security scheme type: HTTP
HTTP Authorization Scheme bearer

QueryToken

Security scheme type: API Key
Query parameter name: token

Leagues

List leagues

List leagues

Authorizations:
query Parameters
filter
object (filter_over_Leagues)

Options to filter results

page
integer or object

Pagination

per_page
integer [ 1 .. 100 ]
Default: 50

Equivalent to page[size]

range
object (range_over_Leagues)

Options to select results within ranges

sort
Array of any (sort_over_Leagues) non-empty
Items Enum:"id" "-id" "image_url" "-image_url" "live_supported" "-live_supported" "modified_at" "-modified_at" "name" "-name" "slug" "-slug" "url" "-url"

Options to sort results

Responses

200

A list of leagues

400

Bad request

401

Unauthorized

403

Forbidden

404

Not found

422

Unprocessable Entity

get /leagues
https://api.pandascore.co//leagues

Response samples

application/json
Copy
Expand all Collapse all
[
  • {
    }
]

Get a league

Get a single league by ID or by slug

Authorizations:
path Parameters
league_id_or_slug
required
LeagueID (integer) or LeagueSlug (string) (LeagueIDOrSlug)

A league ID or slug

Responses

200

A league

400

Bad request

401

Unauthorized

403

Forbidden

404

Not found

422

Unprocessable Entity

get /leagues/{league_id_or_slug}
https://api.pandascore.co//leagues/{league_id_or_slug}

Response samples

application/json
Copy
Expand all Collapse all
{
  • "id": 1,
  • "image_url": null,
  • "live_supported": true,
  • "modified_at": "2019-06-19T14:24:08Z",
  • "name": "string",
  • "series":
    [
    ],
  • "slug": "string",
  • "url": null,
  • "videogame":
    {
    }
}

Get matches for a league

List matches of the given league

Authorizations:
path Parameters
league_id_or_slug
required
LeagueID (integer) or LeagueSlug (string) (LeagueIDOrSlug)

A league ID or slug

query Parameters
filter
object (filter_over_Matches)

Options to filter results

page
integer or object

Pagination

per_page
integer [ 1 .. 100 ]
Default: 50

Equivalent to page[size]

range
object (range_over_Matches)

Options to select results within ranges

sort
Array of any (sort_over_Matches) non-empty
Items Enum:"begin_at" "-begin_at" "draw" "-draw" "end_at" "-end_at" "forfeit" "-forfeit" "id" "-id" "league_id" "-league_id" "match_type" "-match_type" "modified_at" "-modified_at" "name" "-name" "number_of_games" "-number_of_games" "serie_id" "-serie_id" "slug" "-slug" "status" "-status" "tournament_id" "-tournament_id" "winner_id" "-winner_id"

Options to sort results

Responses

200

A list of matches of any e-sport

400

Bad request

401

Unauthorized

403

Forbidden

404

Not found

422

Unprocessable Entity

get /leagues/{league_id_or_slug}/matches
https://api.pandascore.co//leagues/{league_id_or_slug}/matches

Response samples

application/json
Copy
Expand all Collapse all
[
  • {
    }
]

Get past matches for league

List past matches for the given league

Authorizations:
path Parameters
league_id_or_slug
required
LeagueID (integer) or LeagueSlug (string) (LeagueIDOrSlug)

A league ID or slug

query Parameters
filter
object (filter_over_Matches)

Options to filter results

page
integer or object

Pagination

per_page
integer [ 1 .. 100 ]
Default: 50

Equivalent to page[size]

range
object (range_over_Matches)

Options to select results within ranges

sort
Array of any (sort_over_Matches) non-empty
Items Enum:"begin_at" "-begin_at" "draw" "-draw" "end_at" "-end_at" "forfeit" "-forfeit" "id" "-id" "league_id" "-league_id" "match_type" "-match_type" "modified_at" "-modified_at" "name" "-name" "number_of_games" "-number_of_games" "serie_id" "-serie_id" "slug" "-slug" "status" "-status" "tournament_id" "-tournament_id" "winner_id" "-winner_id"

Options to sort results

Responses

200

A list of matches of any e-sport

400

Bad request

401

Unauthorized

403

Forbidden

404

Not found

422

Unprocessable Entity

get /leagues/{league_id_or_slug}/matches/past
https://api.pandascore.co//leagues/{league_id_or_slug}/matches/past

Response samples

application/json
Copy
Expand all Collapse all
[
  • {
    }
]

Get running matches for league

List currently running matches for the given league

Authorizations:
path Parameters
league_id_or_slug
required
LeagueID (integer) or LeagueSlug (string) (LeagueIDOrSlug)

A league ID or slug

query Parameters
filter
object (filter_over_Matches)

Options to filter results

page
integer or object

Pagination

per_page
integer [ 1 .. 100 ]
Default: 50

Equivalent to page[size]

range
object (range_over_Matches)

Options to select results within ranges

sort
Array of any (sort_over_Matches) non-empty
Items Enum:"begin_at" "-begin_at" "draw" "-draw" "end_at" "-end_at" "forfeit" "-forfeit" "id" "-id" "league_id" "-league_id" "match_type" "-match_type" "modified_at" "-modified_at" "name" "-name" "number_of_games" "-number_of_games" "serie_id" "-serie_id" "slug" "-slug" "status" "-status" "tournament_id" "-tournament_id" "winner_id" "-winner_id"

Options to sort results

Responses

200

A list of matches of any e-sport

400

Bad request

401

Unauthorized

403

Forbidden

404

Not found

422

Unprocessable Entity

get /leagues/{league_id_or_slug}/matches/running
https://api.pandascore.co//leagues/{league_id_or_slug}/matches/running

Response samples

application/json
Copy
Expand all Collapse all
[
  • {
    }
]

Get upcoming matches for league

List upcoming matches for the given league

Authorizations:
path Parameters
league_id_or_slug
required
LeagueID (integer) or LeagueSlug (string) (LeagueIDOrSlug)

A league ID or slug

query Parameters
filter
object (filter_over_Matches)

Options to filter results

page
integer or object

Pagination

per_page
integer [ 1 .. 100 ]
Default: 50

Equivalent to page[size]

range
object (range_over_Matches)

Options to select results within ranges

sort
Array of any (sort_over_Matches) non-empty
Items Enum:"begin_at" "-begin_at" "draw" "-draw" "end_at" "-end_at" "forfeit" "-forfeit" "id" "-id" "league_id" "-league_id" "match_type" "-match_type" "modified_at" "-modified_at" "name" "-name" "number_of_games" "-number_of_games" "serie_id" "-serie_id" "slug" "-slug" "status" "-status" "tournament_id" "-tournament_id" "winner_id" "-winner_id"

Options to sort results

Responses

200

A list of matches of any e-sport

400

Bad request

401

Unauthorized

403

Forbidden

404

Not found

422

Unprocessable Entity

get /leagues/{league_id_or_slug}/matches/upcoming
https://api.pandascore.co//leagues/{league_id_or_slug}/matches/upcoming

Response samples

application/json
Copy
Expand all Collapse all
[
  • {
    }
]

List series of a league

List series for the given league

Authorizations:
path Parameters
league_id_or_slug
required
LeagueID (integer) or LeagueSlug (string) (LeagueIDOrSlug)

A league ID or slug

query Parameters
filter
object (filter_over_Series)

Options to filter results

page
integer or object

Pagination

per_page
integer [ 1 .. 100 ]
Default: 50

Equivalent to page[size]

range
object (range_over_Series)

Options to select results within ranges

sort
Array of any (sort_over_Series) non-empty
Items Enum:"begin_at" "-begin_at" "description" "-description" "end_at" "-end_at" "full_name" "-full_name" "id" "-id" "league_id" "-league_id" "modified_at" "-modified_at" "name" "-name" "prizepool" "-prizepool" "season" "-season" "slug" "-slug" "winner_id" "-winner_id" "winner_type" "-winner_type" "year" "-year"

Options to sort results

Responses

200

A list of series

400

Bad request

401

Unauthorized

403

Forbidden

404

Not found

422

Unprocessable Entity

get /leagues/{league_id_or_slug}/series
https://api.pandascore.co//leagues/{league_id_or_slug}/series

Response samples

application/json
Copy
Expand all Collapse all
[
  • {
    }
]

Get tournaments for a league

List tournaments of the given league

Authorizations:
path Parameters
league_id_or_slug
required
LeagueID (integer) or LeagueSlug (string) (LeagueIDOrSlug)

A league ID or slug

query Parameters
filter
object (filter_over_ShortTournaments)

Options to filter results

page
integer or object

Pagination

per_page
integer [ 1 .. 100 ]
Default: 50

Equivalent to page[size]

range
object (range_over_ShortTournaments)

Options to select results within ranges

sort
Array of any (sort_over_ShortTournaments) non-empty
Items Enum:"begin_at" "-begin_at" "end_at" "-end_at" "id" "-id" "league_id" "-league_id" "modified_at" "-modified_at" "name" "-name" "serie_id" "-serie_id" "slug" "-slug" "winner_id" "-winner_id" "winner_type" "-winner_type"

Options to sort results

Responses

200

A list of tournaments

400

Bad request

401

Unauthorized

403

Forbidden

404

Not found

422

Unprocessable Entity

get /leagues/{league_id_or_slug}/tournaments
https://api.pandascore.co//leagues/{league_id_or_slug}/tournaments

Response samples

application/json
Copy
Expand all Collapse all
[
  • {
    }
]

Series

List series

List series

Authorizations:
query Parameters
filter
object (filter_over_Series)

Options to filter results

page
integer or object

Pagination

per_page
integer [ 1 .. 100 ]
Default: 50

Equivalent to page[size]

range
object (range_over_Series)

Options to select results within ranges

sort
Array of any (sort_over_Series) non-empty
Items Enum:"begin_at" "-begin_at" "description" "-description" "end_at" "-end_at" "full_name" "-full_name" "id" "-id" "league_id" "-league_id" "modified_at" "-modified_at" "name" "-name" "prizepool" "-prizepool" "season" "-season" "slug" "-slug" "winner_id" "-winner_id" "winner_type" "-winner_type" "year" "-year"

Options to sort results

Responses

200

A list of series

400

Bad request

401

Unauthorized

403

Forbidden

404

Not found

422

Unprocessable Entity

get /series
https://api.pandascore.co//series

Response samples

application/json
Copy
Expand all Collapse all
[
  • {
    }
]

Get past series

List past series

Authorizations:
query Parameters
filter
object (filter_over_Series)

Options to filter results

page
integer or object

Pagination

per_page
integer [ 1 .. 100 ]
Default: 50

Equivalent to page[size]

range
object (range_over_Series)

Options to select results within ranges

sort
Array of any (sort_over_Series) non-empty
Items Enum:"begin_at" "-begin_at" "description" "-description" "end_at" "-end_at" "full_name" "-full_name" "id" "-id" "league_id" "-league_id" "modified_at" "-modified_at" "name" "-name" "prizepool" "-prizepool" "season" "-season" "slug" "-slug" "winner_id" "-winner_id" "winner_type" "-winner_type" "year" "-year"

Options to sort results

Responses

200

A list of series

400

Bad request

401

Unauthorized

403

Forbidden

404

Not found

422

Unprocessable Entity

get /series/past
https://api.pandascore.co//series/past

Response samples

application/json
Copy
Expand all Collapse all
[
  • {
    }
]

Get running series

List currently running series

Authorizations:
query Parameters
filter
object (filter_over_Series)

Options to filter results

page
integer or object

Pagination

per_page
integer [ 1 .. 100 ]
Default: 50

Equivalent to page[size]

range
object (range_over_Series)

Options to select results within ranges

sort
Array of any (sort_over_Series) non-empty
Items Enum:"begin_at" "-begin_at" "description" "-description" "end_at" "-end_at" "full_name" "-full_name" "id" "-id" "league_id" "-league_id" "modified_at" "-modified_at" "name" "-name" "prizepool" "-prizepool" "season" "-season" "slug" "-slug" "winner_id" "-winner_id" "winner_type" "-winner_type" "year" "-year"

Options to sort results

Responses

200

A list of series

400

Bad request

401

Unauthorized

403

Forbidden

404

Not found

422

Unprocessable Entity

get /series/running
https://api.pandascore.co//series/running

Response samples

application/json
Copy
Expand all Collapse all
[
  • {
    }
]

Get upcoming series

List upcoming series

Authorizations:
query Parameters
filter
object (filter_over_Series)

Options to filter results

page
integer or object

Pagination

per_page
integer [ 1 .. 100 ]
Default: 50

Equivalent to page[size]

range
object (range_over_Series)

Options to select results within ranges

sort
Array of any (sort_over_Series) non-empty
Items Enum:"begin_at" "-begin_at" "description" "-description" "end_at" "-end_at" "full_name" "-full_name" "id" "-id" "league_id" "-league_id" "modified_at" "-modified_at" "name" "-name" "prizepool" "-prizepool" "season" "-season" "slug" "-slug" "winner_id" "-winner_id" "winner_type" "-winner_type" "year" "-year"

Options to sort results

Responses

200

A list of series

400

Bad request

401

Unauthorized

403

Forbidden

404

Not found

422

Unprocessable Entity

get /series/upcoming
https://api.pandascore.co//series/upcoming

Response samples

application/json
Copy
Expand all Collapse all
[
  • {
    }
]

Get a serie

Get a single serie by ID or by slug

Authorizations:
path Parameters
serie_id_or_slug
required
SerieID (integer) or SerieSlug (string) (SerieIDOrSlug)

A serie ID or slug

Responses

200

A serie

400

Bad request

401

Unauthorized

403

Forbidden

404

Not found

422

Unprocessable Entity

get /series/{serie_id_or_slug}
https://api.pandascore.co//series/{serie_id_or_slug}

Response samples

application/json
Copy
Expand all Collapse all
{
  • "begin_at": null,
  • "description": null,
  • "end_at": null,
  • "full_name": "string",
  • "id": 1,
  • "league":
    {
    },
  • "league_id": 1,
  • "modified_at": "2019-06-19T14:24:08Z",
  • "name": null,
  • "prizepool": null,
  • "season": null,
  • "slug": "string",
  • "tournaments":
    [
    ],
  • "videogame":
    {
    },
  • "winner_id": null,
  • "winner_type": null,
  • "year": 2012
}

Get matches for a serie

List matches of the given serie

Authorizations:
path Parameters
serie_id_or_slug
required
SerieID (integer) or SerieSlug (string) (SerieIDOrSlug)

A serie ID or slug

query Parameters
filter
object (filter_over_Matches)

Options to filter results

page
integer or object

Pagination

per_page
integer [ 1 .. 100 ]
Default: 50

Equivalent to page[size]

range
object (range_over_Matches)

Options to select results within ranges

sort
Array of any (sort_over_Matches) non-empty
Items Enum:"begin_at" "-begin_at" "draw" "-draw" "end_at" "-end_at" "forfeit" "-forfeit" "id" "-id" "league_id" "-league_id" "match_type" "-match_type" "modified_at" "-modified_at" "name" "-name" "number_of_games" "-number_of_games" "serie_id" "-serie_id" "slug" "-slug" "status" "-status" "tournament_id" "-tournament_id" "winner_id" "-winner_id"

Options to sort results

Responses

200

A list of matches of any e-sport

400

Bad request

401

Unauthorized

403

Forbidden

404

Not found

422

Unprocessable Entity

get /series/{serie_id_or_slug}/matches
https://api.pandascore.co//series/{serie_id_or_slug}/matches

Response samples

application/json
Copy
Expand all Collapse all
[
  • {
    }
]

Get past matches for serie

List past matches for the given serie

Authorizations:
path Parameters
serie_id_or_slug
required
SerieID (integer) or SerieSlug (string) (SerieIDOrSlug)

A serie ID or slug

query Parameters
filter
object (filter_over_Matches)

Options to filter results

page
integer or object

Pagination

per_page
integer [ 1 .. 100 ]
Default: 50

Equivalent to page[size]

range
object (range_over_Matches)

Options to select results within ranges

sort
Array of any (sort_over_Matches) non-empty
Items Enum:"begin_at" "-begin_at" "draw" "-draw" "end_at" "-end_at" "forfeit" "-forfeit" "id" "-id" "league_id" "-league_id" "match_type" "-match_type" "modified_at" "-modified_at" "name" "-name" "number_of_games" "-number_of_games" "serie_id" "-serie_id" "slug" "-slug" "status" "-status" "tournament_id" "-tournament_id" "winner_id" "-winner_id"

Options to sort results

Responses

200

A list of matches of any e-sport

400

Bad request

401

Unauthorized

403

Forbidden

404

Not found

422

Unprocessable Entity

get /series/{serie_id_or_slug}/matches/past
https://api.pandascore.co//series/{serie_id_or_slug}/matches/past

Response samples

application/json
Copy
Expand all Collapse all
[
  • {
    }
]

Get running matches for serie

List currently running matches for the given serie

Authorizations:
path Parameters
serie_id_or_slug
required
SerieID (integer) or SerieSlug (string) (SerieIDOrSlug)

A serie ID or slug

query Parameters
filter
object (filter_over_Matches)

Options to filter results

page
integer or object

Pagination

per_page
integer [ 1 .. 100 ]
Default: 50

Equivalent to page[size]

range
object (range_over_Matches)

Options to select results within ranges

sort
Array of any (sort_over_Matches) non-empty
Items Enum:"begin_at" "-begin_at" "draw" "-draw" "end_at" "-end_at" "forfeit" "-forfeit" "id" "-id" "league_id" "-league_id" "match_type" "-match_type" "modified_at" "-modified_at" "name" "-name" "number_of_games" "-number_of_games" "serie_id" "-serie_id" "slug" "-slug" "status" "-status" "tournament_id" "-tournament_id" "winner_id" "-winner_id"

Options to sort results

Responses

200

A list of matches of any e-sport

400

Bad request

401

Unauthorized

403

Forbidden

404

Not found

422

Unprocessable Entity

get /series/{serie_id_or_slug}/matches/running
https://api.pandascore.co//series/{serie_id_or_slug}/matches/running

Response samples

application/json
Copy
Expand all Collapse all
[
  • {
    }
]

Get upcoming matches for serie

List upcoming matches for the given serie

Authorizations:
path Parameters
serie_id_or_slug
required
SerieID (integer) or SerieSlug (string) (SerieIDOrSlug)

A serie ID or slug

query Parameters
filter
object (filter_over_Matches)

Options to filter results

page
integer or object

Pagination

per_page
integer [ 1 .. 100 ]
Default: 50

Equivalent to page[size]

range
object (range_over_Matches)

Options to select results within ranges

sort
Array of any (sort_over_Matches) non-empty
Items Enum:"begin_at" "-begin_at" "draw" "-draw" "end_at" "-end_at" "forfeit" "-forfeit" "id" "-id" "league_id" "-league_id" "match_type" "-match_type" "modified_at" "-modified_at" "name" "-name" "number_of_games" "-number_of_games" "serie_id" "-serie_id" "slug" "-slug" "status" "-status" "tournament_id" "-tournament_id" "winner_id" "-winner_id"

Options to sort results

Responses

200

A list of matches of any e-sport

400

Bad request

401

Unauthorized

403

Forbidden

404

Not found

422

Unprocessable Entity

get /series/{serie_id_or_slug}/matches/upcoming
https://api.pandascore.co//series/{serie_id_or_slug}/matches/upcoming

Response samples

application/json
Copy
Expand all Collapse all
[
  • {
    }
]

Get tournaments for a serie

List tournaments of the given serie

Authorizations:
path Parameters
serie_id_or_slug
required
SerieID (integer) or SerieSlug (string) (SerieIDOrSlug)

A serie ID or slug

query Parameters
filter
object (filter_over_ShortTournaments)

Options to filter results

page
integer or object

Pagination

per_page
integer [ 1 .. 100 ]
Default: 50

Equivalent to page[size]

range
object (range_over_ShortTournaments)

Options to select results within ranges

sort
Array of any (sort_over_ShortTournaments) non-empty
Items Enum:"begin_at" "-begin_at" "end_at" "-end_at" "id" "-id" "league_id" "-league_id" "modified_at" "-modified_at" "name" "-name" "serie_id" "-serie_id" "slug" "-slug" "winner_id" "-winner_id" "winner_type" "-winner_type"

Options to sort results

Responses

200

A list of tournaments

400

Bad request

401

Unauthorized

403

Forbidden

404

Not found

422

Unprocessable Entity

get /series/{serie_id_or_slug}/tournaments
https://api.pandascore.co//series/{serie_id_or_slug}/tournaments

Response samples

application/json
Copy
Expand all Collapse all
[
  • {
    }
]

Tournaments

List tournaments

List tournaments

Authorizations:
query Parameters
filter
object (filter_over_ShortTournaments)

Options to filter results

page
integer or object

Pagination

per_page
integer [ 1 .. 100 ]
Default: 50

Equivalent to page[size]

range
object (range_over_ShortTournaments)

Options to select results within ranges

sort
Array of any (sort_over_ShortTournaments) non-empty
Items Enum:"begin_at" "-begin_at" "end_at" "-end_at" "id" "-id" "league_id" "-league_id" "modified_at" "-modified_at" "name" "-name" "serie_id" "-serie_id" "slug" "-slug" "winner_id" "-winner_id" "winner_type" "-winner_type"

Options to sort results

Responses

200

A list of tournaments

400

Bad request

401

Unauthorized

403

Forbidden

404

Not found

422

Unprocessable Entity

get /tournaments
https://api.pandascore.co//tournaments

Response samples

application/json
Copy
Expand all Collapse all
[
  • {
    }
]

Get past tournaments

List past tournaments

Authorizations:
query Parameters
filter
object (filter_over_ShortTournaments)

Options to filter results

page
integer or object

Pagination

per_page
integer [ 1 .. 100 ]
Default: 50

Equivalent to page[size]

range
object (range_over_ShortTournaments)

Options to select results within ranges

sort
Array of any (sort_over_ShortTournaments) non-empty
Items Enum:"begin_at" "-begin_at" "end_at" "-end_at" "id" "-id" "league_id" "-league_id" "modified_at" "-modified_at" "name" "-name" "serie_id" "-serie_id" "slug" "-slug" "winner_id" "-winner_id" "winner_type" "-winner_type"

Options to sort results

Responses

200

A list of tournaments

400

Bad request

401

Unauthorized

403

Forbidden

404

Not found

422

Unprocessable Entity

get /tournaments/past
https://api.pandascore.co//tournaments/past

Response samples

application/json
Copy
Expand all Collapse all
[
  • {
    }
]

Get running tournaments

List currently running tournaments

Authorizations:
query Parameters
filter
object (filter_over_ShortTournaments)

Options to filter results

page
integer or object

Pagination

per_page
integer [ 1 .. 100 ]
Default: 50

Equivalent to page[size]

range
object (range_over_ShortTournaments)

Options to select results within ranges

sort
Array of any (sort_over_ShortTournaments) non-empty
Items Enum:"begin_at" "-begin_at" "end_at" "-end_at" "id" "-id" "league_id" "-league_id" "modified_at" "-modified_at" "name" "-name" "serie_id" "-serie_id" "slug" "-slug" "winner_id" "-winner_id" "winner_type" "-winner_type"

Options to sort results

Responses

200

A list of tournaments

400

Bad request

401

Unauthorized

403

Forbidden

404

Not found

422

Unprocessable Entity

get /tournaments/running
https://api.pandascore.co//tournaments/running

Response samples

application/json
Copy
Expand all Collapse all
[
  • {
    }
]

Get upcoming tournaments

List upcoming tournaments

Authorizations:
query Parameters
filter
object (filter_over_ShortTournaments)

Options to filter results

page
integer or object

Pagination

per_page
integer [ 1 .. 100 ]
Default: 50

Equivalent to page[size]

range
object (range_over_ShortTournaments)

Options to select results within ranges

sort
Array of any (sort_over_ShortTournaments) non-empty
Items Enum:"begin_at" "-begin_at" "end_at" "-end_at" "id" "-id" "league_id" "-league_id" "modified_at" "-modified_at" "name" "-name" "serie_id" "-serie_id" "slug" "-slug" "winner_id" "-winner_id" "winner_type" "-winner_type"

Options to sort results

Responses

200

A list of tournaments

400

Bad request

401

Unauthorized

403

Forbidden

404

Not found

422

Unprocessable Entity

get /tournaments/upcoming
https://api.pandascore.co//tournaments/upcoming

Response samples

application/json
Copy
Expand all Collapse all
[
  • {
    }
]

Get a tournament

Get a single tournament by ID or by slug

Authorizations:
path Parameters
tournament_id_or_slug
required
TournamentID (integer) or TournamentSlug (string) (TournamentIDOrSlug)

A tournament ID or slug

Responses

200

A detailed tournament

400

Bad request

401

Unauthorized

403

Forbidden

404

Not found

422

Unprocessable Entity

get /tournaments/{tournament_id_or_slug}
https://api.pandascore.co//tournaments/{tournament_id_or_slug}

Response samples

application/json
Copy
Expand all Collapse all
{
  • "begin_at": null,
  • "end_at": null,
  • "expected_roster":
    [
    ],
  • "id": 1,
  • "league":
    {
    },
  • "league_id": 1,
  • "matches":
    [
    ],
  • "modified_at": "2019-06-19T14:24:08Z",
  • "name": "string",
  • "serie":
    {
    },
  • "serie_id": 1,
  • "slug": "string",
  • "teams":
    [
    ],
  • "videogame":
    {
    },
  • "winner_id": null,
  • "winner_type": null
}

Get a tournament's brackets

Get the brackets of the given tournament

Authorizations:
path Parameters
tournament_id_or_slug
required
TournamentID (integer) or TournamentSlug (string) (TournamentIDOrSlug)

A tournament ID or slug

query Parameters
filter
object (filter_over_Brackets)

Options to filter results

page
integer or object

Pagination

per_page
integer [ 1 .. 100 ]
Default: 50

Equivalent to page[size]

range
object (range_over_Brackets)

Options to select results within ranges

sort
Array of any (sort_over_Brackets) non-empty
Items Enum:"begin_at" "-begin_at" "draw" "-draw" "end_at" "-end_at" "forfeit" "-forfeit" "id" "-id" "match_type" "-match_type" "modified_at" "-modified_at" "name" "-name" "number_of_games" "-number_of_games" "slug" "-slug" "status" "-status" "tournament_id" "-tournament_id" "winner_id" "-winner_id"

Options to sort results

Responses

200

A tree of games played during a tournament

400

Bad request

401

Unauthorized

403

Forbidden

404

Not found

422

Unprocessable Entity

get /tournaments/{tournament_id_or_slug}/brackets
https://api.pandascore.co//tournaments/{tournament_id_or_slug}/brackets

Response samples

application/json
Copy
Expand all Collapse all
[
  • {
    }
]

Get matches for tournament

List matches for the given tournament

Authorizations:
path Parameters
tournament_id_or_slug
required
TournamentID (integer) or TournamentSlug (string) (TournamentIDOrSlug)

A tournament ID or slug

query Parameters
filter
object (filter_over_Matches)

Options to filter results

page
integer or object

Pagination

per_page
integer [ 1 .. 100 ]
Default: 50

Equivalent to page[size]

range
object (range_over_Matches)

Options to select results within ranges

sort
Array of any (sort_over_Matches) non-empty
Items Enum:"begin_at" "-begin_at" "draw" "-draw" "end_at" "-end_at" "forfeit" "-forfeit" "id" "-id" "league_id" "-league_id" "match_type" "-match_type" "modified_at" "-modified_at" "name" "-name" "number_of_games" "-number_of_games" "serie_id" "-serie_id" "slug" "-slug" "status" "-status" "tournament_id" "-tournament_id" "winner_id" "-winner_id"

Options to sort results

Responses

200

A list of matches of any e-sport

400

Bad request

401

Unauthorized

403

Forbidden

404

Not found

422

Unprocessable Entity

get /tournaments/{tournament_id_or_slug}/matches
https://api.pandascore.co//tournaments/{tournament_id_or_slug}/matches

Response samples

application/json
Copy
Expand all Collapse all
[
  • {
    }
]

Get tournament standings

Get the current standings for a given tournament

Authorizations:
path Parameters
tournament_id_or_slug
required
TournamentID (integer) or TournamentSlug (string) (TournamentIDOrSlug)

A tournament ID or slug

query Parameters
page
integer or object

Pagination

per_page
integer [ 1 .. 100 ]
Default: 50

Equivalent to page[size]

Responses

200

Ranking of teams in a tournament

400

Bad request

401

Unauthorized

403

Forbidden

404

Not found

422

Unprocessable Entity

get /tournaments/{tournament_id_or_slug}/standings
https://api.pandascore.co//tournaments/{tournament_id_or_slug}/standings

Response samples

application/json
Copy
Expand all Collapse all
[
  • {
    }
]

Get teams for a tournament

List teams for the given tournament

Authorizations:
path Parameters
tournament_id_or_slug
required
TournamentID (integer) or TournamentSlug (string) (TournamentIDOrSlug)

A tournament ID or slug

query Parameters
filter
object (filter_over_Teams)

Options to filter results

page
integer or object

Pagination

per_page
integer [ 1 .. 100 ]
Default: 50

Equivalent to page[size]

range
object (range_over_Teams)

Options to select results within ranges

sort
Array of any (sort_over_Teams) non-empty
Items Enum:"acronym" "-acronym" "id" "-id" "image_url" "-image_url" "name" "-name" "slug" "-slug"

Options to sort results

Responses

200

A list of teams

400

Bad request

401

Unauthorized

403

Forbidden

404

Not found

422

Unprocessable Entity

get /tournaments/{tournament_id_or_slug}/teams
https://api.pandascore.co//tournaments/{tournament_id_or_slug}/teams

Response samples

application/json
Copy
Expand all Collapse all
[
  • {
    }
]

Matches

List lives matches

List currently running live matches, available from pandascore with live websocket data.

Authorizations:
query Parameters
page
integer or object

Pagination

per_page
integer [ 1 .. 100 ]
Default: 50

Equivalent to page[size]

Responses

200

A list of games being played or about to be played

400

Bad request

401

Unauthorized

403

Forbidden

404

Not found

422

Unprocessable Entity

get /lives
https://api.pandascore.co//lives

Response samples

application/json
Copy
Expand all Collapse all
[
  • {
    }
]

List matches

List matches

Authorizations:
query Parameters
filter
object (filter_over_Matches)

Options to filter results

page
integer or object

Pagination

per_page
integer [ 1 .. 100 ]
Default: 50

Equivalent to page[size]

range
object (range_over_Matches)

Options to select results within ranges

sort
Array of any (sort_over_Matches) non-empty
Items Enum:"begin_at" "-begin_at" "draw" "-draw" "end_at" "-end_at" "forfeit" "-forfeit" "id" "-id" "league_id" "-league_id" "match_type" "-match_type" "modified_at" "-modified_at" "name" "-name" "number_of_games" "-number_of_games" "serie_id" "-serie_id" "slug" "-slug" "status" "-status" "tournament_id" "-tournament_id" "winner_id" "-winner_id"

Options to sort results

Responses

200

A list of matches of any e-sport

400

Bad request

401

Unauthorized

403

Forbidden

404

Not found

422

Unprocessable Entity

get /matches
https://api.pandascore.co//matches

Response samples

application/json
Copy
Expand all Collapse all
[
  • {
    }
]

Get past matches

List past matches

Authorizations:
query Parameters
filter
object (filter_over_Matches)

Options to filter results

page
integer or object

Pagination

per_page
integer [ 1 .. 100 ]
Default: 50

Equivalent to page[size]

range
object (range_over_Matches)

Options to select results within ranges

sort
Array of any (sort_over_Matches) non-empty
Items Enum:"begin_at" "-begin_at" "draw" "-draw" "end_at" "-end_at" "forfeit" "-forfeit" "id" "-id" "league_id" "-league_id" "match_type" "-match_type" "modified_at" "-modified_at" "name" "-name" "number_of_games" "-number_of_games" "serie_id" "-serie_id" "slug" "-slug" "status" "-status" "tournament_id" "-tournament_id" "winner_id" "-winner_id"

Options to sort results

Responses

200

A list of matches of any e-sport

400

Bad request

401

Unauthorized

403

Forbidden

404

Not found

422

Unprocessable Entity

get /matches/past
https://api.pandascore.co//matches/past

Response samples

application/json
Copy
Expand all Collapse all
[
  • {
    }
]

Get running matches

List currently running matches

Authorizations:
query Parameters
filter
object (filter_over_Matches)

Options to filter results

page
integer or object

Pagination

per_page
integer [ 1 .. 100 ]
Default: 50

Equivalent to page[size]

range
object (range_over_Matches)

Options to select results within ranges

sort
Array of any (sort_over_Matches) non-empty
Items Enum:"begin_at" "-begin_at" "draw" "-draw" "end_at" "-end_at" "forfeit" "-forfeit" "id" "-id" "league_id" "-league_id" "match_type" "-match_type" "modified_at" "-modified_at" "name" "-name" "number_of_games" "-number_of_games" "serie_id" "-serie_id" "slug" "-slug" "status" "-status" "tournament_id" "-tournament_id" "winner_id" "-winner_id"

Options to sort results

Responses

200

A list of matches of any e-sport

400

Bad request

401

Unauthorized

403

Forbidden

404

Not found

422

Unprocessable Entity

get /matches/running
https://api.pandascore.co//matches/running

Response samples

application/json
Copy
Expand all Collapse all
[
  • {
    }
]

Get upcoming matches

List upcoming matches

Authorizations:
query Parameters
filter
object (filter_over_Matches)

Options to filter results

page
integer or object

Pagination

per_page
integer [ 1 .. 100 ]
Default: 50

Equivalent to page[size]

range
object (range_over_Matches)

Options to select results within ranges

sort
Array of any (sort_over_Matches) non-empty
Items Enum:"begin_at" "-begin_at" "draw" "-draw" "end_at" "-end_at" "forfeit" "-forfeit" "id" "-id" "league_id" "-league_id" "match_type" "-match_type" "modified_at" "-modified_at" "name" "-name" "number_of_games" "-number_of_games" "serie_id" "-serie_id" "slug" "-slug" "status" "-status" "tournament_id" "-tournament_id" "winner_id" "-winner_id"

Options to sort results

Responses

200

A list of matches of any e-sport

400

Bad request

401

Unauthorized

403

Forbidden

404

Not found

422

Unprocessable Entity

get /matches/upcoming
https://api.pandascore.co//matches/upcoming

Response samples

application/json
Copy
Expand all Collapse all
[
  • {
    }
]

Get a match

Get a single match by ID or by slug

Authorizations:
path Parameters
match_id_or_slug
required
(MatchID (LoLMatchID (integer) or CSGOMatchID (integer) or OwMatchID (integer) or Dota2MatchID (integer) or PUBGMatchID (integer))) or MatchSlug (string) (MatchIDOrSlug)

A match ID or slug

Responses

200

A match of any e-sport

400

Bad request

401

Unauthorized

403

Forbidden

404

Not found

422

Unprocessable Entity

get /matches/{match_id_or_slug}
https://api.pandascore.co//matches/{match_id_or_slug}

Response samples

application/json
Copy
Expand all Collapse all
{
  • "begin_at": null,
  • "draw": true,
  • "end_at": null,
  • "forfeit": true,
  • "games":
    [
    ],
  • "id": 1,
  • "league":
    {
    },
  • "league_id": 1,
  • "live":
    {
    },
  • "match_type": "best_of",
  • "modified_at": "2019-06-19T14:24:09Z",
  • "name": "string",
  • "number_of_games": 0,
  • "opponents":
    [
    ],
  • "results":
    [
    ],
  • "serie":
    {
    },
  • "serie_id": 1,
  • "slug": null,
  • "status": "canceled",
  • "tournament":
    {
    },
  • "tournament_id": 1,
  • "videogame":
    {
    },
  • "videogame_version": null,
  • "winner": null,
  • "winner_id": null
}

Get a match's opponents

List opponents (player or teams) for the given match

Authorizations:
path Parameters
match_id_or_slug
required
(MatchID (LoLMatchID (integer) or CSGOMatchID (integer) or OwMatchID (integer) or Dota2MatchID (integer) or PUBGMatchID (integer))) or MatchSlug (string) (MatchIDOrSlug)

A match ID or slug

Responses

200

A match's opponents

400

Bad request

401

Unauthorized

403

Forbidden

404

Not found

422

Unprocessable Entity

get /matches/{match_id_or_slug}/opponents
https://api.pandascore.co//matches/{match_id_or_slug}/opponents

Response samples

application/json
Copy
Expand all Collapse all
{
  • "opponent_type": null,
  • "opponents":
    [
    ]
}

Teams

List teams

List teams

Authorizations:
query Parameters
filter
object (filter_over_Teams)

Options to filter results

page
integer or object

Pagination

per_page
integer [ 1 .. 100 ]
Default: 50

Equivalent to page[size]

range
object (range_over_Teams)

Options to select results within ranges

sort
Array of any (sort_over_Teams) non-empty
Items Enum:"acronym" "-acronym" "id" "-id" "image_url" "-image_url" "name" "-name" "slug" "-slug"

Options to sort results

Responses

200

A list of teams

400

Bad request

401

Unauthorized

403

Forbidden

404

Not found

422

Unprocessable Entity

get /teams
https://api.pandascore.co//teams

Response samples

application/json
Copy
Expand all Collapse all
[
  • {
    }
]

Get a team

Get a single team by ID or by slug

Authorizations:
path Parameters
team_id_or_slug
required
TeamID (integer) or TeamSlug (string) (TeamIDOrSlug)

A team ID or slug

Responses

200

A team

400

Bad request

401

Unauthorized

403

Forbidden

404

Not found

422

Unprocessable Entity

get /teams/{team_id_or_slug}
https://api.pandascore.co//teams/{team_id_or_slug}

Response samples

application/json
Copy
Expand all Collapse all
{
  • "acronym": null,
  • "current_videogame": null,
  • "id": 1,
  • "image_url": null,
  • "name": "string",
  • "players":
    [
    ],
  • "slug": null
}

Get leagues for a team

List leagues in which the given team was part of

Authorizations:
path Parameters
team_id_or_slug
required
TeamID (integer) or TeamSlug (string) (TeamIDOrSlug)

A team ID or slug

query Parameters
filter
object (filter_over_Leagues)

Options to filter results

page
integer or object

Pagination

per_page
integer [ 1 .. 100 ]
Default: 50

Equivalent to page[size]

range
object (range_over_Leagues)

Options to select results within ranges

sort
Array of any (sort_over_Leagues) non-empty
Items Enum:"id" "-id" "image_url" "-image_url" "live_supported" "-live_supported" "modified_at" "-modified_at" "name" "-name" "slug" "-slug" "url" "-url"

Options to sort results

Responses

200

A list of leagues

400

Bad request

401

Unauthorized

403

Forbidden

404

Not found

422

Unprocessable Entity

get /teams/{team_id_or_slug}/leagues
https://api.pandascore.co//teams/{team_id_or_slug}/leagues

Response samples

application/json
Copy
Expand all Collapse all
[
  • {
    }
]

Get matches for team

List matches for the given team

Authorizations:
path Parameters
team_id_or_slug
required
TeamID (integer) or TeamSlug (string) (TeamIDOrSlug)

A team ID or slug

query Parameters
filter
object (filter_over_Matches)

Options to filter results

page
integer or object

Pagination

per_page
integer [ 1 .. 100 ]
Default: 50

Equivalent to page[size]

range
object (range_over_Matches)

Options to select results within ranges

sort
Array of any (sort_over_Matches) non-empty
Items Enum:"begin_at" "-begin_at" "draw" "-draw" "end_at" "-end_at" "forfeit" "-forfeit" "id" "-id" "league_id" "-league_id" "match_type" "-match_type" "modified_at" "-modified_at" "name" "-name" "number_of_games" "-number_of_games" "serie_id" "-serie_id" "slug" "-slug" "status" "-status" "tournament_id" "-tournament_id" "winner_id" "-winner_id"

Options to sort results

Responses

200

A list of matches of any e-sport

400

Bad request

401

Unauthorized

403

Forbidden

404

Not found

422

Unprocessable Entity

get /teams/{team_id_or_slug}/matches
https://api.pandascore.co//teams/{team_id_or_slug}/matches

Response samples

application/json
Copy
Expand all Collapse all
[
  • {
    }
]

Get series for a team

List series in which the given team was part of

Authorizations:
path Parameters
team_id_or_slug
required
TeamID (integer) or TeamSlug (string) (TeamIDOrSlug)

A team ID or slug

query Parameters
filter
object (filter_over_Series)

Options to filter results

page
integer or object

Pagination

per_page
integer [ 1 .. 100 ]
Default: 50

Equivalent to page[size]

range
object (range_over_Series)

Options to select results within ranges

sort
Array of any (sort_over_Series) non-empty
Items Enum:"begin_at" "-begin_at" "description" "-description" "end_at" "-end_at" "full_name" "-full_name" "id" "-id" "league_id" "-league_id" "modified_at" "-modified_at" "name" "-name" "prizepool" "-prizepool" "season" "-season" "slug" "-slug" "winner_id" "-winner_id" "winner_type" "-winner_type" "year" "-year"

Options to sort results

Responses

200

A list of series

400

Bad request

401

Unauthorized

403

Forbidden

404

Not found

422

Unprocessable Entity

get /teams/{team_id_or_slug}/series
https://api.pandascore.co//teams/{team_id_or_slug}/series

Response samples

application/json
Copy
Expand all Collapse all
[
  • {
    }
]

Get tournaments for a team

List tournaments in which the given team was part of

Authorizations:
path Parameters
team_id_or_slug
required
TeamID (integer) or TeamSlug (string) (TeamIDOrSlug)

A team ID or slug

query Parameters
filter
object (filter_over_ShortTournaments)

Options to filter results

page
integer or object

Pagination

per_page
integer [ 1 .. 100 ]
Default: 50

Equivalent to page[size]

range
object (range_over_ShortTournaments)

Options to select results within ranges

sort
Array of any (sort_over_ShortTournaments) non-empty
Items Enum:"begin_at" "-begin_at" "end_at" "-end_at" "id" "-id" "league_id" "-league_id" "modified_at" "-modified_at" "name" "-name" "serie_id" "-serie_id" "slug" "-slug" "winner_id" "-winner_id" "winner_type" "-winner_type"

Options to sort results

Responses

200

A l