# Venues
The Venue is the physical location where a match occurs. Every match can have only one venue. The organization has many venues.
## Get a list of venues in the season
> Return a list of venues for a season
```json
{"openapi":"3.0.0","info":{"title":"DataCore API - Hockey","version":"v1"},"tags":[{"name":"Venues","description":"The Venue is the physical location where a match occurs. Every match can have only one venue. The organization has many venues.\n\n![](\"https://yuml.me/diagram/scruffy;dir:LR/class/[Organizations]-<)
[Venues],[Organizations]-<>[Sites],[Matches]-1[Venues{bg:orange}],[Sites]-.-<>[Venues],\">\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_Venues_ListModel":{"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 venues belongs to","type":"object"},"venueId":{"description":"The unique identifier of the venue","type":"string","format":"uuid"},"siteId":{"description":"The site that this season venues belongs to","type":"string","format":"uuid","nullable":true},"site":{"properties":{"resourceType":{"type":"string","enum":["sites"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The site that this season venues belongs to","type":"object"},"abbreviationLocal":{"description":"An abbreviation/short name in the [local](#section/Introduction/Character-Sets-and-Names) language","type":"string","maxLength":50,"nullable":true},"nameLocal":{"description":"The name of the season venues in the [local](#section/Introduction/Character-Sets-and-Names) language","type":"string","maxLength":150},"alternateNameLocal":{"description":"The alternate name of the venue, in Local Language","type":"string","maxLength":150,"nullable":true},"abbreviationLatin":{"description":"An abbreviation/short name in [latin](#section/Introduction/Character-Sets-and-Names) characters","type":"string","maxLength":50,"nullable":true},"nameLatin":{"description":"The name of the season venues in [latin](#section/Introduction/Character-Sets-and-Names) characters","type":"string","maxLength":150,"nullable":true},"alternateNameLatin":{"description":"The alternate name of the venue, in Latin characters","type":"string","maxLength":150,"nullable":true},"countryCode":{"description":"Country code of the season venues. We recommend you use ISO-3166-1:alpha3 (upper case) values where available.","type":"string","minLength":3,"maxLength":3,"nullable":true},"timezone":{"description":"Timezone of the venue. The name of the zone as defined by the IANA TZ database. https://en.wikipedia.org/wiki/List_of_tz_database_time_zones","type":"string","maxLength":150},"address":{"title":"Season Venues address","description":"Street Address for the season venues","type":"object","nullable":true,"additionalProperties":false,"properties":{"address1":{"description":"First line of the address","type":"string","nullable":true},"address2":{"description":"Second line of the address","type":"string","nullable":true},"address3":{"description":"Third line of the address","type":"string","nullable":true},"city":{"description":"The city/suburb of the address","type":"string","nullable":true},"state":{"description":"The state of the address","type":"string","nullable":true},"postalCode":{"description":"The postal code for the address","type":"string","nullable":true},"countryCode":{"description":"ISO Country code of the address. We recommend you use ISO-3166-1:alpha3 (upper case) values where available.","type":"string","nullable":true,"maxLength":3,"minLength":3},"longitude":{"type":"number","nullable":true},"latitude":{"type":"number","nullable":true}}},"social":{"title":"Social Media","description":"Social Media contacts","type":"object","nullable":true,"additionalProperties":false,"properties":{"website":{"type":"string","nullable":true,"format":"uri"},"facebook":{"type":"string","nullable":true},"twitter":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true,"format":"uri"},"instagram":{"type":"string","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":"season venues 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"},"nameLatin":{"name":"nameLatin","description":"The full name in latin characters","schema":{"type":"string","maxLength":50},"required":false,"in":"query"},"nameLatinContains":{"name":"nameLatinContains","description":"Fields that allow a 'Contains' query string parameter search for words separated by a space, matching characters left to right. Example: nameLatin=David Johnson nameLatinContains=Dav will match nameLatinContains=John will match nameLatinContains=son will not match","schema":{"type":"string","minLength":2,"maxLength":50},"required":false,"in":"query"},"nameLocal":{"name":"nameLocal","description":"The full name","schema":{"type":"string","maxLength":50},"required":false,"in":"query"},"nameLocalContains":{"name":"nameLocalContains","description":"Fields that allow a 'Contains' query string parameter search for words separated by a space, matching characters left to right. Example: nameLocal=David Johnson nameLocalContains=Dav will match nameLocalContains=John will match nameLocalContains=son will not match","schema":{"type":"string","minLength":2,"maxLength":50},"required":false,"in":"query"},"offset":{"name":"offset","description":"The offset of the records. See [Pagination](#section/Introduction/Pagination) for more information.","schema":{"type":"integer","format":"int32"},"required":false,"in":"query"}}},"paths":{"/hockey/o/{organizationId}/seasons/{seasonId}/venues":{"get":{"tags":["Venues"],"summary":"Get a list of venues in the season","description":"Return a list of venues for a season","operationId":"season_venues_list","responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","title":"Season_Venues_List 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_Venues_ListModel"}}}}}}},"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/nameLatin"},{"$ref":"#/components/parameters/nameLatinContains"},{"$ref":"#/components/parameters/nameLocal"},{"$ref":"#/components/parameters/nameLocalContains"},{"$ref":"#/components/parameters/offset"},{"name":"organizationId","description":"The unique identifier of the organization","schema":{"type":"string","minLength":5,"maxLength":5},"required":true,"in":"path"},{"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":"^(\\-?nameLocal|\\-?nameLatin|,)*$"},"required":false,"in":"query"},{"name":"venueId","description":"The unique identifiers of the venues (comma-delimited).","schema":{"type":"string","format":"uuid"},"required":false,"in":"query"}]}}}}
```
## Get a list of venues
> Return a list of available venues
```json
{"openapi":"3.0.0","info":{"title":"DataCore API - Hockey","version":"v1"},"tags":[{"name":"Venues","description":"The Venue is the physical location where a match occurs. Every match can have only one venue. The organization has many venues.\n\n[Venues],[Organizations]-<>[Sites],[Matches]-1[Venues{bg:orange}],[Sites]-.-<>[Venues],\">\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"}}}}}},"VenuesModel":{"type":"object","additionalProperties":false,"properties":{"venueId":{"description":"The unique identifier of the venue","type":"string","format":"uuid"},"siteId":{"description":"The site that this venue belongs to","type":"string","format":"uuid","nullable":true},"site":{"properties":{"resourceType":{"type":"string","enum":["sites"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The site that this venue belongs to","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 venue belongs to","type":"object"},"abbreviationLocal":{"description":"An abbreviation/short name in the [local](#section/Introduction/Character-Sets-and-Names) language","type":"string","maxLength":30,"nullable":true},"nameLocal":{"description":"The name of the venue in the [local](#section/Introduction/Character-Sets-and-Names) language","type":"string","maxLength":150},"status":{"description":"Status\n>- `ACTIVE` Active\n>- `INACTIVE` Inactive\n>- `PENDING` Pending\n","type":"string","enum":["ACTIVE","INACTIVE","PENDING"],"maxLength":30,"default":"ACTIVE"},"alternateNameLocal":{"description":"The alternate name of the venue, in Local Language","type":"string","maxLength":150,"nullable":true},"abbreviationLatin":{"description":"An abbreviation/short name in [latin](#section/Introduction/Character-Sets-and-Names) characters","type":"string","maxLength":30,"nullable":true},"nameLatin":{"description":"The name of the venue in [latin](#section/Introduction/Character-Sets-and-Names) characters","type":"string","maxLength":150,"nullable":true},"alternateNameLatin":{"description":"The alternate name of the venue, in Latin characters","type":"string","maxLength":150,"nullable":true},"countryCode":{"description":"Country code of the venue. We recommend you use ISO-3166-1:alpha3 (upper case) values where available.","type":"string","minLength":3,"maxLength":3,"nullable":true},"timezone":{"description":"Timezone of the venue. The name of the zone as defined by the IANA TZ database. https://en.wikipedia.org/wiki/List_of_tz_database_time_zones","type":"string","maxLength":150},"address":{"title":"Venue address","description":"Street Address for the venue","type":"object","nullable":true,"additionalProperties":false,"properties":{"address1":{"description":"First line of the address","type":"string","nullable":true},"address2":{"description":"Second line of the address","type":"string","nullable":true},"address3":{"description":"Third line of the address","type":"string","nullable":true},"city":{"description":"The city/suburb of the address","type":"string","nullable":true},"state":{"description":"The state of the address","type":"string","nullable":true},"postalCode":{"description":"The postal code for the address","type":"string","nullable":true},"countryCode":{"description":"ISO Country code of the address. We recommend you use ISO-3166-1:alpha3 (upper case) values where available.","type":"string","nullable":true,"maxLength":3,"minLength":3},"longitude":{"type":"number","nullable":true},"latitude":{"type":"number","nullable":true}}},"social":{"title":"Social Media","description":"Social Media contacts","type":"object","nullable":true,"additionalProperties":false,"properties":{"website":{"type":"string","nullable":true,"format":"uri"},"facebook":{"type":"string","nullable":true},"twitter":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true,"format":"uri"},"instagram":{"type":"string","nullable":true}}},"capacity":{"description":"This is the maximum number of people allowed for the venue in normal use. Certain events/configurations of the venue may cause this capacity to be increased/decreased - this is not reflected in this value.","type":"integer","format":"int32","nullable":true},"historicalNames":{"type":"array","nullable":true,"title":"Venue historical names","description":"Array of venue historical names","items":{"type":"object","title":"Venue historical name","additionalProperties":false,"properties":{"dateStart":{"description":"Start date","type":"string","nullable":true,"format":"date"},"dateEnd":{"description":"End date","type":"string","nullable":true,"format":"date"},"nameLocal":{"description":"Full name in local language","type":"string","nullable":true},"nameLatin":{"description":"Full name in latin characters","type":"string","nullable":true},"alternateNameLocal":{"description":"Alternate name in local lanuage","type":"string","nullable":true},"alternateNameLatin":{"description":"Alternate name in latin characters","type":"string","nullable":true},"abbreviationLocal":{"description":"Abbreviation in local lanuage","type":"string","nullable":true},"abbreviationLatin":{"description":"Abbreviation in latin characters","type":"string","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},"masterVenueId":{"description":"The unique identifier of the master venue","type":"string","format":"uuid","readOnly":true},"updated":{"description":"Date/time last modified. In UTC","type":"string","format":"date-time","readOnly":true},"added":{"description":"Date/time added. In UTC","type":"string","format":"date-time","readOnly":true}},"title":"venue 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"},"countryCode":{"name":"countryCode","description":"Country code","schema":{"type":"string","minLength":3,"maxLength":3},"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"},"nameLatin":{"name":"nameLatin","description":"The full name in latin characters","schema":{"type":"string","maxLength":50},"required":false,"in":"query"},"nameLatinContains":{"name":"nameLatinContains","description":"Fields that allow a 'Contains' query string parameter search for words separated by a space, matching characters left to right. Example: nameLatin=David Johnson nameLatinContains=Dav will match nameLatinContains=John will match nameLatinContains=son will not match","schema":{"type":"string","minLength":2,"maxLength":50},"required":false,"in":"query"},"nameLocal":{"name":"nameLocal","description":"The full name","schema":{"type":"string","maxLength":50},"required":false,"in":"query"},"nameLocalContains":{"name":"nameLocalContains","description":"Fields that allow a 'Contains' query string parameter search for words separated by a space, matching characters left to right. Example: nameLocal=David Johnson nameLocalContains=Dav will match nameLocalContains=John will match nameLocalContains=son will not match","schema":{"type":"string","minLength":2,"maxLength":50},"required":false,"in":"query"},"offset":{"name":"offset","description":"The offset of the records. See [Pagination](#section/Introduction/Pagination) for more information.","schema":{"type":"integer","format":"int32"},"required":false,"in":"query"},"status":{"name":"status","description":"Status\n>- `ACTIVE` Active\n>- `INACTIVE` Inactive\n>- `PENDING` Pending\n","schema":{"type":"string","enum":["ACTIVE","INACTIVE","PENDING"]},"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":{"/hockey/o/{organizationId}/venues":{"get":{"tags":["Venues"],"summary":"Get a list of venues","description":"Return a list of available venues","operationId":"venue_list","responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","title":"Venues 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/VenuesModel"}}}}}}},"default":{"$ref":"#/components/responses/ErrorResponse"}},"parameters":[{"$ref":"#/components/parameters/added"},{"$ref":"#/components/parameters/countryCode"},{"$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/nameLatin"},{"$ref":"#/components/parameters/nameLatinContains"},{"$ref":"#/components/parameters/nameLocal"},{"$ref":"#/components/parameters/nameLocalContains"},{"$ref":"#/components/parameters/offset"},{"name":"organizationId","description":"The unique identifier of the organization","schema":{"type":"string","minLength":5,"maxLength":5},"required":true,"in":"path"},{"name":"sortBy","description":"Comma-delimited list of one or more fields to sort by. Each field can have '-' as prefix to sort in descending order and no prefix to sort in ascending order.","schema":{"type":"string","pattern":"^(\\-?nameLocal|\\-?nameLatin|,)*$"},"required":false,"in":"query"},{"$ref":"#/components/parameters/status"},{"$ref":"#/components/parameters/updated"},{"name":"venueId","description":"The unique identifiers of the venues (comma-delimited).","schema":{"type":"string","format":"uuid"},"required":false,"in":"query"}]}}}}
```
## Create a venue
> Add a new venue
```json
{"openapi":"3.0.0","info":{"title":"DataCore API - Hockey","version":"v1"},"tags":[{"name":"Venues","description":"The Venue is the physical location where a match occurs. Every match can have only one venue. The organization has many venues.\n\n[Venues],[Organizations]-<>[Sites],[Matches]-1[Venues{bg:orange}],[Sites]-.-<>[Venues],\">\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"}}}}}},"VenuesModel":{"type":"object","additionalProperties":false,"properties":{"venueId":{"description":"The unique identifier of the venue","type":"string","format":"uuid"},"siteId":{"description":"The site that this venue belongs to","type":"string","format":"uuid","nullable":true},"site":{"properties":{"resourceType":{"type":"string","enum":["sites"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The site that this venue belongs to","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 venue belongs to","type":"object"},"abbreviationLocal":{"description":"An abbreviation/short name in the [local](#section/Introduction/Character-Sets-and-Names) language","type":"string","maxLength":30,"nullable":true},"nameLocal":{"description":"The name of the venue in the [local](#section/Introduction/Character-Sets-and-Names) language","type":"string","maxLength":150},"status":{"description":"Status\n>- `ACTIVE` Active\n>- `INACTIVE` Inactive\n>- `PENDING` Pending\n","type":"string","enum":["ACTIVE","INACTIVE","PENDING"],"maxLength":30,"default":"ACTIVE"},"alternateNameLocal":{"description":"The alternate name of the venue, in Local Language","type":"string","maxLength":150,"nullable":true},"abbreviationLatin":{"description":"An abbreviation/short name in [latin](#section/Introduction/Character-Sets-and-Names) characters","type":"string","maxLength":30,"nullable":true},"nameLatin":{"description":"The name of the venue in [latin](#section/Introduction/Character-Sets-and-Names) characters","type":"string","maxLength":150,"nullable":true},"alternateNameLatin":{"description":"The alternate name of the venue, in Latin characters","type":"string","maxLength":150,"nullable":true},"countryCode":{"description":"Country code of the venue. We recommend you use ISO-3166-1:alpha3 (upper case) values where available.","type":"string","minLength":3,"maxLength":3,"nullable":true},"timezone":{"description":"Timezone of the venue. The name of the zone as defined by the IANA TZ database. https://en.wikipedia.org/wiki/List_of_tz_database_time_zones","type":"string","maxLength":150},"address":{"title":"Venue address","description":"Street Address for the venue","type":"object","nullable":true,"additionalProperties":false,"properties":{"address1":{"description":"First line of the address","type":"string","nullable":true},"address2":{"description":"Second line of the address","type":"string","nullable":true},"address3":{"description":"Third line of the address","type":"string","nullable":true},"city":{"description":"The city/suburb of the address","type":"string","nullable":true},"state":{"description":"The state of the address","type":"string","nullable":true},"postalCode":{"description":"The postal code for the address","type":"string","nullable":true},"countryCode":{"description":"ISO Country code of the address. We recommend you use ISO-3166-1:alpha3 (upper case) values where available.","type":"string","nullable":true,"maxLength":3,"minLength":3},"longitude":{"type":"number","nullable":true},"latitude":{"type":"number","nullable":true}}},"social":{"title":"Social Media","description":"Social Media contacts","type":"object","nullable":true,"additionalProperties":false,"properties":{"website":{"type":"string","nullable":true,"format":"uri"},"facebook":{"type":"string","nullable":true},"twitter":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true,"format":"uri"},"instagram":{"type":"string","nullable":true}}},"capacity":{"description":"This is the maximum number of people allowed for the venue in normal use. Certain events/configurations of the venue may cause this capacity to be increased/decreased - this is not reflected in this value.","type":"integer","format":"int32","nullable":true},"historicalNames":{"type":"array","nullable":true,"title":"Venue historical names","description":"Array of venue historical names","items":{"type":"object","title":"Venue historical name","additionalProperties":false,"properties":{"dateStart":{"description":"Start date","type":"string","nullable":true,"format":"date"},"dateEnd":{"description":"End date","type":"string","nullable":true,"format":"date"},"nameLocal":{"description":"Full name in local language","type":"string","nullable":true},"nameLatin":{"description":"Full name in latin characters","type":"string","nullable":true},"alternateNameLocal":{"description":"Alternate name in local lanuage","type":"string","nullable":true},"alternateNameLatin":{"description":"Alternate name in latin characters","type":"string","nullable":true},"abbreviationLocal":{"description":"Abbreviation in local lanuage","type":"string","nullable":true},"abbreviationLatin":{"description":"Abbreviation in latin characters","type":"string","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},"masterVenueId":{"description":"The unique identifier of the master venue","type":"string","format":"uuid","readOnly":true},"updated":{"description":"Date/time last modified. In UTC","type":"string","format":"date-time","readOnly":true},"added":{"description":"Date/time added. In UTC","type":"string","format":"date-time","readOnly":true}},"title":"venue 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":{"/hockey/o/{organizationId}/venues":{"post":{"tags":["Venues"],"summary":"Create a venue","description":"Add a new venue","operationId":"venue_insert","responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","title":"Venues 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/VenuesModel"}}}}}}},"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":{"venueId":{"description":"The unique identifier of the venue","type":"string","format":"uuid"},"siteId":{"description":"The site that this venue belongs to","type":"string","format":"uuid","nullable":true},"abbreviationLocal":{"description":"An abbreviation/short name in the [local](#section/Introduction/Character-Sets-and-Names) language","type":"string","maxLength":30,"nullable":true},"nameLocal":{"description":"The name of the venue in the [local](#section/Introduction/Character-Sets-and-Names) language","type":"string","maxLength":150},"status":{"description":"Status\n>- `ACTIVE` Active\n>- `INACTIVE` Inactive\n>- `PENDING` Pending\n","type":"string","enum":["ACTIVE","INACTIVE","PENDING"],"maxLength":30,"default":"ACTIVE"},"alternateNameLocal":{"description":"The alternate name of the venue, in Local Language","type":"string","maxLength":150,"nullable":true},"abbreviationLatin":{"description":"An abbreviation/short name in [latin](#section/Introduction/Character-Sets-and-Names) characters","type":"string","maxLength":30,"nullable":true},"nameLatin":{"description":"The name of the venue in [latin](#section/Introduction/Character-Sets-and-Names) characters","type":"string","maxLength":150,"nullable":true},"alternateNameLatin":{"description":"The alternate name of the venue, in Latin characters","type":"string","maxLength":150,"nullable":true},"countryCode":{"description":"Country code of the venue. We recommend you use ISO-3166-1:alpha3 (upper case) values where available.","type":"string","minLength":3,"maxLength":3,"nullable":true},"timezone":{"description":"Timezone of the venue. The name of the zone as defined by the IANA TZ database. https://en.wikipedia.org/wiki/List_of_tz_database_time_zones","type":"string","maxLength":150},"address":{"title":"Venue address","description":"Street Address for the venue","type":"object","nullable":true,"additionalProperties":false,"properties":{"address1":{"description":"First line of the address","type":"string","nullable":true},"address2":{"description":"Second line of the address","type":"string","nullable":true},"address3":{"description":"Third line of the address","type":"string","nullable":true},"city":{"description":"The city/suburb of the address","type":"string","nullable":true},"state":{"description":"The state of the address","type":"string","nullable":true},"postalCode":{"description":"The postal code for the address","type":"string","nullable":true},"countryCode":{"description":"ISO Country code of the address. We recommend you use ISO-3166-1:alpha3 (upper case) values where available.","type":"string","nullable":true,"maxLength":3,"minLength":3},"longitude":{"type":"number","nullable":true},"latitude":{"type":"number","nullable":true}}},"social":{"title":"Social Media","description":"Social Media contacts","type":"object","nullable":true,"additionalProperties":false,"properties":{"website":{"type":"string","nullable":true,"format":"uri"},"facebook":{"type":"string","nullable":true},"twitter":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true,"format":"uri"},"instagram":{"type":"string","nullable":true}}},"capacity":{"description":"This is the maximum number of people allowed for the venue in normal use. Certain events/configurations of the venue may cause this capacity to be increased/decreased - this is not reflected in this value.","type":"integer","format":"int32","nullable":true},"historicalNames":{"type":"array","nullable":true,"title":"Venue historical names","description":"Array of venue historical names","items":{"type":"object","title":"Venue historical name","additionalProperties":false,"properties":{"dateStart":{"description":"Start date","type":"string","nullable":true,"format":"date"},"dateEnd":{"description":"End date","type":"string","nullable":true,"format":"date"},"nameLocal":{"description":"Full name in local language","type":"string","nullable":true},"nameLatin":{"description":"Full name in latin characters","type":"string","nullable":true},"alternateNameLocal":{"description":"Alternate name in local lanuage","type":"string","nullable":true},"alternateNameLatin":{"description":"Alternate name in latin characters","type":"string","nullable":true},"abbreviationLocal":{"description":"Abbreviation in local lanuage","type":"string","nullable":true},"abbreviationLatin":{"description":"Abbreviation in latin characters","type":"string","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":"venue post body","required":["nameLocal","timezone"]}}}}}}}}
```
## Get a list of venues by site
> Return a list of available venues
```json
{"openapi":"3.0.0","info":{"title":"DataCore API - Hockey","version":"v1"},"tags":[{"name":"Venues","description":"The Venue is the physical location where a match occurs. Every match can have only one venue. The organization has many venues.\n\n[Venues],[Organizations]-<>[Sites],[Matches]-1[Venues{bg:orange}],[Sites]-.-<>[Venues],\">\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"}}}}}},"VenuesModel":{"type":"object","additionalProperties":false,"properties":{"venueId":{"description":"The unique identifier of the venue","type":"string","format":"uuid"},"siteId":{"description":"The site that this venue belongs to","type":"string","format":"uuid","nullable":true},"site":{"properties":{"resourceType":{"type":"string","enum":["sites"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The site that this venue belongs to","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 venue belongs to","type":"object"},"abbreviationLocal":{"description":"An abbreviation/short name in the [local](#section/Introduction/Character-Sets-and-Names) language","type":"string","maxLength":30,"nullable":true},"nameLocal":{"description":"The name of the venue in the [local](#section/Introduction/Character-Sets-and-Names) language","type":"string","maxLength":150},"status":{"description":"Status\n>- `ACTIVE` Active\n>- `INACTIVE` Inactive\n>- `PENDING` Pending\n","type":"string","enum":["ACTIVE","INACTIVE","PENDING"],"maxLength":30,"default":"ACTIVE"},"alternateNameLocal":{"description":"The alternate name of the venue, in Local Language","type":"string","maxLength":150,"nullable":true},"abbreviationLatin":{"description":"An abbreviation/short name in [latin](#section/Introduction/Character-Sets-and-Names) characters","type":"string","maxLength":30,"nullable":true},"nameLatin":{"description":"The name of the venue in [latin](#section/Introduction/Character-Sets-and-Names) characters","type":"string","maxLength":150,"nullable":true},"alternateNameLatin":{"description":"The alternate name of the venue, in Latin characters","type":"string","maxLength":150,"nullable":true},"countryCode":{"description":"Country code of the venue. We recommend you use ISO-3166-1:alpha3 (upper case) values where available.","type":"string","minLength":3,"maxLength":3,"nullable":true},"timezone":{"description":"Timezone of the venue. The name of the zone as defined by the IANA TZ database. https://en.wikipedia.org/wiki/List_of_tz_database_time_zones","type":"string","maxLength":150},"address":{"title":"Venue address","description":"Street Address for the venue","type":"object","nullable":true,"additionalProperties":false,"properties":{"address1":{"description":"First line of the address","type":"string","nullable":true},"address2":{"description":"Second line of the address","type":"string","nullable":true},"address3":{"description":"Third line of the address","type":"string","nullable":true},"city":{"description":"The city/suburb of the address","type":"string","nullable":true},"state":{"description":"The state of the address","type":"string","nullable":true},"postalCode":{"description":"The postal code for the address","type":"string","nullable":true},"countryCode":{"description":"ISO Country code of the address. We recommend you use ISO-3166-1:alpha3 (upper case) values where available.","type":"string","nullable":true,"maxLength":3,"minLength":3},"longitude":{"type":"number","nullable":true},"latitude":{"type":"number","nullable":true}}},"social":{"title":"Social Media","description":"Social Media contacts","type":"object","nullable":true,"additionalProperties":false,"properties":{"website":{"type":"string","nullable":true,"format":"uri"},"facebook":{"type":"string","nullable":true},"twitter":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true,"format":"uri"},"instagram":{"type":"string","nullable":true}}},"capacity":{"description":"This is the maximum number of people allowed for the venue in normal use. Certain events/configurations of the venue may cause this capacity to be increased/decreased - this is not reflected in this value.","type":"integer","format":"int32","nullable":true},"historicalNames":{"type":"array","nullable":true,"title":"Venue historical names","description":"Array of venue historical names","items":{"type":"object","title":"Venue historical name","additionalProperties":false,"properties":{"dateStart":{"description":"Start date","type":"string","nullable":true,"format":"date"},"dateEnd":{"description":"End date","type":"string","nullable":true,"format":"date"},"nameLocal":{"description":"Full name in local language","type":"string","nullable":true},"nameLatin":{"description":"Full name in latin characters","type":"string","nullable":true},"alternateNameLocal":{"description":"Alternate name in local lanuage","type":"string","nullable":true},"alternateNameLatin":{"description":"Alternate name in latin characters","type":"string","nullable":true},"abbreviationLocal":{"description":"Abbreviation in local lanuage","type":"string","nullable":true},"abbreviationLatin":{"description":"Abbreviation in latin characters","type":"string","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},"masterVenueId":{"description":"The unique identifier of the master venue","type":"string","format":"uuid","readOnly":true},"updated":{"description":"Date/time last modified. In UTC","type":"string","format":"date-time","readOnly":true},"added":{"description":"Date/time added. In UTC","type":"string","format":"date-time","readOnly":true}},"title":"venue 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"},"countryCode":{"name":"countryCode","description":"Country code","schema":{"type":"string","minLength":3,"maxLength":3},"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"},"nameLatin":{"name":"nameLatin","description":"The full name in latin characters","schema":{"type":"string","maxLength":50},"required":false,"in":"query"},"nameLocal":{"name":"nameLocal","description":"The full name","schema":{"type":"string","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"},"status":{"name":"status","description":"Status\n>- `ACTIVE` Active\n>- `INACTIVE` Inactive\n>- `PENDING` Pending\n","schema":{"type":"string","enum":["ACTIVE","INACTIVE","PENDING"]},"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":{"/hockey/o/{organizationId}/sites/{siteId}/venues":{"get":{"tags":["Venues"],"summary":"Get a list of venues by site","description":"Return a list of available venues","operationId":"venue_list_by_siteId","responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","title":"Venues 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/VenuesModel"}}}}}}},"default":{"$ref":"#/components/responses/ErrorResponse"}},"parameters":[{"$ref":"#/components/parameters/added"},{"$ref":"#/components/parameters/countryCode"},{"$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/nameLatin"},{"$ref":"#/components/parameters/nameLocal"},{"$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":"siteId","description":"The unique identifier of the site","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":"^(\\-?nameLocal|\\-?nameLatin|,)*$"},"required":false,"in":"query"},{"$ref":"#/components/parameters/status"},{"$ref":"#/components/parameters/updated"},{"name":"venueId","description":"The unique identifiers of the venues (comma-delimited).","schema":{"type":"string","format":"uuid"},"required":false,"in":"query"}]}}}}
```
## Get a venue
> Return detailed information about a specific venue
```json
{"openapi":"3.0.0","info":{"title":"DataCore API - Hockey","version":"v1"},"tags":[{"name":"Venues","description":"The Venue is the physical location where a match occurs. Every match can have only one venue. The organization has many venues.\n\n[Venues],[Organizations]-<>[Sites],[Matches]-1[Venues{bg:orange}],[Sites]-.-<>[Venues],\">\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"}}}}}},"VenuesModel":{"type":"object","additionalProperties":false,"properties":{"venueId":{"description":"The unique identifier of the venue","type":"string","format":"uuid"},"siteId":{"description":"The site that this venue belongs to","type":"string","format":"uuid","nullable":true},"site":{"properties":{"resourceType":{"type":"string","enum":["sites"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The site that this venue belongs to","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 venue belongs to","type":"object"},"abbreviationLocal":{"description":"An abbreviation/short name in the [local](#section/Introduction/Character-Sets-and-Names) language","type":"string","maxLength":30,"nullable":true},"nameLocal":{"description":"The name of the venue in the [local](#section/Introduction/Character-Sets-and-Names) language","type":"string","maxLength":150},"status":{"description":"Status\n>- `ACTIVE` Active\n>- `INACTIVE` Inactive\n>- `PENDING` Pending\n","type":"string","enum":["ACTIVE","INACTIVE","PENDING"],"maxLength":30,"default":"ACTIVE"},"alternateNameLocal":{"description":"The alternate name of the venue, in Local Language","type":"string","maxLength":150,"nullable":true},"abbreviationLatin":{"description":"An abbreviation/short name in [latin](#section/Introduction/Character-Sets-and-Names) characters","type":"string","maxLength":30,"nullable":true},"nameLatin":{"description":"The name of the venue in [latin](#section/Introduction/Character-Sets-and-Names) characters","type":"string","maxLength":150,"nullable":true},"alternateNameLatin":{"description":"The alternate name of the venue, in Latin characters","type":"string","maxLength":150,"nullable":true},"countryCode":{"description":"Country code of the venue. We recommend you use ISO-3166-1:alpha3 (upper case) values where available.","type":"string","minLength":3,"maxLength":3,"nullable":true},"timezone":{"description":"Timezone of the venue. The name of the zone as defined by the IANA TZ database. https://en.wikipedia.org/wiki/List_of_tz_database_time_zones","type":"string","maxLength":150},"address":{"title":"Venue address","description":"Street Address for the venue","type":"object","nullable":true,"additionalProperties":false,"properties":{"address1":{"description":"First line of the address","type":"string","nullable":true},"address2":{"description":"Second line of the address","type":"string","nullable":true},"address3":{"description":"Third line of the address","type":"string","nullable":true},"city":{"description":"The city/suburb of the address","type":"string","nullable":true},"state":{"description":"The state of the address","type":"string","nullable":true},"postalCode":{"description":"The postal code for the address","type":"string","nullable":true},"countryCode":{"description":"ISO Country code of the address. We recommend you use ISO-3166-1:alpha3 (upper case) values where available.","type":"string","nullable":true,"maxLength":3,"minLength":3},"longitude":{"type":"number","nullable":true},"latitude":{"type":"number","nullable":true}}},"social":{"title":"Social Media","description":"Social Media contacts","type":"object","nullable":true,"additionalProperties":false,"properties":{"website":{"type":"string","nullable":true,"format":"uri"},"facebook":{"type":"string","nullable":true},"twitter":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true,"format":"uri"},"instagram":{"type":"string","nullable":true}}},"capacity":{"description":"This is the maximum number of people allowed for the venue in normal use. Certain events/configurations of the venue may cause this capacity to be increased/decreased - this is not reflected in this value.","type":"integer","format":"int32","nullable":true},"historicalNames":{"type":"array","nullable":true,"title":"Venue historical names","description":"Array of venue historical names","items":{"type":"object","title":"Venue historical name","additionalProperties":false,"properties":{"dateStart":{"description":"Start date","type":"string","nullable":true,"format":"date"},"dateEnd":{"description":"End date","type":"string","nullable":true,"format":"date"},"nameLocal":{"description":"Full name in local language","type":"string","nullable":true},"nameLatin":{"description":"Full name in latin characters","type":"string","nullable":true},"alternateNameLocal":{"description":"Alternate name in local lanuage","type":"string","nullable":true},"alternateNameLatin":{"description":"Alternate name in latin characters","type":"string","nullable":true},"abbreviationLocal":{"description":"Abbreviation in local lanuage","type":"string","nullable":true},"abbreviationLatin":{"description":"Abbreviation in latin characters","type":"string","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},"masterVenueId":{"description":"The unique identifier of the master venue","type":"string","format":"uuid","readOnly":true},"updated":{"description":"Date/time last modified. In UTC","type":"string","format":"date-time","readOnly":true},"added":{"description":"Date/time added. In UTC","type":"string","format":"date-time","readOnly":true}},"title":"venue 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":{"/hockey/o/{organizationId}/venues/{venueId}":{"get":{"tags":["Venues"],"summary":"Get a venue","description":"Return detailed information about a specific venue","operationId":"venue_detail","responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","title":"Venues 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/VenuesModel"}}}}}}},"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":"venueId","description":"The unique identifier of the venue","schema":{"type":"string","format":"uuid"},"required":true,"in":"path"}]}}}}
```
## Update a venue
> Change the information of a specific venue
```json
{"openapi":"3.0.0","info":{"title":"DataCore API - Hockey","version":"v1"},"tags":[{"name":"Venues","description":"The Venue is the physical location where a match occurs. Every match can have only one venue. The organization has many venues.\n\n[Venues],[Organizations]-<>[Sites],[Matches]-1[Venues{bg:orange}],[Sites]-.-<>[Venues],\">\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"}}}}}},"VenuesModel":{"type":"object","additionalProperties":false,"properties":{"venueId":{"description":"The unique identifier of the venue","type":"string","format":"uuid"},"siteId":{"description":"The site that this venue belongs to","type":"string","format":"uuid","nullable":true},"site":{"properties":{"resourceType":{"type":"string","enum":["sites"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The site that this venue belongs to","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 venue belongs to","type":"object"},"abbreviationLocal":{"description":"An abbreviation/short name in the [local](#section/Introduction/Character-Sets-and-Names) language","type":"string","maxLength":30,"nullable":true},"nameLocal":{"description":"The name of the venue in the [local](#section/Introduction/Character-Sets-and-Names) language","type":"string","maxLength":150},"status":{"description":"Status\n>- `ACTIVE` Active\n>- `INACTIVE` Inactive\n>- `PENDING` Pending\n","type":"string","enum":["ACTIVE","INACTIVE","PENDING"],"maxLength":30,"default":"ACTIVE"},"alternateNameLocal":{"description":"The alternate name of the venue, in Local Language","type":"string","maxLength":150,"nullable":true},"abbreviationLatin":{"description":"An abbreviation/short name in [latin](#section/Introduction/Character-Sets-and-Names) characters","type":"string","maxLength":30,"nullable":true},"nameLatin":{"description":"The name of the venue in [latin](#section/Introduction/Character-Sets-and-Names) characters","type":"string","maxLength":150,"nullable":true},"alternateNameLatin":{"description":"The alternate name of the venue, in Latin characters","type":"string","maxLength":150,"nullable":true},"countryCode":{"description":"Country code of the venue. We recommend you use ISO-3166-1:alpha3 (upper case) values where available.","type":"string","minLength":3,"maxLength":3,"nullable":true},"timezone":{"description":"Timezone of the venue. The name of the zone as defined by the IANA TZ database. https://en.wikipedia.org/wiki/List_of_tz_database_time_zones","type":"string","maxLength":150},"address":{"title":"Venue address","description":"Street Address for the venue","type":"object","nullable":true,"additionalProperties":false,"properties":{"address1":{"description":"First line of the address","type":"string","nullable":true},"address2":{"description":"Second line of the address","type":"string","nullable":true},"address3":{"description":"Third line of the address","type":"string","nullable":true},"city":{"description":"The city/suburb of the address","type":"string","nullable":true},"state":{"description":"The state of the address","type":"string","nullable":true},"postalCode":{"description":"The postal code for the address","type":"string","nullable":true},"countryCode":{"description":"ISO Country code of the address. We recommend you use ISO-3166-1:alpha3 (upper case) values where available.","type":"string","nullable":true,"maxLength":3,"minLength":3},"longitude":{"type":"number","nullable":true},"latitude":{"type":"number","nullable":true}}},"social":{"title":"Social Media","description":"Social Media contacts","type":"object","nullable":true,"additionalProperties":false,"properties":{"website":{"type":"string","nullable":true,"format":"uri"},"facebook":{"type":"string","nullable":true},"twitter":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true,"format":"uri"},"instagram":{"type":"string","nullable":true}}},"capacity":{"description":"This is the maximum number of people allowed for the venue in normal use. Certain events/configurations of the venue may cause this capacity to be increased/decreased - this is not reflected in this value.","type":"integer","format":"int32","nullable":true},"historicalNames":{"type":"array","nullable":true,"title":"Venue historical names","description":"Array of venue historical names","items":{"type":"object","title":"Venue historical name","additionalProperties":false,"properties":{"dateStart":{"description":"Start date","type":"string","nullable":true,"format":"date"},"dateEnd":{"description":"End date","type":"string","nullable":true,"format":"date"},"nameLocal":{"description":"Full name in local language","type":"string","nullable":true},"nameLatin":{"description":"Full name in latin characters","type":"string","nullable":true},"alternateNameLocal":{"description":"Alternate name in local lanuage","type":"string","nullable":true},"alternateNameLatin":{"description":"Alternate name in latin characters","type":"string","nullable":true},"abbreviationLocal":{"description":"Abbreviation in local lanuage","type":"string","nullable":true},"abbreviationLatin":{"description":"Abbreviation in latin characters","type":"string","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},"masterVenueId":{"description":"The unique identifier of the master venue","type":"string","format":"uuid","readOnly":true},"updated":{"description":"Date/time last modified. In UTC","type":"string","format":"date-time","readOnly":true},"added":{"description":"Date/time added. In UTC","type":"string","format":"date-time","readOnly":true}},"title":"venue 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":{"/hockey/o/{organizationId}/venues/{venueId}":{"put":{"tags":["Venues"],"summary":"Update a venue","description":"Change the information of a specific venue","operationId":"venue_update","responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","title":"Venues 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/VenuesModel"}}}}}}},"default":{"$ref":"#/components/responses/ErrorResponse"}},"parameters":[{"$ref":"#/components/parameters/external"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/hideNull"},{"$ref":"#/components/parameters/include"},{"name":"organizationId","description":"The unique identifier of the organization","schema":{"type":"string","minLength":5,"maxLength":5},"required":true,"in":"path"},{"name":"venueId","description":"The unique identifier of the venue","schema":{"type":"string","format":"uuid"},"required":true,"in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"siteId":{"description":"The site that this venue belongs to","type":"string","format":"uuid","nullable":true},"abbreviationLocal":{"description":"An abbreviation/short name in the [local](#section/Introduction/Character-Sets-and-Names) language","type":"string","maxLength":30,"nullable":true},"nameLocal":{"description":"The name of the venue in the [local](#section/Introduction/Character-Sets-and-Names) language","type":"string","maxLength":150},"status":{"description":"Status\n>- `ACTIVE` Active\n>- `INACTIVE` Inactive\n>- `PENDING` Pending\n","type":"string","enum":["ACTIVE","INACTIVE","PENDING"],"maxLength":30,"default":"ACTIVE"},"alternateNameLocal":{"description":"The alternate name of the venue, in Local Language","type":"string","maxLength":150,"nullable":true},"abbreviationLatin":{"description":"An abbreviation/short name in [latin](#section/Introduction/Character-Sets-and-Names) characters","type":"string","maxLength":30,"nullable":true},"nameLatin":{"description":"The name of the venue in [latin](#section/Introduction/Character-Sets-and-Names) characters","type":"string","maxLength":150,"nullable":true},"alternateNameLatin":{"description":"The alternate name of the venue, in Latin characters","type":"string","maxLength":150,"nullable":true},"countryCode":{"description":"Country code of the venue. We recommend you use ISO-3166-1:alpha3 (upper case) values where available.","type":"string","minLength":3,"maxLength":3,"nullable":true},"timezone":{"description":"Timezone of the venue. The name of the zone as defined by the IANA TZ database. https://en.wikipedia.org/wiki/List_of_tz_database_time_zones","type":"string","maxLength":150},"address":{"title":"Venue address","description":"Street Address for the venue","type":"object","nullable":true,"additionalProperties":false,"properties":{"address1":{"description":"First line of the address","type":"string","nullable":true},"address2":{"description":"Second line of the address","type":"string","nullable":true},"address3":{"description":"Third line of the address","type":"string","nullable":true},"city":{"description":"The city/suburb of the address","type":"string","nullable":true},"state":{"description":"The state of the address","type":"string","nullable":true},"postalCode":{"description":"The postal code for the address","type":"string","nullable":true},"countryCode":{"description":"ISO Country code of the address. We recommend you use ISO-3166-1:alpha3 (upper case) values where available.","type":"string","nullable":true,"maxLength":3,"minLength":3},"longitude":{"type":"number","nullable":true},"latitude":{"type":"number","nullable":true}}},"social":{"title":"Social Media","description":"Social Media contacts","type":"object","nullable":true,"additionalProperties":false,"properties":{"website":{"type":"string","nullable":true,"format":"uri"},"facebook":{"type":"string","nullable":true},"twitter":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true,"format":"uri"},"instagram":{"type":"string","nullable":true}}},"capacity":{"description":"This is the maximum number of people allowed for the venue in normal use. Certain events/configurations of the venue may cause this capacity to be increased/decreased - this is not reflected in this value.","type":"integer","format":"int32","nullable":true},"historicalNames":{"type":"array","nullable":true,"title":"Venue historical names","description":"Array of venue historical names","items":{"type":"object","title":"Venue historical name","additionalProperties":false,"properties":{"dateStart":{"description":"Start date","type":"string","nullable":true,"format":"date"},"dateEnd":{"description":"End date","type":"string","nullable":true,"format":"date"},"nameLocal":{"description":"Full name in local language","type":"string","nullable":true},"nameLatin":{"description":"Full name in latin characters","type":"string","nullable":true},"alternateNameLocal":{"description":"Alternate name in local lanuage","type":"string","nullable":true},"alternateNameLatin":{"description":"Alternate name in latin characters","type":"string","nullable":true},"abbreviationLocal":{"description":"Abbreviation in local lanuage","type":"string","nullable":true},"abbreviationLatin":{"description":"Abbreviation in latin characters","type":"string","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":"venue put body"}}}}}}}}
```
## Delete a venue
> Delete a specific venue
```json
{"openapi":"3.0.0","info":{"title":"DataCore API - Hockey","version":"v1"},"tags":[{"name":"Venues","description":"The Venue is the physical location where a match occurs. Every match can have only one venue. The organization has many venues.\n\n[Venues],[Organizations]-<>[Sites],[Matches]-1[Venues{bg:orange}],[Sites]-.-<>[Venues],\">\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"}}}}}},"VenuesModel":{"type":"object","additionalProperties":false,"properties":{"venueId":{"description":"The unique identifier of the venue","type":"string","format":"uuid"},"siteId":{"description":"The site that this venue belongs to","type":"string","format":"uuid","nullable":true},"site":{"properties":{"resourceType":{"type":"string","enum":["sites"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The site that this venue belongs to","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 venue belongs to","type":"object"},"abbreviationLocal":{"description":"An abbreviation/short name in the [local](#section/Introduction/Character-Sets-and-Names) language","type":"string","maxLength":30,"nullable":true},"nameLocal":{"description":"The name of the venue in the [local](#section/Introduction/Character-Sets-and-Names) language","type":"string","maxLength":150},"status":{"description":"Status\n>- `ACTIVE` Active\n>- `INACTIVE` Inactive\n>- `PENDING` Pending\n","type":"string","enum":["ACTIVE","INACTIVE","PENDING"],"maxLength":30,"default":"ACTIVE"},"alternateNameLocal":{"description":"The alternate name of the venue, in Local Language","type":"string","maxLength":150,"nullable":true},"abbreviationLatin":{"description":"An abbreviation/short name in [latin](#section/Introduction/Character-Sets-and-Names) characters","type":"string","maxLength":30,"nullable":true},"nameLatin":{"description":"The name of the venue in [latin](#section/Introduction/Character-Sets-and-Names) characters","type":"string","maxLength":150,"nullable":true},"alternateNameLatin":{"description":"The alternate name of the venue, in Latin characters","type":"string","maxLength":150,"nullable":true},"countryCode":{"description":"Country code of the venue. We recommend you use ISO-3166-1:alpha3 (upper case) values where available.","type":"string","minLength":3,"maxLength":3,"nullable":true},"timezone":{"description":"Timezone of the venue. The name of the zone as defined by the IANA TZ database. https://en.wikipedia.org/wiki/List_of_tz_database_time_zones","type":"string","maxLength":150},"address":{"title":"Venue address","description":"Street Address for the venue","type":"object","nullable":true,"additionalProperties":false,"properties":{"address1":{"description":"First line of the address","type":"string","nullable":true},"address2":{"description":"Second line of the address","type":"string","nullable":true},"address3":{"description":"Third line of the address","type":"string","nullable":true},"city":{"description":"The city/suburb of the address","type":"string","nullable":true},"state":{"description":"The state of the address","type":"string","nullable":true},"postalCode":{"description":"The postal code for the address","type":"string","nullable":true},"countryCode":{"description":"ISO Country code of the address. We recommend you use ISO-3166-1:alpha3 (upper case) values where available.","type":"string","nullable":true,"maxLength":3,"minLength":3},"longitude":{"type":"number","nullable":true},"latitude":{"type":"number","nullable":true}}},"social":{"title":"Social Media","description":"Social Media contacts","type":"object","nullable":true,"additionalProperties":false,"properties":{"website":{"type":"string","nullable":true,"format":"uri"},"facebook":{"type":"string","nullable":true},"twitter":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true,"format":"uri"},"instagram":{"type":"string","nullable":true}}},"capacity":{"description":"This is the maximum number of people allowed for the venue in normal use. Certain events/configurations of the venue may cause this capacity to be increased/decreased - this is not reflected in this value.","type":"integer","format":"int32","nullable":true},"historicalNames":{"type":"array","nullable":true,"title":"Venue historical names","description":"Array of venue historical names","items":{"type":"object","title":"Venue historical name","additionalProperties":false,"properties":{"dateStart":{"description":"Start date","type":"string","nullable":true,"format":"date"},"dateEnd":{"description":"End date","type":"string","nullable":true,"format":"date"},"nameLocal":{"description":"Full name in local language","type":"string","nullable":true},"nameLatin":{"description":"Full name in latin characters","type":"string","nullable":true},"alternateNameLocal":{"description":"Alternate name in local lanuage","type":"string","nullable":true},"alternateNameLatin":{"description":"Alternate name in latin characters","type":"string","nullable":true},"abbreviationLocal":{"description":"Abbreviation in local lanuage","type":"string","nullable":true},"abbreviationLatin":{"description":"Abbreviation in latin characters","type":"string","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},"masterVenueId":{"description":"The unique identifier of the master venue","type":"string","format":"uuid","readOnly":true},"updated":{"description":"Date/time last modified. In UTC","type":"string","format":"date-time","readOnly":true},"added":{"description":"Date/time added. In UTC","type":"string","format":"date-time","readOnly":true}},"title":"venue 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":{"/hockey/o/{organizationId}/venues/{venueId}":{"delete":{"tags":["Venues"],"summary":"Delete a venue","description":"Delete a specific venue","operationId":"venue_delete","responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","title":"Venues 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/VenuesModel"}}}}}}},"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":"venueId","description":"The unique identifier of the venue","schema":{"type":"string","format":"uuid"},"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/field-hockey/datacore-api-v1/venues.md?ask=
```
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.