Tournament API › Final Standings
GET /standing-items
Returns a list of final standing items.
Resource URL
https://api.toornament.com/organizer/v2/standing-items
HTTP headers
- X-Api-Keystring
API key of your application (see Authentication)
- Authorizationstring
Access token with
organizer:result
scope (see Authorization) - Rangestring
A range of requested items using the
items
unit. The size of the range can not exceed 50. (see Pagination)Example: items=0-49
Query Parameters
- tournament_idsarray
Only return tournaments for the given list of ids.
Example: 378426939508809728,534138941862841533
- custom_user_identifiersarray
A list of external custom user identifiers.
Example: acme:account:1234,acme:account:1235
- participant_idsarray
One or several participant ids involved in the standings to filter.
Example: 618965416546776434,618975467354349191
- min_rankinteger
A minimal rank to filter.
- max_rankinteger
A maximal rank to filter.
Request Body
This endpoint does not require a request body.
Response
[206] Standing items retrieved.
Example
[ { "id": "378426939508809728", "position": 4, "rank": 3, "participant": { "id": "375143143408309123", "name": "Jon Snow", "custom_user_identifier": "acme:account:1234", "custom_fields": {} }, "tournament_id": "378426939508809728" } ]
Structure (collection)
- idstring
A unique identifier for the standing item.
Example: "378426939508809728"
- positioninteger
A position used for presentation purposes. It is always unique within the same standing.
Example: 4
- rankinteger|null
The ranking of the participant in the standing. Multiple participants can share the same rank if they are tied after involving all configured tiebreakers.
Example: 3
- participantobject|null
- tournament_idstring
The id of the tournament.
Example: "378426939508809728"