Leader Criteria Sets

For individuals to appear in the list of statistical leaders you can apply a set of criteria. This criteria will contain a number of qualifiers. Each qualifier will compare a person statistic against a qualifying value. If the statistic compares favourably (based on the qualifier) then the person is included in the statistics leaders.

Leader criteria (sets) serve as a grouping tool for bundling multiple leader qualifiers together and reusing them across seasons. In order for leader criteria & leader qualifiers to be effective, each leader criteria needs to be assigned to a season either by updating an existing one with the leaderCriteriaId of the newly created leader criterion, or by including the leaderCriteriaId in the payload when creating a new season.

Get a list of leader criteria sets

get

https://api.dc.connect.sportradar.com/v1https://api.dc.stg.connect-nonprod.sportradar.dev/v1

/beachvolleyball/o/{organizationId}/statistics/leaders/criteria

Return a list of leader criteria sets

Required scopes

This endpoint requires the following scopes:

• : Read any data from the organization down

Authorizations

OAuth2

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

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

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

Default: 10Example: 10

namestring · max: 50Optional

Generic object name

nameContainsstring · min: 2 · max: 50Optional

Fields that allow a 'Contains' query string parameter search for words separated by a space, matching characters left to right. Example: nameFullLatin=David Johnson nameContains=Dav will match nameContains=John will match nameContains=son will not match

Example: Dav and name='David Johnson'

offsetinteger · int32Optional

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

Example: 10

Responses

200

Successful operation

application/json

default

Error

application/json

get

/beachvolleyball/o/{organizationId}/statistics/leaders/criteria

HTTPcURLJavaScriptPython

GET /v1/beachvolleyball/o/{organizationId}/statistics/leaders/criteria 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": [
    {
      "added": "2025-11-19T05:22:47.066Z",
      "updated": "2025-11-19T05:22:47.066Z",
      "organizationId": "9",
      "organization": {
        "resourceType": "organizations",
        "id": "9"
      },
      "leaderCriteriaId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "name": "text"
    }
  ]
}

Create a new leader criterion

post

https://api.dc.connect.sportradar.com/v1https://api.dc.stg.connect-nonprod.sportradar.dev/v1

/beachvolleyball/o/{organizationId}/statistics/leaders/criteria

Insert a new leader criterion

Required scopes

This endpoint requires the following scopes:

• : Write/Update any data from below the organization

Authorizations

OAuth2

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

Body

application/json

leaderCriteriaIdstring · uuidOptional

The unique identifier of the leader criteria

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

namestringRequired

The name of the criteria

Responses

200

Successful operation

application/json

default

Error

application/json

post

/beachvolleyball/o/{organizationId}/statistics/leaders/criteria

HTTPcURLJavaScriptPython

POST /v1/beachvolleyball/o/{organizationId}/statistics/leaders/criteria HTTP/1.1
Host: api.dc.connect.sportradar.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 73

{
  "leaderCriteriaId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
  "name": "text"
}

{
  "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": [
    {
      "added": "2025-11-19T05:22:47.066Z",
      "updated": "2025-11-19T05:22:47.066Z",
      "organizationId": "9",
      "organization": {
        "resourceType": "organizations",
        "id": "9"
      },
      "leaderCriteriaId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "name": "text"
    }
  ]
}

Get a leader criterion

get

https://api.dc.connect.sportradar.com/v1https://api.dc.stg.connect-nonprod.sportradar.dev/v1

/beachvolleyball/o/{organizationId}/statistics/leaders/criteria/{leaderCriteriaId}

Return detailed information about a specific leader criterion

Required scopes

This endpoint requires the following scopes:

• : Read any data from the organization down

Authorizations

OAuth2

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

leaderCriteriaIdstring · uuidRequired

The unique identifier of the leader criteria

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

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

default

Error

application/json

get

/beachvolleyball/o/{organizationId}/statistics/leaders/criteria/{leaderCriteriaId}

HTTPcURLJavaScriptPython

GET /v1/beachvolleyball/o/{organizationId}/statistics/leaders/criteria/{leaderCriteriaId} 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": [
    {
      "added": "2025-11-19T05:22:47.066Z",
      "updated": "2025-11-19T05:22:47.066Z",
      "organizationId": "9",
      "organization": {
        "resourceType": "organizations",
        "id": "9"
      },
      "leaderCriteriaId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "name": "text"
    }
  ]
}

Update a leader criteria

put

https://api.dc.connect.sportradar.com/v1https://api.dc.stg.connect-nonprod.sportradar.dev/v1

/beachvolleyball/o/{organizationId}/statistics/leaders/criteria/{leaderCriteriaId}

Update a leader criterion

Required scopes

This endpoint requires the following scopes:

• : Write/Update any data from below the organization

Authorizations

OAuth2

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

leaderCriteriaIdstring · uuidRequired

The unique identifier of the leader criteria

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

Body

application/json

namestringOptional

The name of the criteria

Responses

200

Successful operation

application/json

default

Error

application/json

put

/beachvolleyball/o/{organizationId}/statistics/leaders/criteria/{leaderCriteriaId}

HTTPcURLJavaScriptPython

PUT /v1/beachvolleyball/o/{organizationId}/statistics/leaders/criteria/{leaderCriteriaId} HTTP/1.1
Host: api.dc.connect.sportradar.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 15

{
  "name": "text"
}

{
  "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": [
    {
      "added": "2025-11-19T05:22:47.066Z",
      "updated": "2025-11-19T05:22:47.066Z",
      "organizationId": "9",
      "organization": {
        "resourceType": "organizations",
        "id": "9"
      },
      "leaderCriteriaId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "name": "text"
    }
  ]
}

Delete leader criteria

delete

https://api.dc.connect.sportradar.com/v1https://api.dc.stg.connect-nonprod.sportradar.dev/v1

/beachvolleyball/o/{organizationId}/statistics/leaders/criteria/{leaderCriteriaId}

Delete a specific leader criterion

Required scopes

This endpoint requires the following scopes:

• : Write/Update any data from below the organization

Authorizations

OAuth2

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

leaderCriteriaIdstring · uuidRequired

The unique identifier of the leader criteria

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)]

forceDeletebooleanOptional

Force a delete command to run and delete child records as well if there are existing records depending on the record.

Example: true

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

default

Error

application/json

delete

/beachvolleyball/o/{organizationId}/statistics/leaders/criteria/{leaderCriteriaId}

HTTPcURLJavaScriptPython

DELETE /v1/beachvolleyball/o/{organizationId}/statistics/leaders/criteria/{leaderCriteriaId} 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": [
    {
      "added": "2025-11-19T05:22:47.066Z",
      "updated": "2025-11-19T05:22:47.066Z",
      "organizationId": "9",
      "organization": {
        "resourceType": "organizations",
        "id": "9"
      },
      "leaderCriteriaId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "name": "text"
    }
  ]
}