APIAPI v2V2 endpoint referenceRankings
/rankings/referee-cards
Rank the officials who worked a competition by card record
Rank the officials who worked a competition by card record
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 -cardsPerGame. Rate orderings are descending only, so that entries with no data — whose rates are null — sort last rather than first.
Value in
- "-cardsPerGame"
- "-foulsPerGame"
- "-games"
- "-over35CardsPercentage"
- "-penaltiesPerGame"
- "-redsPerGame"
- "-yellowsPerGame"
- "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/referee-cards?competitionId=string"{ "data": [ { "bothTeamsOver15CardsPercentage": 0, "cardsPerGame": 0, "countrySlug": "string", "firstHalfCardsPerGame": 0, "foulsPerGame": 0, "games": 0, "nextFixture": { "awayTeam": { "id": "string", "name": "string", "shortName": "string", "slug": "string" }, "competition": { "id": "string", "name": "string", "slug": "string" }, "homeTeam": { "id": "string", "name": "string", "shortName": "string", "slug": "string" }, "id": "string", "kickoffAt": "2019-08-24T14:15:22Z", "slug": "string" }, "over35CardsPercentage": 0, "over45CardsPercentage": 0, "over55CardsPercentage": 0, "penalties": 0, "penaltiesPerGame": 0, "redCards": 0, "redsPerGame": 0, "referee": { "id": "string", "name": "string", "slug": "string" }, "secondHalfCardsPerGame": 0, "yellowCards": 0, "yellowsPerGame": 0 } ], "links": { "next": "string", "previous": "string", "self": "string" }, "page": { "hasNext": true, "hasPrevious": true, "limit": 0, "nextCursor": "string", "previousCursor": "string" }}