APIAPI v2V2 endpoint referenceRankings
/rankings/player-cards
Rank players by discipline in a competition
Rank players by discipline in a competition
Query Parameters
competitionId*string
Competition to rank within. Required: a card board spanning every competition is not a query the API will serve.
Match
^[1-9][0-9]*$seasonId?string
Restrict the sample to one season of that competition
Match
^[1-9][0-9]*$sort?string
Ordering; defaults to -cardsPerAppearance. Rate orderings are descending only, so that entries with no data — whose rates are null — sort last rather than first.
Value in
- "-appearances"
- "-bookedPercentage"
- "-cards"
- "-cardsPer90"
- "-cardsPerAppearance"
- "-foulsPerAppearance"
- "name"
limit?integer
Maximum resources to return; defaults to 25
Range
1 <= value <= 100Default
25after?string
Opaque cursor for the next page
before?string
Opaque cursor for the previous page
Response Body
application/json
application/problem+json
application/problem+json
curl -X GET "https://example.com/rankings/player-cards?competitionId=string"{ "data": [ { "appearances": 0, "bookedPercentage": 0, "cardsPer90": 0, "cardsPerAppearance": 0, "foulsPerAppearance": 0, "minutesPerAppearance": 0, "nation": { "id": "string", "name": "string", "slug": "string" }, "player": { "id": "string", "name": "string", "slug": "string" }, "position": "string", "redCards": 0, "tacklesPerAppearance": 0, "team": { "id": "string", "name": "string", "slug": "string" }, "yellowCards": 0 } ], "links": { "next": "string", "previous": "string", "self": "string" }, "page": { "hasNext": true, "hasPrevious": true, "limit": 0, "nextCursor": "string", "previousCursor": "string" }}