# Season Series

A series is a collection of matches inside a season where specific teams play each other multiple times. A series for example can be a Best-Of 7.

## Get a list of series

> Return a list of series for a season

```json
{"openapi":"3.0.0","info":{"title":"DataCore API  - Badminton","version":"v1"},"tags":[{"name":"Season Series","description":"A series is a collection of matches inside a season where specific teams play each other multiple times.  A series for example can be a Best-Of 7.\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"}}}}}},"Season_SeriesModel":{"type":"object","additionalProperties":false,"properties":{"seriesCode":{"description":"A unique code for the season series. (Unique for season)","type":"string","maxLength":30},"seasonId":{"description":"The unique identifier of the season","type":"string","format":"uuid"},"season":{"properties":{"resourceType":{"type":"string","enum":["seasons"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The season linked to this record","type":"object"},"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 series belongs to","type":"object"},"conferenceId":{"description":"The unique identifier of the conference","type":"string","format":"uuid","nullable":true},"conference":{"properties":{"resourceType":{"type":"string","enum":["conferences"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The conference information","type":"object"},"divisionId":{"description":"The unique identifier of the division","type":"string","format":"uuid","nullable":true},"division":{"properties":{"resourceType":{"type":"string","enum":["divisions"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The division information","type":"object"},"nameLocal":{"description":"The name of the series in the [local](#section/Introduction/Character-Sets-and-Names) language","type":"string","maxLength":150},"abbreviationLocal":{"description":"An abbreviation/short name in the [local](#section/Introduction/Character-Sets-and-Names) language","type":"string","maxLength":50,"nullable":true},"nameLatin":{"description":"The name of the series in [latin](#section/Introduction/Character-Sets-and-Names) characters","type":"string","maxLength":150,"nullable":true},"abbreviationLatin":{"description":"An abbreviation/short name in [latin](#section/Introduction/Character-Sets-and-Names) characters","type":"string","maxLength":50,"nullable":true},"status":{"description":"Status\n>- `ACTIVE` Active\n>- `COMPLETE` Complete\n>- `NOT_STARTED` Not Started\n","type":"string","enum":["NOT_STARTED","ACTIVE","COMPLETE"],"maxLength":30},"seriesType":{"description":"The type of series\n>- `BEST_OF` Best of\n>- `HOME_AND_AWAY` Home and Away\n>- `KNOCKOUT` Knockout\n","type":"string","enum":["BEST_OF","HOME_AND_AWAY","KNOCKOUT"],"maxLength":50},"autoCalculated":{"description":"Is the winner auto calculated?","type":"boolean"},"bestOf":{"description":"Best of number","type":"integer","format":"int32","maxLength":3,"nullable":true},"seriesNumber":{"description":"User defined series number","type":"integer","format":"int32","maxLength":3,"nullable":true},"maxFixturesNumber":{"description":"The maximum number of games within a playoff series","type":"integer","format":"int32","nullable":true},"winner":{"description":"The unique identifier of the winner, person or entity","type":"string","format":"uuid","nullable":true},"seriesOrder":{"description":"User defined sort order of the series","type":"integer","format":"int32","maxLength":3,"nullable":true},"stageCode":{"description":"A unique code for the stage. (Unique for season)","type":"string","maxLength":30,"nullable":true},"stage":{"properties":{"resourceType":{"type":"string","enum":["seasonStages"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The stage that is related to this record","type":"object"},"poolCode":{"description":"A unique code for the pool. (Unique for season)","type":"string","maxLength":30,"nullable":true},"pool":{"properties":{"resourceType":{"type":"string","enum":["seasonPools"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The pool that is related to this record","type":"object"},"startDate":{"description":"Series start date","type":"string","format":"date","nullable":true},"endDate":{"description":"Series end date","type":"string","format":"date","nullable":true},"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},"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},"competitors":{"type":"array","nullable":true,"title":"Season series competitors","description":"Array of competitors in the series. A competitor may have a results and a ranking","items":{"type":"object","title":"Season series competitor","additionalProperties":false,"properties":{"entityId":{"description":"The uuid of the entity","type":"string"},"personId":{"description":"The uuid of the person","type":"string"},"conferenceId":{"description":"The uuid of the conference the competitor represents","type":"string"},"divisionId":{"description":"The uuid of the conference the competitor represents","type":"string"},"preSeriesRanking":{"description":"The rank of the competitor coming into the series","type":"number"},"stringRecord":{"description":"String record of the competitor","type":"number"},"seriesWins":{"description":"Number of wins in the series for the competitor","type":"number"},"seriesLosses":{"description":"Number of losses in the series for the competitor","type":"number"},"seriesDraws":{"description":"Number of draws in the series for the competitor","type":"number"},"seriesResult":{"description":"Result for the competitor in the series","type":"string","enum":["PENDING","WON","LOST","DRAW"]}}}}},"title":"series 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"},"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"},"includeTotalCount":{"name":"includeTotalCount","description":"Include the total number of records matching the filters.","schema":{"type":"boolean"},"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"},"poolCode":{"name":"poolCode","description":"The pool identifier within a season","schema":{"type":"string","maxLength":30},"required":false,"in":"query"},"seriesCodeContains":{"name":"seriesCodeContains","description":"Fields that allow a 'Contains' query string parameter search for words separated by a space, matching characters left to right. Example: seriesCode=Series 001seriesCodeContains=Ser will match seriesCodeContains=001 will match seriesCodeContains=ies will not match","schema":{"type":"string","minLength":2,"maxLength":50},"required":false,"in":"query"},"seriesType":{"name":"seriesType","description":"The type of series. Multiple allowed (comma-delimited).\n>- `BEST_OF` Best of\n>- `HOME_AND_AWAY` Home and Away\n>- `KNOCKOUT` Knockout\n","schema":{"type":"string","enum":["BEST_OF","HOME_AND_AWAY","KNOCKOUT"],"maxLength":50},"required":false,"in":"query"},"stageCode":{"name":"stageCode","description":"The stage identifier within a season","schema":{"type":"string","maxLength":30},"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"}}},"paths":{"/badminton/o/{organizationId}/seasons/{seasonId}/series":{"get":{"tags":["Season Series"],"summary":"Get a list of series","description":"Return a list of series for a season","operationId":"season_series_list","responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","title":"Season_Series 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/Season_SeriesModel"}}}}}}},"default":{"$ref":"#/components/responses/ErrorResponse"}},"parameters":[{"$ref":"#/components/parameters/added"},{"$ref":"#/components/parameters/external"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/hideNull"},{"$ref":"#/components/parameters/include"},{"$ref":"#/components/parameters/includeTotalCount"},{"$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/poolCode"},{"name":"seasonId","description":"The unique identifier of the season","schema":{"type":"string","format":"uuid"},"required":true,"in":"path"},{"$ref":"#/components/parameters/seriesCodeContains"},{"$ref":"#/components/parameters/seriesType"},{"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|,)*$"},"required":false,"in":"query"},{"$ref":"#/components/parameters/stageCode"},{"$ref":"#/components/parameters/updated"}]}}}}
```

## Create a series

> Add a new series in a season

```json
{"openapi":"3.0.0","info":{"title":"DataCore API  - Badminton","version":"v1"},"tags":[{"name":"Season Series","description":"A series is a collection of matches inside a season where specific teams play each other multiple times.  A series for example can be a Best-Of 7.\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"}}}}}},"Season_SeriesModel":{"type":"object","additionalProperties":false,"properties":{"seriesCode":{"description":"A unique code for the season series. (Unique for season)","type":"string","maxLength":30},"seasonId":{"description":"The unique identifier of the season","type":"string","format":"uuid"},"season":{"properties":{"resourceType":{"type":"string","enum":["seasons"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The season linked to this record","type":"object"},"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 series belongs to","type":"object"},"conferenceId":{"description":"The unique identifier of the conference","type":"string","format":"uuid","nullable":true},"conference":{"properties":{"resourceType":{"type":"string","enum":["conferences"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The conference information","type":"object"},"divisionId":{"description":"The unique identifier of the division","type":"string","format":"uuid","nullable":true},"division":{"properties":{"resourceType":{"type":"string","enum":["divisions"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The division information","type":"object"},"nameLocal":{"description":"The name of the series in the [local](#section/Introduction/Character-Sets-and-Names) language","type":"string","maxLength":150},"abbreviationLocal":{"description":"An abbreviation/short name in the [local](#section/Introduction/Character-Sets-and-Names) language","type":"string","maxLength":50,"nullable":true},"nameLatin":{"description":"The name of the series in [latin](#section/Introduction/Character-Sets-and-Names) characters","type":"string","maxLength":150,"nullable":true},"abbreviationLatin":{"description":"An abbreviation/short name in [latin](#section/Introduction/Character-Sets-and-Names) characters","type":"string","maxLength":50,"nullable":true},"status":{"description":"Status\n>- `ACTIVE` Active\n>- `COMPLETE` Complete\n>- `NOT_STARTED` Not Started\n","type":"string","enum":["NOT_STARTED","ACTIVE","COMPLETE"],"maxLength":30},"seriesType":{"description":"The type of series\n>- `BEST_OF` Best of\n>- `HOME_AND_AWAY` Home and Away\n>- `KNOCKOUT` Knockout\n","type":"string","enum":["BEST_OF","HOME_AND_AWAY","KNOCKOUT"],"maxLength":50},"autoCalculated":{"description":"Is the winner auto calculated?","type":"boolean"},"bestOf":{"description":"Best of number","type":"integer","format":"int32","maxLength":3,"nullable":true},"seriesNumber":{"description":"User defined series number","type":"integer","format":"int32","maxLength":3,"nullable":true},"maxFixturesNumber":{"description":"The maximum number of games within a playoff series","type":"integer","format":"int32","nullable":true},"winner":{"description":"The unique identifier of the winner, person or entity","type":"string","format":"uuid","nullable":true},"seriesOrder":{"description":"User defined sort order of the series","type":"integer","format":"int32","maxLength":3,"nullable":true},"stageCode":{"description":"A unique code for the stage. (Unique for season)","type":"string","maxLength":30,"nullable":true},"stage":{"properties":{"resourceType":{"type":"string","enum":["seasonStages"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The stage that is related to this record","type":"object"},"poolCode":{"description":"A unique code for the pool. (Unique for season)","type":"string","maxLength":30,"nullable":true},"pool":{"properties":{"resourceType":{"type":"string","enum":["seasonPools"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The pool that is related to this record","type":"object"},"startDate":{"description":"Series start date","type":"string","format":"date","nullable":true},"endDate":{"description":"Series end date","type":"string","format":"date","nullable":true},"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},"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},"competitors":{"type":"array","nullable":true,"title":"Season series competitors","description":"Array of competitors in the series. A competitor may have a results and a ranking","items":{"type":"object","title":"Season series competitor","additionalProperties":false,"properties":{"entityId":{"description":"The uuid of the entity","type":"string"},"personId":{"description":"The uuid of the person","type":"string"},"conferenceId":{"description":"The uuid of the conference the competitor represents","type":"string"},"divisionId":{"description":"The uuid of the conference the competitor represents","type":"string"},"preSeriesRanking":{"description":"The rank of the competitor coming into the series","type":"number"},"stringRecord":{"description":"String record of the competitor","type":"number"},"seriesWins":{"description":"Number of wins in the series for the competitor","type":"number"},"seriesLosses":{"description":"Number of losses in the series for the competitor","type":"number"},"seriesDraws":{"description":"Number of draws in the series for the competitor","type":"number"},"seriesResult":{"description":"Result for the competitor in the series","type":"string","enum":["PENDING","WON","LOST","DRAW"]}}}}},"title":"series 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":{"/badminton/o/{organizationId}/seasons/{seasonId}/series":{"post":{"tags":["Season Series"],"summary":"Create a series","description":"Add a new series in a season","operationId":"season_series_insert","responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","title":"Season_Series 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/Season_SeriesModel"}}}}}}},"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":{"seriesCode":{"description":"A unique code for the season series. (Unique for season)","type":"string","maxLength":30},"seasonId":{"description":"The unique identifier of the season","type":"string","format":"uuid"},"conferenceId":{"description":"The unique identifier of the conference","type":"string","format":"uuid","nullable":true},"divisionId":{"description":"The unique identifier of the division","type":"string","format":"uuid","nullable":true},"nameLocal":{"description":"The name of the series in the [local](#section/Introduction/Character-Sets-and-Names) language","type":"string","maxLength":150},"abbreviationLocal":{"description":"An abbreviation/short name in the [local](#section/Introduction/Character-Sets-and-Names) language","type":"string","maxLength":50,"nullable":true},"nameLatin":{"description":"The name of the series in [latin](#section/Introduction/Character-Sets-and-Names) characters","type":"string","maxLength":150,"nullable":true},"abbreviationLatin":{"description":"An abbreviation/short name in [latin](#section/Introduction/Character-Sets-and-Names) characters","type":"string","maxLength":50,"nullable":true},"status":{"description":"Status\n>- `ACTIVE` Active\n>- `COMPLETE` Complete\n>- `NOT_STARTED` Not Started\n","type":"string","enum":["NOT_STARTED","ACTIVE","COMPLETE"],"maxLength":30},"seriesType":{"description":"The type of series\n>- `BEST_OF` Best of\n>- `HOME_AND_AWAY` Home and Away\n>- `KNOCKOUT` Knockout\n","type":"string","enum":["BEST_OF","HOME_AND_AWAY","KNOCKOUT"],"maxLength":50},"autoCalculated":{"description":"Is the winner auto calculated?","type":"boolean"},"bestOf":{"description":"Best of number","type":"integer","format":"int32","maxLength":3,"nullable":true},"seriesNumber":{"description":"User defined series number","type":"integer","format":"int32","maxLength":3,"nullable":true},"maxFixturesNumber":{"description":"The maximum number of games within a playoff series","type":"integer","format":"int32","nullable":true},"winner":{"description":"The unique identifier of the winner, person or entity","type":"string","format":"uuid","nullable":true},"seriesOrder":{"description":"User defined sort order of the series","type":"integer","format":"int32","maxLength":3,"nullable":true},"stageCode":{"description":"A unique code for the stage. (Unique for season)","type":"string","maxLength":30,"nullable":true},"poolCode":{"description":"A unique code for the pool. (Unique for season)","type":"string","maxLength":30,"nullable":true},"startDate":{"description":"Series start date","type":"string","format":"date","nullable":true},"endDate":{"description":"Series end date","type":"string","format":"date","nullable":true},"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},"competitors":{"type":"array","nullable":true,"title":"Season series competitors","description":"Array of competitors in the series. A competitor may have a results and a ranking","items":{"type":"object","title":"Season series competitor","additionalProperties":false,"properties":{"entityId":{"description":"The uuid of the entity","type":"string"},"personId":{"description":"The uuid of the person","type":"string"},"conferenceId":{"description":"The uuid of the conference the competitor represents","type":"string"},"divisionId":{"description":"The uuid of the conference the competitor represents","type":"string"},"preSeriesRanking":{"description":"The rank of the competitor coming into the series","type":"number"},"stringRecord":{"description":"String record of the competitor","type":"number"},"seriesWins":{"description":"Number of wins in the series for the competitor","type":"number"},"seriesLosses":{"description":"Number of losses in the series for the competitor","type":"number"},"seriesDraws":{"description":"Number of draws in the series for the competitor","type":"number"},"seriesResult":{"description":"Result for the competitor in the series","type":"string","enum":["PENDING","WON","LOST","DRAW"]}}}}},"title":"series post body","required":["seriesCode","seasonId","nameLocal","status","seriesType"]}}}}}}}}
```

## Get a series

> Return detailed information about a specific season series

```json
{"openapi":"3.0.0","info":{"title":"DataCore API  - Badminton","version":"v1"},"tags":[{"name":"Season Series","description":"A series is a collection of matches inside a season where specific teams play each other multiple times.  A series for example can be a Best-Of 7.\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"}}}}}},"Season_SeriesModel":{"type":"object","additionalProperties":false,"properties":{"seriesCode":{"description":"A unique code for the season series. (Unique for season)","type":"string","maxLength":30},"seasonId":{"description":"The unique identifier of the season","type":"string","format":"uuid"},"season":{"properties":{"resourceType":{"type":"string","enum":["seasons"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The season linked to this record","type":"object"},"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 series belongs to","type":"object"},"conferenceId":{"description":"The unique identifier of the conference","type":"string","format":"uuid","nullable":true},"conference":{"properties":{"resourceType":{"type":"string","enum":["conferences"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The conference information","type":"object"},"divisionId":{"description":"The unique identifier of the division","type":"string","format":"uuid","nullable":true},"division":{"properties":{"resourceType":{"type":"string","enum":["divisions"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The division information","type":"object"},"nameLocal":{"description":"The name of the series in the [local](#section/Introduction/Character-Sets-and-Names) language","type":"string","maxLength":150},"abbreviationLocal":{"description":"An abbreviation/short name in the [local](#section/Introduction/Character-Sets-and-Names) language","type":"string","maxLength":50,"nullable":true},"nameLatin":{"description":"The name of the series in [latin](#section/Introduction/Character-Sets-and-Names) characters","type":"string","maxLength":150,"nullable":true},"abbreviationLatin":{"description":"An abbreviation/short name in [latin](#section/Introduction/Character-Sets-and-Names) characters","type":"string","maxLength":50,"nullable":true},"status":{"description":"Status\n>- `ACTIVE` Active\n>- `COMPLETE` Complete\n>- `NOT_STARTED` Not Started\n","type":"string","enum":["NOT_STARTED","ACTIVE","COMPLETE"],"maxLength":30},"seriesType":{"description":"The type of series\n>- `BEST_OF` Best of\n>- `HOME_AND_AWAY` Home and Away\n>- `KNOCKOUT` Knockout\n","type":"string","enum":["BEST_OF","HOME_AND_AWAY","KNOCKOUT"],"maxLength":50},"autoCalculated":{"description":"Is the winner auto calculated?","type":"boolean"},"bestOf":{"description":"Best of number","type":"integer","format":"int32","maxLength":3,"nullable":true},"seriesNumber":{"description":"User defined series number","type":"integer","format":"int32","maxLength":3,"nullable":true},"maxFixturesNumber":{"description":"The maximum number of games within a playoff series","type":"integer","format":"int32","nullable":true},"winner":{"description":"The unique identifier of the winner, person or entity","type":"string","format":"uuid","nullable":true},"seriesOrder":{"description":"User defined sort order of the series","type":"integer","format":"int32","maxLength":3,"nullable":true},"stageCode":{"description":"A unique code for the stage. (Unique for season)","type":"string","maxLength":30,"nullable":true},"stage":{"properties":{"resourceType":{"type":"string","enum":["seasonStages"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The stage that is related to this record","type":"object"},"poolCode":{"description":"A unique code for the pool. (Unique for season)","type":"string","maxLength":30,"nullable":true},"pool":{"properties":{"resourceType":{"type":"string","enum":["seasonPools"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The pool that is related to this record","type":"object"},"startDate":{"description":"Series start date","type":"string","format":"date","nullable":true},"endDate":{"description":"Series end date","type":"string","format":"date","nullable":true},"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},"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},"competitors":{"type":"array","nullable":true,"title":"Season series competitors","description":"Array of competitors in the series. A competitor may have a results and a ranking","items":{"type":"object","title":"Season series competitor","additionalProperties":false,"properties":{"entityId":{"description":"The uuid of the entity","type":"string"},"personId":{"description":"The uuid of the person","type":"string"},"conferenceId":{"description":"The uuid of the conference the competitor represents","type":"string"},"divisionId":{"description":"The uuid of the conference the competitor represents","type":"string"},"preSeriesRanking":{"description":"The rank of the competitor coming into the series","type":"number"},"stringRecord":{"description":"String record of the competitor","type":"number"},"seriesWins":{"description":"Number of wins in the series for the competitor","type":"number"},"seriesLosses":{"description":"Number of losses in the series for the competitor","type":"number"},"seriesDraws":{"description":"Number of draws in the series for the competitor","type":"number"},"seriesResult":{"description":"Result for the competitor in the series","type":"string","enum":["PENDING","WON","LOST","DRAW"]}}}}},"title":"series 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"},"includeTotalCount":{"name":"includeTotalCount","description":"Include the total number of records matching the filters.","schema":{"type":"boolean"},"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":{"/badminton/o/{organizationId}/seasons/{seasonId}/series/{seriesCode}":{"get":{"tags":["Season Series"],"summary":"Get a series","description":"Return detailed information about a specific season series","operationId":"season_series_detail","responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","title":"Season_Series 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/Season_SeriesModel"}}}}}}},"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/includeTotalCount"},{"$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"},{"name":"seriesCode","description":"The series identifier within a season","schema":{"type":"string","maxLength":30},"required":true,"in":"path"}]}}}}
```

## Update a series

> Change the information of a specific season series

```json
{"openapi":"3.0.0","info":{"title":"DataCore API  - Badminton","version":"v1"},"tags":[{"name":"Season Series","description":"A series is a collection of matches inside a season where specific teams play each other multiple times.  A series for example can be a Best-Of 7.\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"}}}}}},"Season_SeriesModel":{"type":"object","additionalProperties":false,"properties":{"seriesCode":{"description":"A unique code for the season series. (Unique for season)","type":"string","maxLength":30},"seasonId":{"description":"The unique identifier of the season","type":"string","format":"uuid"},"season":{"properties":{"resourceType":{"type":"string","enum":["seasons"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The season linked to this record","type":"object"},"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 series belongs to","type":"object"},"conferenceId":{"description":"The unique identifier of the conference","type":"string","format":"uuid","nullable":true},"conference":{"properties":{"resourceType":{"type":"string","enum":["conferences"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The conference information","type":"object"},"divisionId":{"description":"The unique identifier of the division","type":"string","format":"uuid","nullable":true},"division":{"properties":{"resourceType":{"type":"string","enum":["divisions"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The division information","type":"object"},"nameLocal":{"description":"The name of the series in the [local](#section/Introduction/Character-Sets-and-Names) language","type":"string","maxLength":150},"abbreviationLocal":{"description":"An abbreviation/short name in the [local](#section/Introduction/Character-Sets-and-Names) language","type":"string","maxLength":50,"nullable":true},"nameLatin":{"description":"The name of the series in [latin](#section/Introduction/Character-Sets-and-Names) characters","type":"string","maxLength":150,"nullable":true},"abbreviationLatin":{"description":"An abbreviation/short name in [latin](#section/Introduction/Character-Sets-and-Names) characters","type":"string","maxLength":50,"nullable":true},"status":{"description":"Status\n>- `ACTIVE` Active\n>- `COMPLETE` Complete\n>- `NOT_STARTED` Not Started\n","type":"string","enum":["NOT_STARTED","ACTIVE","COMPLETE"],"maxLength":30},"seriesType":{"description":"The type of series\n>- `BEST_OF` Best of\n>- `HOME_AND_AWAY` Home and Away\n>- `KNOCKOUT` Knockout\n","type":"string","enum":["BEST_OF","HOME_AND_AWAY","KNOCKOUT"],"maxLength":50},"autoCalculated":{"description":"Is the winner auto calculated?","type":"boolean"},"bestOf":{"description":"Best of number","type":"integer","format":"int32","maxLength":3,"nullable":true},"seriesNumber":{"description":"User defined series number","type":"integer","format":"int32","maxLength":3,"nullable":true},"maxFixturesNumber":{"description":"The maximum number of games within a playoff series","type":"integer","format":"int32","nullable":true},"winner":{"description":"The unique identifier of the winner, person or entity","type":"string","format":"uuid","nullable":true},"seriesOrder":{"description":"User defined sort order of the series","type":"integer","format":"int32","maxLength":3,"nullable":true},"stageCode":{"description":"A unique code for the stage. (Unique for season)","type":"string","maxLength":30,"nullable":true},"stage":{"properties":{"resourceType":{"type":"string","enum":["seasonStages"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The stage that is related to this record","type":"object"},"poolCode":{"description":"A unique code for the pool. (Unique for season)","type":"string","maxLength":30,"nullable":true},"pool":{"properties":{"resourceType":{"type":"string","enum":["seasonPools"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The pool that is related to this record","type":"object"},"startDate":{"description":"Series start date","type":"string","format":"date","nullable":true},"endDate":{"description":"Series end date","type":"string","format":"date","nullable":true},"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},"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},"competitors":{"type":"array","nullable":true,"title":"Season series competitors","description":"Array of competitors in the series. A competitor may have a results and a ranking","items":{"type":"object","title":"Season series competitor","additionalProperties":false,"properties":{"entityId":{"description":"The uuid of the entity","type":"string"},"personId":{"description":"The uuid of the person","type":"string"},"conferenceId":{"description":"The uuid of the conference the competitor represents","type":"string"},"divisionId":{"description":"The uuid of the conference the competitor represents","type":"string"},"preSeriesRanking":{"description":"The rank of the competitor coming into the series","type":"number"},"stringRecord":{"description":"String record of the competitor","type":"number"},"seriesWins":{"description":"Number of wins in the series for the competitor","type":"number"},"seriesLosses":{"description":"Number of losses in the series for the competitor","type":"number"},"seriesDraws":{"description":"Number of draws in the series for the competitor","type":"number"},"seriesResult":{"description":"Result for the competitor in the series","type":"string","enum":["PENDING","WON","LOST","DRAW"]}}}}},"title":"series 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":{"/badminton/o/{organizationId}/seasons/{seasonId}/series/{seriesCode}":{"put":{"tags":["Season Series"],"summary":"Update a series","description":"Change the information of a specific season series","operationId":"season_series_update","responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","title":"Season_Series 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/Season_SeriesModel"}}}}}}},"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"},{"name":"seriesCode","description":"The series identifier within a season","schema":{"type":"string","maxLength":30},"required":true,"in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"conferenceId":{"description":"The unique identifier of the conference","type":"string","format":"uuid","nullable":true},"divisionId":{"description":"The unique identifier of the division","type":"string","format":"uuid","nullable":true},"nameLocal":{"description":"The name of the series in the [local](#section/Introduction/Character-Sets-and-Names) language","type":"string","maxLength":150},"abbreviationLocal":{"description":"An abbreviation/short name in the [local](#section/Introduction/Character-Sets-and-Names) language","type":"string","maxLength":50,"nullable":true},"nameLatin":{"description":"The name of the series in [latin](#section/Introduction/Character-Sets-and-Names) characters","type":"string","maxLength":150,"nullable":true},"abbreviationLatin":{"description":"An abbreviation/short name in [latin](#section/Introduction/Character-Sets-and-Names) characters","type":"string","maxLength":50,"nullable":true},"status":{"description":"Status\n>- `ACTIVE` Active\n>- `COMPLETE` Complete\n>- `NOT_STARTED` Not Started\n","type":"string","enum":["NOT_STARTED","ACTIVE","COMPLETE"],"maxLength":30},"seriesType":{"description":"The type of series\n>- `BEST_OF` Best of\n>- `HOME_AND_AWAY` Home and Away\n>- `KNOCKOUT` Knockout\n","type":"string","enum":["BEST_OF","HOME_AND_AWAY","KNOCKOUT"],"maxLength":50},"autoCalculated":{"description":"Is the winner auto calculated?","type":"boolean"},"bestOf":{"description":"Best of number","type":"integer","format":"int32","maxLength":3,"nullable":true},"seriesNumber":{"description":"User defined series number","type":"integer","format":"int32","maxLength":3,"nullable":true},"maxFixturesNumber":{"description":"The maximum number of games within a playoff series","type":"integer","format":"int32","nullable":true},"winner":{"description":"The unique identifier of the winner, person or entity","type":"string","format":"uuid","nullable":true},"seriesOrder":{"description":"User defined sort order of the series","type":"integer","format":"int32","maxLength":3,"nullable":true},"stageCode":{"description":"A unique code for the stage. (Unique for season)","type":"string","maxLength":30,"nullable":true},"poolCode":{"description":"A unique code for the pool. (Unique for season)","type":"string","maxLength":30,"nullable":true},"startDate":{"description":"Series start date","type":"string","format":"date","nullable":true},"endDate":{"description":"Series end date","type":"string","format":"date","nullable":true},"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},"competitors":{"type":"array","nullable":true,"title":"Season series competitors","description":"Array of competitors in the series. A competitor may have a results and a ranking","items":{"type":"object","title":"Season series competitor","additionalProperties":false,"properties":{"entityId":{"description":"The uuid of the entity","type":"string"},"personId":{"description":"The uuid of the person","type":"string"},"conferenceId":{"description":"The uuid of the conference the competitor represents","type":"string"},"divisionId":{"description":"The uuid of the conference the competitor represents","type":"string"},"preSeriesRanking":{"description":"The rank of the competitor coming into the series","type":"number"},"stringRecord":{"description":"String record of the competitor","type":"number"},"seriesWins":{"description":"Number of wins in the series for the competitor","type":"number"},"seriesLosses":{"description":"Number of losses in the series for the competitor","type":"number"},"seriesDraws":{"description":"Number of draws in the series for the competitor","type":"number"},"seriesResult":{"description":"Result for the competitor in the series","type":"string","enum":["PENDING","WON","LOST","DRAW"]}}}}},"title":"series put body"}}}}}}}}
```

## Delete a series

> Delete a specific series

```json
{"openapi":"3.0.0","info":{"title":"DataCore API  - Badminton","version":"v1"},"tags":[{"name":"Season Series","description":"A series is a collection of matches inside a season where specific teams play each other multiple times.  A series for example can be a Best-Of 7.\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"}}}}}},"Season_SeriesModel":{"type":"object","additionalProperties":false,"properties":{"seriesCode":{"description":"A unique code for the season series. (Unique for season)","type":"string","maxLength":30},"seasonId":{"description":"The unique identifier of the season","type":"string","format":"uuid"},"season":{"properties":{"resourceType":{"type":"string","enum":["seasons"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The season linked to this record","type":"object"},"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 series belongs to","type":"object"},"conferenceId":{"description":"The unique identifier of the conference","type":"string","format":"uuid","nullable":true},"conference":{"properties":{"resourceType":{"type":"string","enum":["conferences"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The conference information","type":"object"},"divisionId":{"description":"The unique identifier of the division","type":"string","format":"uuid","nullable":true},"division":{"properties":{"resourceType":{"type":"string","enum":["divisions"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The division information","type":"object"},"nameLocal":{"description":"The name of the series in the [local](#section/Introduction/Character-Sets-and-Names) language","type":"string","maxLength":150},"abbreviationLocal":{"description":"An abbreviation/short name in the [local](#section/Introduction/Character-Sets-and-Names) language","type":"string","maxLength":50,"nullable":true},"nameLatin":{"description":"The name of the series in [latin](#section/Introduction/Character-Sets-and-Names) characters","type":"string","maxLength":150,"nullable":true},"abbreviationLatin":{"description":"An abbreviation/short name in [latin](#section/Introduction/Character-Sets-and-Names) characters","type":"string","maxLength":50,"nullable":true},"status":{"description":"Status\n>- `ACTIVE` Active\n>- `COMPLETE` Complete\n>- `NOT_STARTED` Not Started\n","type":"string","enum":["NOT_STARTED","ACTIVE","COMPLETE"],"maxLength":30},"seriesType":{"description":"The type of series\n>- `BEST_OF` Best of\n>- `HOME_AND_AWAY` Home and Away\n>- `KNOCKOUT` Knockout\n","type":"string","enum":["BEST_OF","HOME_AND_AWAY","KNOCKOUT"],"maxLength":50},"autoCalculated":{"description":"Is the winner auto calculated?","type":"boolean"},"bestOf":{"description":"Best of number","type":"integer","format":"int32","maxLength":3,"nullable":true},"seriesNumber":{"description":"User defined series number","type":"integer","format":"int32","maxLength":3,"nullable":true},"maxFixturesNumber":{"description":"The maximum number of games within a playoff series","type":"integer","format":"int32","nullable":true},"winner":{"description":"The unique identifier of the winner, person or entity","type":"string","format":"uuid","nullable":true},"seriesOrder":{"description":"User defined sort order of the series","type":"integer","format":"int32","maxLength":3,"nullable":true},"stageCode":{"description":"A unique code for the stage. (Unique for season)","type":"string","maxLength":30,"nullable":true},"stage":{"properties":{"resourceType":{"type":"string","enum":["seasonStages"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The stage that is related to this record","type":"object"},"poolCode":{"description":"A unique code for the pool. (Unique for season)","type":"string","maxLength":30,"nullable":true},"pool":{"properties":{"resourceType":{"type":"string","enum":["seasonPools"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The pool that is related to this record","type":"object"},"startDate":{"description":"Series start date","type":"string","format":"date","nullable":true},"endDate":{"description":"Series end date","type":"string","format":"date","nullable":true},"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},"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},"competitors":{"type":"array","nullable":true,"title":"Season series competitors","description":"Array of competitors in the series. A competitor may have a results and a ranking","items":{"type":"object","title":"Season series competitor","additionalProperties":false,"properties":{"entityId":{"description":"The uuid of the entity","type":"string"},"personId":{"description":"The uuid of the person","type":"string"},"conferenceId":{"description":"The uuid of the conference the competitor represents","type":"string"},"divisionId":{"description":"The uuid of the conference the competitor represents","type":"string"},"preSeriesRanking":{"description":"The rank of the competitor coming into the series","type":"number"},"stringRecord":{"description":"String record of the competitor","type":"number"},"seriesWins":{"description":"Number of wins in the series for the competitor","type":"number"},"seriesLosses":{"description":"Number of losses in the series for the competitor","type":"number"},"seriesDraws":{"description":"Number of draws in the series for the competitor","type":"number"},"seriesResult":{"description":"Result for the competitor in the series","type":"string","enum":["PENDING","WON","LOST","DRAW"]}}}}},"title":"series 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":{"/badminton/o/{organizationId}/seasons/{seasonId}/series/{seriesCode}":{"delete":{"tags":["Season Series"],"summary":"Delete a series","description":"Delete a specific series","operationId":"season_series_delete","responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","title":"Season_Series 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/Season_SeriesModel"}}}}}}},"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"},{"name":"seriesCode","description":"The series identifier within a season","schema":{"type":"string","maxLength":30},"required":true,"in":"path"}]}}}}
```

## Calculate season series competitors score related fields

> Calculate season series competitors score related fields

```json
{"openapi":"3.0.0","info":{"title":"DataCore API  - Badminton","version":"v1"},"tags":[{"name":"Season Series","description":"A series is a collection of matches inside a season where specific teams play each other multiple times.  A series for example can be a Best-Of 7.\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"}}}}}},"SuccessModel":{"type":"object","additionalProperties":false,"properties":{"success":{"description":"Was the call a success?","type":"boolean"}},"title":" 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"},"includeTotalCount":{"name":"includeTotalCount","description":"Include the total number of records matching the filters.","schema":{"type":"boolean"},"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":{"/badminton/o/{organizationId}/seasons/{seasonId}/series/{seriesCode}/calculate":{"post":{"tags":["Season Series"],"summary":"Calculate season series competitors score related fields","description":"Calculate season series competitors score related fields","operationId":"season_series_calculate","responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","title":"Success 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/SuccessModel"}}}}}}},"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/includeTotalCount"},{"$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"},{"name":"seriesCode","description":"The series identifier within a season","schema":{"type":"string","maxLength":30},"required":true,"in":"path"}]}}}}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.sportradar.com/datacore/sports-apis/badminton/datacore-api-v1/season-series.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.