📢 The Ask AI can now translate any part of the docs to your preferred language!
Read the guide
sportradar.comSportradar Support Portal

Competition Leaders

Competition statistical leaders are a list of persons for a statistic ranked from highest to lowest across an entire competition (multi-season). Each season's own qualification rules are applied to that season's data before aggregating and ranking across seasons.

competition statistical leaders

get
/ice3/o/{organizationId}/statistics/leaders/for/{statistic}/in/competitions/{competitionId}

Return a list of the leading persons for a statistic in a competition, aggregated across all included seasons in that competition.

Required scopes
This endpoint requires the following scopes:
  • : Read any data from the organization down
Authorizations
OAuth2clientCredentialsRequired

You can create a JSON Web Token (JWT) using the token API call. Each token is given a set of scopes/permissions. Each endpoint has a scope/permission that it requires to run. If your token does not possess the correct scope then you will be unable to make the API call.

Token URL:
Path parameters
competitionIdstring · uuidRequired

The unique identifier of the competition

Example: 009e9276-5c80-11e8-9c2d-fa7ae01bbebc
organizationIdstring · min: 5 · max: 5Required

The unique identifier of the organization

Example: b1a23
statisticstring · max: 50Required

The name of the statistic

Example: points
Query parameters
entityIdstring · uuidOptional

The unique identifier of the entity

Example: 009e9276-5c80-11e8-9c2d-fa7ae01bbebc
externalstringOptional

A comma separated list of fields that will instead be interpreted as an externalId. See External Ids for more information.

Example: entityId,personId
fieldsstringOptional

A comma separated list of fields to display. The response will only display these fields. See Partial Response section for more information.

Example: dob,firstName,organization(id),organizations[name], teams[name,details/metrics/*,tags(id)]
fixtureTypestring · enum · max: 50Optional

Type of Fixture

  • ALL_STAR All Star
  • DEMONSTRATION Demonstration
  • FINAL Final
  • FRIENDLY Friendly
  • PLAYOFF Playoff
  • PRESEASON Pre Season
  • REGULAR Regular
Example: REGULARPossible values:
hideNullbooleanOptional

Don't display data fields with null values or empty structures

Example: true
homeAwaystring · enum · max: 50Optional

Where the result was

  • AWAY Away
  • HOME Home
Possible values:
includestringOptional

A comma separated list of resource types to include. See Resource Inclusion for more information.

Example: organizations,fixtures,entities
isPlayerbooleanOptional

Is the person a player?

isTeamOfficialbooleanOptional

Is the person a team official?

limitinteger · int32 · min: 1 · max: 1000Optional

The maximum number of records to return. See Pagination for more information.

Default: 10Example: 10
offsetinteger · int32Optional

The offset of the records. See Pagination for more information.

Example: 10
personIdstring · uuidOptional

The unique identifier of the person

Example: 009e9276-5c80-11e8-9c2d-fa7ae01bbebc
starterbooleanOptional

Is the person a starter in the match ?

winLossstring · enum · max: 50Optional

What the result was

  • DRAW Draw
  • LOSS Loss
  • WIN Win
Possible values:
Responses
200

Successful operation

application/json
get
/ice3/o/{organizationId}/statistics/leaders/for/{statistic}/in/competitions/{competitionId}
GET /v1/ice3/o/{organizationId}/statistics/leaders/for/{statistic}/in/competitions/{competitionId} HTTP/1.1
Host: api.dc.connect.sportradar.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

{
  "meta": {
    "version": 1,
    "codeVersion": "d6cd1e2bd19e03a81132a23b2025920577f84e37",
    "code": 200,
    "time": "2018-06-05 23:43:41.227584+00:00",
    "fromCache": false,
    "count": 7,
    "limit": 10,
    "offset": 10,
    "generationTime": 0.011604
  },
  "links": {
    "self": "https://example.com",
    "next": "https://example.com",
    "previous": "https://example.com"
  },
  "included": {
    "resources": {
      "ANY_ADDITIONAL_PROPERTY": "league"
    }
  },
  "data": [
    {
      "personId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "person": {
        "resourceType": "persons",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "organizationId": "9",
      "organization": {
        "resourceType": "organizations",
        "id": "9"
      },
      "competitionId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "competition": {
        "resourceType": "competitions",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "statistics": {
        "assistsPrimary": 1,
        "assistsPrimaryPerGame": 1,
        "assistsSecondary": 1,
        "assistsSecondaryPerGame": 1,
        "assists": 1,
        "assistsPerGame": 1,
        "blocks": 1,
        "blocksPerGame": 1,
        "draws": 1,
        "faceOffsWon": 1,
        "faceOffsLost": 1,
        "games": 1,
        "gamesLost": 1,
        "gamesPlayed": 1,
        "gamesStarted": 1,
        "gamesWon": 1,
        "goalsAgainstAverage": 1,
        "goalsConceded": 1,
        "goalsEmptyNet": 1,
        "goalsPercentage": 1,
        "goalsPenaltyShot": 1,
        "goalsPenaltyShotPerGame": 1,
        "goalsScored": 1,
        "goalsScoredPerGame": 1,
        "goalsShootOut": 1,
        "losses": 1,
        "minus": 1,
        "penalties": 1,
        "penaltiesPerGame": 1,
        "penaltiesDrawn": 1,
        "penaltiesDrawnPerGame": 1,
        "plus": 1,
        "plusMinus": 1,
        "points": 1,
        "pointsPerGame": 1,
        "saves": 1,
        "savesPerGame": 1,
        "savesPenaltyShot": 1,
        "savesPenaltyShotPerGame": 1,
        "savesPercentage": 1,
        "savesPercentageShootOut": 1,
        "savesShootOut": 1,
        "shots": 1,
        "shotsPerGame": 1,
        "shotsMissed": 1,
        "shotsMissedPerGame": 1,
        "shotsMissedPenaltyShot": 1,
        "shotsMissedPenaltyShotPerGame": 1,
        "shotsMissedShootOut": 1,
        "shotsOnTarget": 1,
        "shotsOnTargetPerGame": 1,
        "shotsOnTargetAgainst": 1,
        "shutOut": 1,
        "minutes": "text",
        "minutesPerGame": "text",
        "wins": 1
      }
    }
  ]
}

competition statistical leader summary

get
/ice3/o/{organizationId}/statistics/leaders/in/competitions/{competitionId}

Return a summary of the leading persons for a number of statistics in a competition. Only the requested statistic is returned within the 'statistics' object of each row.

Required scopes
This endpoint requires the following scopes:
  • : Read any data from the organization down
Authorizations
OAuth2clientCredentialsRequired

You can create a JSON Web Token (JWT) using the token API call. Each token is given a set of scopes/permissions. Each endpoint has a scope/permission that it requires to run. If your token does not possess the correct scope then you will be unable to make the API call.

Token URL:
Path parameters
competitionIdstring · uuidRequired

The unique identifier of the competition

Example: 009e9276-5c80-11e8-9c2d-fa7ae01bbebc
organizationIdstring · min: 5 · max: 5Required

The unique identifier of the organization

Example: b1a23
Query parameters
entityIdstring · uuidOptional

The unique identifier of the entity

Example: 009e9276-5c80-11e8-9c2d-fa7ae01bbebc
externalstringOptional

A comma separated list of fields that will instead be interpreted as an externalId. See External Ids for more information.

Example: entityId,personId
fieldsstringOptional

A comma separated list of fields to display. The response will only display these fields. See Partial Response section for more information.

Example: dob,firstName,organization(id),organizations[name], teams[name,details/metrics/*,tags(id)]
fixtureTypestring · enum · max: 50Optional

Type of Fixture

  • ALL_STAR All Star
  • DEMONSTRATION Demonstration
  • FINAL Final
  • FRIENDLY Friendly
  • PLAYOFF Playoff
  • PRESEASON Pre Season
  • REGULAR Regular
Example: REGULARPossible values:
hideNullbooleanOptional

Don't display data fields with null values or empty structures

Example: true
homeAwaystring · enum · max: 50Optional

Where the result was

  • AWAY Away
  • HOME Home
Possible values:
includestringOptional

A comma separated list of resource types to include. See Resource Inclusion for more information.

Example: organizations,fixtures,entities
isPlayerbooleanOptional

Is the person a player?

isTeamOfficialbooleanOptional

Is the person a team official?

limitinteger · int32 · min: 1 · max: 1000Optional

The maximum number of records to return. See Pagination for more information.

Default: 10Example: 10
offsetinteger · int32Optional

The offset of the records. See Pagination for more information.

Example: 10
personIdstring · uuidOptional

The unique identifier of the person

Example: 009e9276-5c80-11e8-9c2d-fa7ae01bbebc
starterbooleanOptional

Is the person a starter in the match ?

statisticsstringOptional

The name of the statistic. Can specify multiple, delimited by comma.

Example: points,minutes
winLossstring · enum · max: 50Optional

What the result was

  • DRAW Draw
  • LOSS Loss
  • WIN Win
Possible values:
Responses
200

Successful operation

application/json
get
/ice3/o/{organizationId}/statistics/leaders/in/competitions/{competitionId}
GET /v1/ice3/o/{organizationId}/statistics/leaders/in/competitions/{competitionId} HTTP/1.1
Host: api.dc.connect.sportradar.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

{
  "meta": {
    "version": 1,
    "codeVersion": "d6cd1e2bd19e03a81132a23b2025920577f84e37",
    "code": 200,
    "time": "2018-06-05 23:43:41.227584+00:00",
    "fromCache": false,
    "count": 7,
    "limit": 10,
    "offset": 10,
    "generationTime": 0.011604
  },
  "links": {
    "self": "https://example.com",
    "next": "https://example.com",
    "previous": "https://example.com"
  },
  "included": {
    "resources": {
      "ANY_ADDITIONAL_PROPERTY": "league"
    }
  },
  "data": [
    {
      "statName": [
        {
          "personId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
          "person": {
            "resourceType": "persons",
            "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
          },
          "entityId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
          "entity": {
            "resourceType": "entities",
            "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
          },
          "organizationId": "9",
          "organization": {
            "resourceType": "organizations",
            "id": "9"
          },
          "seasonId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
          "season": {
            "resourceType": "seasons",
            "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
          },
          "competitionId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
          "competition": {
            "resourceType": "competitions",
            "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
          },
          "statistics": {
            "assistsPrimary": 1,
            "assistsPrimaryPerGame": 1,
            "assistsSecondary": 1,
            "assistsSecondaryPerGame": 1,
            "assists": 1,
            "assistsPerGame": 1,
            "blocks": 1,
            "blocksPerGame": 1,
            "draws": 1,
            "faceOffsWon": 1,
            "faceOffsLost": 1,
            "games": 1,
            "gamesLost": 1,
            "gamesPlayed": 1,
            "gamesStarted": 1,
            "gamesWon": 1,
            "goalsAgainstAverage": 1,
            "goalsConceded": 1,
            "goalsEmptyNet": 1,
            "goalsPercentage": 1,
            "goalsPenaltyShot": 1,
            "goalsPenaltyShotPerGame": 1,
            "goalsScored": 1,
            "goalsScoredPerGame": 1,
            "goalsShootOut": 1,
            "losses": 1,
            "minus": 1,
            "penalties": 1,
            "penaltiesPerGame": 1,
            "penaltiesDrawn": 1,
            "penaltiesDrawnPerGame": 1,
            "plus": 1,
            "plusMinus": 1,
            "points": 1,
            "pointsPerGame": 1,
            "saves": 1,
            "savesPerGame": 1,
            "savesPenaltyShot": 1,
            "savesPenaltyShotPerGame": 1,
            "savesPercentage": 1,
            "savesPercentageShootOut": 1,
            "savesShootOut": 1,
            "shots": 1,
            "shotsPerGame": 1,
            "shotsMissed": 1,
            "shotsMissedPerGame": 1,
            "shotsMissedPenaltyShot": 1,
            "shotsMissedPenaltyShotPerGame": 1,
            "shotsMissedShootOut": 1,
            "shotsOnTarget": 1,
            "shotsOnTargetPerGame": 1,
            "shotsOnTargetAgainst": 1,
            "shutOut": 1,
            "minutes": "text",
            "minutesPerGame": "text",
            "wins": 1
          }
        }
      ]
    }
  ]
}

Fast (pre-aggregated) competition statistical leaders

get
/ice3/o/{organizationId}/statistics/leaders/for/{statistic}/in/competitions/{competitionId}/simple

Return pre-aggregated list of the leading persons for a statistic in a competition derived from the side table based on aggregated data across all included seasons in that competition.

Required scopes
This endpoint requires the following scopes:
  • : Read any data from the organization down
Authorizations
OAuth2clientCredentialsRequired

You can create a JSON Web Token (JWT) using the token API call. Each token is given a set of scopes/permissions. Each endpoint has a scope/permission that it requires to run. If your token does not possess the correct scope then you will be unable to make the API call.

Token URL:
Path parameters
competitionIdstring · uuidRequired

The unique identifier of the competition

Example: 009e9276-5c80-11e8-9c2d-fa7ae01bbebc
organizationIdstring · min: 5 · max: 5Required

The unique identifier of the organization

Example: b1a23
statisticstring · max: 50Required

The name of the statistic

Example: points
Query parameters
externalstringOptional

A comma separated list of fields that will instead be interpreted as an externalId. See External Ids for more information.

Example: entityId,personId
fieldsstringOptional

A comma separated list of fields to display. The response will only display these fields. See Partial Response section for more information.

Example: dob,firstName,organization(id),organizations[name], teams[name,details/metrics/*,tags(id)]
fixtureTypestring · enum · max: 50Optional

Type of Fixture

  • ALL_STAR All Star
  • DEMONSTRATION Demonstration
  • FINAL Final
  • FRIENDLY Friendly
  • PLAYOFF Playoff
  • PRESEASON Pre Season
  • REGULAR Regular
Example: REGULARPossible values:
hideNullbooleanOptional

Don't display data fields with null values or empty structures

Example: true
includestringOptional

A comma separated list of resource types to include. See Resource Inclusion for more information.

Example: organizations,fixtures,entities
limitinteger · int32 · min: 1 · max: 1000Optional

The maximum number of records to return. See Pagination for more information.

Default: 10Example: 10
offsetinteger · int32Optional

The offset of the records. See Pagination for more information.

Example: 10
Responses
200

Successful operation

application/json
get
/ice3/o/{organizationId}/statistics/leaders/for/{statistic}/in/competitions/{competitionId}/simple
GET /v1/ice3/o/{organizationId}/statistics/leaders/for/{statistic}/in/competitions/{competitionId}/simple HTTP/1.1
Host: api.dc.connect.sportradar.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

{
  "meta": {
    "version": 1,
    "codeVersion": "d6cd1e2bd19e03a81132a23b2025920577f84e37",
    "code": 200,
    "time": "2018-06-05 23:43:41.227584+00:00",
    "fromCache": false,
    "count": 7,
    "limit": 10,
    "offset": 10,
    "generationTime": 0.011604
  },
  "links": {
    "self": "https://example.com",
    "next": "https://example.com",
    "previous": "https://example.com"
  },
  "included": {
    "resources": {
      "ANY_ADDITIONAL_PROPERTY": "league"
    }
  },
  "data": [
    {
      "organizationId": "9",
      "organization": {
        "resourceType": "organizations",
        "id": "9"
      },
      "competitionId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "competition": {
        "resourceType": "competitions",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "personId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "person": {
        "resourceType": "persons",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "fixtureType": "text",
      "statisticField": "text",
      "order": 1,
      "statistics": null,
      "added": "2025-11-19T06:04:43.495Z",
      "updated": "2025-11-19T06:04:43.495Z"
    }
  ]
}

Fast (pre-aggregated) competition statistical leader summary

get
/ice3/o/{organizationId}/statistics/leaders/in/competitions/{competitionId}/simple

Return a summary {stat: rows} from the side table for the requested statistics.

Required scopes
This endpoint requires the following scopes:
  • : Read any data from the organization down
Authorizations
OAuth2clientCredentialsRequired

You can create a JSON Web Token (JWT) using the token API call. Each token is given a set of scopes/permissions. Each endpoint has a scope/permission that it requires to run. If your token does not possess the correct scope then you will be unable to make the API call.

Token URL:
Path parameters
competitionIdstring · uuidRequired

The unique identifier of the competition

Example: 009e9276-5c80-11e8-9c2d-fa7ae01bbebc
organizationIdstring · min: 5 · max: 5Required

The unique identifier of the organization

Example: b1a23
Query parameters
externalstringOptional

A comma separated list of fields that will instead be interpreted as an externalId. See External Ids for more information.

Example: entityId,personId
fieldsstringOptional

A comma separated list of fields to display. The response will only display these fields. See Partial Response section for more information.

Example: dob,firstName,organization(id),organizations[name], teams[name,details/metrics/*,tags(id)]
fixtureTypestring · enum · max: 50Optional

Type of Fixture

  • ALL_STAR All Star
  • DEMONSTRATION Demonstration
  • FINAL Final
  • FRIENDLY Friendly
  • PLAYOFF Playoff
  • PRESEASON Pre Season
  • REGULAR Regular
Example: REGULARPossible values:
hideNullbooleanOptional

Don't display data fields with null values or empty structures

Example: true
includestringOptional

A comma separated list of resource types to include. See Resource Inclusion for more information.

Example: organizations,fixtures,entities
limitinteger · int32 · min: 1 · max: 1000Optional

The maximum number of records to return. See Pagination for more information.

Default: 10Example: 10
offsetinteger · int32Optional

The offset of the records. See Pagination for more information.

Example: 10
statisticsstringOptional

The name of the statistic. Can specify multiple, delimited by comma.

Example: points,minutes
Responses
200

Successful operation

application/json
get
/ice3/o/{organizationId}/statistics/leaders/in/competitions/{competitionId}/simple
GET /v1/ice3/o/{organizationId}/statistics/leaders/in/competitions/{competitionId}/simple HTTP/1.1
Host: api.dc.connect.sportradar.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

{
  "meta": {
    "version": 1,
    "codeVersion": "d6cd1e2bd19e03a81132a23b2025920577f84e37",
    "code": 200,
    "time": "2018-06-05 23:43:41.227584+00:00",
    "fromCache": false,
    "count": 7,
    "limit": 10,
    "offset": 10,
    "generationTime": 0.011604
  },
  "links": {
    "self": "https://example.com",
    "next": "https://example.com",
    "previous": "https://example.com"
  },
  "included": {
    "resources": {
      "ANY_ADDITIONAL_PROPERTY": "league"
    }
  },
  "data": [
    {
      "organizationId": "9",
      "organization": {
        "resourceType": "organizations",
        "id": "9"
      },
      "competitionId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "competition": {
        "resourceType": "competitions",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "personId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "person": {
        "resourceType": "persons",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "fixtureType": "text",
      "statisticField": "text",
      "order": 1,
      "statistics": null,
      "added": "2025-11-19T06:04:43.495Z",
      "updated": "2025-11-19T06:04:43.495Z"
    }
  ]
}

Build competition person leaders side table

post
/ice3/o/{organizationId}/statistics/leaders/in/competitions/{competitionId}/build

Build pre-aggregated competition person leaders for a competition.

Required scopes
This endpoint requires the following scopes:
  • : Write/Update any data from below the organization
Authorizations
OAuth2clientCredentialsRequired

You can create a JSON Web Token (JWT) using the token API call. Each token is given a set of scopes/permissions. Each endpoint has a scope/permission that it requires to run. If your token does not possess the correct scope then you will be unable to make the API call.

Token URL:
Path parameters
competitionIdstring · uuidRequired

The unique identifier of the competition

Example: 009e9276-5c80-11e8-9c2d-fa7ae01bbebc
organizationIdstring · min: 5 · max: 5Required

The unique identifier of the organization

Example: b1a23
Query parameters
externalstringOptional

A comma separated list of fields that will instead be interpreted as an externalId. See External Ids for more information.

Example: entityId,personId
fieldsstringOptional

A comma separated list of fields to display. The response will only display these fields. See Partial Response section for more information.

Example: dob,firstName,organization(id),organizations[name], teams[name,details/metrics/*,tags(id)]
hideNullbooleanOptional

Don't display data fields with null values or empty structures

Example: true
includestringOptional

A comma separated list of resource types to include. See Resource Inclusion for more information.

Example: organizations,fixtures,entities
Responses
200

Successful operation

application/json
post
/ice3/o/{organizationId}/statistics/leaders/in/competitions/{competitionId}/build
POST /v1/ice3/o/{organizationId}/statistics/leaders/in/competitions/{competitionId}/build HTTP/1.1
Host: api.dc.connect.sportradar.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

{
  "meta": {
    "version": 1,
    "codeVersion": "d6cd1e2bd19e03a81132a23b2025920577f84e37",
    "code": 200,
    "time": "2018-06-05 23:43:41.227584+00:00",
    "fromCache": false,
    "count": 7,
    "limit": 10,
    "offset": 10,
    "generationTime": 0.011604
  },
  "links": {
    "self": "https://example.com",
    "next": "https://example.com",
    "previous": "https://example.com"
  },
  "included": {
    "resources": {
      "ANY_ADDITIONAL_PROPERTY": "league"
    }
  },
  "data": [
    {
      "personId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "person": {
        "resourceType": "persons",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "organizationId": "9",
      "organization": {
        "resourceType": "organizations",
        "id": "9"
      },
      "competitionId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "competition": {
        "resourceType": "competitions",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "statistics": {
        "assistsPrimary": 1,
        "assistsPrimaryPerGame": 1,
        "assistsSecondary": 1,
        "assistsSecondaryPerGame": 1,
        "assists": 1,
        "assistsPerGame": 1,
        "blocks": 1,
        "blocksPerGame": 1,
        "draws": 1,
        "faceOffsWon": 1,
        "faceOffsLost": 1,
        "games": 1,
        "gamesLost": 1,
        "gamesPlayed": 1,
        "gamesStarted": 1,
        "gamesWon": 1,
        "goalsAgainstAverage": 1,
        "goalsConceded": 1,
        "goalsEmptyNet": 1,
        "goalsPercentage": 1,
        "goalsPenaltyShot": 1,
        "goalsPenaltyShotPerGame": 1,
        "goalsScored": 1,
        "goalsScoredPerGame": 1,
        "goalsShootOut": 1,
        "losses": 1,
        "minus": 1,
        "penalties": 1,
        "penaltiesPerGame": 1,
        "penaltiesDrawn": 1,
        "penaltiesDrawnPerGame": 1,
        "plus": 1,
        "plusMinus": 1,
        "points": 1,
        "pointsPerGame": 1,
        "saves": 1,
        "savesPerGame": 1,
        "savesPenaltyShot": 1,
        "savesPenaltyShotPerGame": 1,
        "savesPercentage": 1,
        "savesPercentageShootOut": 1,
        "savesShootOut": 1,
        "shots": 1,
        "shotsPerGame": 1,
        "shotsMissed": 1,
        "shotsMissedPerGame": 1,
        "shotsMissedPenaltyShot": 1,
        "shotsMissedPenaltyShotPerGame": 1,
        "shotsMissedShootOut": 1,
        "shotsOnTarget": 1,
        "shotsOnTargetPerGame": 1,
        "shotsOnTargetAgainst": 1,
        "shutOut": 1,
        "minutes": "text",
        "minutesPerGame": "text",
        "wins": 1
      }
    }
  ]
}

Build all competition person leaders (org)

post
/ice3/o/{organizationId}/statistics/leaders/in/competitions/build

Build pre-aggregated competition person leaders for all competitions in an organization.

Required scopes
This endpoint requires the following scopes:
  • : Write/Update any data from below the organization
Authorizations
OAuth2clientCredentialsRequired

You can create a JSON Web Token (JWT) using the token API call. Each token is given a set of scopes/permissions. Each endpoint has a scope/permission that it requires to run. If your token does not possess the correct scope then you will be unable to make the API call.

Token URL:
Path parameters
organizationIdstring · min: 5 · max: 5Required

The unique identifier of the organization

Example: b1a23
Query parameters
externalstringOptional

A comma separated list of fields that will instead be interpreted as an externalId. See External Ids for more information.

Example: entityId,personId
fieldsstringOptional

A comma separated list of fields to display. The response will only display these fields. See Partial Response section for more information.

Example: dob,firstName,organization(id),organizations[name], teams[name,details/metrics/*,tags(id)]
hideNullbooleanOptional

Don't display data fields with null values or empty structures

Example: true
includestringOptional

A comma separated list of resource types to include. See Resource Inclusion for more information.

Example: organizations,fixtures,entities
Responses
200

Successful operation

application/json
post
/ice3/o/{organizationId}/statistics/leaders/in/competitions/build
POST /v1/ice3/o/{organizationId}/statistics/leaders/in/competitions/build HTTP/1.1
Host: api.dc.connect.sportradar.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

{
  "meta": {
    "version": 1,
    "codeVersion": "d6cd1e2bd19e03a81132a23b2025920577f84e37",
    "code": 200,
    "time": "2018-06-05 23:43:41.227584+00:00",
    "fromCache": false,
    "count": 7,
    "limit": 10,
    "offset": 10,
    "generationTime": 0.011604
  },
  "links": {
    "self": "https://example.com",
    "next": "https://example.com",
    "previous": "https://example.com"
  },
  "included": {
    "resources": {
      "ANY_ADDITIONAL_PROPERTY": "league"
    }
  },
  "data": [
    {
      "personId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "person": {
        "resourceType": "persons",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "organizationId": "9",
      "organization": {
        "resourceType": "organizations",
        "id": "9"
      },
      "competitionId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "competition": {
        "resourceType": "competitions",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "statistics": {
        "assistsPrimary": 1,
        "assistsPrimaryPerGame": 1,
        "assistsSecondary": 1,
        "assistsSecondaryPerGame": 1,
        "assists": 1,
        "assistsPerGame": 1,
        "blocks": 1,
        "blocksPerGame": 1,
        "draws": 1,
        "faceOffsWon": 1,
        "faceOffsLost": 1,
        "games": 1,
        "gamesLost": 1,
        "gamesPlayed": 1,
        "gamesStarted": 1,
        "gamesWon": 1,
        "goalsAgainstAverage": 1,
        "goalsConceded": 1,
        "goalsEmptyNet": 1,
        "goalsPercentage": 1,
        "goalsPenaltyShot": 1,
        "goalsPenaltyShotPerGame": 1,
        "goalsScored": 1,
        "goalsScoredPerGame": 1,
        "goalsShootOut": 1,
        "losses": 1,
        "minus": 1,
        "penalties": 1,
        "penaltiesPerGame": 1,
        "penaltiesDrawn": 1,
        "penaltiesDrawnPerGame": 1,
        "plus": 1,
        "plusMinus": 1,
        "points": 1,
        "pointsPerGame": 1,
        "saves": 1,
        "savesPerGame": 1,
        "savesPenaltyShot": 1,
        "savesPenaltyShotPerGame": 1,
        "savesPercentage": 1,
        "savesPercentageShootOut": 1,
        "savesShootOut": 1,
        "shots": 1,
        "shotsPerGame": 1,
        "shotsMissed": 1,
        "shotsMissedPerGame": 1,
        "shotsMissedPenaltyShot": 1,
        "shotsMissedPenaltyShotPerGame": 1,
        "shotsMissedShootOut": 1,
        "shotsOnTarget": 1,
        "shotsOnTargetPerGame": 1,
        "shotsOnTargetAgainst": 1,
        "shutOut": 1,
        "minutes": "text",
        "minutesPerGame": "text",
        "wins": 1
      }
    }
  ]
}

List competition leaders configuration

get
/ice3/admin/statistics/leaders/in/competitions/config

Return configuration rows that drive competition person leaders builds.

Authorizations
OAuth2clientCredentialsRequired

You can create a JSON Web Token (JWT) using the token API call. Each token is given a set of scopes/permissions. Each endpoint has a scope/permission that it requires to run. If your token does not possess the correct scope then you will be unable to make the API call.

Token URL:
Available scopes:
  • : Authenticate based on a specific OrganizationId
  • : Read data over multiple organizations using and *orggroup* code
  • : Write/Update any data from below the organization
  • : Read any data from the organization down
  • : Perform administration API calls
  • : Ability to manage organizations
  • : Perform system configuration API calls
Query parameters
competitionIdstring · uuidOptional

The unique identifier of the competition

Example: 009e9276-5c80-11e8-9c2d-fa7ae01bbebc
externalstringOptional

A comma separated list of fields that will instead be interpreted as an externalId. See External Ids for more information.

Example: entityId,personId
fieldsstringOptional

A comma separated list of fields to display. The response will only display these fields. See Partial Response section for more information.

Example: dob,firstName,organization(id),organizations[name], teams[name,details/metrics/*,tags(id)]
hideNullbooleanOptional

Don't display data fields with null values or empty structures

Example: true
includestringOptional

A comma separated list of resource types to include. See Resource Inclusion for more information.

Example: organizations,fixtures,entities
limitinteger · int32 · min: 1 · max: 1000Optional

The maximum number of records to return. See Pagination for more information.

Default: 10Example: 10
offsetinteger · int32Optional

The offset of the records. See Pagination for more information.

Example: 10
organizationIdstring · min: 5 · max: 5Optional

The unique identifier of the organization

Example: b1a23
Responses
200

Successful operation

application/json
get
/ice3/admin/statistics/leaders/in/competitions/config
GET /v1/ice3/admin/statistics/leaders/in/competitions/config HTTP/1.1
Host: api.dc.connect.sportradar.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

{
  "meta": {
    "version": 1,
    "codeVersion": "d6cd1e2bd19e03a81132a23b2025920577f84e37",
    "code": 200,
    "time": "2018-06-05 23:43:41.227584+00:00",
    "fromCache": false,
    "count": 7,
    "limit": 10,
    "offset": 10,
    "generationTime": 0.011604
  },
  "links": {
    "self": "https://example.com",
    "next": "https://example.com",
    "previous": "https://example.com"
  },
  "included": {
    "resources": {
      "ANY_ADDITIONAL_PROPERTY": "league"
    }
  },
  "data": [
    {
      "competitionPersonLeadersConfigurationId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "organizationId": "b1a23",
      "competitionId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "runEvery": 1,
      "lastRun": "2025-01-01 12:00:00",
      "added": "2025-11-19T06:04:43.495Z",
      "updated": "2025-11-19T06:04:43.495Z"
    }
  ]
}

Upsert competition person leaders configuration

post
/ice3/admin/statistics/leaders/in/competitions/config

Insert or update competition person leaders configuration rows.

Required scopes
This endpoint requires the following scopes:
  • : Perform administration API calls
Authorizations
OAuth2clientCredentialsRequired

You can create a JSON Web Token (JWT) using the token API call. Each token is given a set of scopes/permissions. Each endpoint has a scope/permission that it requires to run. If your token does not possess the correct scope then you will be unable to make the API call.

Token URL:
Query parameters
competitionIdstring · uuidOptional

The unique identifier of the competition

Example: 009e9276-5c80-11e8-9c2d-fa7ae01bbebc
externalstringOptional

A comma separated list of fields that will instead be interpreted as an externalId. See External Ids for more information.

Example: entityId,personId
fieldsstringOptional

A comma separated list of fields to display. The response will only display these fields. See Partial Response section for more information.

Example: dob,firstName,organization(id),organizations[name], teams[name,details/metrics/*,tags(id)]
hideNullbooleanOptional

Don't display data fields with null values or empty structures

Example: true
includestringOptional

A comma separated list of resource types to include. See Resource Inclusion for more information.

Example: organizations,fixtures,entities
organizationIdstring · min: 5 · max: 5Optional

The unique identifier of the organization

Example: b1a23
Body
competitionPersonLeadersConfigurationIdstring · uuidOptional

The unique identifier of the competition person leaders configuration row

Example: 009e9276-5c80-11e8-9c2d-fa7ae01bbebc
organizationIdstring · min: 5 · max: 5Required

The unique identifier of the organization

Example: b1a23
competitionIdstring · uuid | nullableOptional

The unique identifier of the competition (optional for org-wide config)

Example: 009e9276-5c80-11e8-9c2d-fa7ae01bbebc
runEveryinteger · int32Optional

Minutes between scheduled builds (0 to always allow)

Responses
200

Successful operation

application/json
post
/ice3/admin/statistics/leaders/in/competitions/config
POST /v1/ice3/admin/statistics/leaders/in/competitions/config HTTP/1.1
Host: api.dc.connect.sportradar.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 175

{
  "competitionPersonLeadersConfigurationId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
  "organizationId": "b1a23",
  "competitionId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
  "runEvery": 1
}
{
  "meta": {
    "version": 1,
    "codeVersion": "d6cd1e2bd19e03a81132a23b2025920577f84e37",
    "code": 200,
    "time": "2018-06-05 23:43:41.227584+00:00",
    "fromCache": false,
    "count": 7,
    "limit": 10,
    "offset": 10,
    "generationTime": 0.011604
  },
  "links": {
    "self": "https://example.com",
    "next": "https://example.com",
    "previous": "https://example.com"
  },
  "included": {
    "resources": {
      "ANY_ADDITIONAL_PROPERTY": "league"
    }
  },
  "data": [
    {
      "competitionPersonLeadersConfigurationId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "organizationId": "b1a23",
      "competitionId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "runEvery": 1,
      "lastRun": "2025-01-01 12:00:00",
      "added": "2025-11-19T06:04:43.495Z",
      "updated": "2025-11-19T06:04:43.495Z"
    }
  ]
}

Delete competition person leaders configuration

delete
/ice3/admin/statistics/leaders/in/competitions/config

Remove competition person leaders configuration rows.

Required scopes
This endpoint requires the following scopes:
  • : Perform administration API calls
Authorizations
OAuth2clientCredentialsRequired

You can create a JSON Web Token (JWT) using the token API call. Each token is given a set of scopes/permissions. Each endpoint has a scope/permission that it requires to run. If your token does not possess the correct scope then you will be unable to make the API call.

Token URL:
Query parameters
competitionIdstring · uuidOptional

The unique identifier of the competition

Example: 009e9276-5c80-11e8-9c2d-fa7ae01bbebc
externalstringOptional

A comma separated list of fields that will instead be interpreted as an externalId. See External Ids for more information.

Example: entityId,personId
fieldsstringOptional

A comma separated list of fields to display. The response will only display these fields. See Partial Response section for more information.

Example: dob,firstName,organization(id),organizations[name], teams[name,details/metrics/*,tags(id)]
hideNullbooleanOptional

Don't display data fields with null values or empty structures

Example: true
includestringOptional

A comma separated list of resource types to include. See Resource Inclusion for more information.

Example: organizations,fixtures,entities
organizationIdstring · min: 5 · max: 5Optional

The unique identifier of the organization

Example: b1a23
Responses
200

Successful operation

application/json
delete
/ice3/admin/statistics/leaders/in/competitions/config
DELETE /v1/ice3/admin/statistics/leaders/in/competitions/config HTTP/1.1
Host: api.dc.connect.sportradar.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

{
  "meta": {
    "version": 1,
    "codeVersion": "d6cd1e2bd19e03a81132a23b2025920577f84e37",
    "code": 200,
    "time": "2018-06-05 23:43:41.227584+00:00",
    "fromCache": false,
    "count": 7,
    "limit": 10,
    "offset": 10,
    "generationTime": 0.011604
  },
  "links": {
    "self": "https://example.com",
    "next": "https://example.com",
    "previous": "https://example.com"
  },
  "included": {
    "resources": {
      "ANY_ADDITIONAL_PROPERTY": "league"
    }
  },
  "data": [
    {
      "competitionPersonLeadersConfigurationId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "organizationId": "b1a23",
      "competitionId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "runEvery": 1,
      "lastRun": "2025-01-01 12:00:00",
      "added": "2025-11-19T06:04:43.495Z",
      "updated": "2025-11-19T06:04:43.495Z"
    }
  ]
}

Build competition person leaders from configuration

post
/ice3/admin/statistics/leaders/in/competitions/config/build

Trigger competition person leaders builds for configured organizations and competitions.

Required scopes
This endpoint requires the following scopes:
  • : Perform administration API calls
Authorizations
OAuth2clientCredentialsRequired

You can create a JSON Web Token (JWT) using the token API call. Each token is given a set of scopes/permissions. Each endpoint has a scope/permission that it requires to run. If your token does not possess the correct scope then you will be unable to make the API call.

Token URL:
Query parameters
externalstringOptional

A comma separated list of fields that will instead be interpreted as an externalId. See External Ids for more information.

Example: entityId,personId
fieldsstringOptional

A comma separated list of fields to display. The response will only display these fields. See Partial Response section for more information.

Example: dob,firstName,organization(id),organizations[name], teams[name,details/metrics/*,tags(id)]
hideNullbooleanOptional

Don't display data fields with null values or empty structures

Example: true
includestringOptional

A comma separated list of resource types to include. See Resource Inclusion for more information.

Example: organizations,fixtures,entities
Body
competitionPersonLeadersConfigurationIdstring · uuidOptional

The unique identifier of the competition person leaders configuration row

Example: 009e9276-5c80-11e8-9c2d-fa7ae01bbebc
organizationIdstring · min: 5 · max: 5Required

The unique identifier of the organization

Example: b1a23
competitionIdstring · uuid | nullableOptional

The unique identifier of the competition (optional for org-wide config)

Example: 009e9276-5c80-11e8-9c2d-fa7ae01bbebc
runEveryinteger · int32Optional

Minutes between scheduled builds (0 to always allow)

Responses
200

Successful operation

application/json
post
/ice3/admin/statistics/leaders/in/competitions/config/build
POST /v1/ice3/admin/statistics/leaders/in/competitions/config/build HTTP/1.1
Host: api.dc.connect.sportradar.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 175

{
  "competitionPersonLeadersConfigurationId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
  "organizationId": "b1a23",
  "competitionId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
  "runEvery": 1
}
{
  "meta": {
    "version": 1,
    "codeVersion": "d6cd1e2bd19e03a81132a23b2025920577f84e37",
    "code": 200,
    "time": "2018-06-05 23:43:41.227584+00:00",
    "fromCache": false,
    "count": 7,
    "limit": 10,
    "offset": 10,
    "generationTime": 0.011604
  },
  "links": {
    "self": "https://example.com",
    "next": "https://example.com",
    "previous": "https://example.com"
  },
  "included": {
    "resources": {
      "ANY_ADDITIONAL_PROPERTY": "league"
    }
  },
  "data": [
    {
      "personId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "person": {
        "resourceType": "persons",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "organizationId": "9",
      "organization": {
        "resourceType": "organizations",
        "id": "9"
      },
      "competitionId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "competition": {
        "resourceType": "competitions",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "statistics": {
        "assistsPrimary": 1,
        "assistsPrimaryPerGame": 1,
        "assistsSecondary": 1,
        "assistsSecondaryPerGame": 1,
        "assists": 1,
        "assistsPerGame": 1,
        "blocks": 1,
        "blocksPerGame": 1,
        "draws": 1,
        "faceOffsWon": 1,
        "faceOffsLost": 1,
        "games": 1,
        "gamesLost": 1,
        "gamesPlayed": 1,
        "gamesStarted": 1,
        "gamesWon": 1,
        "goalsAgainstAverage": 1,
        "goalsConceded": 1,
        "goalsEmptyNet": 1,
        "goalsPercentage": 1,
        "goalsPenaltyShot": 1,
        "goalsPenaltyShotPerGame": 1,
        "goalsScored": 1,
        "goalsScoredPerGame": 1,
        "goalsShootOut": 1,
        "losses": 1,
        "minus": 1,
        "penalties": 1,
        "penaltiesPerGame": 1,
        "penaltiesDrawn": 1,
        "penaltiesDrawnPerGame": 1,
        "plus": 1,
        "plusMinus": 1,
        "points": 1,
        "pointsPerGame": 1,
        "saves": 1,
        "savesPerGame": 1,
        "savesPenaltyShot": 1,
        "savesPenaltyShotPerGame": 1,
        "savesPercentage": 1,
        "savesPercentageShootOut": 1,
        "savesShootOut": 1,
        "shots": 1,
        "shotsPerGame": 1,
        "shotsMissed": 1,
        "shotsMissedPerGame": 1,
        "shotsMissedPenaltyShot": 1,
        "shotsMissedPenaltyShotPerGame": 1,
        "shotsMissedShootOut": 1,
        "shotsOnTarget": 1,
        "shotsOnTargetPerGame": 1,
        "shotsOnTargetAgainst": 1,
        "shutOut": 1,
        "minutes": "text",
        "minutesPerGame": "text",
        "wins": 1
      }
    }
  ]
}
PreviousSeason LeadersNextMatch Live Summary

Last updated

Was this helpful?