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-Key
    string

    API key of your application (see Authentication)

  • Authorization
    string

    Access token with organizer:result scope (see Authorization)

  • Range
    string

    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_ids
    array

    Only return tournaments for the given list of ids.

    Example: 378426939508809728,534138941862841533

  • custom_user_identifiers
    array

    A list of external custom user identifiers.

    Example: acme:account:1234,acme:account:1235

  • participant_ids
    array

    One or several participant ids involved in the standings to filter.

    Example: 618965416546776434,618975467354349191

  • min_rank
    integer

    A minimal rank to filter.

  • max_rank
    integer

    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)
  • id
    string

    A unique identifier for the standing item.

    Example: "378426939508809728"

  • position
    integer

    A position used for presentation purposes. It is always unique within the same standing.

    Example: 4

  • rank
    integer|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

  • participant
    object|null
  • tournament_id
    string

    The id of the tournament.

    Example: "378426939508809728"