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

Stages, Pools & Rounds

Stages are a collection of pools, rounds or matches. A stage can form a group of teams and matches within a season.

A stage is optional, but must be created if the matches stageCode field is utilized.

Pools are a collection of rounds or matches. A pool can form a group of teams and matches within a season and optionally within a stage. A pool is optional, but must be created if the matches poolCode field is utilized.

A pool can be defined in a match without defining it here. In that case the only information about the pool will be it's code. We recommend that all pools are added here as well to give well rounded information.

Rounds are a collection of matches generally over a day or series of days. A round can optionally be contained within a pool and/or a stage. A round is optional, but must be created if the matches roundCode field is utilized. The simplier matches roundNumber can be utilized without defining as a round.

How they link to a match:

Get a list of stages

get
/ice3/o/{organizationId}/seasons/{seasonId}/stages

Return a list of stages for a season

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
organizationIdstring · min: 5 · max: 5Required

The unique identifier of the organization

Example: b1a23
seasonIdstring · uuidRequired

The unique identifier of the season

Example: 009e9276-5c80-11e8-9c2d-fa7ae01bbebc
Query parameters
addedstring · date-timeOptional

Record was added after this date/time. In UTC.

Example: 2018-08-16T02:10:48
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
nameLatinContainsstring · 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: nameLatin=David Johnson nameLatinContains=Dav will match nameLatinContains=John will match nameLatinContains=son will not match

Example: Dav and nameLatin='David Johnson'
nameLocalContainsstring · 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: nameLocal=David Johnson nameLocalContains=Dav will match nameLocalContains=John will match nameLocalContains=son will not match

Example: Dav and nameLocal='David Johnson'
offsetinteger · int32Optional

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

Example: 10
sortBystringOptional

Comma-delimited list of one or more fields to sort by. Each field can have '-' as prefix to sort in descending order and no prefix to sort in ascending order.

Example: nameLocalPattern: ^(\-?nameLocal|\-?nameLatin|,)*$
updatedstring · date-timeOptional

Record was modified after this date/time. In UTC.

Example: 2018-08-16T02:11:48
Responses
200

Successful operation

application/json
get
/ice3/o/{organizationId}/seasons/{seasonId}/stages
GET /v1/ice3/o/{organizationId}/seasons/{seasonId}/stages 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": [
    {
      "seasonId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "season": {
        "resourceType": "seasons",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "organizationId": "9",
      "organization": {
        "resourceType": "organizations",
        "id": "9"
      },
      "stageCode": "ST1",
      "nameLocal": "Test name local",
      "abbreviationLocal": "NFA",
      "nameLatin": "Test name latin ",
      "abbreviationLatin": "NFA",
      "stageOrder": 1,
      "externalId": "A123",
      "updated": "2025-11-18T10:46:31.063Z",
      "added": "2025-11-18T10:46:31.063Z"
    }
  ]
}

Create a stage

post
/ice3/o/{organizationId}/seasons/{seasonId}/stages

Add a new stage in a season

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
seasonIdstring · uuidRequired

The unique identifier of the season

Example: 009e9276-5c80-11e8-9c2d-fa7ae01bbebc
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
seasonIdstring · uuidRequired

The unique identifier of the season

Example: 009e9276-5c80-11e8-9c2d-fa7ae01bbebc
stageCodestring · max: 30Required

A unique code for the stage. (Unique for season)

Example: ST1
nameLocalstring | nullableOptional

The name of the season stage in the local language

Example: Test name local
abbreviationLocalstring | nullableOptional

An abbreviation/short name in the local language

Example: NFA
nameLatinstring | nullableOptional

The name of the season stage in latin characters

Example: Test name latin
abbreviationLatinstring | nullableOptional

An abbreviation/short name in latin characters

Example: NFA
stageOrderinteger · int32 | nullableOptional

User defined sort order of the stage

Example: 1
externalIdstring | nullableOptional

The Id of the data as set by the provider of the data

Example: A123Pattern: ^[0-9A-Za-z/_-]+$
Responses
200

Successful operation

application/json
post
/ice3/o/{organizationId}/seasons/{seasonId}/stages
POST /v1/ice3/o/{organizationId}/seasons/{seasonId}/stages HTTP/1.1
Host: api.dc.connect.sportradar.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 217

{
  "seasonId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
  "stageCode": "ST1",
  "nameLocal": "Test name local",
  "abbreviationLocal": "NFA",
  "nameLatin": "Test name latin ",
  "abbreviationLatin": "NFA",
  "stageOrder": 1,
  "externalId": "A123"
}
{
  "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": [
    {
      "seasonId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "season": {
        "resourceType": "seasons",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "organizationId": "9",
      "organization": {
        "resourceType": "organizations",
        "id": "9"
      },
      "stageCode": "ST1",
      "nameLocal": "Test name local",
      "abbreviationLocal": "NFA",
      "nameLatin": "Test name latin ",
      "abbreviationLatin": "NFA",
      "stageOrder": 1,
      "externalId": "A123",
      "updated": "2025-11-18T10:46:31.063Z",
      "added": "2025-11-18T10:46:31.063Z"
    }
  ]
}

Get a stage

get
/ice3/o/{organizationId}/seasons/{seasonId}/stages/{stageCode}

Return detailed information about a specific stage

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
organizationIdstring · min: 5 · max: 5Required

The unique identifier of the organization

Example: b1a23
seasonIdstring · uuidRequired

The unique identifier of the season

Example: 009e9276-5c80-11e8-9c2d-fa7ae01bbebc
stageCodestring · max: 30Required

The stage identifier within a season

Example: ST1
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
get
/ice3/o/{organizationId}/seasons/{seasonId}/stages/{stageCode}
GET /v1/ice3/o/{organizationId}/seasons/{seasonId}/stages/{stageCode} 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": [
    {
      "seasonId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "season": {
        "resourceType": "seasons",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "organizationId": "9",
      "organization": {
        "resourceType": "organizations",
        "id": "9"
      },
      "stageCode": "ST1",
      "nameLocal": "Test name local",
      "abbreviationLocal": "NFA",
      "nameLatin": "Test name latin ",
      "abbreviationLatin": "NFA",
      "stageOrder": 1,
      "externalId": "A123",
      "updated": "2025-11-18T10:46:31.063Z",
      "added": "2025-11-18T10:46:31.063Z"
    }
  ]
}

Update a stage

put
/ice3/o/{organizationId}/seasons/{seasonId}/stages/{stageCode}

Change the information of a specific stage

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
seasonIdstring · uuidRequired

The unique identifier of the season

Example: 009e9276-5c80-11e8-9c2d-fa7ae01bbebc
stageCodestring · max: 30Required

The stage identifier within a season

Example: ST1
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
nameLocalstring | nullableOptional

The name of the season stage in the local language

Example: Test name local
abbreviationLocalstring | nullableOptional

An abbreviation/short name in the local language

Example: NFA
nameLatinstring | nullableOptional

The name of the season stage in latin characters

Example: Test name latin
abbreviationLatinstring | nullableOptional

An abbreviation/short name in latin characters

Example: NFA
stageOrderinteger · int32 | nullableOptional

User defined sort order of the stage

Example: 1
externalIdstring | nullableOptional

The Id of the data as set by the provider of the data

Example: A123Pattern: ^[0-9A-Za-z/_-]+$
Responses
200

Successful operation

application/json
put
/ice3/o/{organizationId}/seasons/{seasonId}/stages/{stageCode}
PUT /v1/ice3/o/{organizationId}/seasons/{seasonId}/stages/{stageCode} HTTP/1.1
Host: api.dc.connect.sportradar.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 149

{
  "nameLocal": "Test name local",
  "abbreviationLocal": "NFA",
  "nameLatin": "Test name latin ",
  "abbreviationLatin": "NFA",
  "stageOrder": 1,
  "externalId": "A123"
}
{
  "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": [
    {
      "seasonId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "season": {
        "resourceType": "seasons",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "organizationId": "9",
      "organization": {
        "resourceType": "organizations",
        "id": "9"
      },
      "stageCode": "ST1",
      "nameLocal": "Test name local",
      "abbreviationLocal": "NFA",
      "nameLatin": "Test name latin ",
      "abbreviationLatin": "NFA",
      "stageOrder": 1,
      "externalId": "A123",
      "updated": "2025-11-18T10:46:31.063Z",
      "added": "2025-11-18T10:46:31.063Z"
    }
  ]
}

Delete a stage

delete
/ice3/o/{organizationId}/seasons/{seasonId}/stages/{stageCode}

Delete a specific stage

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
seasonIdstring · uuidRequired

The unique identifier of the season

Example: 009e9276-5c80-11e8-9c2d-fa7ae01bbebc
stageCodestring · max: 30Required

The stage identifier within a season

Example: ST1
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
delete
/ice3/o/{organizationId}/seasons/{seasonId}/stages/{stageCode}
DELETE /v1/ice3/o/{organizationId}/seasons/{seasonId}/stages/{stageCode} 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": [
    {
      "seasonId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "season": {
        "resourceType": "seasons",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "organizationId": "9",
      "organization": {
        "resourceType": "organizations",
        "id": "9"
      },
      "stageCode": "ST1",
      "nameLocal": "Test name local",
      "abbreviationLocal": "NFA",
      "nameLatin": "Test name latin ",
      "abbreviationLatin": "NFA",
      "stageOrder": 1,
      "externalId": "A123",
      "updated": "2025-11-18T10:46:31.063Z",
      "added": "2025-11-18T10:46:31.063Z"
    }
  ]
}

Get a list of pools

get
/ice3/o/{organizationId}/seasons/{seasonId}/pools

Return a list of the pools for a season

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
organizationIdstring · min: 5 · max: 5Required

The unique identifier of the organization

Example: b1a23
seasonIdstring · uuidRequired

The unique identifier of the season

Example: 009e9276-5c80-11e8-9c2d-fa7ae01bbebc
Query parameters
addedstring · date-timeOptional

Record was added after this date/time. In UTC.

Example: 2018-08-16T02:10:48
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
nameLatinContainsstring · 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: nameLatin=David Johnson nameLatinContains=Dav will match nameLatinContains=John will match nameLatinContains=son will not match

Example: Dav and nameLatin='David Johnson'
nameLocalContainsstring · 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: nameLocal=David Johnson nameLocalContains=Dav will match nameLocalContains=John will match nameLocalContains=son will not match

Example: Dav and nameLocal='David Johnson'
offsetinteger · int32Optional

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

Example: 10
sortBystringOptional

Comma-delimited list of one or more fields to sort by. Each field can have '-' as prefix to sort in descending order and no prefix to sort in ascending order.

Example: nameLocalPattern: ^(\-?nameLocal|\-?nameLatin|,)*$
stageCodestring · max: 30Optional

The stage identifier within a season

Example: ST1
updatedstring · date-timeOptional

Record was modified after this date/time. In UTC.

Example: 2018-08-16T02:11:48
Responses
200

Successful operation

application/json
get
/ice3/o/{organizationId}/seasons/{seasonId}/pools
GET /v1/ice3/o/{organizationId}/seasons/{seasonId}/pools 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"
      },
      "seasonId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "season": {
        "resourceType": "seasons",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "poolCode": "P1",
      "stageCode": "ST1",
      "stage": {
        "resourceType": "seasonStages",
        "id": "ST1"
      },
      "nameLocal": "Stage 1",
      "abbreviationLocal": "S1",
      "nameLatin": "Stage 1",
      "abbreviationLatin": "S1",
      "poolOrder": 1,
      "externalId": "A123",
      "updated": "2025-11-18T10:46:31.063Z",
      "added": "2025-11-18T10:46:31.063Z"
    }
  ]
}

Create a pool

post
/ice3/o/{organizationId}/seasons/{seasonId}/pools

Add a new pool into a season

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
seasonIdstring · uuidRequired

The unique identifier of the season

Example: 009e9276-5c80-11e8-9c2d-fa7ae01bbebc
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
seasonIdstring · uuidRequired

The unique identifier of the season

Example: 009e9276-5c80-11e8-9c2d-fa7ae01bbebc
poolCodestring · max: 30Required

A unique code for the pool. (Unique for season)

Example: P1
stageCodestring | nullableOptional

A unique code for the stage. (Unique for season)

Example: ST1
nameLocalstring | nullableOptional

The name of the pool in the local language

Example: Stage 1
abbreviationLocalstring | nullableOptional

An abbreviation/short name in the local language

Example: S1
nameLatinstring | nullableOptional

The name of the pool in latin characters

Example: Stage 1
abbreviationLatinstring | nullableOptional

An abbreviation/short name in latin characters

Example: S1
poolOrderinteger · int32 | nullableOptional

User defined sort order of the pool

Example: 1
externalIdstring | nullableOptional

The Id of the data as set by the provider of the data

Example: A123Pattern: ^[0-9A-Za-z/_-]+$
Responses
200

Successful operation

application/json
post
/ice3/o/{organizationId}/seasons/{seasonId}/pools
POST /v1/ice3/o/{organizationId}/seasons/{seasonId}/pools HTTP/1.1
Host: api.dc.connect.sportradar.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 213

{
  "seasonId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
  "poolCode": "P1",
  "stageCode": "ST1",
  "nameLocal": "Stage 1",
  "abbreviationLocal": "S1",
  "nameLatin": "Stage 1",
  "abbreviationLatin": "S1",
  "poolOrder": 1,
  "externalId": "A123"
}
{
  "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"
      },
      "seasonId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "season": {
        "resourceType": "seasons",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "poolCode": "P1",
      "stageCode": "ST1",
      "stage": {
        "resourceType": "seasonStages",
        "id": "ST1"
      },
      "nameLocal": "Stage 1",
      "abbreviationLocal": "S1",
      "nameLatin": "Stage 1",
      "abbreviationLatin": "S1",
      "poolOrder": 1,
      "externalId": "A123",
      "updated": "2025-11-18T10:46:31.063Z",
      "added": "2025-11-18T10:46:31.063Z"
    }
  ]
}

Get a pool

get
/ice3/o/{organizationId}/seasons/{seasonId}/pools/{poolCode}

Return detailed information about a specific pool

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
organizationIdstring · min: 5 · max: 5Required

The unique identifier of the organization

Example: b1a23
poolCodestring · max: 30Required

The pool identifier within a season

Example: P1
seasonIdstring · uuidRequired

The unique identifier of the season

Example: 009e9276-5c80-11e8-9c2d-fa7ae01bbebc
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
get
/ice3/o/{organizationId}/seasons/{seasonId}/pools/{poolCode}
GET /v1/ice3/o/{organizationId}/seasons/{seasonId}/pools/{poolCode} 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"
      },
      "seasonId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "season": {
        "resourceType": "seasons",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "poolCode": "P1",
      "stageCode": "ST1",
      "stage": {
        "resourceType": "seasonStages",
        "id": "ST1"
      },
      "nameLocal": "Stage 1",
      "abbreviationLocal": "S1",
      "nameLatin": "Stage 1",
      "abbreviationLatin": "S1",
      "poolOrder": 1,
      "externalId": "A123",
      "updated": "2025-11-18T10:46:31.063Z",
      "added": "2025-11-18T10:46:31.063Z"
    }
  ]
}

Update a pool

put
/ice3/o/{organizationId}/seasons/{seasonId}/pools/{poolCode}

Change the information of a specific pool

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
poolCodestring · max: 30Required

The pool identifier within a season

Example: P1
seasonIdstring · uuidRequired

The unique identifier of the season

Example: 009e9276-5c80-11e8-9c2d-fa7ae01bbebc
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
stageCodestring | nullableOptional

A unique code for the stage. (Unique for season)

Example: ST1
nameLocalstring | nullableOptional

The name of the pool in the local language

Example: Stage 1
abbreviationLocalstring | nullableOptional

An abbreviation/short name in the local language

Example: S1
nameLatinstring | nullableOptional

The name of the pool in latin characters

Example: Stage 1
abbreviationLatinstring | nullableOptional

An abbreviation/short name in latin characters

Example: S1
poolOrderinteger · int32 | nullableOptional

User defined sort order of the pool

Example: 1
externalIdstring | nullableOptional

The Id of the data as set by the provider of the data

Example: A123Pattern: ^[0-9A-Za-z/_-]+$
Responses
200

Successful operation

application/json
put
/ice3/o/{organizationId}/seasons/{seasonId}/pools/{poolCode}
PUT /v1/ice3/o/{organizationId}/seasons/{seasonId}/pools/{poolCode} HTTP/1.1
Host: api.dc.connect.sportradar.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 147

{
  "stageCode": "ST1",
  "nameLocal": "Stage 1",
  "abbreviationLocal": "S1",
  "nameLatin": "Stage 1",
  "abbreviationLatin": "S1",
  "poolOrder": 1,
  "externalId": "A123"
}
{
  "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"
      },
      "seasonId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "season": {
        "resourceType": "seasons",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "poolCode": "P1",
      "stageCode": "ST1",
      "stage": {
        "resourceType": "seasonStages",
        "id": "ST1"
      },
      "nameLocal": "Stage 1",
      "abbreviationLocal": "S1",
      "nameLatin": "Stage 1",
      "abbreviationLatin": "S1",
      "poolOrder": 1,
      "externalId": "A123",
      "updated": "2025-11-18T10:46:31.063Z",
      "added": "2025-11-18T10:46:31.063Z"
    }
  ]
}

Delete a pool

delete
/ice3/o/{organizationId}/seasons/{seasonId}/pools/{poolCode}

Delete a specific pool

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
poolCodestring · max: 30Required

The pool identifier within a season

Example: P1
seasonIdstring · uuidRequired

The unique identifier of the season

Example: 009e9276-5c80-11e8-9c2d-fa7ae01bbebc
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
delete
/ice3/o/{organizationId}/seasons/{seasonId}/pools/{poolCode}
DELETE /v1/ice3/o/{organizationId}/seasons/{seasonId}/pools/{poolCode} 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"
      },
      "seasonId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "season": {
        "resourceType": "seasons",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "poolCode": "P1",
      "stageCode": "ST1",
      "stage": {
        "resourceType": "seasonStages",
        "id": "ST1"
      },
      "nameLocal": "Stage 1",
      "abbreviationLocal": "S1",
      "nameLatin": "Stage 1",
      "abbreviationLatin": "S1",
      "poolOrder": 1,
      "externalId": "A123",
      "updated": "2025-11-18T10:46:31.063Z",
      "added": "2025-11-18T10:46:31.063Z"
    }
  ]
}

Get a list of rounds

get
/ice3/o/{organizationId}/seasons/{seasonId}/rounds

Return a list of rounds in a season

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
organizationIdstring · min: 5 · max: 5Required

The unique identifier of the organization

Example: b1a23
seasonIdstring · uuidRequired

The unique identifier of the season

Example: 009e9276-5c80-11e8-9c2d-fa7ae01bbebc
Query parameters
addedstring · date-timeOptional

Record was added after this date/time. In UTC.

Example: 2018-08-16T02:10:48
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
poolCodestring · max: 30Optional

The pool identifier within a season

Example: P1
stageCodestring · max: 30Optional

The stage identifier within a season

Example: ST1
updatedstring · date-timeOptional

Record was modified after this date/time. In UTC.

Example: 2018-08-16T02:11:48
Responses
200

Successful operation

application/json
get
/ice3/o/{organizationId}/seasons/{seasonId}/rounds
GET /v1/ice3/o/{organizationId}/seasons/{seasonId}/rounds 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": [
    {
      "seasonId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "season": {
        "resourceType": "seasons",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "organizationId": "9",
      "organization": {
        "resourceType": "organizations",
        "id": "9"
      },
      "roundCode": "RN1",
      "poolCode": "P1",
      "pool": {
        "resourceType": "seasonPools",
        "id": "P1"
      },
      "stageCode": "ST1",
      "stage": {
        "resourceType": "seasonStages",
        "id": "ST1"
      },
      "roundNumber": 1,
      "nameLocal": "Rivalry Round",
      "nameLatin": "Rivalry Round",
      "abbreviationLocal": "RR",
      "abbreviationLatin": "RR",
      "roundOrder": 1,
      "externalId": "A123",
      "updated": "2025-11-18T10:46:31.063Z",
      "added": "2025-11-18T10:46:31.063Z"
    }
  ]
}

Create a round

post
/ice3/o/{organizationId}/seasons/{seasonId}/rounds

Add a new round in a season

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
seasonIdstring · uuidRequired

The unique identifier of the season

Example: 009e9276-5c80-11e8-9c2d-fa7ae01bbebc
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
seasonIdstring · uuidRequired

The unique identifier of the season

Example: 009e9276-5c80-11e8-9c2d-fa7ae01bbebc
roundCodestring · max: 30Required

A unique code for the round. (Unique for season)

Example: RN1
poolCodestring | nullableOptional

A unique code for the pool. (Unique for season)

Example: P1
stageCodestring | nullableOptional

A unique code for the stage. (Unique for season)

Example: ST1
roundNumberstring | nullableOptional

The number given to the round

Example: 1
nameLocalstring | nullableOptional

The name of the round in the local language

Example: Rivalry Round
nameLatinstring | nullableOptional

The name of the round in latin characters

Example: Rivalry Round
abbreviationLocalstring | nullableOptional

An abbreviation/short name in the local language

Example: RR
abbreviationLatinstring | nullableOptional

An abbreviation/short name in latin characters

Example: RR
roundOrderinteger · int32 | nullableOptional

User defined sort order of the stage

Example: 1
externalIdstring | nullableOptional

The Id of the data as set by the provider of the data

Example: A123Pattern: ^[0-9A-Za-z/_-]+$
Responses
200

Successful operation

application/json
post
/ice3/o/{organizationId}/seasons/{seasonId}/rounds
POST /v1/ice3/o/{organizationId}/seasons/{seasonId}/rounds HTTP/1.1
Host: api.dc.connect.sportradar.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 260

{
  "seasonId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
  "roundCode": "RN1",
  "poolCode": "P1",
  "stageCode": "ST1",
  "roundNumber": 1,
  "nameLocal": "Rivalry Round",
  "nameLatin": "Rivalry Round",
  "abbreviationLocal": "RR",
  "abbreviationLatin": "RR",
  "roundOrder": 1,
  "externalId": "A123"
}
{
  "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": [
    {
      "seasonId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "season": {
        "resourceType": "seasons",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "organizationId": "9",
      "organization": {
        "resourceType": "organizations",
        "id": "9"
      },
      "roundCode": "RN1",
      "poolCode": "P1",
      "pool": {
        "resourceType": "seasonPools",
        "id": "P1"
      },
      "stageCode": "ST1",
      "stage": {
        "resourceType": "seasonStages",
        "id": "ST1"
      },
      "roundNumber": 1,
      "nameLocal": "Rivalry Round",
      "nameLatin": "Rivalry Round",
      "abbreviationLocal": "RR",
      "abbreviationLatin": "RR",
      "roundOrder": 1,
      "externalId": "A123",
      "updated": "2025-11-18T10:46:31.063Z",
      "added": "2025-11-18T10:46:31.063Z"
    }
  ]
}

Get a round

get
/ice3/o/{organizationId}/seasons/{seasonId}/rounds/{roundCode}

Return detailed information about a specific round

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
organizationIdstring · min: 5 · max: 5Required

The unique identifier of the organization

Example: b1a23
roundCodestring · max: 30Required

The round identifier within a season

Example: RN1
seasonIdstring · uuidRequired

The unique identifier of the season

Example: 009e9276-5c80-11e8-9c2d-fa7ae01bbebc
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
get
/ice3/o/{organizationId}/seasons/{seasonId}/rounds/{roundCode}
GET /v1/ice3/o/{organizationId}/seasons/{seasonId}/rounds/{roundCode} 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": [
    {
      "seasonId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "season": {
        "resourceType": "seasons",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "organizationId": "9",
      "organization": {
        "resourceType": "organizations",
        "id": "9"
      },
      "roundCode": "RN1",
      "poolCode": "P1",
      "pool": {
        "resourceType": "seasonPools",
        "id": "P1"
      },
      "stageCode": "ST1",
      "stage": {
        "resourceType": "seasonStages",
        "id": "ST1"
      },
      "roundNumber": 1,
      "nameLocal": "Rivalry Round",
      "nameLatin": "Rivalry Round",
      "abbreviationLocal": "RR",
      "abbreviationLatin": "RR",
      "roundOrder": 1,
      "externalId": "A123",
      "updated": "2025-11-18T10:46:31.063Z",
      "added": "2025-11-18T10:46:31.063Z"
    }
  ]
}

Update a round

put
/ice3/o/{organizationId}/seasons/{seasonId}/rounds/{roundCode}

Change the information of a specific round

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
roundCodestring · max: 30Required

The round identifier within a season

Example: RN1
seasonIdstring · uuidRequired

The unique identifier of the season

Example: 009e9276-5c80-11e8-9c2d-fa7ae01bbebc
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
poolCodestring | nullableOptional

A unique code for the pool. (Unique for season)

Example: P1
stageCodestring | nullableOptional

A unique code for the stage. (Unique for season)

Example: ST1
roundNumberstring | nullableOptional

The number given to the round

Example: 1
nameLocalstring | nullableOptional

The name of the round in the local language

Example: Rivalry Round
nameLatinstring | nullableOptional

The name of the round in latin characters

Example: Rivalry Round
abbreviationLocalstring | nullableOptional

An abbreviation/short name in the local language

Example: RR
abbreviationLatinstring | nullableOptional

An abbreviation/short name in latin characters

Example: RR
roundOrderinteger · int32 | nullableOptional

User defined sort order of the stage

Example: 1
externalIdstring | nullableOptional

The Id of the data as set by the provider of the data

Example: A123Pattern: ^[0-9A-Za-z/_-]+$
Responses
200

Successful operation

application/json
put
/ice3/o/{organizationId}/seasons/{seasonId}/rounds/{roundCode}
PUT /v1/ice3/o/{organizationId}/seasons/{seasonId}/rounds/{roundCode} HTTP/1.1
Host: api.dc.connect.sportradar.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 192

{
  "poolCode": "P1",
  "stageCode": "ST1",
  "roundNumber": 1,
  "nameLocal": "Rivalry Round",
  "nameLatin": "Rivalry Round",
  "abbreviationLocal": "RR",
  "abbreviationLatin": "RR",
  "roundOrder": 1,
  "externalId": "A123"
}
{
  "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": [
    {
      "seasonId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "season": {
        "resourceType": "seasons",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "organizationId": "9",
      "organization": {
        "resourceType": "organizations",
        "id": "9"
      },
      "roundCode": "RN1",
      "poolCode": "P1",
      "pool": {
        "resourceType": "seasonPools",
        "id": "P1"
      },
      "stageCode": "ST1",
      "stage": {
        "resourceType": "seasonStages",
        "id": "ST1"
      },
      "roundNumber": 1,
      "nameLocal": "Rivalry Round",
      "nameLatin": "Rivalry Round",
      "abbreviationLocal": "RR",
      "abbreviationLatin": "RR",
      "roundOrder": 1,
      "externalId": "A123",
      "updated": "2025-11-18T10:46:31.063Z",
      "added": "2025-11-18T10:46:31.063Z"
    }
  ]
}

Delete a round

delete
/ice3/o/{organizationId}/seasons/{seasonId}/rounds/{roundCode}

Delete a specific round

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
roundCodestring · max: 30Required

The round identifier within a season

Example: RN1
seasonIdstring · uuidRequired

The unique identifier of the season

Example: 009e9276-5c80-11e8-9c2d-fa7ae01bbebc
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
delete
/ice3/o/{organizationId}/seasons/{seasonId}/rounds/{roundCode}
DELETE /v1/ice3/o/{organizationId}/seasons/{seasonId}/rounds/{roundCode} 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": [
    {
      "seasonId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "season": {
        "resourceType": "seasons",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "organizationId": "9",
      "organization": {
        "resourceType": "organizations",
        "id": "9"
      },
      "roundCode": "RN1",
      "poolCode": "P1",
      "pool": {
        "resourceType": "seasonPools",
        "id": "P1"
      },
      "stageCode": "ST1",
      "stage": {
        "resourceType": "seasonStages",
        "id": "ST1"
      },
      "roundNumber": 1,
      "nameLocal": "Rivalry Round",
      "nameLatin": "Rivalry Round",
      "abbreviationLocal": "RR",
      "abbreviationLatin": "RR",
      "roundOrder": 1,
      "externalId": "A123",
      "updated": "2025-11-18T10:46:31.063Z",
      "added": "2025-11-18T10:46:31.063Z"
    }
  ]
}

Create or Update a round

post
/ice3/o/{organizationId}/seasons/{seasonId}/rounds/force

Depending on primary keys, insert a new round or update an existing one

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
seasonIdstring · uuidRequired

The unique identifier of the season

Example: 009e9276-5c80-11e8-9c2d-fa7ae01bbebc
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
seasonIdstring · uuidRequired

The unique identifier of the season

Example: 009e9276-5c80-11e8-9c2d-fa7ae01bbebc
roundCodestring · max: 30Required

A unique code for the round. (Unique for season)

Example: RN1
poolCodestring | nullableOptional

A unique code for the pool. (Unique for season)

Example: P1
stageCodestring | nullableOptional

A unique code for the stage. (Unique for season)

Example: ST1
roundNumberstring | nullableOptional

The number given to the round

Example: 1
nameLocalstring | nullableOptional

The name of the round in the local language

Example: Rivalry Round
nameLatinstring | nullableOptional

The name of the round in latin characters

Example: Rivalry Round
abbreviationLocalstring | nullableOptional

An abbreviation/short name in the local language

Example: RR
abbreviationLatinstring | nullableOptional

An abbreviation/short name in latin characters

Example: RR
roundOrderinteger · int32 | nullableOptional

User defined sort order of the stage

Example: 1
externalIdstring | nullableOptional

The Id of the data as set by the provider of the data

Example: A123Pattern: ^[0-9A-Za-z/_-]+$
Responses
200

Successful operation

application/json
post
/ice3/o/{organizationId}/seasons/{seasonId}/rounds/force
POST /v1/ice3/o/{organizationId}/seasons/{seasonId}/rounds/force HTTP/1.1
Host: api.dc.connect.sportradar.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 260

{
  "seasonId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
  "roundCode": "RN1",
  "poolCode": "P1",
  "stageCode": "ST1",
  "roundNumber": 1,
  "nameLocal": "Rivalry Round",
  "nameLatin": "Rivalry Round",
  "abbreviationLocal": "RR",
  "abbreviationLatin": "RR",
  "roundOrder": 1,
  "externalId": "A123"
}
{
  "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": [
    {
      "seasonId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "season": {
        "resourceType": "seasons",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "organizationId": "9",
      "organization": {
        "resourceType": "organizations",
        "id": "9"
      },
      "roundCode": "RN1",
      "poolCode": "P1",
      "pool": {
        "resourceType": "seasonPools",
        "id": "P1"
      },
      "stageCode": "ST1",
      "stage": {
        "resourceType": "seasonStages",
        "id": "ST1"
      },
      "roundNumber": 1,
      "nameLocal": "Rivalry Round",
      "nameLatin": "Rivalry Round",
      "abbreviationLocal": "RR",
      "abbreviationLatin": "RR",
      "roundOrder": 1,
      "externalId": "A123",
      "updated": "2025-11-18T10:46:31.063Z",
      "added": "2025-11-18T10:46:31.063Z"
    }
  ]
}
PreviousRolesNextSeason Roster

Last updated

Was this helpful?