# 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.

![](https://yuml.me/diagram/scruffy;dir:LR/class/\[Competitions]-%3C%3E\[Seasons%7Bbg:orange%7D],\[Seasons]-%3C%3E\[Matches],\[Seasons]-%3E\[Stages],\[Seasons]-%3E\[Pools],\[Seasons]-%3E\[Rounds],\[Matches]-.-%3E\[Stages],\[Matches]-.-%3E\[Pools],\[Matches]-.-%3E\[Rounds],)

## Get a list of seasons

> Return a list of seasons in the competition.

```json
{"openapi":"3.0.0","info":{"title":"DataCore API  - Ice Hockey","version":"v1"},"tags":[{"name":"Seasons","description":"Season is a grouping of matches. Generally the season will last a portion of a year (every year).\n\nThe competition can have many seasons, but the season can only belong to one competition.\n\n<img src = \"https://yuml.me/diagram/scruffy;dir:LR/class/[Competitions]-<>[Seasons{bg:orange}],[Seasons]-<>[Matches],[Seasons]->[Stages],[Seasons]->[Pools],[Seasons]->[Rounds],[Matches]-.->[Stages],[Matches]-.->[Pools],[Matches]-.->[Rounds],\">\n\n"}],"servers":[{"url":"https://api.dc.connect.sportradar.com/v1","description":"Production server"},{"url":"https://api.dc.stg.connect-nonprod.sportradar.dev/v1","description":"NonProduction/Staging server"}],"security":[{"OAuth2":["read:organization"]}],"components":{"securitySchemes":{"OAuth2":{"type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"/oauth/token","scopes":{"orgId":"Authenticate based on a specific OrganizationId","read:orggroup":"Read data over multiple organizations using and *orggroup* code","write:organization":"Write/Update any data from below the organization","read:organization":"Read any data from the organization down","write:admin":"Perform administration API calls","write:admin_organization":"Ability to manage organizations","write:system":"Perform system configuration API calls"}}},"description":"You can create a JSON Web Token (JWT) using the [token](http://developer.connect.sportradar.com/token/#operation/getToken) 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."}},"schemas":{"ResponseMetaData":{"type":"object","properties":{"version":{"type":"integer","description":"The version of the API in use for this call"},"codeVersion":{"type":"string","description":"A string indicating the version of the code that handled this request"},"code":{"type":"integer","description":"The HTTP response code for this request"},"time":{"type":"string","format":"date-time","description":"The date/time this request was made (in UTC)."},"fromCache":{"type":"boolean","description":"Was this request served directly from the cache?"},"count":{"type":"integer","description":"The number of records being returned"},"limit":{"type":"integer","description":"The record limit in place for this request"},"offset":{"type":"integer","description":"The record offset in place for this request"},"generationTime":{"type":"number","format":"float","description":"The number of seconds taken to generate this request."}}},"ResponseLinks":{"type":"object","properties":{"self":{"type":"string","format":"uri","description":"The URI referencing this request."},"next":{"type":"string","format":"uri","description":"The URI referencing the 'next' page, if more data is available."},"previous":{"type":"string","format":"uri","description":"The URI referencing the 'previous' page, if the request is not on the first page."}}},"IncludedData":{"type":"object","description":"Available if the request used the 'include' parameter.  It contains extra data about resources found in the data block.","properties":{"resources":{"type":"object","additionalProperties":{"description":"The type of resource","type":"object","enum":["league","organisation","persons"],"additionalProperties":{"type":"object","format":"uuid","description":"The id of the resource","additionalProperties":{"description":"The model for the resource as defined by the type and id"}}}}}},"SeasonsModel":{"type":"object","additionalProperties":false,"properties":{"seasonId":{"description":"The unique identifier of the season","type":"string","format":"uuid"},"organizationId":{"description":"The unique identifier of the organization","type":"string","readOnly":true},"organization":{"properties":{"resourceType":{"type":"string","enum":["organizations"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The organization that this season belongs to","type":"object"},"competitionId":{"description":"The unique identifier of the competition","type":"string","format":"uuid"},"competition":{"properties":{"resourceType":{"type":"string","enum":["competitions"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The competition that this season belongs to","type":"object"},"leaderCriteriaId":{"description":"The unique identifier of the ~LeaderCriteria~","type":"string","format":"uuid","nullable":true},"leadersCriteria":{"properties":{"resourceType":{"type":"string","enum":["leaderCriteria"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The ~LeaderCriteria~ linked to this record","type":"object"},"internationalReference":{"description":"The international reference for this season given by the sport governing body","type":"string","maxLength":30,"nullable":true},"eventType":{"description":"Primary Type of Matches\n>- `FIXTURE` Fixture\n>- `PRACTICE` Practice\n","type":"string","enum":["FIXTURE","PRACTICE"],"maxLength":30,"default":"FIXTURE"},"seasonType":{"description":"The type of matches added to this season\n>- `MULTI_YEAR_HISTORICAL` Mulit-Year Historical\n>- `ONE_OFF` One off\n>- `PRESEASON` Pre Season\n>- `SEASON` Season\n>- `TOURNAMENT` Tournament\n","type":"string","enum":["SEASON","TOURNAMENT","ONE_OFF","PRESEASON","MULTI_YEAR_HISTORICAL"],"maxLength":30},"year":{"description":"Year of the season","type":"integer","format":"int32","maxLength":4},"grade":{"description":"The playing grade of the matches in this season","type":"string","maxLength":50,"nullable":true},"status":{"description":"Status\n>- `ACTIVE` Active\n>- `COMPLETE` Complete\n>- `DRAFT` Draft\n>- `INACTIVE` Inactive\n>- `PENDING` Pending\n","type":"string","enum":["ACTIVE","COMPLETE","DRAFT","INACTIVE","PENDING"],"maxLength":30},"includeInStatistics":{"description":"Include this season in calculated statistics?","type":"boolean","default":true},"liveVideoAvailable":{"description":"If no 'liveVideoAvailable' flag passed to a new match this value is used","type":"boolean"},"liveDataAvailable":{"description":"If no 'liveDataAvailable' flag passed to a new match this value is used","type":"boolean"},"durationFull":{"description":"If no 'durationFull' is passed to a new match this value is used","type":"integer","format":"int32","default":180,"nullable":true},"discipline":{"description":"If no 'discipline' is passed to a new match this value is used\n>- None None\n>- `INDOOR` Indoor\n>- `OUTDOOR` Outdoor\n","type":"string","enum":["INDOOR","OUTDOOR",null],"nullable":true},"nameLocal":{"description":"The name of the season in the [local](#section/Introduction/Character-Sets-and-Names) language","type":"string","maxLength":150},"nameLatin":{"description":"The name of the season in [latin](#section/Introduction/Character-Sets-and-Names) characters","type":"string","maxLength":150,"nullable":true},"nameShortLocal":{"description":"The abbreviated name of the season in the [local](#section/Introduction/Character-Sets-and-Names) language","type":"string","maxLength":50,"nullable":true},"nameShortLatin":{"description":"The abbreviated name of the season in [latin](#section/Introduction/Character-Sets-and-Names) characters","type":"string","maxLength":50,"nullable":true},"startDate":{"description":"Season start date","type":"string","format":"date"},"endDate":{"description":"Season end date","type":"string","format":"date","nullable":true},"gender":{"description":"The gender of the participants in the season\n>- `FEMALE` Female\n>- `MALE` Male\n>- `MIXED` Mixed\n>- `UNKNOWN` Unknown\n","type":"string","enum":["FEMALE","MALE","MIXED","UNKNOWN"],"maxLength":20},"ageGroup":{"description":"The age group of the season\n>- `JUNIOR` Junior\n>- `MASTERS` Masters\n>- `SENIOR` Senior\n>- `UNDER_15` Under 15\n>- `UNDER_16` Under 16\n>- `UNDER_17` Under 17\n>- `UNDER_18` Under 18\n>- `UNDER_19` Under 19\n>- `UNDER_20` Under 20\n>- `UNDER_21` Under 21\n>- `UNDER_22` Under 22\n>- `UNDER_23` Under 23\n>- `YOUTH` Youth\n","type":"string","enum":["JUNIOR","YOUTH","UNDER_15","UNDER_16","UNDER_17","UNDER_18","UNDER_19","UNDER_20","UNDER_21","UNDER_22","UNDER_23","SENIOR","MASTERS"],"maxLength":50},"standard":{"description":"The playing standard of the season\n>- `ELITE` Professional/elite organisation\n>- `FRIENDLY` International Friendly\n>- `GRASS_ROOT` Normal\n>- `HISTORICAL_BASELINE` Historical Baseline\n>- `INTERNATIONAL` International\n>- `NONCONTINENTAL_CHAMPIONSHIP` Non-continental Championship\n>- `OLYMPIC` Olympics\n>- `REGION` Regional\n>- `TIER2` lesser standard than elite\n>- `TIER3` lesser standard than tier 2\n>- `WORLD_CHAMPIONSHIP` World Championship\n>- `ZONE_CHAMPIONSHIP` International Zone Championship\n","type":"string","enum":["ELITE","FRIENDLY","GRASS_ROOT","INTERNATIONAL","NONCONTINENTAL_CHAMPIONSHIP","OLYMPIC","REGION","TIER2","TIER3","WORLD_CHAMPIONSHIP","ZONE_CHAMPIONSHIP","HISTORICAL_BASELINE"],"maxLength":50},"representation":{"description":"What level are the competitors representing\n>- `CLUB` Club\n>- `COUNTRY` Country\n>- `PERSON` Person\n>- `REGION` Region\n>- `STATE` State\n","type":"string","enum":["CLUB","STATE","REGION","COUNTRY","PERSON"],"maxLength":50},"standingConfigurationId":{"description":"The unique identifier of the ~standingConfiguration~","type":"string","format":"uuid","nullable":true},"standingConfiguration":{"properties":{"resourceType":{"type":"string","enum":["standingConfigurations"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The ~standingConfiguration~ that this season belongs to","type":"object"},"lockStandings":{"description":"Is the standings generation locked ?","type":"boolean"},"externalId":{"description":"The Id of the data as set by the provider of the data","type":"string","maxLength":150,"pattern":"^[0-9A-Za-z/_-]+$","nullable":true},"social":{"title":"Social Media","description":"Social Media contacts","type":"object","nullable":true,"additionalProperties":false,"properties":{"website":{"type":"string","nullable":true,"format":"uri"},"facebook":{"type":"string","nullable":true,"format":"uri"},"twitter":{"type":"string","nullable":true,"format":"uri"},"wikipedia":{"type":"string","nullable":true,"format":"uri"},"instagram":{"type":"string","nullable":true,"format":"uri"}}},"configuration":{"title":"Season Configuration","description":"Season Configuration settings","type":"object","nullable":true,"additionalProperties":false,"properties":{"periodBreakDuration":{"type":"number"},"halfTimeDuration":{"type":"number"},"shotClockLength":{"type":"number"},"foulsUntilBonus":{"type":"number"},"foulsAllowedPersonal":{"type":"number"},"foulsAllowedTechnical":{"type":"number"}}},"profileId":{"description":"The profile that this season belongs to","type":"string","format":"uuid","nullable":true},"fixtureProfile":{"properties":{"resourceType":{"type":"string","enum":["fixtureProfiles"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The profile that this season belongs to","type":"object"},"updated":{"description":"Date/time last modified. In UTC","type":"string","format":"date-time","readOnly":true},"added":{"description":"Date/time added. In UTC","type":"string","format":"date-time","readOnly":true},"images":{"type":"array","items":{"$ref":"#/components/schemas/ImagesModel"}},"videoProduction":{"description":"Data synchronization strategy with video production systems\n>- `AUTOMATED` Automated\n>- `MANUAL` Manual\n>- `NONE` None\n","type":"string","enum":["NONE","AUTOMATED","MANUAL"],"maxLength":50,"default":"NONE"},"promotionRelegationRules":{"type":"array","nullable":true,"items":{"type":"object","additionalProperties":false,"required":["ruleType","position","value"],"properties":{"ruleType":{"description":"Rule Type","type":"string","enum":["PROMOTION","RELEGATION"]},"position":{"description":"Standings Position","type":"number"},"value":{"description":"Value to apply to Promotion or Relegation","type":"string"}}}},"rosterConfiguration":{"title":"SEASON ROSTER configuration","description":"Configuration for the SEASON ROSTER","type":"object","nullable":true,"additionalProperties":false,"properties":{"windowOpenDate":{"description":"What date can a SEASON ROSTER be submitted from for this SEASON?","type":"string","nullable":true,"format":"date"},"windowCloseDate":{"description":"What is the last date a SEASON ROSTER can be submitted from for this SEASON?","type":"string","nullable":true,"format":"date"},"seasonRosterLock":{"description":"Make SEASON ROSTERS un-editable when SEASON ROSTER Registration Window Close Date has elapsed.","type":"boolean","nullable":true},"fixtureRosterLock":{"description":"Make FIXTURE ROSTERS un-editable when MATCH Status is set to Scheduled","type":"boolean","nullable":true},"fixtureBibEdit":{"description":"Allow Add/Edit of FIXTURE ROSTERS bib","type":"boolean","nullable":true},"seasonRosterStatusAllowed":{"description":"Season Roster status allowed","type":"array","items":{"type":"string","enum":["ACTIVE","INJURED","OTHER_NOT_PARTICIPATING","OUT","SUSPENDED"]}},"publishSeasonRosterRolesInHours":{"description":"How long before SEASON starts can rosters or roles be published (in hours)","type":"number","nullable":true},"publishFixtureRosterRolesInMinutes":{"description":"How long before a MATCH starts can rosters or roles be published (in minutes)","type":"number","nullable":true}}}},"title":"season model"},"ImagesModel":{"type":"object","additionalProperties":false,"properties":{"imageId":{"description":"The unique identifier of the image record","type":"string","format":"uuid","readOnly":true},"organizationId":{"description":"The unique identifier of the organization","type":"string","readOnly":true},"organization":{"properties":{"resourceType":{"type":"string","enum":["organizations"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The organization that this images belongs to","type":"object"},"baseType":{"description":"The object that this image relates to\n>- `COMPETITION` Competition\n>- `CONFERENCE` Conference\n>- `DIVISION` Division\n>- `ENTITY` Entity\n>- `ENTITYGROUP` Entity Group\n>- `LEAGUE` League\n>- `ORGANIZATION` Organization\n>- `PERSON` Person\n>- `SEASON` Season\n>- `UNIFORM` Uniform\n>- `UNIFORM_ITEM` Uniform Item\n","type":"string","enum":["PERSON","ENTITY","ENTITYGROUP","COMPETITION","SEASON","LEAGUE","ORGANIZATION","DIVISION","CONFERENCE","UNIFORM","UNIFORM_ITEM"],"maxLength":100},"baseId":{"description":"The unique identifier of the object associated with this image's record. If the `baseType` is `PERSON` then this would be the value of `personId`.","type":"string","format":"uuid"},"fileType":{"description":"The type of file\n>- `JPG` jpg\n>- `PNG` png\n>- `SVG` svg\n","type":"string","enum":["JPG","PNG","SVG"],"maxLength":3,"readOnly":true},"imageType":{"description":"Upload Type\n>- `LOGO` Logo - Not valid for 'PERSON' baseType\n>- `LOGO_ALTERNATE` Logo (alternate) - Not valid for 'PERSON' baseType\n>- `LOGO_BACKGROUND` Stylised logo for background purposes - Not valid for 'PERSON' baseType\n>- `PERSON_HEAD` Head shot (shoulders and head) - Only valid for 'PERSON' baseType\n>- `PERSON_POSE` Person posing - Only valid for 'PERSON' baseType\n>- `PERSON_WAIST` Head shot from the waist up - Only valid for 'PERSON' baseType\n>- `TEAM_PHOTO` Team Photo - Only valid for 'ENTITY' baseType\n>- `UNIFORM` Uniform\n>- `UNIFORM_ITEM` Uniform Item\n","type":"string","enum":["LOGO","LOGO_ALTERNATE","LOGO_BACKGROUND","PERSON_HEAD","PERSON_WAIST","PERSON_POSE","TEAM_PHOTO","UNIFORM","UNIFORM_ITEM"],"maxLength":100},"secondaryType":{"description":"If the image relates to a secondary object. Such as a photo of a person in a team, then baseType would be PERSON and secondaryType would be TEAM.\n>- None None\n>- `COMPETITION` Competition\n>- `CONFERENCE` Conference\n>- `DIVISION` Division\n>- `ENTITY` Entity\n>- `ENTITYGROUP` Entity Group\n>- `LEAGUE` League\n>- `SEASON` Season\n","type":"string","enum":["ENTITY","ENTITYGROUP","COMPETITION","SEASON","LEAGUE","DIVISION","CONFERENCE",null],"maxLength":100,"nullable":true},"secondaryId":{"description":"The unique identifier of the object associated with the secondaryType","type":"string","format":"uuid"},"rating":{"description":"The rating given to the quality of the image.  All images are LOW by default but are set ad MEDIUM if they are large enough and have transparency.  Images are only marked as HIGH if they have been manually reviewed.  You should take your use-case into account when you go to use the image.\n>- `HIGH` High\n>- `LOW` Low\n>- `MEDIUM` Medium\n","type":"string","enum":["LOW","MEDIUM","HIGH"],"maxLength":100,"readOnly":true},"url":{"description":"The URL of the image. See [Images](#section/Introduction/Images) for more information.","type":"string","readOnly":true},"maximumHeight":{"description":"The maximum height (in pixels) of this image.","type":"integer","format":"int32","readOnly":true},"maximumWidth":{"description":"The maximum width (in pixels) of this image.","type":"integer","format":"int32","readOnly":true},"updated":{"description":"Date/time last modified. In UTC","type":"string","format":"date-time","readOnly":true},"added":{"description":"Date/time added. In UTC","type":"string","format":"date-time","readOnly":true}},"title":"images model"},"ErrorModel":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP Error code indicating the type of error.  If there are multiple errors, then this will be the code of the first one.","format":"int32"},"message":{"type":"string","description":"A message indicating the reason for the error. If there are multiple errors, then this is the message for the first one."},"errors":{"type":"array","items":{"$ref":"#/components/schemas/ErrorListModel"}}}},"ErrorListModel":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP Error code indicating the type of error.","format":"int32"},"reason":{"enum":["INVALID_DATA","NOT_FOUND","NOT_AUTHORISED","ERROR","DELETE_ERROR"],"description":"A short code indicating the type of error"},"message":{"type":"string","description":"A message indicating the reason for the error"},"rowNumber":{"type":"integer","description":"The row number of the payload that cause the error","format":"int32"}}}},"responses":{"ErrorResponse":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"meta":{"$ref":"#/components/schemas/ResponseMetaData"},"error":{"$ref":"#/components/schemas/ErrorModel"}}}}}}},"parameters":{"added":{"name":"added","description":"Record was added after this date/time. In UTC.","schema":{"type":"string","format":"date-time"},"required":false,"in":"query"},"ageGroup":{"name":"ageGroup","description":"The age group of the season\n>- `JUNIOR` Junior\n>- `MASTERS` Masters\n>- `SENIOR` Senior\n>- `UNDER_15` Under 15\n>- `UNDER_16` Under 16\n>- `UNDER_17` Under 17\n>- `UNDER_18` Under 18\n>- `UNDER_19` Under 19\n>- `UNDER_20` Under 20\n>- `UNDER_21` Under 21\n>- `UNDER_22` Under 22\n>- `UNDER_23` Under 23\n>- `YOUTH` Youth\n","schema":{"type":"string","enum":["JUNIOR","YOUTH","UNDER_15","UNDER_16","UNDER_17","UNDER_18","UNDER_19","UNDER_20","UNDER_21","UNDER_22","UNDER_23","SENIOR","MASTERS"]},"required":false,"in":"query"},"discipline":{"name":"discipline","description":"The discipline for a match\n>- `BEACH` Beach\n>- `HOCKEY5S` Hockey5s\n>- `INDOOR` Indoor\n>- `OUTDOOR` Outdoor\n>- `PARAHOCKEY` Para hockey\n","schema":{"type":"string","enum":["INDOOR","OUTDOOR","HOCKEY5S","PARAHOCKEY","BEACH"],"maxLength":30},"required":false,"in":"query"},"endDate":{"name":"endDate","description":"endDate on or before this date","schema":{"type":"string","format":"date"},"required":false,"in":"query"},"SEASONeventType":{"name":"eventType","description":"Type of Fixtures\n>- `FIXTURE` Fixture\n>- `PRACTICE` Practice\n","schema":{"type":"string","enum":["FIXTURE","PRACTICE"],"maxLength":30},"required":false,"in":"query"},"external":{"name":"external","description":"A comma separated list of fields that will instead be interpreted as an externalId. See [External Ids](#section/Introduction/External-Ids) for more information.","schema":{"type":"string"},"required":false,"in":"query"},"fields":{"name":"fields","description":"A comma separated list of fields to display.  The response will only display these fields. See [Partial Response](#section/Partial-Response) section for more information.","schema":{"type":"string"},"required":false,"in":"query"},"gender":{"name":"gender","description":"The gender of the season or team\n>- `FEMALE` Female\n>- `MALE` Male\n>- `MIXED` Mixed\n>- `UNKNOWN` Unknown\n","schema":{"type":"string","enum":["FEMALE","MALE","MIXED","UNKNOWN"]},"required":false,"in":"query"},"hideNull":{"name":"hideNull","description":"Don't display data fields with null values or empty structures","schema":{"type":"boolean"},"required":false,"in":"query"},"include":{"name":"include","description":"A comma separated list of resource types to include. See [Resource Inclusion](#section/Introduction/Resource-Inclusion) for more information.","schema":{"type":"string"},"required":false,"in":"query"},"limit":{"name":"limit","description":"The maximum number of records to return. See [Pagination](#section/Introduction/Pagination) for more information.","schema":{"type":"integer","format":"int32","maximum":1000,"minimum":1,"default":10},"required":false,"in":"query"},"nameLatinContains":{"name":"nameLatinContains","description":"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","schema":{"type":"string","minLength":2,"maxLength":50},"required":false,"in":"query"},"nameLocalContains":{"name":"nameLocalContains","description":"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","schema":{"type":"string","minLength":2,"maxLength":50},"required":false,"in":"query"},"offset":{"name":"offset","description":"The offset of the records. See [Pagination](#section/Introduction/Pagination) for more information.","schema":{"type":"integer","format":"int32"},"required":false,"in":"query"},"representation":{"name":"representation","description":"What level are the competitors representing\n>- `CLUB` Club\n>- `COUNTRY` Country\n>- `PERSON` Person\n","schema":{"type":"string","enum":["CLUB","COUNTRY","PERSON"]},"required":false,"in":"query"},"seasonType":{"name":"seasonType","description":"The type of matches added to this season\n>- `MULTI_YEAR_HISTORICAL` Mulit-Year Historical\n>- `ONE_OFF` One off match\n>- `PRESEASON` Pre Season\n>- `SEASON` Season\n>- `TOURNAMENT` Tournament\n","schema":{"type":"string","enum":["SEASON","TOURNAMENT","ONE_OFF","PRESEASON","MULTI_YEAR_HISTORICAL"]},"required":false,"in":"query"},"standard":{"name":"standard","description":"The playing standard of the season or team\n>- `APPROVED_TEST_MATCHES` Approved Test matches\n>- `COMMONWEALTH_GAMES` Commonwealth Games\n>- `CONTINENTAL_CHAMPIONSHIP` Continental Championship\n>- `CONTINENTAL_CHAMPIONSHIP_DIV_2` Continental Championship Div 2\n>- `CONTINENTAL_CHAMPIONSHIP_DIV_3` Continental Championship Div 3\n>- `CONTINENTAL_CHAMPIONSHIP_DIV_4` Continental Championship Div 4\n>- `CONTINENTAL_QUALIFIER` Continental Qualifier\n>- `ELITE` Professional/elite organisation\n>- `FIH_NATIONS_CUP` FIH Nations Cup\n>- `FIH_OLYMPIC_QUALIFIERS` FIH Olympic Qualifiers\n>- `FIH_PRO_LEAGUE` FIH Pro League\n>- `FIH_WORLD_CUP` FIH World Cup\n>- `FIH_WORLD_CUP_QUALIFIERS` FIH World Cup Qualifiers\n>- `FRIENDLY` International Friendly\n>- `GRASS_ROOT` Normal\n>- `HISTORICAL_BASELINE` Historical Baseline\n>- `HOCKEY_SERIES_OPEN` Hockey Series Open\n>- `INTERNATIONAL` International\n>- `INVITATIONAL_TOURNAMENT` Invitational Tournament (3+ teams)\n>- `NONCONTINENTAL_CHAMPIONSHIP` Non-continental Championship\n>- `OLYMPIC` Olympics\n>- `OLYMPICS` Olympic Games\n>- `REGION` Regional\n>- `TIER2` lesser standard than elite\n>- `TIER3` lesser standard than tier 2\n>- `WORLD_CHAMPIONSHIP` World Championship\n>- `WORLD_LEAGUE` World League\n>- `ZONE_CHAMPIONSHIP` International Zone Championship\n","schema":{"type":"string","enum":["ELITE","FRIENDLY","GRASS_ROOT","INTERNATIONAL","NONCONTINENTAL_CHAMPIONSHIP","OLYMPIC","REGION","TIER2","TIER3","WORLD_CHAMPIONSHIP","ZONE_CHAMPIONSHIP","OLYMPICS","FIH_WORLD_CUP","FIH_OLYMPIC_QUALIFIERS","FIH_WORLD_CUP_QUALIFIERS","CONTINENTAL_CHAMPIONSHIP","FIH_PRO_LEAGUE","COMMONWEALTH_GAMES","FIH_NATIONS_CUP","CONTINENTAL_QUALIFIER","CONTINENTAL_CHAMPIONSHIP_DIV_2","CONTINENTAL_CHAMPIONSHIP_DIV_3","INVITATIONAL_TOURNAMENT","CONTINENTAL_CHAMPIONSHIP_DIV_4","APPROVED_TEST_MATCHES","WORLD_LEAGUE","HOCKEY_SERIES_OPEN","HISTORICAL_BASELINE"]},"required":false,"in":"query"},"startDate":{"name":"startDate","description":"startDate on or after this date","schema":{"type":"string","format":"date"},"required":false,"in":"query"},"updated":{"name":"updated","description":"Record was modified after this date/time. In UTC.","schema":{"type":"string","format":"date-time"},"required":false,"in":"query"},"videoProduction":{"name":"videoProduction","description":"Data synchronization strategy with video production systems. Multiple allowed (comma-delimited).\n>- `AUTOMATED` Automated\n>- `MANUAL` Manual\n>- `NONE` None\n","schema":{"type":"string","enum":["NONE","AUTOMATED","MANUAL"],"maxLength":50},"required":false,"in":"query"}}},"paths":{"/icehockey/o/{organizationId}/competitions/{competitionId}/seasons":{"get":{"tags":["Seasons"],"summary":"Get a list of seasons","description":"Return a list of seasons in the competition.","operationId":"season_list","responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","title":"Seasons Response","properties":{"meta":{"$ref":"#/components/schemas/ResponseMetaData"},"links":{"$ref":"#/components/schemas/ResponseLinks"},"included":{"$ref":"#/components/schemas/IncludedData"},"data":{"type":"array","description":"","items":{"$ref":"#/components/schemas/SeasonsModel"}}}}}}},"default":{"$ref":"#/components/responses/ErrorResponse"}},"parameters":[{"$ref":"#/components/parameters/added"},{"$ref":"#/components/parameters/ageGroup"},{"name":"competitionId","description":"The unique identifier of the competition","schema":{"type":"string","format":"uuid"},"required":true,"in":"path"},{"$ref":"#/components/parameters/discipline"},{"$ref":"#/components/parameters/endDate"},{"$ref":"#/components/parameters/SEASONeventType"},{"$ref":"#/components/parameters/external"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/gender"},{"$ref":"#/components/parameters/hideNull"},{"$ref":"#/components/parameters/include"},{"$ref":"#/components/parameters/limit"},{"$ref":"#/components/parameters/nameLatinContains"},{"$ref":"#/components/parameters/nameLocalContains"},{"$ref":"#/components/parameters/offset"},{"name":"organizationId","description":"The unique identifier of the organization","schema":{"type":"string","minLength":5,"maxLength":5},"required":true,"in":"path"},{"$ref":"#/components/parameters/representation"},{"name":"seasonId","description":"The unique identifier of the season. Can specify multiple, delimited by comma.","schema":{"type":"string"},"required":false,"in":"query"},{"$ref":"#/components/parameters/seasonType"},{"name":"sortBy","description":"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.","schema":{"type":"string","pattern":"^(\\-?nameLocal|\\-?nameLatin|\\-?year|,)*$"},"required":false,"in":"query"},{"$ref":"#/components/parameters/standard"},{"$ref":"#/components/parameters/startDate"},{"name":"status","description":"Status\n>- `ACTIVE` Active\n>- `COMPLETE` Complete\n>- `DRAFT` Draft\n>- `INACTIVE` Inactive\n>- `PENDING` Pending\n","schema":{"type":"string","enum":["ACTIVE","COMPLETE","DRAFT","INACTIVE","PENDING"]},"required":false,"in":"query"},{"$ref":"#/components/parameters/updated"},{"$ref":"#/components/parameters/videoProduction"}]}}}}
```

## Create a new season

> Add a new season

```json
{"openapi":"3.0.0","info":{"title":"DataCore API  - Ice Hockey","version":"v1"},"tags":[{"name":"Seasons","description":"Season is a grouping of matches. Generally the season will last a portion of a year (every year).\n\nThe competition can have many seasons, but the season can only belong to one competition.\n\n<img src = \"https://yuml.me/diagram/scruffy;dir:LR/class/[Competitions]-<>[Seasons{bg:orange}],[Seasons]-<>[Matches],[Seasons]->[Stages],[Seasons]->[Pools],[Seasons]->[Rounds],[Matches]-.->[Stages],[Matches]-.->[Pools],[Matches]-.->[Rounds],\">\n\n"}],"servers":[{"url":"https://api.dc.connect.sportradar.com/v1","description":"Production server"},{"url":"https://api.dc.stg.connect-nonprod.sportradar.dev/v1","description":"NonProduction/Staging server"}],"security":[{"OAuth2":["write:organization"]}],"components":{"securitySchemes":{"OAuth2":{"type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"/oauth/token","scopes":{"orgId":"Authenticate based on a specific OrganizationId","read:orggroup":"Read data over multiple organizations using and *orggroup* code","write:organization":"Write/Update any data from below the organization","read:organization":"Read any data from the organization down","write:admin":"Perform administration API calls","write:admin_organization":"Ability to manage organizations","write:system":"Perform system configuration API calls"}}},"description":"You can create a JSON Web Token (JWT) using the [token](http://developer.connect.sportradar.com/token/#operation/getToken) 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."}},"schemas":{"ResponseMetaData":{"type":"object","properties":{"version":{"type":"integer","description":"The version of the API in use for this call"},"codeVersion":{"type":"string","description":"A string indicating the version of the code that handled this request"},"code":{"type":"integer","description":"The HTTP response code for this request"},"time":{"type":"string","format":"date-time","description":"The date/time this request was made (in UTC)."},"fromCache":{"type":"boolean","description":"Was this request served directly from the cache?"},"count":{"type":"integer","description":"The number of records being returned"},"limit":{"type":"integer","description":"The record limit in place for this request"},"offset":{"type":"integer","description":"The record offset in place for this request"},"generationTime":{"type":"number","format":"float","description":"The number of seconds taken to generate this request."}}},"ResponseLinks":{"type":"object","properties":{"self":{"type":"string","format":"uri","description":"The URI referencing this request."},"next":{"type":"string","format":"uri","description":"The URI referencing the 'next' page, if more data is available."},"previous":{"type":"string","format":"uri","description":"The URI referencing the 'previous' page, if the request is not on the first page."}}},"IncludedData":{"type":"object","description":"Available if the request used the 'include' parameter.  It contains extra data about resources found in the data block.","properties":{"resources":{"type":"object","additionalProperties":{"description":"The type of resource","type":"object","enum":["league","organisation","persons"],"additionalProperties":{"type":"object","format":"uuid","description":"The id of the resource","additionalProperties":{"description":"The model for the resource as defined by the type and id"}}}}}},"SeasonsModel":{"type":"object","additionalProperties":false,"properties":{"seasonId":{"description":"The unique identifier of the season","type":"string","format":"uuid"},"organizationId":{"description":"The unique identifier of the organization","type":"string","readOnly":true},"organization":{"properties":{"resourceType":{"type":"string","enum":["organizations"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The organization that this season belongs to","type":"object"},"competitionId":{"description":"The unique identifier of the competition","type":"string","format":"uuid"},"competition":{"properties":{"resourceType":{"type":"string","enum":["competitions"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The competition that this season belongs to","type":"object"},"leaderCriteriaId":{"description":"The unique identifier of the ~LeaderCriteria~","type":"string","format":"uuid","nullable":true},"leadersCriteria":{"properties":{"resourceType":{"type":"string","enum":["leaderCriteria"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The ~LeaderCriteria~ linked to this record","type":"object"},"internationalReference":{"description":"The international reference for this season given by the sport governing body","type":"string","maxLength":30,"nullable":true},"eventType":{"description":"Primary Type of Matches\n>- `FIXTURE` Fixture\n>- `PRACTICE` Practice\n","type":"string","enum":["FIXTURE","PRACTICE"],"maxLength":30,"default":"FIXTURE"},"seasonType":{"description":"The type of matches added to this season\n>- `MULTI_YEAR_HISTORICAL` Mulit-Year Historical\n>- `ONE_OFF` One off\n>- `PRESEASON` Pre Season\n>- `SEASON` Season\n>- `TOURNAMENT` Tournament\n","type":"string","enum":["SEASON","TOURNAMENT","ONE_OFF","PRESEASON","MULTI_YEAR_HISTORICAL"],"maxLength":30},"year":{"description":"Year of the season","type":"integer","format":"int32","maxLength":4},"grade":{"description":"The playing grade of the matches in this season","type":"string","maxLength":50,"nullable":true},"status":{"description":"Status\n>- `ACTIVE` Active\n>- `COMPLETE` Complete\n>- `DRAFT` Draft\n>- `INACTIVE` Inactive\n>- `PENDING` Pending\n","type":"string","enum":["ACTIVE","COMPLETE","DRAFT","INACTIVE","PENDING"],"maxLength":30},"includeInStatistics":{"description":"Include this season in calculated statistics?","type":"boolean","default":true},"liveVideoAvailable":{"description":"If no 'liveVideoAvailable' flag passed to a new match this value is used","type":"boolean"},"liveDataAvailable":{"description":"If no 'liveDataAvailable' flag passed to a new match this value is used","type":"boolean"},"durationFull":{"description":"If no 'durationFull' is passed to a new match this value is used","type":"integer","format":"int32","default":180,"nullable":true},"discipline":{"description":"If no 'discipline' is passed to a new match this value is used\n>- None None\n>- `INDOOR` Indoor\n>- `OUTDOOR` Outdoor\n","type":"string","enum":["INDOOR","OUTDOOR",null],"nullable":true},"nameLocal":{"description":"The name of the season in the [local](#section/Introduction/Character-Sets-and-Names) language","type":"string","maxLength":150},"nameLatin":{"description":"The name of the season in [latin](#section/Introduction/Character-Sets-and-Names) characters","type":"string","maxLength":150,"nullable":true},"nameShortLocal":{"description":"The abbreviated name of the season in the [local](#section/Introduction/Character-Sets-and-Names) language","type":"string","maxLength":50,"nullable":true},"nameShortLatin":{"description":"The abbreviated name of the season in [latin](#section/Introduction/Character-Sets-and-Names) characters","type":"string","maxLength":50,"nullable":true},"startDate":{"description":"Season start date","type":"string","format":"date"},"endDate":{"description":"Season end date","type":"string","format":"date","nullable":true},"gender":{"description":"The gender of the participants in the season\n>- `FEMALE` Female\n>- `MALE` Male\n>- `MIXED` Mixed\n>- `UNKNOWN` Unknown\n","type":"string","enum":["FEMALE","MALE","MIXED","UNKNOWN"],"maxLength":20},"ageGroup":{"description":"The age group of the season\n>- `JUNIOR` Junior\n>- `MASTERS` Masters\n>- `SENIOR` Senior\n>- `UNDER_15` Under 15\n>- `UNDER_16` Under 16\n>- `UNDER_17` Under 17\n>- `UNDER_18` Under 18\n>- `UNDER_19` Under 19\n>- `UNDER_20` Under 20\n>- `UNDER_21` Under 21\n>- `UNDER_22` Under 22\n>- `UNDER_23` Under 23\n>- `YOUTH` Youth\n","type":"string","enum":["JUNIOR","YOUTH","UNDER_15","UNDER_16","UNDER_17","UNDER_18","UNDER_19","UNDER_20","UNDER_21","UNDER_22","UNDER_23","SENIOR","MASTERS"],"maxLength":50},"standard":{"description":"The playing standard of the season\n>- `ELITE` Professional/elite organisation\n>- `FRIENDLY` International Friendly\n>- `GRASS_ROOT` Normal\n>- `HISTORICAL_BASELINE` Historical Baseline\n>- `INTERNATIONAL` International\n>- `NONCONTINENTAL_CHAMPIONSHIP` Non-continental Championship\n>- `OLYMPIC` Olympics\n>- `REGION` Regional\n>- `TIER2` lesser standard than elite\n>- `TIER3` lesser standard than tier 2\n>- `WORLD_CHAMPIONSHIP` World Championship\n>- `ZONE_CHAMPIONSHIP` International Zone Championship\n","type":"string","enum":["ELITE","FRIENDLY","GRASS_ROOT","INTERNATIONAL","NONCONTINENTAL_CHAMPIONSHIP","OLYMPIC","REGION","TIER2","TIER3","WORLD_CHAMPIONSHIP","ZONE_CHAMPIONSHIP","HISTORICAL_BASELINE"],"maxLength":50},"representation":{"description":"What level are the competitors representing\n>- `CLUB` Club\n>- `COUNTRY` Country\n>- `PERSON` Person\n>- `REGION` Region\n>- `STATE` State\n","type":"string","enum":["CLUB","STATE","REGION","COUNTRY","PERSON"],"maxLength":50},"standingConfigurationId":{"description":"The unique identifier of the ~standingConfiguration~","type":"string","format":"uuid","nullable":true},"standingConfiguration":{"properties":{"resourceType":{"type":"string","enum":["standingConfigurations"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The ~standingConfiguration~ that this season belongs to","type":"object"},"lockStandings":{"description":"Is the standings generation locked ?","type":"boolean"},"externalId":{"description":"The Id of the data as set by the provider of the data","type":"string","maxLength":150,"pattern":"^[0-9A-Za-z/_-]+$","nullable":true},"social":{"title":"Social Media","description":"Social Media contacts","type":"object","nullable":true,"additionalProperties":false,"properties":{"website":{"type":"string","nullable":true,"format":"uri"},"facebook":{"type":"string","nullable":true,"format":"uri"},"twitter":{"type":"string","nullable":true,"format":"uri"},"wikipedia":{"type":"string","nullable":true,"format":"uri"},"instagram":{"type":"string","nullable":true,"format":"uri"}}},"configuration":{"title":"Season Configuration","description":"Season Configuration settings","type":"object","nullable":true,"additionalProperties":false,"properties":{"periodBreakDuration":{"type":"number"},"halfTimeDuration":{"type":"number"},"shotClockLength":{"type":"number"},"foulsUntilBonus":{"type":"number"},"foulsAllowedPersonal":{"type":"number"},"foulsAllowedTechnical":{"type":"number"}}},"profileId":{"description":"The profile that this season belongs to","type":"string","format":"uuid","nullable":true},"fixtureProfile":{"properties":{"resourceType":{"type":"string","enum":["fixtureProfiles"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The profile that this season belongs to","type":"object"},"updated":{"description":"Date/time last modified. In UTC","type":"string","format":"date-time","readOnly":true},"added":{"description":"Date/time added. In UTC","type":"string","format":"date-time","readOnly":true},"images":{"type":"array","items":{"$ref":"#/components/schemas/ImagesModel"}},"videoProduction":{"description":"Data synchronization strategy with video production systems\n>- `AUTOMATED` Automated\n>- `MANUAL` Manual\n>- `NONE` None\n","type":"string","enum":["NONE","AUTOMATED","MANUAL"],"maxLength":50,"default":"NONE"},"promotionRelegationRules":{"type":"array","nullable":true,"items":{"type":"object","additionalProperties":false,"required":["ruleType","position","value"],"properties":{"ruleType":{"description":"Rule Type","type":"string","enum":["PROMOTION","RELEGATION"]},"position":{"description":"Standings Position","type":"number"},"value":{"description":"Value to apply to Promotion or Relegation","type":"string"}}}},"rosterConfiguration":{"title":"SEASON ROSTER configuration","description":"Configuration for the SEASON ROSTER","type":"object","nullable":true,"additionalProperties":false,"properties":{"windowOpenDate":{"description":"What date can a SEASON ROSTER be submitted from for this SEASON?","type":"string","nullable":true,"format":"date"},"windowCloseDate":{"description":"What is the last date a SEASON ROSTER can be submitted from for this SEASON?","type":"string","nullable":true,"format":"date"},"seasonRosterLock":{"description":"Make SEASON ROSTERS un-editable when SEASON ROSTER Registration Window Close Date has elapsed.","type":"boolean","nullable":true},"fixtureRosterLock":{"description":"Make FIXTURE ROSTERS un-editable when MATCH Status is set to Scheduled","type":"boolean","nullable":true},"fixtureBibEdit":{"description":"Allow Add/Edit of FIXTURE ROSTERS bib","type":"boolean","nullable":true},"seasonRosterStatusAllowed":{"description":"Season Roster status allowed","type":"array","items":{"type":"string","enum":["ACTIVE","INJURED","OTHER_NOT_PARTICIPATING","OUT","SUSPENDED"]}},"publishSeasonRosterRolesInHours":{"description":"How long before SEASON starts can rosters or roles be published (in hours)","type":"number","nullable":true},"publishFixtureRosterRolesInMinutes":{"description":"How long before a MATCH starts can rosters or roles be published (in minutes)","type":"number","nullable":true}}}},"title":"season model"},"ImagesModel":{"type":"object","additionalProperties":false,"properties":{"imageId":{"description":"The unique identifier of the image record","type":"string","format":"uuid","readOnly":true},"organizationId":{"description":"The unique identifier of the organization","type":"string","readOnly":true},"organization":{"properties":{"resourceType":{"type":"string","enum":["organizations"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The organization that this images belongs to","type":"object"},"baseType":{"description":"The object that this image relates to\n>- `COMPETITION` Competition\n>- `CONFERENCE` Conference\n>- `DIVISION` Division\n>- `ENTITY` Entity\n>- `ENTITYGROUP` Entity Group\n>- `LEAGUE` League\n>- `ORGANIZATION` Organization\n>- `PERSON` Person\n>- `SEASON` Season\n>- `UNIFORM` Uniform\n>- `UNIFORM_ITEM` Uniform Item\n","type":"string","enum":["PERSON","ENTITY","ENTITYGROUP","COMPETITION","SEASON","LEAGUE","ORGANIZATION","DIVISION","CONFERENCE","UNIFORM","UNIFORM_ITEM"],"maxLength":100},"baseId":{"description":"The unique identifier of the object associated with this image's record. If the `baseType` is `PERSON` then this would be the value of `personId`.","type":"string","format":"uuid"},"fileType":{"description":"The type of file\n>- `JPG` jpg\n>- `PNG` png\n>- `SVG` svg\n","type":"string","enum":["JPG","PNG","SVG"],"maxLength":3,"readOnly":true},"imageType":{"description":"Upload Type\n>- `LOGO` Logo - Not valid for 'PERSON' baseType\n>- `LOGO_ALTERNATE` Logo (alternate) - Not valid for 'PERSON' baseType\n>- `LOGO_BACKGROUND` Stylised logo for background purposes - Not valid for 'PERSON' baseType\n>- `PERSON_HEAD` Head shot (shoulders and head) - Only valid for 'PERSON' baseType\n>- `PERSON_POSE` Person posing - Only valid for 'PERSON' baseType\n>- `PERSON_WAIST` Head shot from the waist up - Only valid for 'PERSON' baseType\n>- `TEAM_PHOTO` Team Photo - Only valid for 'ENTITY' baseType\n>- `UNIFORM` Uniform\n>- `UNIFORM_ITEM` Uniform Item\n","type":"string","enum":["LOGO","LOGO_ALTERNATE","LOGO_BACKGROUND","PERSON_HEAD","PERSON_WAIST","PERSON_POSE","TEAM_PHOTO","UNIFORM","UNIFORM_ITEM"],"maxLength":100},"secondaryType":{"description":"If the image relates to a secondary object. Such as a photo of a person in a team, then baseType would be PERSON and secondaryType would be TEAM.\n>- None None\n>- `COMPETITION` Competition\n>- `CONFERENCE` Conference\n>- `DIVISION` Division\n>- `ENTITY` Entity\n>- `ENTITYGROUP` Entity Group\n>- `LEAGUE` League\n>- `SEASON` Season\n","type":"string","enum":["ENTITY","ENTITYGROUP","COMPETITION","SEASON","LEAGUE","DIVISION","CONFERENCE",null],"maxLength":100,"nullable":true},"secondaryId":{"description":"The unique identifier of the object associated with the secondaryType","type":"string","format":"uuid"},"rating":{"description":"The rating given to the quality of the image.  All images are LOW by default but are set ad MEDIUM if they are large enough and have transparency.  Images are only marked as HIGH if they have been manually reviewed.  You should take your use-case into account when you go to use the image.\n>- `HIGH` High\n>- `LOW` Low\n>- `MEDIUM` Medium\n","type":"string","enum":["LOW","MEDIUM","HIGH"],"maxLength":100,"readOnly":true},"url":{"description":"The URL of the image. See [Images](#section/Introduction/Images) for more information.","type":"string","readOnly":true},"maximumHeight":{"description":"The maximum height (in pixels) of this image.","type":"integer","format":"int32","readOnly":true},"maximumWidth":{"description":"The maximum width (in pixels) of this image.","type":"integer","format":"int32","readOnly":true},"updated":{"description":"Date/time last modified. In UTC","type":"string","format":"date-time","readOnly":true},"added":{"description":"Date/time added. In UTC","type":"string","format":"date-time","readOnly":true}},"title":"images model"},"ErrorModel":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP Error code indicating the type of error.  If there are multiple errors, then this will be the code of the first one.","format":"int32"},"message":{"type":"string","description":"A message indicating the reason for the error. If there are multiple errors, then this is the message for the first one."},"errors":{"type":"array","items":{"$ref":"#/components/schemas/ErrorListModel"}}}},"ErrorListModel":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP Error code indicating the type of error.","format":"int32"},"reason":{"enum":["INVALID_DATA","NOT_FOUND","NOT_AUTHORISED","ERROR","DELETE_ERROR"],"description":"A short code indicating the type of error"},"message":{"type":"string","description":"A message indicating the reason for the error"},"rowNumber":{"type":"integer","description":"The row number of the payload that cause the error","format":"int32"}}}},"responses":{"ErrorResponse":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"meta":{"$ref":"#/components/schemas/ResponseMetaData"},"error":{"$ref":"#/components/schemas/ErrorModel"}}}}}}},"parameters":{"external":{"name":"external","description":"A comma separated list of fields that will instead be interpreted as an externalId. See [External Ids](#section/Introduction/External-Ids) for more information.","schema":{"type":"string"},"required":false,"in":"query"},"fields":{"name":"fields","description":"A comma separated list of fields to display.  The response will only display these fields. See [Partial Response](#section/Partial-Response) section for more information.","schema":{"type":"string"},"required":false,"in":"query"},"hideNull":{"name":"hideNull","description":"Don't display data fields with null values or empty structures","schema":{"type":"boolean"},"required":false,"in":"query"},"include":{"name":"include","description":"A comma separated list of resource types to include. See [Resource Inclusion](#section/Introduction/Resource-Inclusion) for more information.","schema":{"type":"string"},"required":false,"in":"query"}}},"paths":{"/icehockey/o/{organizationId}/competitions/{competitionId}/seasons":{"post":{"tags":["Seasons"],"summary":"Create a new season","description":"Add a new season","operationId":"season_insert","responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","title":"Seasons Response","properties":{"meta":{"$ref":"#/components/schemas/ResponseMetaData"},"links":{"$ref":"#/components/schemas/ResponseLinks"},"included":{"$ref":"#/components/schemas/IncludedData"},"data":{"type":"array","description":"","items":{"$ref":"#/components/schemas/SeasonsModel"}}}}}}},"default":{"$ref":"#/components/responses/ErrorResponse"}},"parameters":[{"name":"competitionId","description":"The unique identifier of the competition","schema":{"type":"string","format":"uuid"},"required":true,"in":"path"},{"$ref":"#/components/parameters/external"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/hideNull"},{"$ref":"#/components/parameters/include"},{"name":"organizationId","description":"The unique identifier of the organization","schema":{"type":"string","minLength":5,"maxLength":5},"required":true,"in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"seasonId":{"description":"The unique identifier of the season","type":"string","format":"uuid"},"competitionId":{"description":"The unique identifier of the competition","type":"string","format":"uuid"},"leaderCriteriaId":{"description":"The unique identifier of the ~LeaderCriteria~","type":"string","format":"uuid","nullable":true},"internationalReference":{"description":"The international reference for this season given by the sport governing body","type":"string","maxLength":30,"nullable":true},"eventType":{"description":"Primary Type of Matches\n>- `FIXTURE` Fixture\n>- `PRACTICE` Practice\n","type":"string","enum":["FIXTURE","PRACTICE"],"maxLength":30,"default":"FIXTURE"},"seasonType":{"description":"The type of matches added to this season\n>- `MULTI_YEAR_HISTORICAL` Mulit-Year Historical\n>- `ONE_OFF` One off\n>- `PRESEASON` Pre Season\n>- `SEASON` Season\n>- `TOURNAMENT` Tournament\n","type":"string","enum":["SEASON","TOURNAMENT","ONE_OFF","PRESEASON","MULTI_YEAR_HISTORICAL"],"maxLength":30},"year":{"description":"Year of the season","type":"integer","format":"int32","maxLength":4},"grade":{"description":"The playing grade of the matches in this season","type":"string","maxLength":50,"nullable":true},"status":{"description":"Status\n>- `ACTIVE` Active\n>- `COMPLETE` Complete\n>- `DRAFT` Draft\n>- `INACTIVE` Inactive\n>- `PENDING` Pending\n","type":"string","enum":["ACTIVE","COMPLETE","DRAFT","INACTIVE","PENDING"],"maxLength":30},"includeInStatistics":{"description":"Include this season in calculated statistics?","type":"boolean","default":true},"liveVideoAvailable":{"description":"If no 'liveVideoAvailable' flag passed to a new match this value is used","type":"boolean"},"liveDataAvailable":{"description":"If no 'liveDataAvailable' flag passed to a new match this value is used","type":"boolean"},"durationFull":{"description":"If no 'durationFull' is passed to a new match this value is used","type":"integer","format":"int32","default":180,"nullable":true},"discipline":{"description":"If no 'discipline' is passed to a new match this value is used\n>- None None\n>- `INDOOR` Indoor\n>- `OUTDOOR` Outdoor\n","type":"string","enum":["INDOOR","OUTDOOR",null],"nullable":true},"nameLocal":{"description":"The name of the season in the [local](#section/Introduction/Character-Sets-and-Names) language","type":"string","maxLength":150},"nameLatin":{"description":"The name of the season in [latin](#section/Introduction/Character-Sets-and-Names) characters","type":"string","maxLength":150,"nullable":true},"nameShortLocal":{"description":"The abbreviated name of the season in the [local](#section/Introduction/Character-Sets-and-Names) language","type":"string","maxLength":50,"nullable":true},"nameShortLatin":{"description":"The abbreviated name of the season in [latin](#section/Introduction/Character-Sets-and-Names) characters","type":"string","maxLength":50,"nullable":true},"startDate":{"description":"Season start date","type":"string","format":"date"},"endDate":{"description":"Season end date","type":"string","format":"date","nullable":true},"gender":{"description":"The gender of the participants in the season\n>- `FEMALE` Female\n>- `MALE` Male\n>- `MIXED` Mixed\n>- `UNKNOWN` Unknown\n","type":"string","enum":["FEMALE","MALE","MIXED","UNKNOWN"],"maxLength":20},"ageGroup":{"description":"The age group of the season\n>- `JUNIOR` Junior\n>- `MASTERS` Masters\n>- `SENIOR` Senior\n>- `UNDER_15` Under 15\n>- `UNDER_16` Under 16\n>- `UNDER_17` Under 17\n>- `UNDER_18` Under 18\n>- `UNDER_19` Under 19\n>- `UNDER_20` Under 20\n>- `UNDER_21` Under 21\n>- `UNDER_22` Under 22\n>- `UNDER_23` Under 23\n>- `YOUTH` Youth\n","type":"string","enum":["JUNIOR","YOUTH","UNDER_15","UNDER_16","UNDER_17","UNDER_18","UNDER_19","UNDER_20","UNDER_21","UNDER_22","UNDER_23","SENIOR","MASTERS"],"maxLength":50},"standard":{"description":"The playing standard of the season\n>- `ELITE` Professional/elite organisation\n>- `FRIENDLY` International Friendly\n>- `GRASS_ROOT` Normal\n>- `HISTORICAL_BASELINE` Historical Baseline\n>- `INTERNATIONAL` International\n>- `NONCONTINENTAL_CHAMPIONSHIP` Non-continental Championship\n>- `OLYMPIC` Olympics\n>- `REGION` Regional\n>- `TIER2` lesser standard than elite\n>- `TIER3` lesser standard than tier 2\n>- `WORLD_CHAMPIONSHIP` World Championship\n>- `ZONE_CHAMPIONSHIP` International Zone Championship\n","type":"string","enum":["ELITE","FRIENDLY","GRASS_ROOT","INTERNATIONAL","NONCONTINENTAL_CHAMPIONSHIP","OLYMPIC","REGION","TIER2","TIER3","WORLD_CHAMPIONSHIP","ZONE_CHAMPIONSHIP","HISTORICAL_BASELINE"],"maxLength":50},"representation":{"description":"What level are the competitors representing\n>- `CLUB` Club\n>- `COUNTRY` Country\n>- `PERSON` Person\n>- `REGION` Region\n>- `STATE` State\n","type":"string","enum":["CLUB","STATE","REGION","COUNTRY","PERSON"],"maxLength":50},"standingConfigurationId":{"description":"The unique identifier of the ~standingConfiguration~","type":"string","format":"uuid","nullable":true},"lockStandings":{"description":"Is the standings generation locked ?","type":"boolean"},"externalId":{"description":"The Id of the data as set by the provider of the data","type":"string","maxLength":150,"pattern":"^[0-9A-Za-z/_-]+$","nullable":true},"social":{"title":"Social Media","description":"Social Media contacts","type":"object","nullable":true,"additionalProperties":false,"properties":{"website":{"type":"string","nullable":true,"format":"uri"},"facebook":{"type":"string","nullable":true,"format":"uri"},"twitter":{"type":"string","nullable":true,"format":"uri"},"wikipedia":{"type":"string","nullable":true,"format":"uri"},"instagram":{"type":"string","nullable":true,"format":"uri"}}},"configuration":{"title":"Season Configuration","description":"Season Configuration settings","type":"object","nullable":true,"additionalProperties":false,"properties":{"periodBreakDuration":{"type":"number"},"halfTimeDuration":{"type":"number"},"shotClockLength":{"type":"number"},"foulsUntilBonus":{"type":"number"},"foulsAllowedPersonal":{"type":"number"},"foulsAllowedTechnical":{"type":"number"}}},"profileId":{"description":"The profile that this season belongs to","type":"string","format":"uuid","nullable":true},"videoProduction":{"description":"Data synchronization strategy with video production systems\n>- `AUTOMATED` Automated\n>- `MANUAL` Manual\n>- `NONE` None\n","type":"string","enum":["NONE","AUTOMATED","MANUAL"],"maxLength":50,"default":"NONE"},"promotionRelegationRules":{"type":"array","nullable":true,"items":{"type":"object","additionalProperties":false,"required":["ruleType","position","value"],"properties":{"ruleType":{"description":"Rule Type","type":"string","enum":["PROMOTION","RELEGATION"]},"position":{"description":"Standings Position","type":"number"},"value":{"description":"Value to apply to Promotion or Relegation","type":"string"}}}},"rosterConfiguration":{"title":"SEASON ROSTER configuration","description":"Configuration for the SEASON ROSTER","type":"object","nullable":true,"additionalProperties":false,"properties":{"windowOpenDate":{"description":"What date can a SEASON ROSTER be submitted from for this SEASON?","type":"string","nullable":true,"format":"date"},"windowCloseDate":{"description":"What is the last date a SEASON ROSTER can be submitted from for this SEASON?","type":"string","nullable":true,"format":"date"},"seasonRosterLock":{"description":"Make SEASON ROSTERS un-editable when SEASON ROSTER Registration Window Close Date has elapsed.","type":"boolean","nullable":true},"fixtureRosterLock":{"description":"Make FIXTURE ROSTERS un-editable when MATCH Status is set to Scheduled","type":"boolean","nullable":true},"fixtureBibEdit":{"description":"Allow Add/Edit of FIXTURE ROSTERS bib","type":"boolean","nullable":true},"seasonRosterStatusAllowed":{"description":"Season Roster status allowed","type":"array","items":{"type":"string","enum":["ACTIVE","INJURED","OTHER_NOT_PARTICIPATING","OUT","SUSPENDED"]}},"publishSeasonRosterRolesInHours":{"description":"How long before SEASON starts can rosters or roles be published (in hours)","type":"number","nullable":true},"publishFixtureRosterRolesInMinutes":{"description":"How long before a MATCH starts can rosters or roles be published (in minutes)","type":"number","nullable":true}}}},"title":"season post body","required":["competitionId","seasonType","nameLocal","startDate","gender","ageGroup","standard","representation"]}}}}}}}}
```

## Get a list of seasons for an organization

> Return a list of seasons in an organization.

```json
{"openapi":"3.0.0","info":{"title":"DataCore API  - Ice Hockey","version":"v1"},"tags":[{"name":"Seasons","description":"Season is a grouping of matches. Generally the season will last a portion of a year (every year).\n\nThe competition can have many seasons, but the season can only belong to one competition.\n\n<img src = \"https://yuml.me/diagram/scruffy;dir:LR/class/[Competitions]-<>[Seasons{bg:orange}],[Seasons]-<>[Matches],[Seasons]->[Stages],[Seasons]->[Pools],[Seasons]->[Rounds],[Matches]-.->[Stages],[Matches]-.->[Pools],[Matches]-.->[Rounds],\">\n\n"}],"servers":[{"url":"https://api.dc.connect.sportradar.com/v1","description":"Production server"},{"url":"https://api.dc.stg.connect-nonprod.sportradar.dev/v1","description":"NonProduction/Staging server"}],"security":[{"OAuth2":["read:organization"]}],"components":{"securitySchemes":{"OAuth2":{"type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"/oauth/token","scopes":{"orgId":"Authenticate based on a specific OrganizationId","read:orggroup":"Read data over multiple organizations using and *orggroup* code","write:organization":"Write/Update any data from below the organization","read:organization":"Read any data from the organization down","write:admin":"Perform administration API calls","write:admin_organization":"Ability to manage organizations","write:system":"Perform system configuration API calls"}}},"description":"You can create a JSON Web Token (JWT) using the [token](http://developer.connect.sportradar.com/token/#operation/getToken) 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."}},"schemas":{"ResponseMetaData":{"type":"object","properties":{"version":{"type":"integer","description":"The version of the API in use for this call"},"codeVersion":{"type":"string","description":"A string indicating the version of the code that handled this request"},"code":{"type":"integer","description":"The HTTP response code for this request"},"time":{"type":"string","format":"date-time","description":"The date/time this request was made (in UTC)."},"fromCache":{"type":"boolean","description":"Was this request served directly from the cache?"},"count":{"type":"integer","description":"The number of records being returned"},"limit":{"type":"integer","description":"The record limit in place for this request"},"offset":{"type":"integer","description":"The record offset in place for this request"},"generationTime":{"type":"number","format":"float","description":"The number of seconds taken to generate this request."}}},"ResponseLinks":{"type":"object","properties":{"self":{"type":"string","format":"uri","description":"The URI referencing this request."},"next":{"type":"string","format":"uri","description":"The URI referencing the 'next' page, if more data is available."},"previous":{"type":"string","format":"uri","description":"The URI referencing the 'previous' page, if the request is not on the first page."}}},"IncludedData":{"type":"object","description":"Available if the request used the 'include' parameter.  It contains extra data about resources found in the data block.","properties":{"resources":{"type":"object","additionalProperties":{"description":"The type of resource","type":"object","enum":["league","organisation","persons"],"additionalProperties":{"type":"object","format":"uuid","description":"The id of the resource","additionalProperties":{"description":"The model for the resource as defined by the type and id"}}}}}},"SeasonsModel":{"type":"object","additionalProperties":false,"properties":{"seasonId":{"description":"The unique identifier of the season","type":"string","format":"uuid"},"organizationId":{"description":"The unique identifier of the organization","type":"string","readOnly":true},"organization":{"properties":{"resourceType":{"type":"string","enum":["organizations"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The organization that this season belongs to","type":"object"},"competitionId":{"description":"The unique identifier of the competition","type":"string","format":"uuid"},"competition":{"properties":{"resourceType":{"type":"string","enum":["competitions"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The competition that this season belongs to","type":"object"},"leaderCriteriaId":{"description":"The unique identifier of the ~LeaderCriteria~","type":"string","format":"uuid","nullable":true},"leadersCriteria":{"properties":{"resourceType":{"type":"string","enum":["leaderCriteria"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The ~LeaderCriteria~ linked to this record","type":"object"},"internationalReference":{"description":"The international reference for this season given by the sport governing body","type":"string","maxLength":30,"nullable":true},"eventType":{"description":"Primary Type of Matches\n>- `FIXTURE` Fixture\n>- `PRACTICE` Practice\n","type":"string","enum":["FIXTURE","PRACTICE"],"maxLength":30,"default":"FIXTURE"},"seasonType":{"description":"The type of matches added to this season\n>- `MULTI_YEAR_HISTORICAL` Mulit-Year Historical\n>- `ONE_OFF` One off\n>- `PRESEASON` Pre Season\n>- `SEASON` Season\n>- `TOURNAMENT` Tournament\n","type":"string","enum":["SEASON","TOURNAMENT","ONE_OFF","PRESEASON","MULTI_YEAR_HISTORICAL"],"maxLength":30},"year":{"description":"Year of the season","type":"integer","format":"int32","maxLength":4},"grade":{"description":"The playing grade of the matches in this season","type":"string","maxLength":50,"nullable":true},"status":{"description":"Status\n>- `ACTIVE` Active\n>- `COMPLETE` Complete\n>- `DRAFT` Draft\n>- `INACTIVE` Inactive\n>- `PENDING` Pending\n","type":"string","enum":["ACTIVE","COMPLETE","DRAFT","INACTIVE","PENDING"],"maxLength":30},"includeInStatistics":{"description":"Include this season in calculated statistics?","type":"boolean","default":true},"liveVideoAvailable":{"description":"If no 'liveVideoAvailable' flag passed to a new match this value is used","type":"boolean"},"liveDataAvailable":{"description":"If no 'liveDataAvailable' flag passed to a new match this value is used","type":"boolean"},"durationFull":{"description":"If no 'durationFull' is passed to a new match this value is used","type":"integer","format":"int32","default":180,"nullable":true},"discipline":{"description":"If no 'discipline' is passed to a new match this value is used\n>- None None\n>- `INDOOR` Indoor\n>- `OUTDOOR` Outdoor\n","type":"string","enum":["INDOOR","OUTDOOR",null],"nullable":true},"nameLocal":{"description":"The name of the season in the [local](#section/Introduction/Character-Sets-and-Names) language","type":"string","maxLength":150},"nameLatin":{"description":"The name of the season in [latin](#section/Introduction/Character-Sets-and-Names) characters","type":"string","maxLength":150,"nullable":true},"nameShortLocal":{"description":"The abbreviated name of the season in the [local](#section/Introduction/Character-Sets-and-Names) language","type":"string","maxLength":50,"nullable":true},"nameShortLatin":{"description":"The abbreviated name of the season in [latin](#section/Introduction/Character-Sets-and-Names) characters","type":"string","maxLength":50,"nullable":true},"startDate":{"description":"Season start date","type":"string","format":"date"},"endDate":{"description":"Season end date","type":"string","format":"date","nullable":true},"gender":{"description":"The gender of the participants in the season\n>- `FEMALE` Female\n>- `MALE` Male\n>- `MIXED` Mixed\n>- `UNKNOWN` Unknown\n","type":"string","enum":["FEMALE","MALE","MIXED","UNKNOWN"],"maxLength":20},"ageGroup":{"description":"The age group of the season\n>- `JUNIOR` Junior\n>- `MASTERS` Masters\n>- `SENIOR` Senior\n>- `UNDER_15` Under 15\n>- `UNDER_16` Under 16\n>- `UNDER_17` Under 17\n>- `UNDER_18` Under 18\n>- `UNDER_19` Under 19\n>- `UNDER_20` Under 20\n>- `UNDER_21` Under 21\n>- `UNDER_22` Under 22\n>- `UNDER_23` Under 23\n>- `YOUTH` Youth\n","type":"string","enum":["JUNIOR","YOUTH","UNDER_15","UNDER_16","UNDER_17","UNDER_18","UNDER_19","UNDER_20","UNDER_21","UNDER_22","UNDER_23","SENIOR","MASTERS"],"maxLength":50},"standard":{"description":"The playing standard of the season\n>- `ELITE` Professional/elite organisation\n>- `FRIENDLY` International Friendly\n>- `GRASS_ROOT` Normal\n>- `HISTORICAL_BASELINE` Historical Baseline\n>- `INTERNATIONAL` International\n>- `NONCONTINENTAL_CHAMPIONSHIP` Non-continental Championship\n>- `OLYMPIC` Olympics\n>- `REGION` Regional\n>- `TIER2` lesser standard than elite\n>- `TIER3` lesser standard than tier 2\n>- `WORLD_CHAMPIONSHIP` World Championship\n>- `ZONE_CHAMPIONSHIP` International Zone Championship\n","type":"string","enum":["ELITE","FRIENDLY","GRASS_ROOT","INTERNATIONAL","NONCONTINENTAL_CHAMPIONSHIP","OLYMPIC","REGION","TIER2","TIER3","WORLD_CHAMPIONSHIP","ZONE_CHAMPIONSHIP","HISTORICAL_BASELINE"],"maxLength":50},"representation":{"description":"What level are the competitors representing\n>- `CLUB` Club\n>- `COUNTRY` Country\n>- `PERSON` Person\n>- `REGION` Region\n>- `STATE` State\n","type":"string","enum":["CLUB","STATE","REGION","COUNTRY","PERSON"],"maxLength":50},"standingConfigurationId":{"description":"The unique identifier of the ~standingConfiguration~","type":"string","format":"uuid","nullable":true},"standingConfiguration":{"properties":{"resourceType":{"type":"string","enum":["standingConfigurations"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The ~standingConfiguration~ that this season belongs to","type":"object"},"lockStandings":{"description":"Is the standings generation locked ?","type":"boolean"},"externalId":{"description":"The Id of the data as set by the provider of the data","type":"string","maxLength":150,"pattern":"^[0-9A-Za-z/_-]+$","nullable":true},"social":{"title":"Social Media","description":"Social Media contacts","type":"object","nullable":true,"additionalProperties":false,"properties":{"website":{"type":"string","nullable":true,"format":"uri"},"facebook":{"type":"string","nullable":true,"format":"uri"},"twitter":{"type":"string","nullable":true,"format":"uri"},"wikipedia":{"type":"string","nullable":true,"format":"uri"},"instagram":{"type":"string","nullable":true,"format":"uri"}}},"configuration":{"title":"Season Configuration","description":"Season Configuration settings","type":"object","nullable":true,"additionalProperties":false,"properties":{"periodBreakDuration":{"type":"number"},"halfTimeDuration":{"type":"number"},"shotClockLength":{"type":"number"},"foulsUntilBonus":{"type":"number"},"foulsAllowedPersonal":{"type":"number"},"foulsAllowedTechnical":{"type":"number"}}},"profileId":{"description":"The profile that this season belongs to","type":"string","format":"uuid","nullable":true},"fixtureProfile":{"properties":{"resourceType":{"type":"string","enum":["fixtureProfiles"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The profile that this season belongs to","type":"object"},"updated":{"description":"Date/time last modified. In UTC","type":"string","format":"date-time","readOnly":true},"added":{"description":"Date/time added. In UTC","type":"string","format":"date-time","readOnly":true},"images":{"type":"array","items":{"$ref":"#/components/schemas/ImagesModel"}},"videoProduction":{"description":"Data synchronization strategy with video production systems\n>- `AUTOMATED` Automated\n>- `MANUAL` Manual\n>- `NONE` None\n","type":"string","enum":["NONE","AUTOMATED","MANUAL"],"maxLength":50,"default":"NONE"},"promotionRelegationRules":{"type":"array","nullable":true,"items":{"type":"object","additionalProperties":false,"required":["ruleType","position","value"],"properties":{"ruleType":{"description":"Rule Type","type":"string","enum":["PROMOTION","RELEGATION"]},"position":{"description":"Standings Position","type":"number"},"value":{"description":"Value to apply to Promotion or Relegation","type":"string"}}}},"rosterConfiguration":{"title":"SEASON ROSTER configuration","description":"Configuration for the SEASON ROSTER","type":"object","nullable":true,"additionalProperties":false,"properties":{"windowOpenDate":{"description":"What date can a SEASON ROSTER be submitted from for this SEASON?","type":"string","nullable":true,"format":"date"},"windowCloseDate":{"description":"What is the last date a SEASON ROSTER can be submitted from for this SEASON?","type":"string","nullable":true,"format":"date"},"seasonRosterLock":{"description":"Make SEASON ROSTERS un-editable when SEASON ROSTER Registration Window Close Date has elapsed.","type":"boolean","nullable":true},"fixtureRosterLock":{"description":"Make FIXTURE ROSTERS un-editable when MATCH Status is set to Scheduled","type":"boolean","nullable":true},"fixtureBibEdit":{"description":"Allow Add/Edit of FIXTURE ROSTERS bib","type":"boolean","nullable":true},"seasonRosterStatusAllowed":{"description":"Season Roster status allowed","type":"array","items":{"type":"string","enum":["ACTIVE","INJURED","OTHER_NOT_PARTICIPATING","OUT","SUSPENDED"]}},"publishSeasonRosterRolesInHours":{"description":"How long before SEASON starts can rosters or roles be published (in hours)","type":"number","nullable":true},"publishFixtureRosterRolesInMinutes":{"description":"How long before a MATCH starts can rosters or roles be published (in minutes)","type":"number","nullable":true}}}},"title":"season model"},"ImagesModel":{"type":"object","additionalProperties":false,"properties":{"imageId":{"description":"The unique identifier of the image record","type":"string","format":"uuid","readOnly":true},"organizationId":{"description":"The unique identifier of the organization","type":"string","readOnly":true},"organization":{"properties":{"resourceType":{"type":"string","enum":["organizations"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The organization that this images belongs to","type":"object"},"baseType":{"description":"The object that this image relates to\n>- `COMPETITION` Competition\n>- `CONFERENCE` Conference\n>- `DIVISION` Division\n>- `ENTITY` Entity\n>- `ENTITYGROUP` Entity Group\n>- `LEAGUE` League\n>- `ORGANIZATION` Organization\n>- `PERSON` Person\n>- `SEASON` Season\n>- `UNIFORM` Uniform\n>- `UNIFORM_ITEM` Uniform Item\n","type":"string","enum":["PERSON","ENTITY","ENTITYGROUP","COMPETITION","SEASON","LEAGUE","ORGANIZATION","DIVISION","CONFERENCE","UNIFORM","UNIFORM_ITEM"],"maxLength":100},"baseId":{"description":"The unique identifier of the object associated with this image's record. If the `baseType` is `PERSON` then this would be the value of `personId`.","type":"string","format":"uuid"},"fileType":{"description":"The type of file\n>- `JPG` jpg\n>- `PNG` png\n>- `SVG` svg\n","type":"string","enum":["JPG","PNG","SVG"],"maxLength":3,"readOnly":true},"imageType":{"description":"Upload Type\n>- `LOGO` Logo - Not valid for 'PERSON' baseType\n>- `LOGO_ALTERNATE` Logo (alternate) - Not valid for 'PERSON' baseType\n>- `LOGO_BACKGROUND` Stylised logo for background purposes - Not valid for 'PERSON' baseType\n>- `PERSON_HEAD` Head shot (shoulders and head) - Only valid for 'PERSON' baseType\n>- `PERSON_POSE` Person posing - Only valid for 'PERSON' baseType\n>- `PERSON_WAIST` Head shot from the waist up - Only valid for 'PERSON' baseType\n>- `TEAM_PHOTO` Team Photo - Only valid for 'ENTITY' baseType\n>- `UNIFORM` Uniform\n>- `UNIFORM_ITEM` Uniform Item\n","type":"string","enum":["LOGO","LOGO_ALTERNATE","LOGO_BACKGROUND","PERSON_HEAD","PERSON_WAIST","PERSON_POSE","TEAM_PHOTO","UNIFORM","UNIFORM_ITEM"],"maxLength":100},"secondaryType":{"description":"If the image relates to a secondary object. Such as a photo of a person in a team, then baseType would be PERSON and secondaryType would be TEAM.\n>- None None\n>- `COMPETITION` Competition\n>- `CONFERENCE` Conference\n>- `DIVISION` Division\n>- `ENTITY` Entity\n>- `ENTITYGROUP` Entity Group\n>- `LEAGUE` League\n>- `SEASON` Season\n","type":"string","enum":["ENTITY","ENTITYGROUP","COMPETITION","SEASON","LEAGUE","DIVISION","CONFERENCE",null],"maxLength":100,"nullable":true},"secondaryId":{"description":"The unique identifier of the object associated with the secondaryType","type":"string","format":"uuid"},"rating":{"description":"The rating given to the quality of the image.  All images are LOW by default but are set ad MEDIUM if they are large enough and have transparency.  Images are only marked as HIGH if they have been manually reviewed.  You should take your use-case into account when you go to use the image.\n>- `HIGH` High\n>- `LOW` Low\n>- `MEDIUM` Medium\n","type":"string","enum":["LOW","MEDIUM","HIGH"],"maxLength":100,"readOnly":true},"url":{"description":"The URL of the image. See [Images](#section/Introduction/Images) for more information.","type":"string","readOnly":true},"maximumHeight":{"description":"The maximum height (in pixels) of this image.","type":"integer","format":"int32","readOnly":true},"maximumWidth":{"description":"The maximum width (in pixels) of this image.","type":"integer","format":"int32","readOnly":true},"updated":{"description":"Date/time last modified. In UTC","type":"string","format":"date-time","readOnly":true},"added":{"description":"Date/time added. In UTC","type":"string","format":"date-time","readOnly":true}},"title":"images model"},"ErrorModel":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP Error code indicating the type of error.  If there are multiple errors, then this will be the code of the first one.","format":"int32"},"message":{"type":"string","description":"A message indicating the reason for the error. If there are multiple errors, then this is the message for the first one."},"errors":{"type":"array","items":{"$ref":"#/components/schemas/ErrorListModel"}}}},"ErrorListModel":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP Error code indicating the type of error.","format":"int32"},"reason":{"enum":["INVALID_DATA","NOT_FOUND","NOT_AUTHORISED","ERROR","DELETE_ERROR"],"description":"A short code indicating the type of error"},"message":{"type":"string","description":"A message indicating the reason for the error"},"rowNumber":{"type":"integer","description":"The row number of the payload that cause the error","format":"int32"}}}},"responses":{"ErrorResponse":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"meta":{"$ref":"#/components/schemas/ResponseMetaData"},"error":{"$ref":"#/components/schemas/ErrorModel"}}}}}}},"parameters":{"added":{"name":"added","description":"Record was added after this date/time. In UTC.","schema":{"type":"string","format":"date-time"},"required":false,"in":"query"},"ageGroup":{"name":"ageGroup","description":"The age group of the season\n>- `JUNIOR` Junior\n>- `MASTERS` Masters\n>- `SENIOR` Senior\n>- `UNDER_15` Under 15\n>- `UNDER_16` Under 16\n>- `UNDER_17` Under 17\n>- `UNDER_18` Under 18\n>- `UNDER_19` Under 19\n>- `UNDER_20` Under 20\n>- `UNDER_21` Under 21\n>- `UNDER_22` Under 22\n>- `UNDER_23` Under 23\n>- `YOUTH` Youth\n","schema":{"type":"string","enum":["JUNIOR","YOUTH","UNDER_15","UNDER_16","UNDER_17","UNDER_18","UNDER_19","UNDER_20","UNDER_21","UNDER_22","UNDER_23","SENIOR","MASTERS"]},"required":false,"in":"query"},"competitionId":{"name":"competitionId","description":"The unique identifier of the competition","schema":{"type":"string","format":"uuid"},"required":false,"in":"query"},"discipline":{"name":"discipline","description":"The discipline for a match\n>- `BEACH` Beach\n>- `HOCKEY5S` Hockey5s\n>- `INDOOR` Indoor\n>- `OUTDOOR` Outdoor\n>- `PARAHOCKEY` Para hockey\n","schema":{"type":"string","enum":["INDOOR","OUTDOOR","HOCKEY5S","PARAHOCKEY","BEACH"],"maxLength":30},"required":false,"in":"query"},"endDate":{"name":"endDate","description":"endDate on or before this date","schema":{"type":"string","format":"date"},"required":false,"in":"query"},"SEASONeventType":{"name":"eventType","description":"Type of Fixtures\n>- `FIXTURE` Fixture\n>- `PRACTICE` Practice\n","schema":{"type":"string","enum":["FIXTURE","PRACTICE"],"maxLength":30},"required":false,"in":"query"},"external":{"name":"external","description":"A comma separated list of fields that will instead be interpreted as an externalId. See [External Ids](#section/Introduction/External-Ids) for more information.","schema":{"type":"string"},"required":false,"in":"query"},"fields":{"name":"fields","description":"A comma separated list of fields to display.  The response will only display these fields. See [Partial Response](#section/Partial-Response) section for more information.","schema":{"type":"string"},"required":false,"in":"query"},"gender":{"name":"gender","description":"The gender of the season or team\n>- `FEMALE` Female\n>- `MALE` Male\n>- `MIXED` Mixed\n>- `UNKNOWN` Unknown\n","schema":{"type":"string","enum":["FEMALE","MALE","MIXED","UNKNOWN"]},"required":false,"in":"query"},"hideNull":{"name":"hideNull","description":"Don't display data fields with null values or empty structures","schema":{"type":"boolean"},"required":false,"in":"query"},"include":{"name":"include","description":"A comma separated list of resource types to include. See [Resource Inclusion](#section/Introduction/Resource-Inclusion) for more information.","schema":{"type":"string"},"required":false,"in":"query"},"limit":{"name":"limit","description":"The maximum number of records to return. See [Pagination](#section/Introduction/Pagination) for more information.","schema":{"type":"integer","format":"int32","maximum":1000,"minimum":1,"default":10},"required":false,"in":"query"},"nameLatinContains":{"name":"nameLatinContains","description":"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","schema":{"type":"string","minLength":2,"maxLength":50},"required":false,"in":"query"},"nameLocalContains":{"name":"nameLocalContains","description":"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","schema":{"type":"string","minLength":2,"maxLength":50},"required":false,"in":"query"},"offset":{"name":"offset","description":"The offset of the records. See [Pagination](#section/Introduction/Pagination) for more information.","schema":{"type":"integer","format":"int32"},"required":false,"in":"query"},"representation":{"name":"representation","description":"What level are the competitors representing\n>- `CLUB` Club\n>- `COUNTRY` Country\n>- `PERSON` Person\n","schema":{"type":"string","enum":["CLUB","COUNTRY","PERSON"]},"required":false,"in":"query"},"seasonType":{"name":"seasonType","description":"The type of matches added to this season\n>- `MULTI_YEAR_HISTORICAL` Mulit-Year Historical\n>- `ONE_OFF` One off match\n>- `PRESEASON` Pre Season\n>- `SEASON` Season\n>- `TOURNAMENT` Tournament\n","schema":{"type":"string","enum":["SEASON","TOURNAMENT","ONE_OFF","PRESEASON","MULTI_YEAR_HISTORICAL"]},"required":false,"in":"query"},"standard":{"name":"standard","description":"The playing standard of the season or team\n>- `APPROVED_TEST_MATCHES` Approved Test matches\n>- `COMMONWEALTH_GAMES` Commonwealth Games\n>- `CONTINENTAL_CHAMPIONSHIP` Continental Championship\n>- `CONTINENTAL_CHAMPIONSHIP_DIV_2` Continental Championship Div 2\n>- `CONTINENTAL_CHAMPIONSHIP_DIV_3` Continental Championship Div 3\n>- `CONTINENTAL_CHAMPIONSHIP_DIV_4` Continental Championship Div 4\n>- `CONTINENTAL_QUALIFIER` Continental Qualifier\n>- `ELITE` Professional/elite organisation\n>- `FIH_NATIONS_CUP` FIH Nations Cup\n>- `FIH_OLYMPIC_QUALIFIERS` FIH Olympic Qualifiers\n>- `FIH_PRO_LEAGUE` FIH Pro League\n>- `FIH_WORLD_CUP` FIH World Cup\n>- `FIH_WORLD_CUP_QUALIFIERS` FIH World Cup Qualifiers\n>- `FRIENDLY` International Friendly\n>- `GRASS_ROOT` Normal\n>- `HISTORICAL_BASELINE` Historical Baseline\n>- `HOCKEY_SERIES_OPEN` Hockey Series Open\n>- `INTERNATIONAL` International\n>- `INVITATIONAL_TOURNAMENT` Invitational Tournament (3+ teams)\n>- `NONCONTINENTAL_CHAMPIONSHIP` Non-continental Championship\n>- `OLYMPIC` Olympics\n>- `OLYMPICS` Olympic Games\n>- `REGION` Regional\n>- `TIER2` lesser standard than elite\n>- `TIER3` lesser standard than tier 2\n>- `WORLD_CHAMPIONSHIP` World Championship\n>- `WORLD_LEAGUE` World League\n>- `ZONE_CHAMPIONSHIP` International Zone Championship\n","schema":{"type":"string","enum":["ELITE","FRIENDLY","GRASS_ROOT","INTERNATIONAL","NONCONTINENTAL_CHAMPIONSHIP","OLYMPIC","REGION","TIER2","TIER3","WORLD_CHAMPIONSHIP","ZONE_CHAMPIONSHIP","OLYMPICS","FIH_WORLD_CUP","FIH_OLYMPIC_QUALIFIERS","FIH_WORLD_CUP_QUALIFIERS","CONTINENTAL_CHAMPIONSHIP","FIH_PRO_LEAGUE","COMMONWEALTH_GAMES","FIH_NATIONS_CUP","CONTINENTAL_QUALIFIER","CONTINENTAL_CHAMPIONSHIP_DIV_2","CONTINENTAL_CHAMPIONSHIP_DIV_3","INVITATIONAL_TOURNAMENT","CONTINENTAL_CHAMPIONSHIP_DIV_4","APPROVED_TEST_MATCHES","WORLD_LEAGUE","HOCKEY_SERIES_OPEN","HISTORICAL_BASELINE"]},"required":false,"in":"query"},"startDate":{"name":"startDate","description":"startDate on or after this date","schema":{"type":"string","format":"date"},"required":false,"in":"query"},"updated":{"name":"updated","description":"Record was modified after this date/time. In UTC.","schema":{"type":"string","format":"date-time"},"required":false,"in":"query"},"videoProduction":{"name":"videoProduction","description":"Data synchronization strategy with video production systems. Multiple allowed (comma-delimited).\n>- `AUTOMATED` Automated\n>- `MANUAL` Manual\n>- `NONE` None\n","schema":{"type":"string","enum":["NONE","AUTOMATED","MANUAL"],"maxLength":50},"required":false,"in":"query"}}},"paths":{"/icehockey/o/{organizationId}/seasons":{"get":{"tags":["Seasons"],"summary":"Get a list of seasons for an organization","description":"Return a list of seasons in an organization.","operationId":"season_list_by_organization","responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","title":"Seasons Response","properties":{"meta":{"$ref":"#/components/schemas/ResponseMetaData"},"links":{"$ref":"#/components/schemas/ResponseLinks"},"included":{"$ref":"#/components/schemas/IncludedData"},"data":{"type":"array","description":"","items":{"$ref":"#/components/schemas/SeasonsModel"}}}}}}},"default":{"$ref":"#/components/responses/ErrorResponse"}},"parameters":[{"$ref":"#/components/parameters/added"},{"$ref":"#/components/parameters/ageGroup"},{"$ref":"#/components/parameters/competitionId"},{"$ref":"#/components/parameters/discipline"},{"$ref":"#/components/parameters/endDate"},{"$ref":"#/components/parameters/SEASONeventType"},{"$ref":"#/components/parameters/external"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/gender"},{"$ref":"#/components/parameters/hideNull"},{"$ref":"#/components/parameters/include"},{"$ref":"#/components/parameters/limit"},{"$ref":"#/components/parameters/nameLatinContains"},{"$ref":"#/components/parameters/nameLocalContains"},{"$ref":"#/components/parameters/offset"},{"name":"organizationId","description":"The unique identifier of the organization","schema":{"type":"string","minLength":5,"maxLength":5},"required":true,"in":"path"},{"$ref":"#/components/parameters/representation"},{"name":"seasonId","description":"The unique identifier of the season. Can specify multiple, delimited by comma.","schema":{"type":"string"},"required":false,"in":"query"},{"$ref":"#/components/parameters/seasonType"},{"name":"sortBy","description":"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.","schema":{"type":"string","pattern":"^(\\-?nameLocal|\\-?nameLatin|\\-?year|,)*$"},"required":false,"in":"query"},{"$ref":"#/components/parameters/standard"},{"$ref":"#/components/parameters/startDate"},{"name":"status","description":"Status\n>- `ACTIVE` Active\n>- `COMPLETE` Complete\n>- `DRAFT` Draft\n>- `INACTIVE` Inactive\n>- `PENDING` Pending\n","schema":{"type":"string","enum":["ACTIVE","COMPLETE","DRAFT","INACTIVE","PENDING"]},"required":false,"in":"query"},{"$ref":"#/components/parameters/updated"},{"$ref":"#/components/parameters/videoProduction"}]}}}}
```

## Get a season

> Return detailed information about a specific season

```json
{"openapi":"3.0.0","info":{"title":"DataCore API  - Ice Hockey","version":"v1"},"tags":[{"name":"Seasons","description":"Season is a grouping of matches. Generally the season will last a portion of a year (every year).\n\nThe competition can have many seasons, but the season can only belong to one competition.\n\n<img src = \"https://yuml.me/diagram/scruffy;dir:LR/class/[Competitions]-<>[Seasons{bg:orange}],[Seasons]-<>[Matches],[Seasons]->[Stages],[Seasons]->[Pools],[Seasons]->[Rounds],[Matches]-.->[Stages],[Matches]-.->[Pools],[Matches]-.->[Rounds],\">\n\n"}],"servers":[{"url":"https://api.dc.connect.sportradar.com/v1","description":"Production server"},{"url":"https://api.dc.stg.connect-nonprod.sportradar.dev/v1","description":"NonProduction/Staging server"}],"security":[{"OAuth2":["read:organization"]}],"components":{"securitySchemes":{"OAuth2":{"type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"/oauth/token","scopes":{"orgId":"Authenticate based on a specific OrganizationId","read:orggroup":"Read data over multiple organizations using and *orggroup* code","write:organization":"Write/Update any data from below the organization","read:organization":"Read any data from the organization down","write:admin":"Perform administration API calls","write:admin_organization":"Ability to manage organizations","write:system":"Perform system configuration API calls"}}},"description":"You can create a JSON Web Token (JWT) using the [token](http://developer.connect.sportradar.com/token/#operation/getToken) 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."}},"schemas":{"ResponseMetaData":{"type":"object","properties":{"version":{"type":"integer","description":"The version of the API in use for this call"},"codeVersion":{"type":"string","description":"A string indicating the version of the code that handled this request"},"code":{"type":"integer","description":"The HTTP response code for this request"},"time":{"type":"string","format":"date-time","description":"The date/time this request was made (in UTC)."},"fromCache":{"type":"boolean","description":"Was this request served directly from the cache?"},"count":{"type":"integer","description":"The number of records being returned"},"limit":{"type":"integer","description":"The record limit in place for this request"},"offset":{"type":"integer","description":"The record offset in place for this request"},"generationTime":{"type":"number","format":"float","description":"The number of seconds taken to generate this request."}}},"ResponseLinks":{"type":"object","properties":{"self":{"type":"string","format":"uri","description":"The URI referencing this request."},"next":{"type":"string","format":"uri","description":"The URI referencing the 'next' page, if more data is available."},"previous":{"type":"string","format":"uri","description":"The URI referencing the 'previous' page, if the request is not on the first page."}}},"IncludedData":{"type":"object","description":"Available if the request used the 'include' parameter.  It contains extra data about resources found in the data block.","properties":{"resources":{"type":"object","additionalProperties":{"description":"The type of resource","type":"object","enum":["league","organisation","persons"],"additionalProperties":{"type":"object","format":"uuid","description":"The id of the resource","additionalProperties":{"description":"The model for the resource as defined by the type and id"}}}}}},"SeasonsModel":{"type":"object","additionalProperties":false,"properties":{"seasonId":{"description":"The unique identifier of the season","type":"string","format":"uuid"},"organizationId":{"description":"The unique identifier of the organization","type":"string","readOnly":true},"organization":{"properties":{"resourceType":{"type":"string","enum":["organizations"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The organization that this season belongs to","type":"object"},"competitionId":{"description":"The unique identifier of the competition","type":"string","format":"uuid"},"competition":{"properties":{"resourceType":{"type":"string","enum":["competitions"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The competition that this season belongs to","type":"object"},"leaderCriteriaId":{"description":"The unique identifier of the ~LeaderCriteria~","type":"string","format":"uuid","nullable":true},"leadersCriteria":{"properties":{"resourceType":{"type":"string","enum":["leaderCriteria"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The ~LeaderCriteria~ linked to this record","type":"object"},"internationalReference":{"description":"The international reference for this season given by the sport governing body","type":"string","maxLength":30,"nullable":true},"eventType":{"description":"Primary Type of Matches\n>- `FIXTURE` Fixture\n>- `PRACTICE` Practice\n","type":"string","enum":["FIXTURE","PRACTICE"],"maxLength":30,"default":"FIXTURE"},"seasonType":{"description":"The type of matches added to this season\n>- `MULTI_YEAR_HISTORICAL` Mulit-Year Historical\n>- `ONE_OFF` One off\n>- `PRESEASON` Pre Season\n>- `SEASON` Season\n>- `TOURNAMENT` Tournament\n","type":"string","enum":["SEASON","TOURNAMENT","ONE_OFF","PRESEASON","MULTI_YEAR_HISTORICAL"],"maxLength":30},"year":{"description":"Year of the season","type":"integer","format":"int32","maxLength":4},"grade":{"description":"The playing grade of the matches in this season","type":"string","maxLength":50,"nullable":true},"status":{"description":"Status\n>- `ACTIVE` Active\n>- `COMPLETE` Complete\n>- `DRAFT` Draft\n>- `INACTIVE` Inactive\n>- `PENDING` Pending\n","type":"string","enum":["ACTIVE","COMPLETE","DRAFT","INACTIVE","PENDING"],"maxLength":30},"includeInStatistics":{"description":"Include this season in calculated statistics?","type":"boolean","default":true},"liveVideoAvailable":{"description":"If no 'liveVideoAvailable' flag passed to a new match this value is used","type":"boolean"},"liveDataAvailable":{"description":"If no 'liveDataAvailable' flag passed to a new match this value is used","type":"boolean"},"durationFull":{"description":"If no 'durationFull' is passed to a new match this value is used","type":"integer","format":"int32","default":180,"nullable":true},"discipline":{"description":"If no 'discipline' is passed to a new match this value is used\n>- None None\n>- `INDOOR` Indoor\n>- `OUTDOOR` Outdoor\n","type":"string","enum":["INDOOR","OUTDOOR",null],"nullable":true},"nameLocal":{"description":"The name of the season in the [local](#section/Introduction/Character-Sets-and-Names) language","type":"string","maxLength":150},"nameLatin":{"description":"The name of the season in [latin](#section/Introduction/Character-Sets-and-Names) characters","type":"string","maxLength":150,"nullable":true},"nameShortLocal":{"description":"The abbreviated name of the season in the [local](#section/Introduction/Character-Sets-and-Names) language","type":"string","maxLength":50,"nullable":true},"nameShortLatin":{"description":"The abbreviated name of the season in [latin](#section/Introduction/Character-Sets-and-Names) characters","type":"string","maxLength":50,"nullable":true},"startDate":{"description":"Season start date","type":"string","format":"date"},"endDate":{"description":"Season end date","type":"string","format":"date","nullable":true},"gender":{"description":"The gender of the participants in the season\n>- `FEMALE` Female\n>- `MALE` Male\n>- `MIXED` Mixed\n>- `UNKNOWN` Unknown\n","type":"string","enum":["FEMALE","MALE","MIXED","UNKNOWN"],"maxLength":20},"ageGroup":{"description":"The age group of the season\n>- `JUNIOR` Junior\n>- `MASTERS` Masters\n>- `SENIOR` Senior\n>- `UNDER_15` Under 15\n>- `UNDER_16` Under 16\n>- `UNDER_17` Under 17\n>- `UNDER_18` Under 18\n>- `UNDER_19` Under 19\n>- `UNDER_20` Under 20\n>- `UNDER_21` Under 21\n>- `UNDER_22` Under 22\n>- `UNDER_23` Under 23\n>- `YOUTH` Youth\n","type":"string","enum":["JUNIOR","YOUTH","UNDER_15","UNDER_16","UNDER_17","UNDER_18","UNDER_19","UNDER_20","UNDER_21","UNDER_22","UNDER_23","SENIOR","MASTERS"],"maxLength":50},"standard":{"description":"The playing standard of the season\n>- `ELITE` Professional/elite organisation\n>- `FRIENDLY` International Friendly\n>- `GRASS_ROOT` Normal\n>- `HISTORICAL_BASELINE` Historical Baseline\n>- `INTERNATIONAL` International\n>- `NONCONTINENTAL_CHAMPIONSHIP` Non-continental Championship\n>- `OLYMPIC` Olympics\n>- `REGION` Regional\n>- `TIER2` lesser standard than elite\n>- `TIER3` lesser standard than tier 2\n>- `WORLD_CHAMPIONSHIP` World Championship\n>- `ZONE_CHAMPIONSHIP` International Zone Championship\n","type":"string","enum":["ELITE","FRIENDLY","GRASS_ROOT","INTERNATIONAL","NONCONTINENTAL_CHAMPIONSHIP","OLYMPIC","REGION","TIER2","TIER3","WORLD_CHAMPIONSHIP","ZONE_CHAMPIONSHIP","HISTORICAL_BASELINE"],"maxLength":50},"representation":{"description":"What level are the competitors representing\n>- `CLUB` Club\n>- `COUNTRY` Country\n>- `PERSON` Person\n>- `REGION` Region\n>- `STATE` State\n","type":"string","enum":["CLUB","STATE","REGION","COUNTRY","PERSON"],"maxLength":50},"standingConfigurationId":{"description":"The unique identifier of the ~standingConfiguration~","type":"string","format":"uuid","nullable":true},"standingConfiguration":{"properties":{"resourceType":{"type":"string","enum":["standingConfigurations"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The ~standingConfiguration~ that this season belongs to","type":"object"},"lockStandings":{"description":"Is the standings generation locked ?","type":"boolean"},"externalId":{"description":"The Id of the data as set by the provider of the data","type":"string","maxLength":150,"pattern":"^[0-9A-Za-z/_-]+$","nullable":true},"social":{"title":"Social Media","description":"Social Media contacts","type":"object","nullable":true,"additionalProperties":false,"properties":{"website":{"type":"string","nullable":true,"format":"uri"},"facebook":{"type":"string","nullable":true,"format":"uri"},"twitter":{"type":"string","nullable":true,"format":"uri"},"wikipedia":{"type":"string","nullable":true,"format":"uri"},"instagram":{"type":"string","nullable":true,"format":"uri"}}},"configuration":{"title":"Season Configuration","description":"Season Configuration settings","type":"object","nullable":true,"additionalProperties":false,"properties":{"periodBreakDuration":{"type":"number"},"halfTimeDuration":{"type":"number"},"shotClockLength":{"type":"number"},"foulsUntilBonus":{"type":"number"},"foulsAllowedPersonal":{"type":"number"},"foulsAllowedTechnical":{"type":"number"}}},"profileId":{"description":"The profile that this season belongs to","type":"string","format":"uuid","nullable":true},"fixtureProfile":{"properties":{"resourceType":{"type":"string","enum":["fixtureProfiles"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The profile that this season belongs to","type":"object"},"updated":{"description":"Date/time last modified. In UTC","type":"string","format":"date-time","readOnly":true},"added":{"description":"Date/time added. In UTC","type":"string","format":"date-time","readOnly":true},"images":{"type":"array","items":{"$ref":"#/components/schemas/ImagesModel"}},"videoProduction":{"description":"Data synchronization strategy with video production systems\n>- `AUTOMATED` Automated\n>- `MANUAL` Manual\n>- `NONE` None\n","type":"string","enum":["NONE","AUTOMATED","MANUAL"],"maxLength":50,"default":"NONE"},"promotionRelegationRules":{"type":"array","nullable":true,"items":{"type":"object","additionalProperties":false,"required":["ruleType","position","value"],"properties":{"ruleType":{"description":"Rule Type","type":"string","enum":["PROMOTION","RELEGATION"]},"position":{"description":"Standings Position","type":"number"},"value":{"description":"Value to apply to Promotion or Relegation","type":"string"}}}},"rosterConfiguration":{"title":"SEASON ROSTER configuration","description":"Configuration for the SEASON ROSTER","type":"object","nullable":true,"additionalProperties":false,"properties":{"windowOpenDate":{"description":"What date can a SEASON ROSTER be submitted from for this SEASON?","type":"string","nullable":true,"format":"date"},"windowCloseDate":{"description":"What is the last date a SEASON ROSTER can be submitted from for this SEASON?","type":"string","nullable":true,"format":"date"},"seasonRosterLock":{"description":"Make SEASON ROSTERS un-editable when SEASON ROSTER Registration Window Close Date has elapsed.","type":"boolean","nullable":true},"fixtureRosterLock":{"description":"Make FIXTURE ROSTERS un-editable when MATCH Status is set to Scheduled","type":"boolean","nullable":true},"fixtureBibEdit":{"description":"Allow Add/Edit of FIXTURE ROSTERS bib","type":"boolean","nullable":true},"seasonRosterStatusAllowed":{"description":"Season Roster status allowed","type":"array","items":{"type":"string","enum":["ACTIVE","INJURED","OTHER_NOT_PARTICIPATING","OUT","SUSPENDED"]}},"publishSeasonRosterRolesInHours":{"description":"How long before SEASON starts can rosters or roles be published (in hours)","type":"number","nullable":true},"publishFixtureRosterRolesInMinutes":{"description":"How long before a MATCH starts can rosters or roles be published (in minutes)","type":"number","nullable":true}}}},"title":"season model"},"ImagesModel":{"type":"object","additionalProperties":false,"properties":{"imageId":{"description":"The unique identifier of the image record","type":"string","format":"uuid","readOnly":true},"organizationId":{"description":"The unique identifier of the organization","type":"string","readOnly":true},"organization":{"properties":{"resourceType":{"type":"string","enum":["organizations"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The organization that this images belongs to","type":"object"},"baseType":{"description":"The object that this image relates to\n>- `COMPETITION` Competition\n>- `CONFERENCE` Conference\n>- `DIVISION` Division\n>- `ENTITY` Entity\n>- `ENTITYGROUP` Entity Group\n>- `LEAGUE` League\n>- `ORGANIZATION` Organization\n>- `PERSON` Person\n>- `SEASON` Season\n>- `UNIFORM` Uniform\n>- `UNIFORM_ITEM` Uniform Item\n","type":"string","enum":["PERSON","ENTITY","ENTITYGROUP","COMPETITION","SEASON","LEAGUE","ORGANIZATION","DIVISION","CONFERENCE","UNIFORM","UNIFORM_ITEM"],"maxLength":100},"baseId":{"description":"The unique identifier of the object associated with this image's record. If the `baseType` is `PERSON` then this would be the value of `personId`.","type":"string","format":"uuid"},"fileType":{"description":"The type of file\n>- `JPG` jpg\n>- `PNG` png\n>- `SVG` svg\n","type":"string","enum":["JPG","PNG","SVG"],"maxLength":3,"readOnly":true},"imageType":{"description":"Upload Type\n>- `LOGO` Logo - Not valid for 'PERSON' baseType\n>- `LOGO_ALTERNATE` Logo (alternate) - Not valid for 'PERSON' baseType\n>- `LOGO_BACKGROUND` Stylised logo for background purposes - Not valid for 'PERSON' baseType\n>- `PERSON_HEAD` Head shot (shoulders and head) - Only valid for 'PERSON' baseType\n>- `PERSON_POSE` Person posing - Only valid for 'PERSON' baseType\n>- `PERSON_WAIST` Head shot from the waist up - Only valid for 'PERSON' baseType\n>- `TEAM_PHOTO` Team Photo - Only valid for 'ENTITY' baseType\n>- `UNIFORM` Uniform\n>- `UNIFORM_ITEM` Uniform Item\n","type":"string","enum":["LOGO","LOGO_ALTERNATE","LOGO_BACKGROUND","PERSON_HEAD","PERSON_WAIST","PERSON_POSE","TEAM_PHOTO","UNIFORM","UNIFORM_ITEM"],"maxLength":100},"secondaryType":{"description":"If the image relates to a secondary object. Such as a photo of a person in a team, then baseType would be PERSON and secondaryType would be TEAM.\n>- None None\n>- `COMPETITION` Competition\n>- `CONFERENCE` Conference\n>- `DIVISION` Division\n>- `ENTITY` Entity\n>- `ENTITYGROUP` Entity Group\n>- `LEAGUE` League\n>- `SEASON` Season\n","type":"string","enum":["ENTITY","ENTITYGROUP","COMPETITION","SEASON","LEAGUE","DIVISION","CONFERENCE",null],"maxLength":100,"nullable":true},"secondaryId":{"description":"The unique identifier of the object associated with the secondaryType","type":"string","format":"uuid"},"rating":{"description":"The rating given to the quality of the image.  All images are LOW by default but are set ad MEDIUM if they are large enough and have transparency.  Images are only marked as HIGH if they have been manually reviewed.  You should take your use-case into account when you go to use the image.\n>- `HIGH` High\n>- `LOW` Low\n>- `MEDIUM` Medium\n","type":"string","enum":["LOW","MEDIUM","HIGH"],"maxLength":100,"readOnly":true},"url":{"description":"The URL of the image. See [Images](#section/Introduction/Images) for more information.","type":"string","readOnly":true},"maximumHeight":{"description":"The maximum height (in pixels) of this image.","type":"integer","format":"int32","readOnly":true},"maximumWidth":{"description":"The maximum width (in pixels) of this image.","type":"integer","format":"int32","readOnly":true},"updated":{"description":"Date/time last modified. In UTC","type":"string","format":"date-time","readOnly":true},"added":{"description":"Date/time added. In UTC","type":"string","format":"date-time","readOnly":true}},"title":"images model"},"ErrorModel":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP Error code indicating the type of error.  If there are multiple errors, then this will be the code of the first one.","format":"int32"},"message":{"type":"string","description":"A message indicating the reason for the error. If there are multiple errors, then this is the message for the first one."},"errors":{"type":"array","items":{"$ref":"#/components/schemas/ErrorListModel"}}}},"ErrorListModel":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP Error code indicating the type of error.","format":"int32"},"reason":{"enum":["INVALID_DATA","NOT_FOUND","NOT_AUTHORISED","ERROR","DELETE_ERROR"],"description":"A short code indicating the type of error"},"message":{"type":"string","description":"A message indicating the reason for the error"},"rowNumber":{"type":"integer","description":"The row number of the payload that cause the error","format":"int32"}}}},"responses":{"ErrorResponse":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"meta":{"$ref":"#/components/schemas/ResponseMetaData"},"error":{"$ref":"#/components/schemas/ErrorModel"}}}}}}},"parameters":{"external":{"name":"external","description":"A comma separated list of fields that will instead be interpreted as an externalId. See [External Ids](#section/Introduction/External-Ids) for more information.","schema":{"type":"string"},"required":false,"in":"query"},"fields":{"name":"fields","description":"A comma separated list of fields to display.  The response will only display these fields. See [Partial Response](#section/Partial-Response) section for more information.","schema":{"type":"string"},"required":false,"in":"query"},"hideNull":{"name":"hideNull","description":"Don't display data fields with null values or empty structures","schema":{"type":"boolean"},"required":false,"in":"query"},"include":{"name":"include","description":"A comma separated list of resource types to include. See [Resource Inclusion](#section/Introduction/Resource-Inclusion) for more information.","schema":{"type":"string"},"required":false,"in":"query"},"limit":{"name":"limit","description":"The maximum number of records to return. See [Pagination](#section/Introduction/Pagination) for more information.","schema":{"type":"integer","format":"int32","maximum":1000,"minimum":1,"default":10},"required":false,"in":"query"},"offset":{"name":"offset","description":"The offset of the records. See [Pagination](#section/Introduction/Pagination) for more information.","schema":{"type":"integer","format":"int32"},"required":false,"in":"query"}}},"paths":{"/icehockey/o/{organizationId}/seasons/{seasonId}":{"get":{"tags":["Seasons"],"summary":"Get a season","description":"Return detailed information about a specific season","operationId":"season_detail","responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","title":"Seasons Response","properties":{"meta":{"$ref":"#/components/schemas/ResponseMetaData"},"links":{"$ref":"#/components/schemas/ResponseLinks"},"included":{"$ref":"#/components/schemas/IncludedData"},"data":{"type":"array","description":"","items":{"$ref":"#/components/schemas/SeasonsModel"}}}}}}},"default":{"$ref":"#/components/responses/ErrorResponse"}},"parameters":[{"$ref":"#/components/parameters/external"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/hideNull"},{"$ref":"#/components/parameters/include"},{"$ref":"#/components/parameters/limit"},{"$ref":"#/components/parameters/offset"},{"name":"organizationId","description":"The unique identifier of the organization","schema":{"type":"string","minLength":5,"maxLength":5},"required":true,"in":"path"},{"name":"seasonId","description":"The unique identifier of the season","schema":{"type":"string","format":"uuid"},"required":true,"in":"path"}]}}}}
```

## Update a season

> Change the information of a specific season

```json
{"openapi":"3.0.0","info":{"title":"DataCore API  - Ice Hockey","version":"v1"},"tags":[{"name":"Seasons","description":"Season is a grouping of matches. Generally the season will last a portion of a year (every year).\n\nThe competition can have many seasons, but the season can only belong to one competition.\n\n<img src = \"https://yuml.me/diagram/scruffy;dir:LR/class/[Competitions]-<>[Seasons{bg:orange}],[Seasons]-<>[Matches],[Seasons]->[Stages],[Seasons]->[Pools],[Seasons]->[Rounds],[Matches]-.->[Stages],[Matches]-.->[Pools],[Matches]-.->[Rounds],\">\n\n"}],"servers":[{"url":"https://api.dc.connect.sportradar.com/v1","description":"Production server"},{"url":"https://api.dc.stg.connect-nonprod.sportradar.dev/v1","description":"NonProduction/Staging server"}],"security":[{"OAuth2":["write:organization"]}],"components":{"securitySchemes":{"OAuth2":{"type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"/oauth/token","scopes":{"orgId":"Authenticate based on a specific OrganizationId","read:orggroup":"Read data over multiple organizations using and *orggroup* code","write:organization":"Write/Update any data from below the organization","read:organization":"Read any data from the organization down","write:admin":"Perform administration API calls","write:admin_organization":"Ability to manage organizations","write:system":"Perform system configuration API calls"}}},"description":"You can create a JSON Web Token (JWT) using the [token](http://developer.connect.sportradar.com/token/#operation/getToken) 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."}},"schemas":{"ResponseMetaData":{"type":"object","properties":{"version":{"type":"integer","description":"The version of the API in use for this call"},"codeVersion":{"type":"string","description":"A string indicating the version of the code that handled this request"},"code":{"type":"integer","description":"The HTTP response code for this request"},"time":{"type":"string","format":"date-time","description":"The date/time this request was made (in UTC)."},"fromCache":{"type":"boolean","description":"Was this request served directly from the cache?"},"count":{"type":"integer","description":"The number of records being returned"},"limit":{"type":"integer","description":"The record limit in place for this request"},"offset":{"type":"integer","description":"The record offset in place for this request"},"generationTime":{"type":"number","format":"float","description":"The number of seconds taken to generate this request."}}},"ResponseLinks":{"type":"object","properties":{"self":{"type":"string","format":"uri","description":"The URI referencing this request."},"next":{"type":"string","format":"uri","description":"The URI referencing the 'next' page, if more data is available."},"previous":{"type":"string","format":"uri","description":"The URI referencing the 'previous' page, if the request is not on the first page."}}},"IncludedData":{"type":"object","description":"Available if the request used the 'include' parameter.  It contains extra data about resources found in the data block.","properties":{"resources":{"type":"object","additionalProperties":{"description":"The type of resource","type":"object","enum":["league","organisation","persons"],"additionalProperties":{"type":"object","format":"uuid","description":"The id of the resource","additionalProperties":{"description":"The model for the resource as defined by the type and id"}}}}}},"SeasonsModel":{"type":"object","additionalProperties":false,"properties":{"seasonId":{"description":"The unique identifier of the season","type":"string","format":"uuid"},"organizationId":{"description":"The unique identifier of the organization","type":"string","readOnly":true},"organization":{"properties":{"resourceType":{"type":"string","enum":["organizations"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The organization that this season belongs to","type":"object"},"competitionId":{"description":"The unique identifier of the competition","type":"string","format":"uuid"},"competition":{"properties":{"resourceType":{"type":"string","enum":["competitions"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The competition that this season belongs to","type":"object"},"leaderCriteriaId":{"description":"The unique identifier of the ~LeaderCriteria~","type":"string","format":"uuid","nullable":true},"leadersCriteria":{"properties":{"resourceType":{"type":"string","enum":["leaderCriteria"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The ~LeaderCriteria~ linked to this record","type":"object"},"internationalReference":{"description":"The international reference for this season given by the sport governing body","type":"string","maxLength":30,"nullable":true},"eventType":{"description":"Primary Type of Matches\n>- `FIXTURE` Fixture\n>- `PRACTICE` Practice\n","type":"string","enum":["FIXTURE","PRACTICE"],"maxLength":30,"default":"FIXTURE"},"seasonType":{"description":"The type of matches added to this season\n>- `MULTI_YEAR_HISTORICAL` Mulit-Year Historical\n>- `ONE_OFF` One off\n>- `PRESEASON` Pre Season\n>- `SEASON` Season\n>- `TOURNAMENT` Tournament\n","type":"string","enum":["SEASON","TOURNAMENT","ONE_OFF","PRESEASON","MULTI_YEAR_HISTORICAL"],"maxLength":30},"year":{"description":"Year of the season","type":"integer","format":"int32","maxLength":4},"grade":{"description":"The playing grade of the matches in this season","type":"string","maxLength":50,"nullable":true},"status":{"description":"Status\n>- `ACTIVE` Active\n>- `COMPLETE` Complete\n>- `DRAFT` Draft\n>- `INACTIVE` Inactive\n>- `PENDING` Pending\n","type":"string","enum":["ACTIVE","COMPLETE","DRAFT","INACTIVE","PENDING"],"maxLength":30},"includeInStatistics":{"description":"Include this season in calculated statistics?","type":"boolean","default":true},"liveVideoAvailable":{"description":"If no 'liveVideoAvailable' flag passed to a new match this value is used","type":"boolean"},"liveDataAvailable":{"description":"If no 'liveDataAvailable' flag passed to a new match this value is used","type":"boolean"},"durationFull":{"description":"If no 'durationFull' is passed to a new match this value is used","type":"integer","format":"int32","default":180,"nullable":true},"discipline":{"description":"If no 'discipline' is passed to a new match this value is used\n>- None None\n>- `INDOOR` Indoor\n>- `OUTDOOR` Outdoor\n","type":"string","enum":["INDOOR","OUTDOOR",null],"nullable":true},"nameLocal":{"description":"The name of the season in the [local](#section/Introduction/Character-Sets-and-Names) language","type":"string","maxLength":150},"nameLatin":{"description":"The name of the season in [latin](#section/Introduction/Character-Sets-and-Names) characters","type":"string","maxLength":150,"nullable":true},"nameShortLocal":{"description":"The abbreviated name of the season in the [local](#section/Introduction/Character-Sets-and-Names) language","type":"string","maxLength":50,"nullable":true},"nameShortLatin":{"description":"The abbreviated name of the season in [latin](#section/Introduction/Character-Sets-and-Names) characters","type":"string","maxLength":50,"nullable":true},"startDate":{"description":"Season start date","type":"string","format":"date"},"endDate":{"description":"Season end date","type":"string","format":"date","nullable":true},"gender":{"description":"The gender of the participants in the season\n>- `FEMALE` Female\n>- `MALE` Male\n>- `MIXED` Mixed\n>- `UNKNOWN` Unknown\n","type":"string","enum":["FEMALE","MALE","MIXED","UNKNOWN"],"maxLength":20},"ageGroup":{"description":"The age group of the season\n>- `JUNIOR` Junior\n>- `MASTERS` Masters\n>- `SENIOR` Senior\n>- `UNDER_15` Under 15\n>- `UNDER_16` Under 16\n>- `UNDER_17` Under 17\n>- `UNDER_18` Under 18\n>- `UNDER_19` Under 19\n>- `UNDER_20` Under 20\n>- `UNDER_21` Under 21\n>- `UNDER_22` Under 22\n>- `UNDER_23` Under 23\n>- `YOUTH` Youth\n","type":"string","enum":["JUNIOR","YOUTH","UNDER_15","UNDER_16","UNDER_17","UNDER_18","UNDER_19","UNDER_20","UNDER_21","UNDER_22","UNDER_23","SENIOR","MASTERS"],"maxLength":50},"standard":{"description":"The playing standard of the season\n>- `ELITE` Professional/elite organisation\n>- `FRIENDLY` International Friendly\n>- `GRASS_ROOT` Normal\n>- `HISTORICAL_BASELINE` Historical Baseline\n>- `INTERNATIONAL` International\n>- `NONCONTINENTAL_CHAMPIONSHIP` Non-continental Championship\n>- `OLYMPIC` Olympics\n>- `REGION` Regional\n>- `TIER2` lesser standard than elite\n>- `TIER3` lesser standard than tier 2\n>- `WORLD_CHAMPIONSHIP` World Championship\n>- `ZONE_CHAMPIONSHIP` International Zone Championship\n","type":"string","enum":["ELITE","FRIENDLY","GRASS_ROOT","INTERNATIONAL","NONCONTINENTAL_CHAMPIONSHIP","OLYMPIC","REGION","TIER2","TIER3","WORLD_CHAMPIONSHIP","ZONE_CHAMPIONSHIP","HISTORICAL_BASELINE"],"maxLength":50},"representation":{"description":"What level are the competitors representing\n>- `CLUB` Club\n>- `COUNTRY` Country\n>- `PERSON` Person\n>- `REGION` Region\n>- `STATE` State\n","type":"string","enum":["CLUB","STATE","REGION","COUNTRY","PERSON"],"maxLength":50},"standingConfigurationId":{"description":"The unique identifier of the ~standingConfiguration~","type":"string","format":"uuid","nullable":true},"standingConfiguration":{"properties":{"resourceType":{"type":"string","enum":["standingConfigurations"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The ~standingConfiguration~ that this season belongs to","type":"object"},"lockStandings":{"description":"Is the standings generation locked ?","type":"boolean"},"externalId":{"description":"The Id of the data as set by the provider of the data","type":"string","maxLength":150,"pattern":"^[0-9A-Za-z/_-]+$","nullable":true},"social":{"title":"Social Media","description":"Social Media contacts","type":"object","nullable":true,"additionalProperties":false,"properties":{"website":{"type":"string","nullable":true,"format":"uri"},"facebook":{"type":"string","nullable":true,"format":"uri"},"twitter":{"type":"string","nullable":true,"format":"uri"},"wikipedia":{"type":"string","nullable":true,"format":"uri"},"instagram":{"type":"string","nullable":true,"format":"uri"}}},"configuration":{"title":"Season Configuration","description":"Season Configuration settings","type":"object","nullable":true,"additionalProperties":false,"properties":{"periodBreakDuration":{"type":"number"},"halfTimeDuration":{"type":"number"},"shotClockLength":{"type":"number"},"foulsUntilBonus":{"type":"number"},"foulsAllowedPersonal":{"type":"number"},"foulsAllowedTechnical":{"type":"number"}}},"profileId":{"description":"The profile that this season belongs to","type":"string","format":"uuid","nullable":true},"fixtureProfile":{"properties":{"resourceType":{"type":"string","enum":["fixtureProfiles"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The profile that this season belongs to","type":"object"},"updated":{"description":"Date/time last modified. In UTC","type":"string","format":"date-time","readOnly":true},"added":{"description":"Date/time added. In UTC","type":"string","format":"date-time","readOnly":true},"images":{"type":"array","items":{"$ref":"#/components/schemas/ImagesModel"}},"videoProduction":{"description":"Data synchronization strategy with video production systems\n>- `AUTOMATED` Automated\n>- `MANUAL` Manual\n>- `NONE` None\n","type":"string","enum":["NONE","AUTOMATED","MANUAL"],"maxLength":50,"default":"NONE"},"promotionRelegationRules":{"type":"array","nullable":true,"items":{"type":"object","additionalProperties":false,"required":["ruleType","position","value"],"properties":{"ruleType":{"description":"Rule Type","type":"string","enum":["PROMOTION","RELEGATION"]},"position":{"description":"Standings Position","type":"number"},"value":{"description":"Value to apply to Promotion or Relegation","type":"string"}}}},"rosterConfiguration":{"title":"SEASON ROSTER configuration","description":"Configuration for the SEASON ROSTER","type":"object","nullable":true,"additionalProperties":false,"properties":{"windowOpenDate":{"description":"What date can a SEASON ROSTER be submitted from for this SEASON?","type":"string","nullable":true,"format":"date"},"windowCloseDate":{"description":"What is the last date a SEASON ROSTER can be submitted from for this SEASON?","type":"string","nullable":true,"format":"date"},"seasonRosterLock":{"description":"Make SEASON ROSTERS un-editable when SEASON ROSTER Registration Window Close Date has elapsed.","type":"boolean","nullable":true},"fixtureRosterLock":{"description":"Make FIXTURE ROSTERS un-editable when MATCH Status is set to Scheduled","type":"boolean","nullable":true},"fixtureBibEdit":{"description":"Allow Add/Edit of FIXTURE ROSTERS bib","type":"boolean","nullable":true},"seasonRosterStatusAllowed":{"description":"Season Roster status allowed","type":"array","items":{"type":"string","enum":["ACTIVE","INJURED","OTHER_NOT_PARTICIPATING","OUT","SUSPENDED"]}},"publishSeasonRosterRolesInHours":{"description":"How long before SEASON starts can rosters or roles be published (in hours)","type":"number","nullable":true},"publishFixtureRosterRolesInMinutes":{"description":"How long before a MATCH starts can rosters or roles be published (in minutes)","type":"number","nullable":true}}}},"title":"season model"},"ImagesModel":{"type":"object","additionalProperties":false,"properties":{"imageId":{"description":"The unique identifier of the image record","type":"string","format":"uuid","readOnly":true},"organizationId":{"description":"The unique identifier of the organization","type":"string","readOnly":true},"organization":{"properties":{"resourceType":{"type":"string","enum":["organizations"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The organization that this images belongs to","type":"object"},"baseType":{"description":"The object that this image relates to\n>- `COMPETITION` Competition\n>- `CONFERENCE` Conference\n>- `DIVISION` Division\n>- `ENTITY` Entity\n>- `ENTITYGROUP` Entity Group\n>- `LEAGUE` League\n>- `ORGANIZATION` Organization\n>- `PERSON` Person\n>- `SEASON` Season\n>- `UNIFORM` Uniform\n>- `UNIFORM_ITEM` Uniform Item\n","type":"string","enum":["PERSON","ENTITY","ENTITYGROUP","COMPETITION","SEASON","LEAGUE","ORGANIZATION","DIVISION","CONFERENCE","UNIFORM","UNIFORM_ITEM"],"maxLength":100},"baseId":{"description":"The unique identifier of the object associated with this image's record. If the `baseType` is `PERSON` then this would be the value of `personId`.","type":"string","format":"uuid"},"fileType":{"description":"The type of file\n>- `JPG` jpg\n>- `PNG` png\n>- `SVG` svg\n","type":"string","enum":["JPG","PNG","SVG"],"maxLength":3,"readOnly":true},"imageType":{"description":"Upload Type\n>- `LOGO` Logo - Not valid for 'PERSON' baseType\n>- `LOGO_ALTERNATE` Logo (alternate) - Not valid for 'PERSON' baseType\n>- `LOGO_BACKGROUND` Stylised logo for background purposes - Not valid for 'PERSON' baseType\n>- `PERSON_HEAD` Head shot (shoulders and head) - Only valid for 'PERSON' baseType\n>- `PERSON_POSE` Person posing - Only valid for 'PERSON' baseType\n>- `PERSON_WAIST` Head shot from the waist up - Only valid for 'PERSON' baseType\n>- `TEAM_PHOTO` Team Photo - Only valid for 'ENTITY' baseType\n>- `UNIFORM` Uniform\n>- `UNIFORM_ITEM` Uniform Item\n","type":"string","enum":["LOGO","LOGO_ALTERNATE","LOGO_BACKGROUND","PERSON_HEAD","PERSON_WAIST","PERSON_POSE","TEAM_PHOTO","UNIFORM","UNIFORM_ITEM"],"maxLength":100},"secondaryType":{"description":"If the image relates to a secondary object. Such as a photo of a person in a team, then baseType would be PERSON and secondaryType would be TEAM.\n>- None None\n>- `COMPETITION` Competition\n>- `CONFERENCE` Conference\n>- `DIVISION` Division\n>- `ENTITY` Entity\n>- `ENTITYGROUP` Entity Group\n>- `LEAGUE` League\n>- `SEASON` Season\n","type":"string","enum":["ENTITY","ENTITYGROUP","COMPETITION","SEASON","LEAGUE","DIVISION","CONFERENCE",null],"maxLength":100,"nullable":true},"secondaryId":{"description":"The unique identifier of the object associated with the secondaryType","type":"string","format":"uuid"},"rating":{"description":"The rating given to the quality of the image.  All images are LOW by default but are set ad MEDIUM if they are large enough and have transparency.  Images are only marked as HIGH if they have been manually reviewed.  You should take your use-case into account when you go to use the image.\n>- `HIGH` High\n>- `LOW` Low\n>- `MEDIUM` Medium\n","type":"string","enum":["LOW","MEDIUM","HIGH"],"maxLength":100,"readOnly":true},"url":{"description":"The URL of the image. See [Images](#section/Introduction/Images) for more information.","type":"string","readOnly":true},"maximumHeight":{"description":"The maximum height (in pixels) of this image.","type":"integer","format":"int32","readOnly":true},"maximumWidth":{"description":"The maximum width (in pixels) of this image.","type":"integer","format":"int32","readOnly":true},"updated":{"description":"Date/time last modified. In UTC","type":"string","format":"date-time","readOnly":true},"added":{"description":"Date/time added. In UTC","type":"string","format":"date-time","readOnly":true}},"title":"images model"},"ErrorModel":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP Error code indicating the type of error.  If there are multiple errors, then this will be the code of the first one.","format":"int32"},"message":{"type":"string","description":"A message indicating the reason for the error. If there are multiple errors, then this is the message for the first one."},"errors":{"type":"array","items":{"$ref":"#/components/schemas/ErrorListModel"}}}},"ErrorListModel":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP Error code indicating the type of error.","format":"int32"},"reason":{"enum":["INVALID_DATA","NOT_FOUND","NOT_AUTHORISED","ERROR","DELETE_ERROR"],"description":"A short code indicating the type of error"},"message":{"type":"string","description":"A message indicating the reason for the error"},"rowNumber":{"type":"integer","description":"The row number of the payload that cause the error","format":"int32"}}}},"responses":{"ErrorResponse":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"meta":{"$ref":"#/components/schemas/ResponseMetaData"},"error":{"$ref":"#/components/schemas/ErrorModel"}}}}}}},"parameters":{"external":{"name":"external","description":"A comma separated list of fields that will instead be interpreted as an externalId. See [External Ids](#section/Introduction/External-Ids) for more information.","schema":{"type":"string"},"required":false,"in":"query"},"fields":{"name":"fields","description":"A comma separated list of fields to display.  The response will only display these fields. See [Partial Response](#section/Partial-Response) section for more information.","schema":{"type":"string"},"required":false,"in":"query"},"hideNull":{"name":"hideNull","description":"Don't display data fields with null values or empty structures","schema":{"type":"boolean"},"required":false,"in":"query"},"include":{"name":"include","description":"A comma separated list of resource types to include. See [Resource Inclusion](#section/Introduction/Resource-Inclusion) for more information.","schema":{"type":"string"},"required":false,"in":"query"}}},"paths":{"/icehockey/o/{organizationId}/seasons/{seasonId}":{"put":{"tags":["Seasons"],"summary":"Update a season","description":"Change the information of a specific season","operationId":"season_update","responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","title":"Seasons Response","properties":{"meta":{"$ref":"#/components/schemas/ResponseMetaData"},"links":{"$ref":"#/components/schemas/ResponseLinks"},"included":{"$ref":"#/components/schemas/IncludedData"},"data":{"type":"array","description":"","items":{"$ref":"#/components/schemas/SeasonsModel"}}}}}}},"default":{"$ref":"#/components/responses/ErrorResponse"}},"parameters":[{"$ref":"#/components/parameters/external"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/hideNull"},{"$ref":"#/components/parameters/include"},{"name":"organizationId","description":"The unique identifier of the organization","schema":{"type":"string","minLength":5,"maxLength":5},"required":true,"in":"path"},{"name":"seasonId","description":"The unique identifier of the season","schema":{"type":"string","format":"uuid"},"required":true,"in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"competitionId":{"description":"The unique identifier of the competition","type":"string","format":"uuid"},"leaderCriteriaId":{"description":"The unique identifier of the ~LeaderCriteria~","type":"string","format":"uuid","nullable":true},"internationalReference":{"description":"The international reference for this season given by the sport governing body","type":"string","maxLength":30,"nullable":true},"eventType":{"description":"Primary Type of Matches\n>- `FIXTURE` Fixture\n>- `PRACTICE` Practice\n","type":"string","enum":["FIXTURE","PRACTICE"],"maxLength":30,"default":"FIXTURE"},"seasonType":{"description":"The type of matches added to this season\n>- `MULTI_YEAR_HISTORICAL` Mulit-Year Historical\n>- `ONE_OFF` One off\n>- `PRESEASON` Pre Season\n>- `SEASON` Season\n>- `TOURNAMENT` Tournament\n","type":"string","enum":["SEASON","TOURNAMENT","ONE_OFF","PRESEASON","MULTI_YEAR_HISTORICAL"],"maxLength":30},"year":{"description":"Year of the season","type":"integer","format":"int32","maxLength":4},"grade":{"description":"The playing grade of the matches in this season","type":"string","maxLength":50,"nullable":true},"status":{"description":"Status\n>- `ACTIVE` Active\n>- `COMPLETE` Complete\n>- `DRAFT` Draft\n>- `INACTIVE` Inactive\n>- `PENDING` Pending\n","type":"string","enum":["ACTIVE","COMPLETE","DRAFT","INACTIVE","PENDING"],"maxLength":30},"includeInStatistics":{"description":"Include this season in calculated statistics?","type":"boolean","default":true},"liveVideoAvailable":{"description":"If no 'liveVideoAvailable' flag passed to a new match this value is used","type":"boolean"},"liveDataAvailable":{"description":"If no 'liveDataAvailable' flag passed to a new match this value is used","type":"boolean"},"durationFull":{"description":"If no 'durationFull' is passed to a new match this value is used","type":"integer","format":"int32","default":180,"nullable":true},"discipline":{"description":"If no 'discipline' is passed to a new match this value is used\n>- None None\n>- `INDOOR` Indoor\n>- `OUTDOOR` Outdoor\n","type":"string","enum":["INDOOR","OUTDOOR",null],"nullable":true},"nameLocal":{"description":"The name of the season in the [local](#section/Introduction/Character-Sets-and-Names) language","type":"string","maxLength":150},"nameLatin":{"description":"The name of the season in [latin](#section/Introduction/Character-Sets-and-Names) characters","type":"string","maxLength":150,"nullable":true},"nameShortLocal":{"description":"The abbreviated name of the season in the [local](#section/Introduction/Character-Sets-and-Names) language","type":"string","maxLength":50,"nullable":true},"nameShortLatin":{"description":"The abbreviated name of the season in [latin](#section/Introduction/Character-Sets-and-Names) characters","type":"string","maxLength":50,"nullable":true},"startDate":{"description":"Season start date","type":"string","format":"date"},"endDate":{"description":"Season end date","type":"string","format":"date","nullable":true},"gender":{"description":"The gender of the participants in the season\n>- `FEMALE` Female\n>- `MALE` Male\n>- `MIXED` Mixed\n>- `UNKNOWN` Unknown\n","type":"string","enum":["FEMALE","MALE","MIXED","UNKNOWN"],"maxLength":20},"ageGroup":{"description":"The age group of the season\n>- `JUNIOR` Junior\n>- `MASTERS` Masters\n>- `SENIOR` Senior\n>- `UNDER_15` Under 15\n>- `UNDER_16` Under 16\n>- `UNDER_17` Under 17\n>- `UNDER_18` Under 18\n>- `UNDER_19` Under 19\n>- `UNDER_20` Under 20\n>- `UNDER_21` Under 21\n>- `UNDER_22` Under 22\n>- `UNDER_23` Under 23\n>- `YOUTH` Youth\n","type":"string","enum":["JUNIOR","YOUTH","UNDER_15","UNDER_16","UNDER_17","UNDER_18","UNDER_19","UNDER_20","UNDER_21","UNDER_22","UNDER_23","SENIOR","MASTERS"],"maxLength":50},"standard":{"description":"The playing standard of the season\n>- `ELITE` Professional/elite organisation\n>- `FRIENDLY` International Friendly\n>- `GRASS_ROOT` Normal\n>- `HISTORICAL_BASELINE` Historical Baseline\n>- `INTERNATIONAL` International\n>- `NONCONTINENTAL_CHAMPIONSHIP` Non-continental Championship\n>- `OLYMPIC` Olympics\n>- `REGION` Regional\n>- `TIER2` lesser standard than elite\n>- `TIER3` lesser standard than tier 2\n>- `WORLD_CHAMPIONSHIP` World Championship\n>- `ZONE_CHAMPIONSHIP` International Zone Championship\n","type":"string","enum":["ELITE","FRIENDLY","GRASS_ROOT","INTERNATIONAL","NONCONTINENTAL_CHAMPIONSHIP","OLYMPIC","REGION","TIER2","TIER3","WORLD_CHAMPIONSHIP","ZONE_CHAMPIONSHIP","HISTORICAL_BASELINE"],"maxLength":50},"representation":{"description":"What level are the competitors representing\n>- `CLUB` Club\n>- `COUNTRY` Country\n>- `PERSON` Person\n>- `REGION` Region\n>- `STATE` State\n","type":"string","enum":["CLUB","STATE","REGION","COUNTRY","PERSON"],"maxLength":50},"standingConfigurationId":{"description":"The unique identifier of the ~standingConfiguration~","type":"string","format":"uuid","nullable":true},"lockStandings":{"description":"Is the standings generation locked ?","type":"boolean"},"externalId":{"description":"The Id of the data as set by the provider of the data","type":"string","maxLength":150,"pattern":"^[0-9A-Za-z/_-]+$","nullable":true},"social":{"title":"Social Media","description":"Social Media contacts","type":"object","nullable":true,"additionalProperties":false,"properties":{"website":{"type":"string","nullable":true,"format":"uri"},"facebook":{"type":"string","nullable":true,"format":"uri"},"twitter":{"type":"string","nullable":true,"format":"uri"},"wikipedia":{"type":"string","nullable":true,"format":"uri"},"instagram":{"type":"string","nullable":true,"format":"uri"}}},"configuration":{"title":"Season Configuration","description":"Season Configuration settings","type":"object","nullable":true,"additionalProperties":false,"properties":{"periodBreakDuration":{"type":"number"},"halfTimeDuration":{"type":"number"},"shotClockLength":{"type":"number"},"foulsUntilBonus":{"type":"number"},"foulsAllowedPersonal":{"type":"number"},"foulsAllowedTechnical":{"type":"number"}}},"profileId":{"description":"The profile that this season belongs to","type":"string","format":"uuid","nullable":true},"videoProduction":{"description":"Data synchronization strategy with video production systems\n>- `AUTOMATED` Automated\n>- `MANUAL` Manual\n>- `NONE` None\n","type":"string","enum":["NONE","AUTOMATED","MANUAL"],"maxLength":50,"default":"NONE"},"promotionRelegationRules":{"type":"array","nullable":true,"items":{"type":"object","additionalProperties":false,"required":["ruleType","position","value"],"properties":{"ruleType":{"description":"Rule Type","type":"string","enum":["PROMOTION","RELEGATION"]},"position":{"description":"Standings Position","type":"number"},"value":{"description":"Value to apply to Promotion or Relegation","type":"string"}}}},"rosterConfiguration":{"title":"SEASON ROSTER configuration","description":"Configuration for the SEASON ROSTER","type":"object","nullable":true,"additionalProperties":false,"properties":{"windowOpenDate":{"description":"What date can a SEASON ROSTER be submitted from for this SEASON?","type":"string","nullable":true,"format":"date"},"windowCloseDate":{"description":"What is the last date a SEASON ROSTER can be submitted from for this SEASON?","type":"string","nullable":true,"format":"date"},"seasonRosterLock":{"description":"Make SEASON ROSTERS un-editable when SEASON ROSTER Registration Window Close Date has elapsed.","type":"boolean","nullable":true},"fixtureRosterLock":{"description":"Make FIXTURE ROSTERS un-editable when MATCH Status is set to Scheduled","type":"boolean","nullable":true},"fixtureBibEdit":{"description":"Allow Add/Edit of FIXTURE ROSTERS bib","type":"boolean","nullable":true},"seasonRosterStatusAllowed":{"description":"Season Roster status allowed","type":"array","items":{"type":"string","enum":["ACTIVE","INJURED","OTHER_NOT_PARTICIPATING","OUT","SUSPENDED"]}},"publishSeasonRosterRolesInHours":{"description":"How long before SEASON starts can rosters or roles be published (in hours)","type":"number","nullable":true},"publishFixtureRosterRolesInMinutes":{"description":"How long before a MATCH starts can rosters or roles be published (in minutes)","type":"number","nullable":true}}}},"title":"season put body"}}}}}}}}
```

## Delete a season

> Delete a specific season

```json
{"openapi":"3.0.0","info":{"title":"DataCore API  - Ice Hockey","version":"v1"},"tags":[{"name":"Seasons","description":"Season is a grouping of matches. Generally the season will last a portion of a year (every year).\n\nThe competition can have many seasons, but the season can only belong to one competition.\n\n<img src = \"https://yuml.me/diagram/scruffy;dir:LR/class/[Competitions]-<>[Seasons{bg:orange}],[Seasons]-<>[Matches],[Seasons]->[Stages],[Seasons]->[Pools],[Seasons]->[Rounds],[Matches]-.->[Stages],[Matches]-.->[Pools],[Matches]-.->[Rounds],\">\n\n"}],"servers":[{"url":"https://api.dc.connect.sportradar.com/v1","description":"Production server"},{"url":"https://api.dc.stg.connect-nonprod.sportradar.dev/v1","description":"NonProduction/Staging server"}],"security":[{"OAuth2":["write:organization"]}],"components":{"securitySchemes":{"OAuth2":{"type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"/oauth/token","scopes":{"orgId":"Authenticate based on a specific OrganizationId","read:orggroup":"Read data over multiple organizations using and *orggroup* code","write:organization":"Write/Update any data from below the organization","read:organization":"Read any data from the organization down","write:admin":"Perform administration API calls","write:admin_organization":"Ability to manage organizations","write:system":"Perform system configuration API calls"}}},"description":"You can create a JSON Web Token (JWT) using the [token](http://developer.connect.sportradar.com/token/#operation/getToken) 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."}},"schemas":{"ResponseMetaData":{"type":"object","properties":{"version":{"type":"integer","description":"The version of the API in use for this call"},"codeVersion":{"type":"string","description":"A string indicating the version of the code that handled this request"},"code":{"type":"integer","description":"The HTTP response code for this request"},"time":{"type":"string","format":"date-time","description":"The date/time this request was made (in UTC)."},"fromCache":{"type":"boolean","description":"Was this request served directly from the cache?"},"count":{"type":"integer","description":"The number of records being returned"},"limit":{"type":"integer","description":"The record limit in place for this request"},"offset":{"type":"integer","description":"The record offset in place for this request"},"generationTime":{"type":"number","format":"float","description":"The number of seconds taken to generate this request."}}},"ResponseLinks":{"type":"object","properties":{"self":{"type":"string","format":"uri","description":"The URI referencing this request."},"next":{"type":"string","format":"uri","description":"The URI referencing the 'next' page, if more data is available."},"previous":{"type":"string","format":"uri","description":"The URI referencing the 'previous' page, if the request is not on the first page."}}},"IncludedData":{"type":"object","description":"Available if the request used the 'include' parameter.  It contains extra data about resources found in the data block.","properties":{"resources":{"type":"object","additionalProperties":{"description":"The type of resource","type":"object","enum":["league","organisation","persons"],"additionalProperties":{"type":"object","format":"uuid","description":"The id of the resource","additionalProperties":{"description":"The model for the resource as defined by the type and id"}}}}}},"SeasonsModel":{"type":"object","additionalProperties":false,"properties":{"seasonId":{"description":"The unique identifier of the season","type":"string","format":"uuid"},"organizationId":{"description":"The unique identifier of the organization","type":"string","readOnly":true},"organization":{"properties":{"resourceType":{"type":"string","enum":["organizations"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The organization that this season belongs to","type":"object"},"competitionId":{"description":"The unique identifier of the competition","type":"string","format":"uuid"},"competition":{"properties":{"resourceType":{"type":"string","enum":["competitions"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The competition that this season belongs to","type":"object"},"leaderCriteriaId":{"description":"The unique identifier of the ~LeaderCriteria~","type":"string","format":"uuid","nullable":true},"leadersCriteria":{"properties":{"resourceType":{"type":"string","enum":["leaderCriteria"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The ~LeaderCriteria~ linked to this record","type":"object"},"internationalReference":{"description":"The international reference for this season given by the sport governing body","type":"string","maxLength":30,"nullable":true},"eventType":{"description":"Primary Type of Matches\n>- `FIXTURE` Fixture\n>- `PRACTICE` Practice\n","type":"string","enum":["FIXTURE","PRACTICE"],"maxLength":30,"default":"FIXTURE"},"seasonType":{"description":"The type of matches added to this season\n>- `MULTI_YEAR_HISTORICAL` Mulit-Year Historical\n>- `ONE_OFF` One off\n>- `PRESEASON` Pre Season\n>- `SEASON` Season\n>- `TOURNAMENT` Tournament\n","type":"string","enum":["SEASON","TOURNAMENT","ONE_OFF","PRESEASON","MULTI_YEAR_HISTORICAL"],"maxLength":30},"year":{"description":"Year of the season","type":"integer","format":"int32","maxLength":4},"grade":{"description":"The playing grade of the matches in this season","type":"string","maxLength":50,"nullable":true},"status":{"description":"Status\n>- `ACTIVE` Active\n>- `COMPLETE` Complete\n>- `DRAFT` Draft\n>- `INACTIVE` Inactive\n>- `PENDING` Pending\n","type":"string","enum":["ACTIVE","COMPLETE","DRAFT","INACTIVE","PENDING"],"maxLength":30},"includeInStatistics":{"description":"Include this season in calculated statistics?","type":"boolean","default":true},"liveVideoAvailable":{"description":"If no 'liveVideoAvailable' flag passed to a new match this value is used","type":"boolean"},"liveDataAvailable":{"description":"If no 'liveDataAvailable' flag passed to a new match this value is used","type":"boolean"},"durationFull":{"description":"If no 'durationFull' is passed to a new match this value is used","type":"integer","format":"int32","default":180,"nullable":true},"discipline":{"description":"If no 'discipline' is passed to a new match this value is used\n>- None None\n>- `INDOOR` Indoor\n>- `OUTDOOR` Outdoor\n","type":"string","enum":["INDOOR","OUTDOOR",null],"nullable":true},"nameLocal":{"description":"The name of the season in the [local](#section/Introduction/Character-Sets-and-Names) language","type":"string","maxLength":150},"nameLatin":{"description":"The name of the season in [latin](#section/Introduction/Character-Sets-and-Names) characters","type":"string","maxLength":150,"nullable":true},"nameShortLocal":{"description":"The abbreviated name of the season in the [local](#section/Introduction/Character-Sets-and-Names) language","type":"string","maxLength":50,"nullable":true},"nameShortLatin":{"description":"The abbreviated name of the season in [latin](#section/Introduction/Character-Sets-and-Names) characters","type":"string","maxLength":50,"nullable":true},"startDate":{"description":"Season start date","type":"string","format":"date"},"endDate":{"description":"Season end date","type":"string","format":"date","nullable":true},"gender":{"description":"The gender of the participants in the season\n>- `FEMALE` Female\n>- `MALE` Male\n>- `MIXED` Mixed\n>- `UNKNOWN` Unknown\n","type":"string","enum":["FEMALE","MALE","MIXED","UNKNOWN"],"maxLength":20},"ageGroup":{"description":"The age group of the season\n>- `JUNIOR` Junior\n>- `MASTERS` Masters\n>- `SENIOR` Senior\n>- `UNDER_15` Under 15\n>- `UNDER_16` Under 16\n>- `UNDER_17` Under 17\n>- `UNDER_18` Under 18\n>- `UNDER_19` Under 19\n>- `UNDER_20` Under 20\n>- `UNDER_21` Under 21\n>- `UNDER_22` Under 22\n>- `UNDER_23` Under 23\n>- `YOUTH` Youth\n","type":"string","enum":["JUNIOR","YOUTH","UNDER_15","UNDER_16","UNDER_17","UNDER_18","UNDER_19","UNDER_20","UNDER_21","UNDER_22","UNDER_23","SENIOR","MASTERS"],"maxLength":50},"standard":{"description":"The playing standard of the season\n>- `ELITE` Professional/elite organisation\n>- `FRIENDLY` International Friendly\n>- `GRASS_ROOT` Normal\n>- `HISTORICAL_BASELINE` Historical Baseline\n>- `INTERNATIONAL` International\n>- `NONCONTINENTAL_CHAMPIONSHIP` Non-continental Championship\n>- `OLYMPIC` Olympics\n>- `REGION` Regional\n>- `TIER2` lesser standard than elite\n>- `TIER3` lesser standard than tier 2\n>- `WORLD_CHAMPIONSHIP` World Championship\n>- `ZONE_CHAMPIONSHIP` International Zone Championship\n","type":"string","enum":["ELITE","FRIENDLY","GRASS_ROOT","INTERNATIONAL","NONCONTINENTAL_CHAMPIONSHIP","OLYMPIC","REGION","TIER2","TIER3","WORLD_CHAMPIONSHIP","ZONE_CHAMPIONSHIP","HISTORICAL_BASELINE"],"maxLength":50},"representation":{"description":"What level are the competitors representing\n>- `CLUB` Club\n>- `COUNTRY` Country\n>- `PERSON` Person\n>- `REGION` Region\n>- `STATE` State\n","type":"string","enum":["CLUB","STATE","REGION","COUNTRY","PERSON"],"maxLength":50},"standingConfigurationId":{"description":"The unique identifier of the ~standingConfiguration~","type":"string","format":"uuid","nullable":true},"standingConfiguration":{"properties":{"resourceType":{"type":"string","enum":["standingConfigurations"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The ~standingConfiguration~ that this season belongs to","type":"object"},"lockStandings":{"description":"Is the standings generation locked ?","type":"boolean"},"externalId":{"description":"The Id of the data as set by the provider of the data","type":"string","maxLength":150,"pattern":"^[0-9A-Za-z/_-]+$","nullable":true},"social":{"title":"Social Media","description":"Social Media contacts","type":"object","nullable":true,"additionalProperties":false,"properties":{"website":{"type":"string","nullable":true,"format":"uri"},"facebook":{"type":"string","nullable":true,"format":"uri"},"twitter":{"type":"string","nullable":true,"format":"uri"},"wikipedia":{"type":"string","nullable":true,"format":"uri"},"instagram":{"type":"string","nullable":true,"format":"uri"}}},"configuration":{"title":"Season Configuration","description":"Season Configuration settings","type":"object","nullable":true,"additionalProperties":false,"properties":{"periodBreakDuration":{"type":"number"},"halfTimeDuration":{"type":"number"},"shotClockLength":{"type":"number"},"foulsUntilBonus":{"type":"number"},"foulsAllowedPersonal":{"type":"number"},"foulsAllowedTechnical":{"type":"number"}}},"profileId":{"description":"The profile that this season belongs to","type":"string","format":"uuid","nullable":true},"fixtureProfile":{"properties":{"resourceType":{"type":"string","enum":["fixtureProfiles"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The profile that this season belongs to","type":"object"},"updated":{"description":"Date/time last modified. In UTC","type":"string","format":"date-time","readOnly":true},"added":{"description":"Date/time added. In UTC","type":"string","format":"date-time","readOnly":true},"images":{"type":"array","items":{"$ref":"#/components/schemas/ImagesModel"}},"videoProduction":{"description":"Data synchronization strategy with video production systems\n>- `AUTOMATED` Automated\n>- `MANUAL` Manual\n>- `NONE` None\n","type":"string","enum":["NONE","AUTOMATED","MANUAL"],"maxLength":50,"default":"NONE"},"promotionRelegationRules":{"type":"array","nullable":true,"items":{"type":"object","additionalProperties":false,"required":["ruleType","position","value"],"properties":{"ruleType":{"description":"Rule Type","type":"string","enum":["PROMOTION","RELEGATION"]},"position":{"description":"Standings Position","type":"number"},"value":{"description":"Value to apply to Promotion or Relegation","type":"string"}}}},"rosterConfiguration":{"title":"SEASON ROSTER configuration","description":"Configuration for the SEASON ROSTER","type":"object","nullable":true,"additionalProperties":false,"properties":{"windowOpenDate":{"description":"What date can a SEASON ROSTER be submitted from for this SEASON?","type":"string","nullable":true,"format":"date"},"windowCloseDate":{"description":"What is the last date a SEASON ROSTER can be submitted from for this SEASON?","type":"string","nullable":true,"format":"date"},"seasonRosterLock":{"description":"Make SEASON ROSTERS un-editable when SEASON ROSTER Registration Window Close Date has elapsed.","type":"boolean","nullable":true},"fixtureRosterLock":{"description":"Make FIXTURE ROSTERS un-editable when MATCH Status is set to Scheduled","type":"boolean","nullable":true},"fixtureBibEdit":{"description":"Allow Add/Edit of FIXTURE ROSTERS bib","type":"boolean","nullable":true},"seasonRosterStatusAllowed":{"description":"Season Roster status allowed","type":"array","items":{"type":"string","enum":["ACTIVE","INJURED","OTHER_NOT_PARTICIPATING","OUT","SUSPENDED"]}},"publishSeasonRosterRolesInHours":{"description":"How long before SEASON starts can rosters or roles be published (in hours)","type":"number","nullable":true},"publishFixtureRosterRolesInMinutes":{"description":"How long before a MATCH starts can rosters or roles be published (in minutes)","type":"number","nullable":true}}}},"title":"season model"},"ImagesModel":{"type":"object","additionalProperties":false,"properties":{"imageId":{"description":"The unique identifier of the image record","type":"string","format":"uuid","readOnly":true},"organizationId":{"description":"The unique identifier of the organization","type":"string","readOnly":true},"organization":{"properties":{"resourceType":{"type":"string","enum":["organizations"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The organization that this images belongs to","type":"object"},"baseType":{"description":"The object that this image relates to\n>- `COMPETITION` Competition\n>- `CONFERENCE` Conference\n>- `DIVISION` Division\n>- `ENTITY` Entity\n>- `ENTITYGROUP` Entity Group\n>- `LEAGUE` League\n>- `ORGANIZATION` Organization\n>- `PERSON` Person\n>- `SEASON` Season\n>- `UNIFORM` Uniform\n>- `UNIFORM_ITEM` Uniform Item\n","type":"string","enum":["PERSON","ENTITY","ENTITYGROUP","COMPETITION","SEASON","LEAGUE","ORGANIZATION","DIVISION","CONFERENCE","UNIFORM","UNIFORM_ITEM"],"maxLength":100},"baseId":{"description":"The unique identifier of the object associated with this image's record. If the `baseType` is `PERSON` then this would be the value of `personId`.","type":"string","format":"uuid"},"fileType":{"description":"The type of file\n>- `JPG` jpg\n>- `PNG` png\n>- `SVG` svg\n","type":"string","enum":["JPG","PNG","SVG"],"maxLength":3,"readOnly":true},"imageType":{"description":"Upload Type\n>- `LOGO` Logo - Not valid for 'PERSON' baseType\n>- `LOGO_ALTERNATE` Logo (alternate) - Not valid for 'PERSON' baseType\n>- `LOGO_BACKGROUND` Stylised logo for background purposes - Not valid for 'PERSON' baseType\n>- `PERSON_HEAD` Head shot (shoulders and head) - Only valid for 'PERSON' baseType\n>- `PERSON_POSE` Person posing - Only valid for 'PERSON' baseType\n>- `PERSON_WAIST` Head shot from the waist up - Only valid for 'PERSON' baseType\n>- `TEAM_PHOTO` Team Photo - Only valid for 'ENTITY' baseType\n>- `UNIFORM` Uniform\n>- `UNIFORM_ITEM` Uniform Item\n","type":"string","enum":["LOGO","LOGO_ALTERNATE","LOGO_BACKGROUND","PERSON_HEAD","PERSON_WAIST","PERSON_POSE","TEAM_PHOTO","UNIFORM","UNIFORM_ITEM"],"maxLength":100},"secondaryType":{"description":"If the image relates to a secondary object. Such as a photo of a person in a team, then baseType would be PERSON and secondaryType would be TEAM.\n>- None None\n>- `COMPETITION` Competition\n>- `CONFERENCE` Conference\n>- `DIVISION` Division\n>- `ENTITY` Entity\n>- `ENTITYGROUP` Entity Group\n>- `LEAGUE` League\n>- `SEASON` Season\n","type":"string","enum":["ENTITY","ENTITYGROUP","COMPETITION","SEASON","LEAGUE","DIVISION","CONFERENCE",null],"maxLength":100,"nullable":true},"secondaryId":{"description":"The unique identifier of the object associated with the secondaryType","type":"string","format":"uuid"},"rating":{"description":"The rating given to the quality of the image.  All images are LOW by default but are set ad MEDIUM if they are large enough and have transparency.  Images are only marked as HIGH if they have been manually reviewed.  You should take your use-case into account when you go to use the image.\n>- `HIGH` High\n>- `LOW` Low\n>- `MEDIUM` Medium\n","type":"string","enum":["LOW","MEDIUM","HIGH"],"maxLength":100,"readOnly":true},"url":{"description":"The URL of the image. See [Images](#section/Introduction/Images) for more information.","type":"string","readOnly":true},"maximumHeight":{"description":"The maximum height (in pixels) of this image.","type":"integer","format":"int32","readOnly":true},"maximumWidth":{"description":"The maximum width (in pixels) of this image.","type":"integer","format":"int32","readOnly":true},"updated":{"description":"Date/time last modified. In UTC","type":"string","format":"date-time","readOnly":true},"added":{"description":"Date/time added. In UTC","type":"string","format":"date-time","readOnly":true}},"title":"images model"},"ErrorModel":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP Error code indicating the type of error.  If there are multiple errors, then this will be the code of the first one.","format":"int32"},"message":{"type":"string","description":"A message indicating the reason for the error. If there are multiple errors, then this is the message for the first one."},"errors":{"type":"array","items":{"$ref":"#/components/schemas/ErrorListModel"}}}},"ErrorListModel":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP Error code indicating the type of error.","format":"int32"},"reason":{"enum":["INVALID_DATA","NOT_FOUND","NOT_AUTHORISED","ERROR","DELETE_ERROR"],"description":"A short code indicating the type of error"},"message":{"type":"string","description":"A message indicating the reason for the error"},"rowNumber":{"type":"integer","description":"The row number of the payload that cause the error","format":"int32"}}}},"responses":{"ErrorResponse":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"meta":{"$ref":"#/components/schemas/ResponseMetaData"},"error":{"$ref":"#/components/schemas/ErrorModel"}}}}}}},"parameters":{"external":{"name":"external","description":"A comma separated list of fields that will instead be interpreted as an externalId. See [External Ids](#section/Introduction/External-Ids) for more information.","schema":{"type":"string"},"required":false,"in":"query"},"fields":{"name":"fields","description":"A comma separated list of fields to display.  The response will only display these fields. See [Partial Response](#section/Partial-Response) section for more information.","schema":{"type":"string"},"required":false,"in":"query"},"forceDelete":{"name":"forceDelete","description":"Force a delete command to run and delete child records as well if there are existing records depending on the record.","schema":{"type":"boolean"},"required":false,"in":"query"},"hideNull":{"name":"hideNull","description":"Don't display data fields with null values or empty structures","schema":{"type":"boolean"},"required":false,"in":"query"},"include":{"name":"include","description":"A comma separated list of resource types to include. See [Resource Inclusion](#section/Introduction/Resource-Inclusion) for more information.","schema":{"type":"string"},"required":false,"in":"query"}}},"paths":{"/icehockey/o/{organizationId}/seasons/{seasonId}":{"delete":{"tags":["Seasons"],"summary":"Delete a season","description":"Delete a specific season","operationId":"season_delete","responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","title":"Seasons Response","properties":{"meta":{"$ref":"#/components/schemas/ResponseMetaData"},"links":{"$ref":"#/components/schemas/ResponseLinks"},"included":{"$ref":"#/components/schemas/IncludedData"},"data":{"type":"array","description":"","items":{"$ref":"#/components/schemas/SeasonsModel"}}}}}}},"default":{"$ref":"#/components/responses/ErrorResponse"}},"parameters":[{"$ref":"#/components/parameters/external"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/forceDelete"},{"$ref":"#/components/parameters/hideNull"},{"$ref":"#/components/parameters/include"},{"name":"organizationId","description":"The unique identifier of the organization","schema":{"type":"string","minLength":5,"maxLength":5},"required":true,"in":"path"},{"name":"seasonId","description":"The unique identifier of the season","schema":{"type":"string","format":"uuid"},"required":true,"in":"path"}]}}}}
```
