Skip to content
Uranus Docs
Esc
↑↓navigate↵open⌘Jpreview

Get choosable venues

Returns venues matching the optional name and geographic filters.

GET/api/choosable-venues
Query parameters
namestring

Case-insensitive name search. An asterisk (*) at the beginning and/or end acts as a wildcard, e.g. Kultur* (starts with), *haus (ends with), or *kultur* (contains).

latnumber<double>

Latitude of the center point for the geographic search.

min -90 · max 90
lonnumber<double>

Longitude of the center point for the geographic search.

min -180 · max 180
radiusnumber<double>

Search radius around the specified latitude and longitude, in meters.

min 0
Responses
200

Venues successfully retrieved.

servicestringrequired

Name of the API service.

api_versionstringrequired

API version.

response_typestringrequired

Identifier of the response type.

statusintegerrequired

HTTP status code of the response.

Allowed:200
timestampstring<date-time>required

Time at which the response was generated.

metadataGetChoosableVenues.ChoosableVenuesMetadata

Metadata returned with the list of venues.

Show properties
venue_countintegerrequired

Number of venues matching the requested filters.

min 0
response_time_msintegerrequired

Time required to generate the response in milliseconds.

min 0
dataGetChoosableVenues.Venue[]required

List of matching venues.

Show properties
Array of GetChoosableVenues.Venue
uuidstring<uuid>required

Unique identifier of the venue.

scopestringrequired

Scope defining the ownership or visibility of the venue.

namestring | anyrequired

Name of the venue.

Show properties
Any of:
string
string
any
any
citystring | any

City in which the venue is located.

Show properties
Any of:
string
string
any
any
statestring | any

State or administrative region in which the venue is located.

Show properties
Any of:
string
string
any
any
countrystring | any

Country code of the venue.

Show properties
Any of:
string
string
any
any
messagestring

Human-readable response message.

500

Database or internal server error.

servicestringrequired

Name of the API service.

api_versionstringrequired

API version.

response_typestringrequired

Identifier of the response type.

statusintegerrequired

HTTP status code of the response.

Allowed:500
timestampstring<date-time>required

Time at which the response was generated.

metadataobject

Response metadata.

dataany

Response payload.

Show properties
Any of:
any
any
any
any
messagestring

Human-readable response message.

Try it
Server
Parameters
Request
curl -X GET "https://api.kulturbytes.de/api/choosable-venues"
Response
{
  "service": "Uranus API",
  "api_version": "1.0",
  "response_type": "get-choosable-venues",
  "status": 200,
  "timestamp": "2026-09-20T12:00:00Z",
  "metadata": {
    "venue_count": 3,
    "response_time_ms": 15
  },
  "data": [
    {
      "uuid": "550e8400-e29b-41d4-a716-446655440000",
      "scope": "shared",
      "name": "Kulturzentrum",
      "city": "Flensburg",
      "state": "Schleswig-Holstein",
      "country": "DE"
    },
    {
      "uuid": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
      "scope": "shared",
      "name": "Stadthalle",
      "city": "Flensburg",
      "state": "Schleswig-Holstein",
      "country": "DE"
    },
    {
      "uuid": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
      "scope": "organization",
      "name": "Kulturhaus",
      "city": "Glücksburg",
      "state": "Schleswig-Holstein",
      "country": "DE"
    }
  ]
}