# Season Roster
A season roster is the total roster of all persons allowed to play for a team in a season. This does not mean that all these persons will play in a specific match just that they are available to be selected.
## Get all rosters for a season
> Return a list of all rosters for a season
```json
{"openapi":"3.0.0","info":{"title":"DataCore API - Baseball","version":"v1"},"tags":[{"name":"Season Roster","description":"A season roster is the total roster of all persons allowed to play for a team in a season. This does not mean that all these persons will play in a specific match just that they are available to be selected.\n\n![](\"https://yuml.me/diagram/scruffy;dir:LR/class/[Seasons]-<)
[Season Roster{bg:orange}],[Season Roster]-<>[Persons]\">\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"}}}}}},"Season_RosterModel":{"type":"object","additionalProperties":false,"properties":{"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 season roster belongs to","type":"object"},"entityId":{"description":"The unique identifier of the team","type":"string","format":"uuid"},"entity":{"properties":{"resourceType":{"type":"string","enum":["entities"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The team information","type":"object"},"entityGroupId":{"description":"The club that this team belongs to","type":"string","format":"uuid","nullable":true},"entityGroup":{"properties":{"resourceType":{"type":"string","enum":["entityGroups"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The club that this team belongs to","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"},"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"},"personId":{"description":"The unique identifier of the person","type":"string","format":"uuid"},"person":{"properties":{"resourceType":{"type":"string","enum":["persons"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The person information","type":"object"},"bib":{"description":"The number displayed on the jersey","type":"string","maxLength":100,"nullable":true},"position":{"description":"Playing position","type":"string","maxLength":100,"nullable":true},"status":{"description":"Participation status\n>- `ACTIVE` Active\n>- `INJURED` Injured\n>- `OTHER_NOT_PARTICIPATING` Other Non-Participation\n>- `OUT` Out\n>- `SUSPENDED` Suspended\n","type":"string","enum":["ACTIVE","INJURED","OUT","SUSPENDED","OTHER_NOT_PARTICIPATING"],"maxLength":100},"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}},"title":"season roster 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"},"nameFullLocalContains":{"name":"nameFullLocalContains","description":"Fields that allow a 'Contains' query string parameter search for words separated by a space, matching characters left to right. Example: nameFullLocal=David Johnson nameFullLocalContains=Dav will match nameFullLocalContains=John will match nameFullLocalContains=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"},"position":{"name":"position","description":"Playing position. Can specify multiple values delimited by comma.\n>- `AM` Attacking Midfield\n>- `C` Center\n>- `CB` Center Backcourt\n>- `CF` Centre Forward\n>- `CH` Centre Half\n>- `D` Defender\n>- `DM` Defensive Midfield\n>- `F` Forward\n>- `FB` Full Back\n>- `FC` Forward Center\n>- `G` Goalkeeper\n>- `GF` Guard Forward\n>- `GK` Goal Keeper\n>- `HB` Half Back\n>- `LB` Left Backcourt\n>- `LF` Left Forward\n>- `LW` Left Wingman\n>- `M` Midfielder\n>- `O` Outfielder\n>- `P` Pivot\n>- `PF` Power Forward\n>- `PG` Point Guard\n>- `RB` Right Backcourt\n>- `RF` Right Forward\n>- `RW` Right Wingman\n>- `S` Striker\n>- `SF` Small Forward\n>- `SG` Shooting Guard\n>- `SW` Sweeper\n","schema":{"type":"string","enum":["PG","SG","F","SF","PF","GF","FC","C","G","LW","RW","LB","RB","CB","P","GK","O","D","FB","HB","SW","M","CH","DM","AM","CF","LF","RF","S"]},"required":false,"in":"query"},"participationStatus":{"name":"status","description":"Participation status\n>- `ACTIVE` Active\n>- `INJURED` Injured\n>- `OTHER_NOT_PARTICIPATING` Other Non-Participation\n>- `OUT` Out\n>- `SUSPENSED` Suspended\n","schema":{"type":"string","enum":["ACTIVE","INJURED","OUT","SUSPENSED","OTHER_NOT_PARTICIPATING"],"maxLength":100},"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":{"/baseball/o/{organizationId}/seasons/{seasonId}/roster":{"get":{"tags":["Season Roster"],"summary":"Get all rosters for a season","description":"Return a list of all rosters for a season","operationId":"season_roster_list","responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","title":"Season_Roster 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_RosterModel"}}}}}}},"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/nameFullLocalContains"},{"$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/position"},{"name":"seasonId","description":"The unique identifier of the season","schema":{"type":"string","format":"uuid"},"required":true,"in":"path"},{"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":"^(\\-?bib|\\-?position|\\-?status|,)*$"},"required":false,"in":"query"},{"$ref":"#/components/parameters/participationStatus"},{"$ref":"#/components/parameters/updated"}]}}}}
```
## Create/Update a roster
> Depending on the data, either add a person to a roster, or update an existing roster
```json
{"openapi":"3.0.0","info":{"title":"DataCore API - Baseball","version":"v1"},"tags":[{"name":"Season Roster","description":"A season roster is the total roster of all persons allowed to play for a team in a season. This does not mean that all these persons will play in a specific match just that they are available to be selected.\n\n[Season Roster{bg:orange}],[Season Roster]-<>[Persons]\">\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"}}}}}},"Season_RosterModel":{"type":"object","additionalProperties":false,"properties":{"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 season roster belongs to","type":"object"},"entityId":{"description":"The unique identifier of the team","type":"string","format":"uuid"},"entity":{"properties":{"resourceType":{"type":"string","enum":["entities"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The team information","type":"object"},"entityGroupId":{"description":"The club that this team belongs to","type":"string","format":"uuid","nullable":true},"entityGroup":{"properties":{"resourceType":{"type":"string","enum":["entityGroups"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The club that this team belongs to","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"},"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"},"personId":{"description":"The unique identifier of the person","type":"string","format":"uuid"},"person":{"properties":{"resourceType":{"type":"string","enum":["persons"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The person information","type":"object"},"bib":{"description":"The number displayed on the jersey","type":"string","maxLength":100,"nullable":true},"position":{"description":"Playing position","type":"string","maxLength":100,"nullable":true},"status":{"description":"Participation status\n>- `ACTIVE` Active\n>- `INJURED` Injured\n>- `OTHER_NOT_PARTICIPATING` Other Non-Participation\n>- `OUT` Out\n>- `SUSPENDED` Suspended\n","type":"string","enum":["ACTIVE","INJURED","OUT","SUSPENDED","OTHER_NOT_PARTICIPATING"],"maxLength":100},"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}},"title":"season roster 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"},"onExternalIdConflict":{"name":"onExternalIdConflict","description":"Strategy to use when request externalId is already owned by a different row in scope.\n>- `deleteSource` Delete source row, then continue upsert\n>- `error` Return 409 conflict and perform no writes\n>- `move` Clear source externalId and continue upsert\n>- `swap` Swap externalId between source and target, then continue upsert\n","schema":{"type":"string","enum":["error","move","swap","deleteSource"]},"required":false,"in":"query"},"requireExternalId":{"name":"requireExternalId","description":"If true, request body must include externalId.","schema":{"type":"boolean"},"required":false,"in":"query"}}},"paths":{"/baseball/o/{organizationId}/seasons/{seasonId}/roster":{"post":{"tags":["Season Roster"],"summary":"Create/Update a roster","description":"Depending on the data, either add a person to a roster, or update an existing roster","operationId":"season_roster_insert_update","responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","title":"Season_Roster 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_RosterModel"}}}}}}},"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/onExternalIdConflict"},{"name":"organizationId","description":"The unique identifier of the organization","schema":{"type":"string","minLength":5,"maxLength":5},"required":true,"in":"path"},{"$ref":"#/components/parameters/requireExternalId"},{"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":{"seasonId":{"description":"The unique identifier of the season","type":"string","format":"uuid"},"entityId":{"description":"The unique identifier of the team","type":"string","format":"uuid"},"entityGroupId":{"description":"The club that this team belongs to","type":"string","format":"uuid","nullable":true},"divisionId":{"description":"The unique identifier of the division","type":"string","format":"uuid","nullable":true},"conferenceId":{"description":"The unique identifier of the conference","type":"string","format":"uuid","nullable":true},"personId":{"description":"The unique identifier of the person","type":"string","format":"uuid"},"bib":{"description":"The number displayed on the jersey","type":"string","maxLength":100,"nullable":true},"position":{"description":"Playing position","type":"string","maxLength":100,"nullable":true},"status":{"description":"Participation status\n>- `ACTIVE` Active\n>- `INJURED` Injured\n>- `OTHER_NOT_PARTICIPATING` Other Non-Participation\n>- `OUT` Out\n>- `SUSPENDED` Suspended\n","type":"string","enum":["ACTIVE","INJURED","OUT","SUSPENDED","OTHER_NOT_PARTICIPATING"],"maxLength":100},"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}},"title":"season roster post body","required":["status"]}}}}}}}}
```
## Get the roster for a team for the season
> Return the roster for a team for the season
```json
{"openapi":"3.0.0","info":{"title":"DataCore API - Baseball","version":"v1"},"tags":[{"name":"Season Roster","description":"A season roster is the total roster of all persons allowed to play for a team in a season. This does not mean that all these persons will play in a specific match just that they are available to be selected.\n\n[Season Roster{bg:orange}],[Season Roster]-<>[Persons]\">\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"}}}}}},"Season_RosterModel":{"type":"object","additionalProperties":false,"properties":{"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 season roster belongs to","type":"object"},"entityId":{"description":"The unique identifier of the team","type":"string","format":"uuid"},"entity":{"properties":{"resourceType":{"type":"string","enum":["entities"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The team information","type":"object"},"entityGroupId":{"description":"The club that this team belongs to","type":"string","format":"uuid","nullable":true},"entityGroup":{"properties":{"resourceType":{"type":"string","enum":["entityGroups"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The club that this team belongs to","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"},"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"},"personId":{"description":"The unique identifier of the person","type":"string","format":"uuid"},"person":{"properties":{"resourceType":{"type":"string","enum":["persons"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The person information","type":"object"},"bib":{"description":"The number displayed on the jersey","type":"string","maxLength":100,"nullable":true},"position":{"description":"Playing position","type":"string","maxLength":100,"nullable":true},"status":{"description":"Participation status\n>- `ACTIVE` Active\n>- `INJURED` Injured\n>- `OTHER_NOT_PARTICIPATING` Other Non-Participation\n>- `OUT` Out\n>- `SUSPENDED` Suspended\n","type":"string","enum":["ACTIVE","INJURED","OUT","SUSPENDED","OTHER_NOT_PARTICIPATING"],"maxLength":100},"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}},"title":"season roster 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"},"nameFullLocalContains":{"name":"nameFullLocalContains","description":"Fields that allow a 'Contains' query string parameter search for words separated by a space, matching characters left to right. Example: nameFullLocal=David Johnson nameFullLocalContains=Dav will match nameFullLocalContains=John will match nameFullLocalContains=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"},"position":{"name":"position","description":"Playing position. Can specify multiple values delimited by comma.\n>- `AM` Attacking Midfield\n>- `C` Center\n>- `CB` Center Backcourt\n>- `CF` Centre Forward\n>- `CH` Centre Half\n>- `D` Defender\n>- `DM` Defensive Midfield\n>- `F` Forward\n>- `FB` Full Back\n>- `FC` Forward Center\n>- `G` Goalkeeper\n>- `GF` Guard Forward\n>- `GK` Goal Keeper\n>- `HB` Half Back\n>- `LB` Left Backcourt\n>- `LF` Left Forward\n>- `LW` Left Wingman\n>- `M` Midfielder\n>- `O` Outfielder\n>- `P` Pivot\n>- `PF` Power Forward\n>- `PG` Point Guard\n>- `RB` Right Backcourt\n>- `RF` Right Forward\n>- `RW` Right Wingman\n>- `S` Striker\n>- `SF` Small Forward\n>- `SG` Shooting Guard\n>- `SW` Sweeper\n","schema":{"type":"string","enum":["PG","SG","F","SF","PF","GF","FC","C","G","LW","RW","LB","RB","CB","P","GK","O","D","FB","HB","SW","M","CH","DM","AM","CF","LF","RF","S"]},"required":false,"in":"query"},"participationStatus":{"name":"status","description":"Participation status\n>- `ACTIVE` Active\n>- `INJURED` Injured\n>- `OTHER_NOT_PARTICIPATING` Other Non-Participation\n>- `OUT` Out\n>- `SUSPENSED` Suspended\n","schema":{"type":"string","enum":["ACTIVE","INJURED","OUT","SUSPENSED","OTHER_NOT_PARTICIPATING"],"maxLength":100},"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":{"/baseball/o/{organizationId}/seasons/{seasonId}/entities/{entityId}/roster":{"get":{"tags":["Season Roster"],"summary":"Get the roster for a team for the season","description":"Return the roster for a team for the season","operationId":"season_roster_list_by_entity","responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","title":"Season_Roster 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_RosterModel"}}}}}}},"default":{"$ref":"#/components/responses/ErrorResponse"}},"parameters":[{"$ref":"#/components/parameters/added"},{"name":"entityId","description":"The unique identifier of the entity","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"},{"$ref":"#/components/parameters/includeTotalCount"},{"$ref":"#/components/parameters/limit"},{"$ref":"#/components/parameters/nameFullLocalContains"},{"$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/position"},{"name":"seasonId","description":"The unique identifier of the season","schema":{"type":"string","format":"uuid"},"required":true,"in":"path"},{"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":"^(\\-?bib|\\-?position|\\-?status|,)*$"},"required":false,"in":"query"},{"$ref":"#/components/parameters/participationStatus"},{"$ref":"#/components/parameters/updated"}]}}}}
```
## Get the rosters for a team for all seasons
> Return the rosters for a team for all seasons
```json
{"openapi":"3.0.0","info":{"title":"DataCore API - Baseball","version":"v1"},"tags":[{"name":"Season Roster","description":"A season roster is the total roster of all persons allowed to play for a team in a season. This does not mean that all these persons will play in a specific match just that they are available to be selected.\n\n[Season Roster{bg:orange}],[Season Roster]-<>[Persons]\">\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"}}}}}},"Season_RosterModel":{"type":"object","additionalProperties":false,"properties":{"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 season roster belongs to","type":"object"},"entityId":{"description":"The unique identifier of the team","type":"string","format":"uuid"},"entity":{"properties":{"resourceType":{"type":"string","enum":["entities"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The team information","type":"object"},"entityGroupId":{"description":"The club that this team belongs to","type":"string","format":"uuid","nullable":true},"entityGroup":{"properties":{"resourceType":{"type":"string","enum":["entityGroups"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The club that this team belongs to","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"},"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"},"personId":{"description":"The unique identifier of the person","type":"string","format":"uuid"},"person":{"properties":{"resourceType":{"type":"string","enum":["persons"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The person information","type":"object"},"bib":{"description":"The number displayed on the jersey","type":"string","maxLength":100,"nullable":true},"position":{"description":"Playing position","type":"string","maxLength":100,"nullable":true},"status":{"description":"Participation status\n>- `ACTIVE` Active\n>- `INJURED` Injured\n>- `OTHER_NOT_PARTICIPATING` Other Non-Participation\n>- `OUT` Out\n>- `SUSPENDED` Suspended\n","type":"string","enum":["ACTIVE","INJURED","OUT","SUSPENDED","OTHER_NOT_PARTICIPATING"],"maxLength":100},"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}},"title":"season roster 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"},"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"},"seasonIds":{"name":"seasonIds","description":"The unique identifiers of the seasons (comma-delimited).","schema":{"type":"string","format":"uuid"},"required":false,"in":"query"},"participationStatus":{"name":"status","description":"Participation status\n>- `ACTIVE` Active\n>- `INJURED` Injured\n>- `OTHER_NOT_PARTICIPATING` Other Non-Participation\n>- `OUT` Out\n>- `SUSPENSED` Suspended\n","schema":{"type":"string","enum":["ACTIVE","INJURED","OUT","SUSPENSED","OTHER_NOT_PARTICIPATING"],"maxLength":100},"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":{"/baseball/o/{organizationId}/seasons/entities/{entityId}/roster":{"get":{"tags":["Season Roster"],"summary":"Get the rosters for a team for all seasons","description":"Return the rosters for a team for all seasons","operationId":"seasons_roster_list_by_entity","responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","title":"Season_Roster 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_RosterModel"}}}}}}},"default":{"$ref":"#/components/responses/ErrorResponse"}},"parameters":[{"$ref":"#/components/parameters/added"},{"name":"entityId","description":"The unique identifier of the entity","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"},{"$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"},{"$ref":"#/components/parameters/seasonIds"},{"$ref":"#/components/parameters/participationStatus"},{"$ref":"#/components/parameters/updated"}]}}}}
```
## Get the roster detail for a person for the season
> Return the detailed roster detail for a specific person for the season
```json
{"openapi":"3.0.0","info":{"title":"DataCore API - Baseball","version":"v1"},"tags":[{"name":"Season Roster","description":"A season roster is the total roster of all persons allowed to play for a team in a season. This does not mean that all these persons will play in a specific match just that they are available to be selected.\n\n[Season Roster{bg:orange}],[Season Roster]-<>[Persons]\">\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"}}}}}},"Season_RosterModel":{"type":"object","additionalProperties":false,"properties":{"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 season roster belongs to","type":"object"},"entityId":{"description":"The unique identifier of the team","type":"string","format":"uuid"},"entity":{"properties":{"resourceType":{"type":"string","enum":["entities"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The team information","type":"object"},"entityGroupId":{"description":"The club that this team belongs to","type":"string","format":"uuid","nullable":true},"entityGroup":{"properties":{"resourceType":{"type":"string","enum":["entityGroups"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The club that this team belongs to","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"},"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"},"personId":{"description":"The unique identifier of the person","type":"string","format":"uuid"},"person":{"properties":{"resourceType":{"type":"string","enum":["persons"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The person information","type":"object"},"bib":{"description":"The number displayed on the jersey","type":"string","maxLength":100,"nullable":true},"position":{"description":"Playing position","type":"string","maxLength":100,"nullable":true},"status":{"description":"Participation status\n>- `ACTIVE` Active\n>- `INJURED` Injured\n>- `OTHER_NOT_PARTICIPATING` Other Non-Participation\n>- `OUT` Out\n>- `SUSPENDED` Suspended\n","type":"string","enum":["ACTIVE","INJURED","OUT","SUSPENDED","OTHER_NOT_PARTICIPATING"],"maxLength":100},"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}},"title":"season roster 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"},"participationStatus":{"name":"status","description":"Participation status\n>- `ACTIVE` Active\n>- `INJURED` Injured\n>- `OTHER_NOT_PARTICIPATING` Other Non-Participation\n>- `OUT` Out\n>- `SUSPENSED` Suspended\n","schema":{"type":"string","enum":["ACTIVE","INJURED","OUT","SUSPENSED","OTHER_NOT_PARTICIPATING"],"maxLength":100},"required":false,"in":"query"}}},"paths":{"/baseball/o/{organizationId}/seasons/{seasonId}/persons/{personId}/roster":{"get":{"tags":["Season Roster"],"summary":"Get the roster detail for a person for the season","description":"Return the detailed roster detail for a specific person for the season","operationId":"season_roster_detail","responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","title":"Season_Roster 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_RosterModel"}}}}}}},"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":"personId","description":"The unique identifier of the person","schema":{"type":"string","format":"uuid"},"required":true,"in":"path"},{"name":"seasonId","description":"The unique identifier of the season","schema":{"type":"string","format":"uuid"},"required":true,"in":"path"},{"$ref":"#/components/parameters/participationStatus"}]}}}}
```
## Delete a season roster
> Delete a person from the roster in a season
```json
{"openapi":"3.0.0","info":{"title":"DataCore API - Baseball","version":"v1"},"tags":[{"name":"Season Roster","description":"A season roster is the total roster of all persons allowed to play for a team in a season. This does not mean that all these persons will play in a specific match just that they are available to be selected.\n\n[Season Roster{bg:orange}],[Season Roster]-<>[Persons]\">\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"}}}}}},"Season_RosterModel":{"type":"object","additionalProperties":false,"properties":{"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 season roster belongs to","type":"object"},"entityId":{"description":"The unique identifier of the team","type":"string","format":"uuid"},"entity":{"properties":{"resourceType":{"type":"string","enum":["entities"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The team information","type":"object"},"entityGroupId":{"description":"The club that this team belongs to","type":"string","format":"uuid","nullable":true},"entityGroup":{"properties":{"resourceType":{"type":"string","enum":["entityGroups"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The club that this team belongs to","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"},"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"},"personId":{"description":"The unique identifier of the person","type":"string","format":"uuid"},"person":{"properties":{"resourceType":{"type":"string","enum":["persons"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The person information","type":"object"},"bib":{"description":"The number displayed on the jersey","type":"string","maxLength":100,"nullable":true},"position":{"description":"Playing position","type":"string","maxLength":100,"nullable":true},"status":{"description":"Participation status\n>- `ACTIVE` Active\n>- `INJURED` Injured\n>- `OTHER_NOT_PARTICIPATING` Other Non-Participation\n>- `OUT` Out\n>- `SUSPENDED` Suspended\n","type":"string","enum":["ACTIVE","INJURED","OUT","SUSPENDED","OTHER_NOT_PARTICIPATING"],"maxLength":100},"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}},"title":"season roster 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":{"/baseball/o/{organizationId}/seasons/{seasonId}/persons/{personId}/roster":{"delete":{"tags":["Season Roster"],"summary":"Delete a season roster","description":"Delete a person from the roster in a season","operationId":"season_roster_delete","responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","title":"Season_Roster 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_RosterModel"}}}}}}},"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":"personId","description":"The unique identifier of the person","schema":{"type":"string","format":"uuid"},"required":true,"in":"path"},{"name":"seasonId","description":"The unique identifier of the season","schema":{"type":"string","format":"uuid"},"required":true,"in":"path"}]}}}}
```