# Awards

A person can be assigned an award inside an organization, team, club, season, competition or match. The routes allow awards to be returned that are linked to matches, seasons or not.

## Get a list of non-match awards

> Return a list of awards not linked to matches

```json
{"openapi":"3.0.0","info":{"title":"DataCore API  - basketball","version":"v1"},"tags":[{"name":"Awards","description":"A person can be assigned an award inside an organization, team, club, season, competition or match.  The routes allow awards to be returned that are linked to matches, seasons or not."}],"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"}}}}}},"AwardsModel":{"type":"object","additionalProperties":false,"properties":{"awardId":{"description":"The unique identifier of the award","type":"string","format":"uuid"},"organizationId":{"description":"The unique identifier of the organization","type":"string","readOnly":true},"organization":{"properties":{"resourceType":{"type":"string","enum":["organizations"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The organization that this ~award~ belongs to","type":"object"},"personId":{"description":"The person that this award is for","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"},"entityGroupId":{"description":"The club that this award is linked to","type":"string","format":"uuid"},"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"},"entityId":{"description":"The team that this award is linked to","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"},"competitionId":{"description":"The competition that this award is linked to","type":"string","format":"uuid"},"competition":{"properties":{"resourceType":{"type":"string","enum":["competitions"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The competition that this season belongs to","type":"object"},"seasonId":{"description":"The season that this award is linked to","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"},"fixtureId":{"description":"The match that this award is linked to","type":"string","format":"uuid"},"fixture":{"properties":{"resourceType":{"type":"string","enum":["fixtures"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The match","type":"object"},"votes":{"description":"Number of votes","type":"integer","format":"int32","nullable":true},"dateFrom":{"description":"Date the award is from","type":"string","format":"date","nullable":true},"dateTo":{"description":"Date the award is until","type":"string","format":"date","nullable":true},"award":{"description":"Award\n>- `6th_MAN` Sixth Man\n>- `ALL_TEAM` All first team\n>- `COACH` Coach Award\n>- `DEFENSIVE` Defensive Player\n>- `DEFENSIVE_TEAM` Defensive team\n>- `HALL` Hall of Fame\n>- `HONOUR` Honoured\n>- `MIP` Most Improved Player\n>- `MVP` Most Valuable Player\n>- `OTHER` Other\n>- `ROOKIE` Rookie\n","type":"string","enum":["MVP","MIP","ROOKIE","COACH","ALL_TEAM","DEFENSIVE_TEAM","DEFENSIVE","6th_MAN","OTHER","HONOUR","HALL"],"maxLength":100},"awardSubType":{"description":"Award sub type","type":"string","maxLength":100,"nullable":true},"notes":{"description":"Award Notes","type":"string","maxLength":500,"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}},"title":"~award~ 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"},"award":{"name":"award","description":"Award\n>- `6th_MAN` Sixth Man\n>- `ALL_TEAM` All first team\n>- `COACH` Coach Award\n>- `DEFENSIVE` Defensive Player\n>- `DEFENSIVE_TEAM` Defensive team\n>- `HALL` Hall of Fame\n>- `HONOUR` Honoured\n>- `MIP` Most Improved Player\n>- `MVP` Most Valuable Player\n>- `OTHER` Other\n>- `ROOKIE` Rookie\n","schema":{"type":"string","enum":["MVP","MIP","ROOKIE","COACH","ALL_TEAM","DEFENSIVE_TEAM","DEFENSIVE","6th_MAN","OTHER","HONOUR","HALL"],"maxLength":100},"required":false,"in":"query"},"dateFromEnd":{"name":"dateFromEnd","description":"Where dateFrom <= this value","schema":{"type":"string","format":"date"},"required":false,"in":"query"},"dateFromStart":{"name":"dateFromStart","description":"Where dateFrom >= this value","schema":{"type":"string","format":"date"},"required":false,"in":"query"},"dateToEnd":{"name":"dateToEnd","description":"Where dateTo <= this value","schema":{"type":"string","format":"date"},"required":false,"in":"query"},"dateToStart":{"name":"dateToStart","description":"Where dateTo >= this value","schema":{"type":"string","format":"date"},"required":false,"in":"query"},"entityId":{"name":"entityId","description":"The unique identifier of the team","schema":{"type":"string","format":"uuid"},"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"},"personId":{"name":"personId","description":"The unique identifier of the person","schema":{"type":"string","format":"uuid"},"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":{"/basketball/o/{organizationId}/awards":{"get":{"tags":["Awards"],"summary":"Get a list of non-match awards","description":"Return a list of awards not linked to matches","operationId":"awards_list_non_fixtures","responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","title":"Awards 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/AwardsModel"}}}}}}},"default":{"$ref":"#/components/responses/ErrorResponse"}},"parameters":[{"$ref":"#/components/parameters/added"},{"$ref":"#/components/parameters/award"},{"$ref":"#/components/parameters/dateFromEnd"},{"$ref":"#/components/parameters/dateFromStart"},{"$ref":"#/components/parameters/dateToEnd"},{"$ref":"#/components/parameters/dateToStart"},{"$ref":"#/components/parameters/entityId"},{"$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/personId"},{"$ref":"#/components/parameters/updated"}]}}}}
```

## Create an award

> Add a new award

```json
{"openapi":"3.0.0","info":{"title":"DataCore API  - basketball","version":"v1"},"tags":[{"name":"Awards","description":"A person can be assigned an award inside an organization, team, club, season, competition or match.  The routes allow awards to be returned that are linked to matches, seasons or not."}],"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"}}}}}},"AwardsModel":{"type":"object","additionalProperties":false,"properties":{"awardId":{"description":"The unique identifier of the award","type":"string","format":"uuid"},"organizationId":{"description":"The unique identifier of the organization","type":"string","readOnly":true},"organization":{"properties":{"resourceType":{"type":"string","enum":["organizations"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The organization that this ~award~ belongs to","type":"object"},"personId":{"description":"The person that this award is for","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"},"entityGroupId":{"description":"The club that this award is linked to","type":"string","format":"uuid"},"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"},"entityId":{"description":"The team that this award is linked to","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"},"competitionId":{"description":"The competition that this award is linked to","type":"string","format":"uuid"},"competition":{"properties":{"resourceType":{"type":"string","enum":["competitions"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The competition that this season belongs to","type":"object"},"seasonId":{"description":"The season that this award is linked to","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"},"fixtureId":{"description":"The match that this award is linked to","type":"string","format":"uuid"},"fixture":{"properties":{"resourceType":{"type":"string","enum":["fixtures"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The match","type":"object"},"votes":{"description":"Number of votes","type":"integer","format":"int32","nullable":true},"dateFrom":{"description":"Date the award is from","type":"string","format":"date","nullable":true},"dateTo":{"description":"Date the award is until","type":"string","format":"date","nullable":true},"award":{"description":"Award\n>- `6th_MAN` Sixth Man\n>- `ALL_TEAM` All first team\n>- `COACH` Coach Award\n>- `DEFENSIVE` Defensive Player\n>- `DEFENSIVE_TEAM` Defensive team\n>- `HALL` Hall of Fame\n>- `HONOUR` Honoured\n>- `MIP` Most Improved Player\n>- `MVP` Most Valuable Player\n>- `OTHER` Other\n>- `ROOKIE` Rookie\n","type":"string","enum":["MVP","MIP","ROOKIE","COACH","ALL_TEAM","DEFENSIVE_TEAM","DEFENSIVE","6th_MAN","OTHER","HONOUR","HALL"],"maxLength":100},"awardSubType":{"description":"Award sub type","type":"string","maxLength":100,"nullable":true},"notes":{"description":"Award Notes","type":"string","maxLength":500,"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}},"title":"~award~ 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":{"/basketball/o/{organizationId}/awards":{"post":{"tags":["Awards"],"summary":"Create an award","description":"Add a new award","operationId":"awards_insert","responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","title":"Awards 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/AwardsModel"}}}}}}},"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"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"awardId":{"description":"The unique identifier of the award","type":"string","format":"uuid"},"personId":{"description":"The person that this award is for","type":"string","format":"uuid"},"entityGroupId":{"description":"The club that this award is linked to","type":"string","format":"uuid"},"entityId":{"description":"The team that this award is linked to","type":"string","format":"uuid"},"competitionId":{"description":"The competition that this award is linked to","type":"string","format":"uuid"},"seasonId":{"description":"The season that this award is linked to","type":"string","format":"uuid"},"fixtureId":{"description":"The match that this award is linked to","type":"string","format":"uuid"},"votes":{"description":"Number of votes","type":"integer","format":"int32","nullable":true},"dateFrom":{"description":"Date the award is from","type":"string","format":"date","nullable":true},"dateTo":{"description":"Date the award is until","type":"string","format":"date","nullable":true},"award":{"description":"Award\n>- `6th_MAN` Sixth Man\n>- `ALL_TEAM` All first team\n>- `COACH` Coach Award\n>- `DEFENSIVE` Defensive Player\n>- `DEFENSIVE_TEAM` Defensive team\n>- `HALL` Hall of Fame\n>- `HONOUR` Honoured\n>- `MIP` Most Improved Player\n>- `MVP` Most Valuable Player\n>- `OTHER` Other\n>- `ROOKIE` Rookie\n","type":"string","enum":["MVP","MIP","ROOKIE","COACH","ALL_TEAM","DEFENSIVE_TEAM","DEFENSIVE","6th_MAN","OTHER","HONOUR","HALL"],"maxLength":100},"awardSubType":{"description":"Award sub type","type":"string","maxLength":100,"nullable":true},"notes":{"description":"Award Notes","type":"string","maxLength":500,"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}},"title":"~award~ post body","required":["personId","award"]}}}}}}}}
```

## Get a list of season awards

> Return a list of awards for the organization (linked to seasons)

```json
{"openapi":"3.0.0","info":{"title":"DataCore API  - basketball","version":"v1"},"tags":[{"name":"Awards","description":"A person can be assigned an award inside an organization, team, club, season, competition or match.  The routes allow awards to be returned that are linked to matches, seasons or not."}],"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"}}}}}},"AwardsModel":{"type":"object","additionalProperties":false,"properties":{"awardId":{"description":"The unique identifier of the award","type":"string","format":"uuid"},"organizationId":{"description":"The unique identifier of the organization","type":"string","readOnly":true},"organization":{"properties":{"resourceType":{"type":"string","enum":["organizations"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The organization that this ~award~ belongs to","type":"object"},"personId":{"description":"The person that this award is for","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"},"entityGroupId":{"description":"The club that this award is linked to","type":"string","format":"uuid"},"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"},"entityId":{"description":"The team that this award is linked to","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"},"competitionId":{"description":"The competition that this award is linked to","type":"string","format":"uuid"},"competition":{"properties":{"resourceType":{"type":"string","enum":["competitions"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The competition that this season belongs to","type":"object"},"seasonId":{"description":"The season that this award is linked to","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"},"fixtureId":{"description":"The match that this award is linked to","type":"string","format":"uuid"},"fixture":{"properties":{"resourceType":{"type":"string","enum":["fixtures"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The match","type":"object"},"votes":{"description":"Number of votes","type":"integer","format":"int32","nullable":true},"dateFrom":{"description":"Date the award is from","type":"string","format":"date","nullable":true},"dateTo":{"description":"Date the award is until","type":"string","format":"date","nullable":true},"award":{"description":"Award\n>- `6th_MAN` Sixth Man\n>- `ALL_TEAM` All first team\n>- `COACH` Coach Award\n>- `DEFENSIVE` Defensive Player\n>- `DEFENSIVE_TEAM` Defensive team\n>- `HALL` Hall of Fame\n>- `HONOUR` Honoured\n>- `MIP` Most Improved Player\n>- `MVP` Most Valuable Player\n>- `OTHER` Other\n>- `ROOKIE` Rookie\n","type":"string","enum":["MVP","MIP","ROOKIE","COACH","ALL_TEAM","DEFENSIVE_TEAM","DEFENSIVE","6th_MAN","OTHER","HONOUR","HALL"],"maxLength":100},"awardSubType":{"description":"Award sub type","type":"string","maxLength":100,"nullable":true},"notes":{"description":"Award Notes","type":"string","maxLength":500,"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}},"title":"~award~ 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"},"award":{"name":"award","description":"Award\n>- `6th_MAN` Sixth Man\n>- `ALL_TEAM` All first team\n>- `COACH` Coach Award\n>- `DEFENSIVE` Defensive Player\n>- `DEFENSIVE_TEAM` Defensive team\n>- `HALL` Hall of Fame\n>- `HONOUR` Honoured\n>- `MIP` Most Improved Player\n>- `MVP` Most Valuable Player\n>- `OTHER` Other\n>- `ROOKIE` Rookie\n","schema":{"type":"string","enum":["MVP","MIP","ROOKIE","COACH","ALL_TEAM","DEFENSIVE_TEAM","DEFENSIVE","6th_MAN","OTHER","HONOUR","HALL"],"maxLength":100},"required":false,"in":"query"},"dateFromEnd":{"name":"dateFromEnd","description":"Where dateFrom <= this value","schema":{"type":"string","format":"date"},"required":false,"in":"query"},"dateFromStart":{"name":"dateFromStart","description":"Where dateFrom >= this value","schema":{"type":"string","format":"date"},"required":false,"in":"query"},"dateToEnd":{"name":"dateToEnd","description":"Where dateTo <= this value","schema":{"type":"string","format":"date"},"required":false,"in":"query"},"dateToStart":{"name":"dateToStart","description":"Where dateTo >= this value","schema":{"type":"string","format":"date"},"required":false,"in":"query"},"entityId":{"name":"entityId","description":"The unique identifier of the team","schema":{"type":"string","format":"uuid"},"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"},"personId":{"name":"personId","description":"The unique identifier of the person","schema":{"type":"string","format":"uuid"},"required":false,"in":"query"},"seasonId":{"name":"seasonId","description":"The unique identifier of the season","schema":{"type":"string","format":"uuid"},"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":{"/basketball/o/{organizationId}/awards/in/seasons":{"get":{"tags":["Awards"],"summary":"Get a list of season awards","description":"Return a list of awards for the organization (linked to seasons)","operationId":"awards_list_seasons","responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","title":"Awards 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/AwardsModel"}}}}}}},"default":{"$ref":"#/components/responses/ErrorResponse"}},"parameters":[{"$ref":"#/components/parameters/added"},{"$ref":"#/components/parameters/award"},{"$ref":"#/components/parameters/dateFromEnd"},{"$ref":"#/components/parameters/dateFromStart"},{"$ref":"#/components/parameters/dateToEnd"},{"$ref":"#/components/parameters/dateToStart"},{"$ref":"#/components/parameters/entityId"},{"$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/personId"},{"$ref":"#/components/parameters/seasonId"},{"$ref":"#/components/parameters/updated"}]}}}}
```

## Get a list of match awards

> Return a list of awards for the organization (linked to matches)

```json
{"openapi":"3.0.0","info":{"title":"DataCore API  - basketball","version":"v1"},"tags":[{"name":"Awards","description":"A person can be assigned an award inside an organization, team, club, season, competition or match.  The routes allow awards to be returned that are linked to matches, seasons or not."}],"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"}}}}}},"AwardsModel":{"type":"object","additionalProperties":false,"properties":{"awardId":{"description":"The unique identifier of the award","type":"string","format":"uuid"},"organizationId":{"description":"The unique identifier of the organization","type":"string","readOnly":true},"organization":{"properties":{"resourceType":{"type":"string","enum":["organizations"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The organization that this ~award~ belongs to","type":"object"},"personId":{"description":"The person that this award is for","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"},"entityGroupId":{"description":"The club that this award is linked to","type":"string","format":"uuid"},"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"},"entityId":{"description":"The team that this award is linked to","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"},"competitionId":{"description":"The competition that this award is linked to","type":"string","format":"uuid"},"competition":{"properties":{"resourceType":{"type":"string","enum":["competitions"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The competition that this season belongs to","type":"object"},"seasonId":{"description":"The season that this award is linked to","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"},"fixtureId":{"description":"The match that this award is linked to","type":"string","format":"uuid"},"fixture":{"properties":{"resourceType":{"type":"string","enum":["fixtures"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The match","type":"object"},"votes":{"description":"Number of votes","type":"integer","format":"int32","nullable":true},"dateFrom":{"description":"Date the award is from","type":"string","format":"date","nullable":true},"dateTo":{"description":"Date the award is until","type":"string","format":"date","nullable":true},"award":{"description":"Award\n>- `6th_MAN` Sixth Man\n>- `ALL_TEAM` All first team\n>- `COACH` Coach Award\n>- `DEFENSIVE` Defensive Player\n>- `DEFENSIVE_TEAM` Defensive team\n>- `HALL` Hall of Fame\n>- `HONOUR` Honoured\n>- `MIP` Most Improved Player\n>- `MVP` Most Valuable Player\n>- `OTHER` Other\n>- `ROOKIE` Rookie\n","type":"string","enum":["MVP","MIP","ROOKIE","COACH","ALL_TEAM","DEFENSIVE_TEAM","DEFENSIVE","6th_MAN","OTHER","HONOUR","HALL"],"maxLength":100},"awardSubType":{"description":"Award sub type","type":"string","maxLength":100,"nullable":true},"notes":{"description":"Award Notes","type":"string","maxLength":500,"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}},"title":"~award~ 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"},"award":{"name":"award","description":"Award\n>- `6th_MAN` Sixth Man\n>- `ALL_TEAM` All first team\n>- `COACH` Coach Award\n>- `DEFENSIVE` Defensive Player\n>- `DEFENSIVE_TEAM` Defensive team\n>- `HALL` Hall of Fame\n>- `HONOUR` Honoured\n>- `MIP` Most Improved Player\n>- `MVP` Most Valuable Player\n>- `OTHER` Other\n>- `ROOKIE` Rookie\n","schema":{"type":"string","enum":["MVP","MIP","ROOKIE","COACH","ALL_TEAM","DEFENSIVE_TEAM","DEFENSIVE","6th_MAN","OTHER","HONOUR","HALL"],"maxLength":100},"required":false,"in":"query"},"dateFromEnd":{"name":"dateFromEnd","description":"Where dateFrom <= this value","schema":{"type":"string","format":"date"},"required":false,"in":"query"},"dateFromStart":{"name":"dateFromStart","description":"Where dateFrom >= this value","schema":{"type":"string","format":"date"},"required":false,"in":"query"},"dateToEnd":{"name":"dateToEnd","description":"Where dateTo <= this value","schema":{"type":"string","format":"date"},"required":false,"in":"query"},"dateToStart":{"name":"dateToStart","description":"Where dateTo >= this value","schema":{"type":"string","format":"date"},"required":false,"in":"query"},"entityId":{"name":"entityId","description":"The unique identifier of the team","schema":{"type":"string","format":"uuid"},"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"},"fixtureId":{"name":"fixtureId","description":"The unique identifier of the match","schema":{"type":"string","format":"uuid"},"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"},"personId":{"name":"personId","description":"The unique identifier of the person","schema":{"type":"string","format":"uuid"},"required":false,"in":"query"},"seasonId":{"name":"seasonId","description":"The unique identifier of the season","schema":{"type":"string","format":"uuid"},"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":{"/basketball/o/{organizationId}/awards/in/fixtures":{"get":{"tags":["Awards"],"summary":"Get a list of match awards","description":"Return a list of awards for the organization (linked to matches)","operationId":"awards_list_fixtures","responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","title":"Awards 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/AwardsModel"}}}}}}},"default":{"$ref":"#/components/responses/ErrorResponse"}},"parameters":[{"$ref":"#/components/parameters/added"},{"$ref":"#/components/parameters/award"},{"$ref":"#/components/parameters/dateFromEnd"},{"$ref":"#/components/parameters/dateFromStart"},{"$ref":"#/components/parameters/dateToEnd"},{"$ref":"#/components/parameters/dateToStart"},{"$ref":"#/components/parameters/entityId"},{"$ref":"#/components/parameters/external"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/fixtureId"},{"$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/personId"},{"$ref":"#/components/parameters/seasonId"},{"$ref":"#/components/parameters/updated"}]}}}}
```

## Get an award

> Return detailed information about a specific award

```json
{"openapi":"3.0.0","info":{"title":"DataCore API  - basketball","version":"v1"},"tags":[{"name":"Awards","description":"A person can be assigned an award inside an organization, team, club, season, competition or match.  The routes allow awards to be returned that are linked to matches, seasons or not."}],"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"}}}}}},"AwardsModel":{"type":"object","additionalProperties":false,"properties":{"awardId":{"description":"The unique identifier of the award","type":"string","format":"uuid"},"organizationId":{"description":"The unique identifier of the organization","type":"string","readOnly":true},"organization":{"properties":{"resourceType":{"type":"string","enum":["organizations"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The organization that this ~award~ belongs to","type":"object"},"personId":{"description":"The person that this award is for","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"},"entityGroupId":{"description":"The club that this award is linked to","type":"string","format":"uuid"},"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"},"entityId":{"description":"The team that this award is linked to","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"},"competitionId":{"description":"The competition that this award is linked to","type":"string","format":"uuid"},"competition":{"properties":{"resourceType":{"type":"string","enum":["competitions"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The competition that this season belongs to","type":"object"},"seasonId":{"description":"The season that this award is linked to","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"},"fixtureId":{"description":"The match that this award is linked to","type":"string","format":"uuid"},"fixture":{"properties":{"resourceType":{"type":"string","enum":["fixtures"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The match","type":"object"},"votes":{"description":"Number of votes","type":"integer","format":"int32","nullable":true},"dateFrom":{"description":"Date the award is from","type":"string","format":"date","nullable":true},"dateTo":{"description":"Date the award is until","type":"string","format":"date","nullable":true},"award":{"description":"Award\n>- `6th_MAN` Sixth Man\n>- `ALL_TEAM` All first team\n>- `COACH` Coach Award\n>- `DEFENSIVE` Defensive Player\n>- `DEFENSIVE_TEAM` Defensive team\n>- `HALL` Hall of Fame\n>- `HONOUR` Honoured\n>- `MIP` Most Improved Player\n>- `MVP` Most Valuable Player\n>- `OTHER` Other\n>- `ROOKIE` Rookie\n","type":"string","enum":["MVP","MIP","ROOKIE","COACH","ALL_TEAM","DEFENSIVE_TEAM","DEFENSIVE","6th_MAN","OTHER","HONOUR","HALL"],"maxLength":100},"awardSubType":{"description":"Award sub type","type":"string","maxLength":100,"nullable":true},"notes":{"description":"Award Notes","type":"string","maxLength":500,"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}},"title":"~award~ 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":{"/basketball/o/{organizationId}/awards/{awardId}":{"get":{"tags":["Awards"],"summary":"Get an award","description":"Return detailed information about a specific award","operationId":"awards_detail","responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","title":"Awards 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/AwardsModel"}}}}}}},"default":{"$ref":"#/components/responses/ErrorResponse"}},"parameters":[{"name":"awardId","description":"The unique identifier of the award","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"}]}}}}
```

## Update an award

> Change the information of a specific award

```json
{"openapi":"3.0.0","info":{"title":"DataCore API  - basketball","version":"v1"},"tags":[{"name":"Awards","description":"A person can be assigned an award inside an organization, team, club, season, competition or match.  The routes allow awards to be returned that are linked to matches, seasons or not."}],"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"}}}}}},"AwardsModel":{"type":"object","additionalProperties":false,"properties":{"awardId":{"description":"The unique identifier of the award","type":"string","format":"uuid"},"organizationId":{"description":"The unique identifier of the organization","type":"string","readOnly":true},"organization":{"properties":{"resourceType":{"type":"string","enum":["organizations"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The organization that this ~award~ belongs to","type":"object"},"personId":{"description":"The person that this award is for","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"},"entityGroupId":{"description":"The club that this award is linked to","type":"string","format":"uuid"},"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"},"entityId":{"description":"The team that this award is linked to","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"},"competitionId":{"description":"The competition that this award is linked to","type":"string","format":"uuid"},"competition":{"properties":{"resourceType":{"type":"string","enum":["competitions"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The competition that this season belongs to","type":"object"},"seasonId":{"description":"The season that this award is linked to","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"},"fixtureId":{"description":"The match that this award is linked to","type":"string","format":"uuid"},"fixture":{"properties":{"resourceType":{"type":"string","enum":["fixtures"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The match","type":"object"},"votes":{"description":"Number of votes","type":"integer","format":"int32","nullable":true},"dateFrom":{"description":"Date the award is from","type":"string","format":"date","nullable":true},"dateTo":{"description":"Date the award is until","type":"string","format":"date","nullable":true},"award":{"description":"Award\n>- `6th_MAN` Sixth Man\n>- `ALL_TEAM` All first team\n>- `COACH` Coach Award\n>- `DEFENSIVE` Defensive Player\n>- `DEFENSIVE_TEAM` Defensive team\n>- `HALL` Hall of Fame\n>- `HONOUR` Honoured\n>- `MIP` Most Improved Player\n>- `MVP` Most Valuable Player\n>- `OTHER` Other\n>- `ROOKIE` Rookie\n","type":"string","enum":["MVP","MIP","ROOKIE","COACH","ALL_TEAM","DEFENSIVE_TEAM","DEFENSIVE","6th_MAN","OTHER","HONOUR","HALL"],"maxLength":100},"awardSubType":{"description":"Award sub type","type":"string","maxLength":100,"nullable":true},"notes":{"description":"Award Notes","type":"string","maxLength":500,"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}},"title":"~award~ 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":{"/basketball/o/{organizationId}/awards/{awardId}":{"put":{"tags":["Awards"],"summary":"Update an award","description":"Change the information of a specific award","operationId":"awards_update","responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","title":"Awards 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/AwardsModel"}}}}}}},"default":{"$ref":"#/components/responses/ErrorResponse"}},"parameters":[{"name":"awardId","description":"The unique identifier of the award","schema":{"type":"string","format":"uuid"},"required":true,"in":"path"},{"$ref":"#/components/parameters/external"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/hideNull"},{"$ref":"#/components/parameters/include"},{"name":"organizationId","description":"The unique identifier of the organization","schema":{"type":"string","minLength":5,"maxLength":5},"required":true,"in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"personId":{"description":"The person that this award is for","type":"string","format":"uuid"},"entityGroupId":{"description":"The club that this award is linked to","type":"string","format":"uuid"},"entityId":{"description":"The team that this award is linked to","type":"string","format":"uuid"},"competitionId":{"description":"The competition that this award is linked to","type":"string","format":"uuid"},"seasonId":{"description":"The season that this award is linked to","type":"string","format":"uuid"},"fixtureId":{"description":"The match that this award is linked to","type":"string","format":"uuid"},"votes":{"description":"Number of votes","type":"integer","format":"int32","nullable":true},"dateFrom":{"description":"Date the award is from","type":"string","format":"date","nullable":true},"dateTo":{"description":"Date the award is until","type":"string","format":"date","nullable":true},"award":{"description":"Award\n>- `6th_MAN` Sixth Man\n>- `ALL_TEAM` All first team\n>- `COACH` Coach Award\n>- `DEFENSIVE` Defensive Player\n>- `DEFENSIVE_TEAM` Defensive team\n>- `HALL` Hall of Fame\n>- `HONOUR` Honoured\n>- `MIP` Most Improved Player\n>- `MVP` Most Valuable Player\n>- `OTHER` Other\n>- `ROOKIE` Rookie\n","type":"string","enum":["MVP","MIP","ROOKIE","COACH","ALL_TEAM","DEFENSIVE_TEAM","DEFENSIVE","6th_MAN","OTHER","HONOUR","HALL"],"maxLength":100},"awardSubType":{"description":"Award sub type","type":"string","maxLength":100,"nullable":true},"notes":{"description":"Award Notes","type":"string","maxLength":500,"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}},"title":"~award~ put body"}}}}}}}}
```

## Delete an award

> Delete a specific award

```json
{"openapi":"3.0.0","info":{"title":"DataCore API  - basketball","version":"v1"},"tags":[{"name":"Awards","description":"A person can be assigned an award inside an organization, team, club, season, competition or match.  The routes allow awards to be returned that are linked to matches, seasons or not."}],"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"}}}}}},"AwardsModel":{"type":"object","additionalProperties":false,"properties":{"awardId":{"description":"The unique identifier of the award","type":"string","format":"uuid"},"organizationId":{"description":"The unique identifier of the organization","type":"string","readOnly":true},"organization":{"properties":{"resourceType":{"type":"string","enum":["organizations"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The organization that this ~award~ belongs to","type":"object"},"personId":{"description":"The person that this award is for","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"},"entityGroupId":{"description":"The club that this award is linked to","type":"string","format":"uuid"},"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"},"entityId":{"description":"The team that this award is linked to","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"},"competitionId":{"description":"The competition that this award is linked to","type":"string","format":"uuid"},"competition":{"properties":{"resourceType":{"type":"string","enum":["competitions"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The competition that this season belongs to","type":"object"},"seasonId":{"description":"The season that this award is linked to","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"},"fixtureId":{"description":"The match that this award is linked to","type":"string","format":"uuid"},"fixture":{"properties":{"resourceType":{"type":"string","enum":["fixtures"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The match","type":"object"},"votes":{"description":"Number of votes","type":"integer","format":"int32","nullable":true},"dateFrom":{"description":"Date the award is from","type":"string","format":"date","nullable":true},"dateTo":{"description":"Date the award is until","type":"string","format":"date","nullable":true},"award":{"description":"Award\n>- `6th_MAN` Sixth Man\n>- `ALL_TEAM` All first team\n>- `COACH` Coach Award\n>- `DEFENSIVE` Defensive Player\n>- `DEFENSIVE_TEAM` Defensive team\n>- `HALL` Hall of Fame\n>- `HONOUR` Honoured\n>- `MIP` Most Improved Player\n>- `MVP` Most Valuable Player\n>- `OTHER` Other\n>- `ROOKIE` Rookie\n","type":"string","enum":["MVP","MIP","ROOKIE","COACH","ALL_TEAM","DEFENSIVE_TEAM","DEFENSIVE","6th_MAN","OTHER","HONOUR","HALL"],"maxLength":100},"awardSubType":{"description":"Award sub type","type":"string","maxLength":100,"nullable":true},"notes":{"description":"Award Notes","type":"string","maxLength":500,"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}},"title":"~award~ 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":{"/basketball/o/{organizationId}/awards/{awardId}":{"delete":{"tags":["Awards"],"summary":"Delete an award","description":"Delete a specific award","operationId":"award_delete","responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","title":"Awards 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/AwardsModel"}}}}}}},"default":{"$ref":"#/components/responses/ErrorResponse"}},"parameters":[{"name":"awardId","description":"The unique identifier of the award","schema":{"type":"string","format":"uuid"},"required":true,"in":"path"},{"$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"}]}}}}
```


---

# 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/basketball/datacore-api-v1/awards.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.