# Venues

The Venue is the physical location where a match occurs. Every match can have only one venue. The organization has many venues.

![](https://yuml.me/diagram/scruffy;dir:LR/class/\[Organizations]-%3C%3E\[Venues],\[Organizations]-%3C%3E\[Sites],\[Matches]-1\[Venues%7Bbg:orange%7D],\[Sites]-.-%3C%3E\[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  - Ice 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<img src = \"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,"format":"uri"},"twitter":{"type":"string","nullable":true,"format":"uri"},"wikipedia":{"type":"string","nullable":true,"format":"uri"},"instagram":{"type":"string","nullable":true,"format":"uri"}}},"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"},"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":{"/icehockey/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/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 identifier of the venue. Can specify multiple, delimited by comma.","schema":{"type":"string"},"required":false,"in":"query"}]}}}}
```

## Get a list of venues

> Return a list of available venues

```json
{"openapi":"3.0.0","info":{"title":"DataCore API  - Ice 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<img src = \"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"}}}}}},"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,"format":"uri"},"twitter":{"type":"string","nullable":true,"format":"uri"},"wikipedia":{"type":"string","nullable":true,"format":"uri"},"instagram":{"type":"string","nullable":true,"format":"uri"}}},"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"},"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":{"/icehockey/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/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 identifier of the venue. Can specify multiple, delimited by comma.","schema":{"type":"string"},"required":false,"in":"query"}]}}}}
```

## Create a venue

> Add a new venue

```json
{"openapi":"3.0.0","info":{"title":"DataCore API  - Ice 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<img src = \"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":["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,"format":"uri"},"twitter":{"type":"string","nullable":true,"format":"uri"},"wikipedia":{"type":"string","nullable":true,"format":"uri"},"instagram":{"type":"string","nullable":true,"format":"uri"}}},"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":{"/icehockey/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,"format":"uri"},"twitter":{"type":"string","nullable":true,"format":"uri"},"wikipedia":{"type":"string","nullable":true,"format":"uri"},"instagram":{"type":"string","nullable":true,"format":"uri"}}},"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  - Ice 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<img src = \"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"}}}}}},"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,"format":"uri"},"twitter":{"type":"string","nullable":true,"format":"uri"},"wikipedia":{"type":"string","nullable":true,"format":"uri"},"instagram":{"type":"string","nullable":true,"format":"uri"}}},"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"},"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":{"/icehockey/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/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 identifier of the venue. Can specify multiple, delimited by comma.","schema":{"type":"string"},"required":false,"in":"query"}]}}}}
```

## Get a venue

> Return detailed information about a specific venue

```json
{"openapi":"3.0.0","info":{"title":"DataCore API  - Ice 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<img src = \"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"}}}}}},"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,"format":"uri"},"twitter":{"type":"string","nullable":true,"format":"uri"},"wikipedia":{"type":"string","nullable":true,"format":"uri"},"instagram":{"type":"string","nullable":true,"format":"uri"}}},"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"},"limit":{"name":"limit","description":"The maximum number of records to return. See [Pagination](#section/Introduction/Pagination) for more information.","schema":{"type":"integer","format":"int32","maximum":1000,"minimum":1,"default":10},"required":false,"in":"query"},"offset":{"name":"offset","description":"The offset of the records. See [Pagination](#section/Introduction/Pagination) for more information.","schema":{"type":"integer","format":"int32"},"required":false,"in":"query"}}},"paths":{"/icehockey/o/{organizationId}/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/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  - Ice 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<img src = \"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":["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,"format":"uri"},"twitter":{"type":"string","nullable":true,"format":"uri"},"wikipedia":{"type":"string","nullable":true,"format":"uri"},"instagram":{"type":"string","nullable":true,"format":"uri"}}},"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":{"/icehockey/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,"format":"uri"},"twitter":{"type":"string","nullable":true,"format":"uri"},"wikipedia":{"type":"string","nullable":true,"format":"uri"},"instagram":{"type":"string","nullable":true,"format":"uri"}}},"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  - Ice 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<img src = \"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":["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,"format":"uri"},"twitter":{"type":"string","nullable":true,"format":"uri"},"wikipedia":{"type":"string","nullable":true,"format":"uri"},"instagram":{"type":"string","nullable":true,"format":"uri"}}},"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":{"/icehockey/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"}]}}}}
```
