Viewer API › Final Standings Legacy

This endpoint is in legacy mode. Access will soon be deprecated. It is therefore advised to use another endpoint when possible.

Returns a list of final standing items.

Resource URL

https://api.toornament.com/viewer/v2/standing-items

HTTP headers

• X-Api-Key

  string

  API key of your application (see Authentication)

• 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

• participant_ids

  array

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

  Example: 618965416546776434,618975467354349191

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_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
  • id

    string

    The id of the participant.

    Example: "375143143408309123"

  • name

    string

    The name of the participant.

    Max. length: 40 characters

    Example: "Jon Snow"

  • custom_fields

    object

    The values of the public custom fields configured in the tournament using the machine names as keys. For more information, please read the Custom Fields documentation.

    Example: {}

• tournament_id

  string

  The id of the tournament.

  Example: "378426939508809728"