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

Seasons

Season is a grouping of matches. Generally the season will last a portion of a year (every year).

The competition can have many seasons, but the season can only belong to one competition.

Get a list of seasons

get
/ice3/o/{organizationId}/competitions/{competitionId}/seasons

Return a list of seasons in the 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
Query parameters
addedstring · date-timeOptional

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

Example: 2018-08-16T02:10:48
ageGroupstring · enumOptional

The age group of the season

  • JUNIOR Junior
  • MASTERS Masters
  • SENIOR Senior
  • UNDER_15 Under 15
  • UNDER_16 Under 16
  • UNDER_17 Under 17
  • UNDER_18 Under 18
  • UNDER_19 Under 19
  • UNDER_20 Under 20
  • UNDER_21 Under 21
  • UNDER_22 Under 22
  • UNDER_23 Under 23
  • YOUTH Youth
Example: SENIORPossible values:
disciplinestring · enum · max: 30Optional

The discipline for a match

  • BEACH Beach
  • HOCKEY5S Hockey5s
  • INDOOR Indoor
  • OUTDOOR Outdoor
  • PARAHOCKEY Para hockey
Example: INDOORPossible values:
endDatestring · dateOptional

endDate on or before this date

Example: 2018-08-16
eventTypestring · enum · max: 30Optional

Type of Fixtures

  • FIXTURE Fixture
  • PRACTICE Practice
Example: FIXTUREPossible values:
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)]
genderstring · enumOptional

The gender of the season or team

  • FEMALE Female
  • MALE Male
  • MIXED Mixed
  • UNKNOWN Unknown
Example: MALEPossible 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
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
representationstring · enumOptional

What level are the competitors representing

  • CLUB Club
  • COUNTRY Country
  • PERSON Person
Example: CLUBPossible values:
seasonIdstringOptional

The unique identifier of the season. Can specify multiple, delimited by comma.

Example: 009e9276-5c80-11e8-9c2d-fa7ae01bbebc,de83c6a8-3b29-11eb-bdb7-0242ac130005
seasonTypestring · enumOptional

The type of matches added to this season

  • MULTI_YEAR_HISTORICAL Mulit-Year Historical
  • ONE_OFF One off match
  • PRESEASON Pre Season
  • SEASON Season
  • TOURNAMENT Tournament
Example: SEASONPossible values:
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|\-?year|,)*$
standardstring · enumOptional

The playing standard of the season or team

  • APPROVED_TEST_MATCHES Approved Test matches
  • COMMONWEALTH_GAMES Commonwealth Games
  • CONTINENTAL_CHAMPIONSHIP Continental Championship
  • CONTINENTAL_CHAMPIONSHIP_DIV_2 Continental Championship Div 2
  • CONTINENTAL_CHAMPIONSHIP_DIV_3 Continental Championship Div 3
  • CONTINENTAL_CHAMPIONSHIP_DIV_4 Continental Championship Div 4
  • CONTINENTAL_QUALIFIER Continental Qualifier
  • ELITE Professional/elite organisation
  • FIH_NATIONS_CUP FIH Nations Cup
  • FIH_OLYMPIC_QUALIFIERS FIH Olympic Qualifiers
  • FIH_PRO_LEAGUE FIH Pro League
  • FIH_WORLD_CUP FIH World Cup
  • FIH_WORLD_CUP_QUALIFIERS FIH World Cup Qualifiers
  • FRIENDLY International Friendly
  • GRASS_ROOT Normal
  • HISTORICAL_BASELINE Historical Baseline
  • HOCKEY_SERIES_OPEN Hockey Series Open
  • INTERNATIONAL International
  • INVITATIONAL_TOURNAMENT Invitational Tournament (3+ teams)
  • NONCONTINENTAL_CHAMPIONSHIP Non-continental Championship
  • OLYMPIC Olympics
  • OLYMPICS Olympic Games
  • REGION Regional
  • TIER2 lesser standard than elite
  • TIER3 lesser standard than tier 2
  • WORLD_CHAMPIONSHIP World Championship
  • WORLD_LEAGUE World League
  • ZONE_CHAMPIONSHIP International Zone Championship
Example: ELITEPossible values:
startDatestring · dateOptional

startDate on or after this date

Example: 2018-08-16
statusstring · enumOptional

Status

  • ACTIVE Active
  • COMPLETE Complete
  • DRAFT Draft
  • INACTIVE Inactive
  • PENDING Pending
Example: ACTIVEPossible values:
updatedstring · date-timeOptional

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

Example: 2018-08-16T02:11:48
videoProductionstring · enum · max: 50Optional

Data synchronization strategy with video production systems. Multiple allowed (comma-delimited).

  • AUTOMATED Automated
  • MANUAL Manual
  • NONE None
Example: NONE,AUTOMATEDPossible values:
Responses
get
/ice3/o/{organizationId}/competitions/{competitionId}/seasons
GET /v1/ice3/o/{organizationId}/competitions/{competitionId}/seasons 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",
      "organizationId": "9",
      "organization": {
        "resourceType": "organizations",
        "id": "9"
      },
      "competitionId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "competition": {
        "resourceType": "competitions",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "leaderCriteriaId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "leadersCriteria": {
        "resourceType": "leaderCriteria",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "internationalReference": "CA3243-3",
      "eventType": "FIXTURE",
      "seasonType": "SEASON",
      "year": 2019,
      "grade": "A",
      "status": "ACTIVE",
      "includeInStatistics": true,
      "liveVideoAvailable": true,
      "liveDataAvailable": true,
      "durationFull": 180,
      "discipline": "INDOOR",
      "nameLocal": "Test season",
      "nameLatin": "Test season",
      "nameShortLocal": "Test short local",
      "nameShortLatin": "Test short latin",
      "startDate": "2016-09-08",
      "endDate": "2016-09-08",
      "gender": "MALE",
      "ageGroup": "SENIOR",
      "standard": "ELITE",
      "representation": "CLUB",
      "standingConfigurationId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "standingConfiguration": {
        "resourceType": "standingConfigurations",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "lockStandings": true,
      "externalId": "A123",
      "social": {
        "website": "http://www.example.com",
        "facebook": "https://www.facebook.com/example",
        "twitter": "https://www.twitter.com/example",
        "wikipedia": "https://en.wikipedia.org/wiki/example",
        "instagram": "https://www.instagram.com/example"
      },
      "configuration": {
        "periodBreakDuration": 1,
        "halfTimeDuration": 1
      },
      "profileId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "fixtureProfile": {
        "resourceType": "fixtureProfiles",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "updated": "2025-11-19T06:30:31.104Z",
      "added": "2025-11-19T06:30:31.104Z",
      "images": [
        {
          "imageId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
          "organizationId": "9",
          "organization": {
            "resourceType": "organizations",
            "id": "9"
          },
          "baseType": "entity",
          "baseId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
          "fileType": "png",
          "imageType": "LOGO",
          "secondaryType": "entity",
          "secondaryId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
          "rating": "LOW",
          "url": "text",
          "maximumHeight": 200,
          "maximumWidth": 200,
          "updated": "2025-11-19T06:30:31.104Z",
          "added": "2025-11-19T06:30:31.104Z"
        }
      ],
      "videoProduction": "AUTOMATED",
      "promotionRelegationRules": [
        {
          "ruleType": "PROMOTION",
          "position": 1,
          "value": "DIV1"
        }
      ],
      "rosterConfiguration": {
        "windowOpenDate": "2023-01-01",
        "windowCloseDate": "2023-01-31",
        "seasonRosterLock": true,
        "fixtureRosterLock": false,
        "fixtureBibEdit": false,
        "seasonRosterStatusAllowed": [
          "ACTIVE"
        ],
        "publishSeasonRosterRolesInHours": true,
        "publishFixtureRosterRolesInMinutes": true
      }
    }
  ]
}

Create a new season

post
/ice3/o/{organizationId}/competitions/{competitionId}/seasons

Add a new 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
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
Body
seasonIdstring · uuidOptional

The unique identifier of the season

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

The unique identifier of the competition

Example: 009e9276-5c80-11e8-9c2d-fa7ae01bbebc
leaderCriteriaIdstring · uuid | nullableOptional

The unique identifier of the LeaderCriteria

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

The international reference for this season given by the sport governing body

Example: CA3243-3
eventTypestring · enum · max: 30Optional

Primary Type of Matches

  • FIXTURE Fixture
  • PRACTICE Practice
Default: FIXTUREExample: FIXTUREPossible values:
seasonTypestring · enum · max: 30Required

The type of matches added to this season

  • MULTI_YEAR_HISTORICAL Mulit-Year Historical
  • ONE_OFF One off
  • PRESEASON Pre Season
  • SEASON Season
  • TOURNAMENT Tournament
Example: SEASONPossible values:
yearinteger · int32 · max: 4Optional

Year of the season

Example: 2019
gradestring | nullableOptional

The playing grade of the matches in this season

Example: A
statusstring · enum · max: 30Optional

Status

  • ACTIVE Active
  • COMPLETE Complete
  • DRAFT Draft
  • INACTIVE Inactive
  • PENDING Pending
Example: ACTIVEPossible values:
includeInStatisticsbooleanOptional

Include this season in calculated statistics?

Default: trueExample: true
liveVideoAvailablebooleanOptional

If no 'liveVideoAvailable' flag passed to a new match this value is used

Example: true
liveDataAvailablebooleanOptional

If no 'liveDataAvailable' flag passed to a new match this value is used

Example: true
durationFullinteger · int32 | nullableOptional

If no 'durationFull' is passed to a new match this value is used

Default: 180Example: 180
disciplinestring · enum | nullableOptional

If no 'discipline' is passed to a new match this value is used

  • None None
  • INDOOR Indoor
  • OUTDOOR Outdoor
Example: INDOORPossible values:
nameLocalstring · max: 150Required

The name of the season in the local language

Example: Test season
nameLatinstring | nullableOptional

The name of the season in latin characters

Example: Test season
nameShortLocalstring | nullableOptional

The abbreviated name of the season in the local language

Example: Test short local
nameShortLatinstring | nullableOptional

The abbreviated name of the season in latin characters

Example: Test short latin
startDatestring · dateRequired

Season start date

Example: 2016-09-08
endDatestring · date | nullableOptional

Season end date

Example: 2016-09-08
genderstring · enum · max: 20Required

The gender of the participants in the season

  • FEMALE Female
  • MALE Male
  • MIXED Mixed
  • UNKNOWN Unknown
Example: MALEPossible values:
ageGroupstring · enum · max: 50Required

The age group of the season

  • JUNIOR Junior
  • MASTERS Masters
  • SENIOR Senior
  • UNDER_15 Under 15
  • UNDER_16 Under 16
  • UNDER_17 Under 17
  • UNDER_18 Under 18
  • UNDER_19 Under 19
  • UNDER_20 Under 20
  • UNDER_21 Under 21
  • UNDER_22 Under 22
  • UNDER_23 Under 23
  • YOUTH Youth
Example: SENIORPossible values:
standardstring · enum · max: 50Required

The playing standard of the season

  • ELITE Professional/elite organisation
  • FRIENDLY International Friendly
  • GRASS_ROOT Normal
  • HISTORICAL_BASELINE Historical Baseline
  • INTERNATIONAL International
  • NONCONTINENTAL_CHAMPIONSHIP Non-continental Championship
  • OLYMPIC Olympics
  • REGION Regional
  • TIER2 lesser standard than elite
  • TIER3 lesser standard than tier 2
  • WORLD_CHAMPIONSHIP World Championship
  • ZONE_CHAMPIONSHIP International Zone Championship
Example: ELITEPossible values:
representationstring · enum · max: 50Required

What level are the competitors representing

  • CLUB Club
  • COUNTRY Country
  • PERSON Person
  • REGION Region
  • STATE State
Example: CLUBPossible values:
standingConfigurationIdstring · uuid | nullableOptional

The unique identifier of the standingConfiguration

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

Is the standings generation locked ?

Example: true
externalIdstring | nullableOptional

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

Example: A123Pattern: ^[0-9A-Za-z/_-]+$
profileIdstring · uuid | nullableOptional

The profile that this season belongs to

Example: 009e9276-5c80-11e8-9c2d-fa7ae01bbebc
videoProductionstring · enum · max: 50Optional

Data synchronization strategy with video production systems

  • AUTOMATED Automated
  • MANUAL Manual
  • NONE None
Default: NONEExample: AUTOMATEDPossible values:
Responses
post
/ice3/o/{organizationId}/competitions/{competitionId}/seasons
POST /v1/ice3/o/{organizationId}/competitions/{competitionId}/seasons HTTP/1.1
Host: api.dc.connect.sportradar.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 1502

{
  "seasonId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
  "competitionId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
  "leaderCriteriaId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
  "internationalReference": "CA3243-3",
  "eventType": "FIXTURE",
  "seasonType": "SEASON",
  "year": 2019,
  "grade": "A",
  "status": "ACTIVE",
  "includeInStatistics": true,
  "liveVideoAvailable": true,
  "liveDataAvailable": true,
  "durationFull": 180,
  "discipline": "INDOOR",
  "nameLocal": "Test season",
  "nameLatin": "Test season",
  "nameShortLocal": "Test short local",
  "nameShortLatin": "Test short latin",
  "startDate": "2016-09-08",
  "endDate": "2016-09-08",
  "gender": "MALE",
  "ageGroup": "SENIOR",
  "standard": "ELITE",
  "representation": "CLUB",
  "standingConfigurationId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
  "lockStandings": true,
  "externalId": "A123",
  "social": {
    "website": "http://www.example.com",
    "facebook": "https://www.facebook.com/example",
    "twitter": "https://www.twitter.com/example",
    "wikipedia": "https://en.wikipedia.org/wiki/example",
    "instagram": "https://www.instagram.com/example"
  },
  "configuration": {
    "periodBreakDuration": 1,
    "halfTimeDuration": 1
  },
  "profileId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
  "videoProduction": "AUTOMATED",
  "promotionRelegationRules": [
    {
      "ruleType": "PROMOTION",
      "position": 1,
      "value": "DIV1"
    }
  ],
  "rosterConfiguration": {
    "windowOpenDate": "2023-01-01",
    "windowCloseDate": "2023-01-31",
    "seasonRosterLock": true,
    "fixtureRosterLock": false,
    "fixtureBibEdit": false,
    "seasonRosterStatusAllowed": [
      "ACTIVE"
    ],
    "publishSeasonRosterRolesInHours": true,
    "publishFixtureRosterRolesInMinutes": true
  }
}
{
  "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",
      "organizationId": "9",
      "organization": {
        "resourceType": "organizations",
        "id": "9"
      },
      "competitionId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "competition": {
        "resourceType": "competitions",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "leaderCriteriaId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "leadersCriteria": {
        "resourceType": "leaderCriteria",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "internationalReference": "CA3243-3",
      "eventType": "FIXTURE",
      "seasonType": "SEASON",
      "year": 2019,
      "grade": "A",
      "status": "ACTIVE",
      "includeInStatistics": true,
      "liveVideoAvailable": true,
      "liveDataAvailable": true,
      "durationFull": 180,
      "discipline": "INDOOR",
      "nameLocal": "Test season",
      "nameLatin": "Test season",
      "nameShortLocal": "Test short local",
      "nameShortLatin": "Test short latin",
      "startDate": "2016-09-08",
      "endDate": "2016-09-08",
      "gender": "MALE",
      "ageGroup": "SENIOR",
      "standard": "ELITE",
      "representation": "CLUB",
      "standingConfigurationId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "standingConfiguration": {
        "resourceType": "standingConfigurations",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "lockStandings": true,
      "externalId": "A123",
      "social": {
        "website": "http://www.example.com",
        "facebook": "https://www.facebook.com/example",
        "twitter": "https://www.twitter.com/example",
        "wikipedia": "https://en.wikipedia.org/wiki/example",
        "instagram": "https://www.instagram.com/example"
      },
      "configuration": {
        "periodBreakDuration": 1,
        "halfTimeDuration": 1
      },
      "profileId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "fixtureProfile": {
        "resourceType": "fixtureProfiles",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "updated": "2025-11-19T06:30:31.104Z",
      "added": "2025-11-19T06:30:31.104Z",
      "images": [
        {
          "imageId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
          "organizationId": "9",
          "organization": {
            "resourceType": "organizations",
            "id": "9"
          },
          "baseType": "entity",
          "baseId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
          "fileType": "png",
          "imageType": "LOGO",
          "secondaryType": "entity",
          "secondaryId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
          "rating": "LOW",
          "url": "text",
          "maximumHeight": 200,
          "maximumWidth": 200,
          "updated": "2025-11-19T06:30:31.104Z",
          "added": "2025-11-19T06:30:31.104Z"
        }
      ],
      "videoProduction": "AUTOMATED",
      "promotionRelegationRules": [
        {
          "ruleType": "PROMOTION",
          "position": 1,
          "value": "DIV1"
        }
      ],
      "rosterConfiguration": {
        "windowOpenDate": "2023-01-01",
        "windowCloseDate": "2023-01-31",
        "seasonRosterLock": true,
        "fixtureRosterLock": false,
        "fixtureBibEdit": false,
        "seasonRosterStatusAllowed": [
          "ACTIVE"
        ],
        "publishSeasonRosterRolesInHours": true,
        "publishFixtureRosterRolesInMinutes": true
      }
    }
  ]
}

Get a list of seasons for an organization

get
/ice3/o/{organizationId}/seasons

Return a list of seasons in an organization.

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
Query parameters
addedstring · date-timeOptional

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

Example: 2018-08-16T02:10:48
ageGroupstring · enumOptional

The age group of the season

  • JUNIOR Junior
  • MASTERS Masters
  • SENIOR Senior
  • UNDER_15 Under 15
  • UNDER_16 Under 16
  • UNDER_17 Under 17
  • UNDER_18 Under 18
  • UNDER_19 Under 19
  • UNDER_20 Under 20
  • UNDER_21 Under 21
  • UNDER_22 Under 22
  • UNDER_23 Under 23
  • YOUTH Youth
Example: SENIORPossible values:
competitionIdstring · uuidOptional

The unique identifier of the competition

Example: 009e9276-5c80-11e8-9c2d-fa7ae01bbebc
disciplinestring · enum · max: 30Optional

The discipline for a match

  • BEACH Beach
  • HOCKEY5S Hockey5s
  • INDOOR Indoor
  • OUTDOOR Outdoor
  • PARAHOCKEY Para hockey
Example: INDOORPossible values:
endDatestring · dateOptional

endDate on or before this date

Example: 2018-08-16
eventTypestring · enum · max: 30Optional

Type of Fixtures

  • FIXTURE Fixture
  • PRACTICE Practice
Example: FIXTUREPossible values:
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)]
genderstring · enumOptional

The gender of the season or team

  • FEMALE Female
  • MALE Male
  • MIXED Mixed
  • UNKNOWN Unknown
Example: MALEPossible 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
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
representationstring · enumOptional

What level are the competitors representing

  • CLUB Club
  • COUNTRY Country
  • PERSON Person
Example: CLUBPossible values:
seasonIdstringOptional

The unique identifier of the season. Can specify multiple, delimited by comma.

Example: 009e9276-5c80-11e8-9c2d-fa7ae01bbebc,de83c6a8-3b29-11eb-bdb7-0242ac130005
seasonTypestring · enumOptional

The type of matches added to this season

  • MULTI_YEAR_HISTORICAL Mulit-Year Historical
  • ONE_OFF One off match
  • PRESEASON Pre Season
  • SEASON Season
  • TOURNAMENT Tournament
Example: SEASONPossible values:
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|\-?year|,)*$
standardstring · enumOptional

The playing standard of the season or team

  • APPROVED_TEST_MATCHES Approved Test matches
  • COMMONWEALTH_GAMES Commonwealth Games
  • CONTINENTAL_CHAMPIONSHIP Continental Championship
  • CONTINENTAL_CHAMPIONSHIP_DIV_2 Continental Championship Div 2
  • CONTINENTAL_CHAMPIONSHIP_DIV_3 Continental Championship Div 3
  • CONTINENTAL_CHAMPIONSHIP_DIV_4 Continental Championship Div 4
  • CONTINENTAL_QUALIFIER Continental Qualifier
  • ELITE Professional/elite organisation
  • FIH_NATIONS_CUP FIH Nations Cup
  • FIH_OLYMPIC_QUALIFIERS FIH Olympic Qualifiers
  • FIH_PRO_LEAGUE FIH Pro League
  • FIH_WORLD_CUP FIH World Cup
  • FIH_WORLD_CUP_QUALIFIERS FIH World Cup Qualifiers
  • FRIENDLY International Friendly
  • GRASS_ROOT Normal
  • HISTORICAL_BASELINE Historical Baseline
  • HOCKEY_SERIES_OPEN Hockey Series Open
  • INTERNATIONAL International
  • INVITATIONAL_TOURNAMENT Invitational Tournament (3+ teams)
  • NONCONTINENTAL_CHAMPIONSHIP Non-continental Championship
  • OLYMPIC Olympics
  • OLYMPICS Olympic Games
  • REGION Regional
  • TIER2 lesser standard than elite
  • TIER3 lesser standard than tier 2
  • WORLD_CHAMPIONSHIP World Championship
  • WORLD_LEAGUE World League
  • ZONE_CHAMPIONSHIP International Zone Championship
Example: ELITEPossible values:
startDatestring · dateOptional

startDate on or after this date

Example: 2018-08-16
statusstring · enumOptional

Status

  • ACTIVE Active
  • COMPLETE Complete
  • DRAFT Draft
  • INACTIVE Inactive
  • PENDING Pending
Example: ACTIVEPossible values:
updatedstring · date-timeOptional

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

Example: 2018-08-16T02:11:48
videoProductionstring · enum · max: 50Optional

Data synchronization strategy with video production systems. Multiple allowed (comma-delimited).

  • AUTOMATED Automated
  • MANUAL Manual
  • NONE None
Example: NONE,AUTOMATEDPossible values:
Responses
get
/ice3/o/{organizationId}/seasons
GET /v1/ice3/o/{organizationId}/seasons 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",
      "organizationId": "9",
      "organization": {
        "resourceType": "organizations",
        "id": "9"
      },
      "competitionId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "competition": {
        "resourceType": "competitions",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "leaderCriteriaId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "leadersCriteria": {
        "resourceType": "leaderCriteria",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "internationalReference": "CA3243-3",
      "eventType": "FIXTURE",
      "seasonType": "SEASON",
      "year": 2019,
      "grade": "A",
      "status": "ACTIVE",
      "includeInStatistics": true,
      "liveVideoAvailable": true,
      "liveDataAvailable": true,
      "durationFull": 180,
      "discipline": "INDOOR",
      "nameLocal": "Test season",
      "nameLatin": "Test season",
      "nameShortLocal": "Test short local",
      "nameShortLatin": "Test short latin",
      "startDate": "2016-09-08",
      "endDate": "2016-09-08",
      "gender": "MALE",
      "ageGroup": "SENIOR",
      "standard": "ELITE",
      "representation": "CLUB",
      "standingConfigurationId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "standingConfiguration": {
        "resourceType": "standingConfigurations",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "lockStandings": true,
      "externalId": "A123",
      "social": {
        "website": "http://www.example.com",
        "facebook": "https://www.facebook.com/example",
        "twitter": "https://www.twitter.com/example",
        "wikipedia": "https://en.wikipedia.org/wiki/example",
        "instagram": "https://www.instagram.com/example"
      },
      "configuration": {
        "periodBreakDuration": 1,
        "halfTimeDuration": 1
      },
      "profileId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "fixtureProfile": {
        "resourceType": "fixtureProfiles",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "updated": "2025-11-19T06:30:31.104Z",
      "added": "2025-11-19T06:30:31.104Z",
      "images": [
        {
          "imageId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
          "organizationId": "9",
          "organization": {
            "resourceType": "organizations",
            "id": "9"
          },
          "baseType": "entity",
          "baseId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
          "fileType": "png",
          "imageType": "LOGO",
          "secondaryType": "entity",
          "secondaryId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
          "rating": "LOW",
          "url": "text",
          "maximumHeight": 200,
          "maximumWidth": 200,
          "updated": "2025-11-19T06:30:31.104Z",
          "added": "2025-11-19T06:30:31.104Z"
        }
      ],
      "videoProduction": "AUTOMATED",
      "promotionRelegationRules": [
        {
          "ruleType": "PROMOTION",
          "position": 1,
          "value": "DIV1"
        }
      ],
      "rosterConfiguration": {
        "windowOpenDate": "2023-01-01",
        "windowCloseDate": "2023-01-31",
        "seasonRosterLock": true,
        "fixtureRosterLock": false,
        "fixtureBibEdit": false,
        "seasonRosterStatusAllowed": [
          "ACTIVE"
        ],
        "publishSeasonRosterRolesInHours": true,
        "publishFixtureRosterRolesInMinutes": true
      }
    }
  ]
}

Get a season

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

Return detailed information about a specific 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
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
get
/ice3/o/{organizationId}/seasons/{seasonId}
GET /v1/ice3/o/{organizationId}/seasons/{seasonId} 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",
      "organizationId": "9",
      "organization": {
        "resourceType": "organizations",
        "id": "9"
      },
      "competitionId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "competition": {
        "resourceType": "competitions",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "leaderCriteriaId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "leadersCriteria": {
        "resourceType": "leaderCriteria",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "internationalReference": "CA3243-3",
      "eventType": "FIXTURE",
      "seasonType": "SEASON",
      "year": 2019,
      "grade": "A",
      "status": "ACTIVE",
      "includeInStatistics": true,
      "liveVideoAvailable": true,
      "liveDataAvailable": true,
      "durationFull": 180,
      "discipline": "INDOOR",
      "nameLocal": "Test season",
      "nameLatin": "Test season",
      "nameShortLocal": "Test short local",
      "nameShortLatin": "Test short latin",
      "startDate": "2016-09-08",
      "endDate": "2016-09-08",
      "gender": "MALE",
      "ageGroup": "SENIOR",
      "standard": "ELITE",
      "representation": "CLUB",
      "standingConfigurationId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "standingConfiguration": {
        "resourceType": "standingConfigurations",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "lockStandings": true,
      "externalId": "A123",
      "social": {
        "website": "http://www.example.com",
        "facebook": "https://www.facebook.com/example",
        "twitter": "https://www.twitter.com/example",
        "wikipedia": "https://en.wikipedia.org/wiki/example",
        "instagram": "https://www.instagram.com/example"
      },
      "configuration": {
        "periodBreakDuration": 1,
        "halfTimeDuration": 1
      },
      "profileId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "fixtureProfile": {
        "resourceType": "fixtureProfiles",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "updated": "2025-11-19T06:30:31.104Z",
      "added": "2025-11-19T06:30:31.104Z",
      "images": [
        {
          "imageId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
          "organizationId": "9",
          "organization": {
            "resourceType": "organizations",
            "id": "9"
          },
          "baseType": "entity",
          "baseId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
          "fileType": "png",
          "imageType": "LOGO",
          "secondaryType": "entity",
          "secondaryId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
          "rating": "LOW",
          "url": "text",
          "maximumHeight": 200,
          "maximumWidth": 200,
          "updated": "2025-11-19T06:30:31.104Z",
          "added": "2025-11-19T06:30:31.104Z"
        }
      ],
      "videoProduction": "AUTOMATED",
      "promotionRelegationRules": [
        {
          "ruleType": "PROMOTION",
          "position": 1,
          "value": "DIV1"
        }
      ],
      "rosterConfiguration": {
        "windowOpenDate": "2023-01-01",
        "windowCloseDate": "2023-01-31",
        "seasonRosterLock": true,
        "fixtureRosterLock": false,
        "fixtureBibEdit": false,
        "seasonRosterStatusAllowed": [
          "ACTIVE"
        ],
        "publishSeasonRosterRolesInHours": true,
        "publishFixtureRosterRolesInMinutes": true
      }
    }
  ]
}

Update a season

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

Change the information of a specific 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
competitionIdstring · uuidOptional

The unique identifier of the competition

Example: 009e9276-5c80-11e8-9c2d-fa7ae01bbebc
leaderCriteriaIdstring · uuid | nullableOptional

The unique identifier of the LeaderCriteria

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

The international reference for this season given by the sport governing body

Example: CA3243-3
eventTypestring · enum · max: 30Optional

Primary Type of Matches

  • FIXTURE Fixture
  • PRACTICE Practice
Default: FIXTUREExample: FIXTUREPossible values:
seasonTypestring · enum · max: 30Optional

The type of matches added to this season

  • MULTI_YEAR_HISTORICAL Mulit-Year Historical
  • ONE_OFF One off
  • PRESEASON Pre Season
  • SEASON Season
  • TOURNAMENT Tournament
Example: SEASONPossible values:
yearinteger · int32 · max: 4Optional

Year of the season

Example: 2019
gradestring | nullableOptional

The playing grade of the matches in this season

Example: A
statusstring · enum · max: 30Optional

Status

  • ACTIVE Active
  • COMPLETE Complete
  • DRAFT Draft
  • INACTIVE Inactive
  • PENDING Pending
Example: ACTIVEPossible values:
includeInStatisticsbooleanOptional

Include this season in calculated statistics?

Default: trueExample: true
liveVideoAvailablebooleanOptional

If no 'liveVideoAvailable' flag passed to a new match this value is used

Example: true
liveDataAvailablebooleanOptional

If no 'liveDataAvailable' flag passed to a new match this value is used

Example: true
durationFullinteger · int32 | nullableOptional

If no 'durationFull' is passed to a new match this value is used

Default: 180Example: 180
disciplinestring · enum | nullableOptional

If no 'discipline' is passed to a new match this value is used

  • None None
  • INDOOR Indoor
  • OUTDOOR Outdoor
Example: INDOORPossible values:
nameLocalstring · max: 150Optional

The name of the season in the local language

Example: Test season
nameLatinstring | nullableOptional

The name of the season in latin characters

Example: Test season
nameShortLocalstring | nullableOptional

The abbreviated name of the season in the local language

Example: Test short local
nameShortLatinstring | nullableOptional

The abbreviated name of the season in latin characters

Example: Test short latin
startDatestring · dateOptional

Season start date

Example: 2016-09-08
endDatestring · date | nullableOptional

Season end date

Example: 2016-09-08
genderstring · enum · max: 20Optional

The gender of the participants in the season

  • FEMALE Female
  • MALE Male
  • MIXED Mixed
  • UNKNOWN Unknown
Example: MALEPossible values:
ageGroupstring · enum · max: 50Optional

The age group of the season

  • JUNIOR Junior
  • MASTERS Masters
  • SENIOR Senior
  • UNDER_15 Under 15
  • UNDER_16 Under 16
  • UNDER_17 Under 17
  • UNDER_18 Under 18
  • UNDER_19 Under 19
  • UNDER_20 Under 20
  • UNDER_21 Under 21
  • UNDER_22 Under 22
  • UNDER_23 Under 23
  • YOUTH Youth
Example: SENIORPossible values:
standardstring · enum · max: 50Optional

The playing standard of the season

  • ELITE Professional/elite organisation
  • FRIENDLY International Friendly
  • GRASS_ROOT Normal
  • HISTORICAL_BASELINE Historical Baseline
  • INTERNATIONAL International
  • NONCONTINENTAL_CHAMPIONSHIP Non-continental Championship
  • OLYMPIC Olympics
  • REGION Regional
  • TIER2 lesser standard than elite
  • TIER3 lesser standard than tier 2
  • WORLD_CHAMPIONSHIP World Championship
  • ZONE_CHAMPIONSHIP International Zone Championship
Example: ELITEPossible values:
representationstring · enum · max: 50Optional

What level are the competitors representing

  • CLUB Club
  • COUNTRY Country
  • PERSON Person
  • REGION Region
  • STATE State
Example: CLUBPossible values:
standingConfigurationIdstring · uuid | nullableOptional

The unique identifier of the standingConfiguration

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

Is the standings generation locked ?

Example: true
externalIdstring | nullableOptional

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

Example: A123Pattern: ^[0-9A-Za-z/_-]+$
profileIdstring · uuid | nullableOptional

The profile that this season belongs to

Example: 009e9276-5c80-11e8-9c2d-fa7ae01bbebc
videoProductionstring · enum · max: 50Optional

Data synchronization strategy with video production systems

  • AUTOMATED Automated
  • MANUAL Manual
  • NONE None
Default: NONEExample: AUTOMATEDPossible values:
Responses
put
/ice3/o/{organizationId}/seasons/{seasonId}
PUT /v1/ice3/o/{organizationId}/seasons/{seasonId} HTTP/1.1
Host: api.dc.connect.sportradar.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 1452

{
  "competitionId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
  "leaderCriteriaId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
  "internationalReference": "CA3243-3",
  "eventType": "FIXTURE",
  "seasonType": "SEASON",
  "year": 2019,
  "grade": "A",
  "status": "ACTIVE",
  "includeInStatistics": true,
  "liveVideoAvailable": true,
  "liveDataAvailable": true,
  "durationFull": 180,
  "discipline": "INDOOR",
  "nameLocal": "Test season",
  "nameLatin": "Test season",
  "nameShortLocal": "Test short local",
  "nameShortLatin": "Test short latin",
  "startDate": "2016-09-08",
  "endDate": "2016-09-08",
  "gender": "MALE",
  "ageGroup": "SENIOR",
  "standard": "ELITE",
  "representation": "CLUB",
  "standingConfigurationId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
  "lockStandings": true,
  "externalId": "A123",
  "social": {
    "website": "http://www.example.com",
    "facebook": "https://www.facebook.com/example",
    "twitter": "https://www.twitter.com/example",
    "wikipedia": "https://en.wikipedia.org/wiki/example",
    "instagram": "https://www.instagram.com/example"
  },
  "configuration": {
    "periodBreakDuration": 1,
    "halfTimeDuration": 1
  },
  "profileId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
  "videoProduction": "AUTOMATED",
  "promotionRelegationRules": [
    {
      "ruleType": "PROMOTION",
      "position": 1,
      "value": "DIV1"
    }
  ],
  "rosterConfiguration": {
    "windowOpenDate": "2023-01-01",
    "windowCloseDate": "2023-01-31",
    "seasonRosterLock": true,
    "fixtureRosterLock": false,
    "fixtureBibEdit": false,
    "seasonRosterStatusAllowed": [
      "ACTIVE"
    ],
    "publishSeasonRosterRolesInHours": true,
    "publishFixtureRosterRolesInMinutes": true
  }
}
{
  "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",
      "organizationId": "9",
      "organization": {
        "resourceType": "organizations",
        "id": "9"
      },
      "competitionId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "competition": {
        "resourceType": "competitions",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "leaderCriteriaId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "leadersCriteria": {
        "resourceType": "leaderCriteria",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "internationalReference": "CA3243-3",
      "eventType": "FIXTURE",
      "seasonType": "SEASON",
      "year": 2019,
      "grade": "A",
      "status": "ACTIVE",
      "includeInStatistics": true,
      "liveVideoAvailable": true,
      "liveDataAvailable": true,
      "durationFull": 180,
      "discipline": "INDOOR",
      "nameLocal": "Test season",
      "nameLatin": "Test season",
      "nameShortLocal": "Test short local",
      "nameShortLatin": "Test short latin",
      "startDate": "2016-09-08",
      "endDate": "2016-09-08",
      "gender": "MALE",
      "ageGroup": "SENIOR",
      "standard": "ELITE",
      "representation": "CLUB",
      "standingConfigurationId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "standingConfiguration": {
        "resourceType": "standingConfigurations",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "lockStandings": true,
      "externalId": "A123",
      "social": {
        "website": "http://www.example.com",
        "facebook": "https://www.facebook.com/example",
        "twitter": "https://www.twitter.com/example",
        "wikipedia": "https://en.wikipedia.org/wiki/example",
        "instagram": "https://www.instagram.com/example"
      },
      "configuration": {
        "periodBreakDuration": 1,
        "halfTimeDuration": 1
      },
      "profileId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "fixtureProfile": {
        "resourceType": "fixtureProfiles",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "updated": "2025-11-19T06:30:31.104Z",
      "added": "2025-11-19T06:30:31.104Z",
      "images": [
        {
          "imageId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
          "organizationId": "9",
          "organization": {
            "resourceType": "organizations",
            "id": "9"
          },
          "baseType": "entity",
          "baseId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
          "fileType": "png",
          "imageType": "LOGO",
          "secondaryType": "entity",
          "secondaryId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
          "rating": "LOW",
          "url": "text",
          "maximumHeight": 200,
          "maximumWidth": 200,
          "updated": "2025-11-19T06:30:31.104Z",
          "added": "2025-11-19T06:30:31.104Z"
        }
      ],
      "videoProduction": "AUTOMATED",
      "promotionRelegationRules": [
        {
          "ruleType": "PROMOTION",
          "position": 1,
          "value": "DIV1"
        }
      ],
      "rosterConfiguration": {
        "windowOpenDate": "2023-01-01",
        "windowCloseDate": "2023-01-31",
        "seasonRosterLock": true,
        "fixtureRosterLock": false,
        "fixtureBibEdit": false,
        "seasonRosterStatusAllowed": [
          "ACTIVE"
        ],
        "publishSeasonRosterRolesInHours": true,
        "publishFixtureRosterRolesInMinutes": true
      }
    }
  ]
}

Delete a season

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

Delete a specific 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)]
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
delete
/ice3/o/{organizationId}/seasons/{seasonId}
DELETE /v1/ice3/o/{organizationId}/seasons/{seasonId} 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",
      "organizationId": "9",
      "organization": {
        "resourceType": "organizations",
        "id": "9"
      },
      "competitionId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "competition": {
        "resourceType": "competitions",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "leaderCriteriaId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "leadersCriteria": {
        "resourceType": "leaderCriteria",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "internationalReference": "CA3243-3",
      "eventType": "FIXTURE",
      "seasonType": "SEASON",
      "year": 2019,
      "grade": "A",
      "status": "ACTIVE",
      "includeInStatistics": true,
      "liveVideoAvailable": true,
      "liveDataAvailable": true,
      "durationFull": 180,
      "discipline": "INDOOR",
      "nameLocal": "Test season",
      "nameLatin": "Test season",
      "nameShortLocal": "Test short local",
      "nameShortLatin": "Test short latin",
      "startDate": "2016-09-08",
      "endDate": "2016-09-08",
      "gender": "MALE",
      "ageGroup": "SENIOR",
      "standard": "ELITE",
      "representation": "CLUB",
      "standingConfigurationId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "standingConfiguration": {
        "resourceType": "standingConfigurations",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "lockStandings": true,
      "externalId": "A123",
      "social": {
        "website": "http://www.example.com",
        "facebook": "https://www.facebook.com/example",
        "twitter": "https://www.twitter.com/example",
        "wikipedia": "https://en.wikipedia.org/wiki/example",
        "instagram": "https://www.instagram.com/example"
      },
      "configuration": {
        "periodBreakDuration": 1,
        "halfTimeDuration": 1
      },
      "profileId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "fixtureProfile": {
        "resourceType": "fixtureProfiles",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "updated": "2025-11-19T06:30:31.104Z",
      "added": "2025-11-19T06:30:31.104Z",
      "images": [
        {
          "imageId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
          "organizationId": "9",
          "organization": {
            "resourceType": "organizations",
            "id": "9"
          },
          "baseType": "entity",
          "baseId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
          "fileType": "png",
          "imageType": "LOGO",
          "secondaryType": "entity",
          "secondaryId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
          "rating": "LOW",
          "url": "text",
          "maximumHeight": 200,
          "maximumWidth": 200,
          "updated": "2025-11-19T06:30:31.104Z",
          "added": "2025-11-19T06:30:31.104Z"
        }
      ],
      "videoProduction": "AUTOMATED",
      "promotionRelegationRules": [
        {
          "ruleType": "PROMOTION",
          "position": 1,
          "value": "DIV1"
        }
      ],
      "rosterConfiguration": {
        "windowOpenDate": "2023-01-01",
        "windowCloseDate": "2023-01-31",
        "seasonRosterLock": true,
        "fixtureRosterLock": false,
        "fixtureBibEdit": false,
        "seasonRosterStatusAllowed": [
          "ACTIVE"
        ],
        "publishSeasonRosterRolesInHours": true,
        "publishFixtureRosterRolesInMinutes": true
      }
    }
  ]
}
PreviousSeason RosterNextSites

Last updated

Was this helpful?