Get Events

GET /api/events/{optional query parameters}

The GET /api/events endpoint provides a flexible query interface that allows clients to combine multiple parameters to build complex searches. Parameters can be used together to narrow down results and adapt responses to different use cases.

Date Range

The event search can be limited to a specific time period by providing a start and/or end date.

Parameter	Value	Description
`start`	date string (`YYYY-MM-DD`)	Returns events starting on or after this date.
`end`	date string (`YYYY-MM-DD`)	Returns events ending on or before this date.

Example:

https://api.kulturbytes.de/api/events?start=2026-08-01&end=2026-09-01

Search events within a specific time period.

Time Range

The event search can be limited to a specific time range by providing a start and end time. Both values must be separated by a - character.

Parameter	Value
`time`	time range (`start,end`)

The time values are interpreted as follows:

Format	Example	Interpretation
`H` or `HH`	`1`, `01`	Hour in 24-hour format
`HHMM`	`1030`	Hour and minute in 24-hour format

Examples:

https://api.kulturbytes.de/api/events?time=1030,1545

String Matching

String-based search parameters support optional wildcard matching using the * character.

The * character represents any sequence of characters and can be used at the beginning and/or end of a search value. String comparisons are case-insensitive.

Examples:

value

Matches the exact value.

*value

Matches values ending with value.

value*

Matches values beginning with value.

*value*

Matches values containing value.

Title, Venue, Postal Code, City

Parameter	Value	Description
`title`	string (optional `*` wildcard)	Filters events by title.
`venue`	string (optional `*` wildcard)	Filters events by venue name.
`postal_code`	string (optional `*` wildcard)	Filters events by venue postal code.
`city`	string (optional `*` wildcard)	Filters events by venue city.

Event Types and Genres

The event search can be filtered by one or more event types or genres.
Multiple identifiers can be specified by separating them with commas.

Events are returned when they match at least one of the specified identifiers.

Parameter	Value	Description
`event_types`	comma-separated integers	Filters events by event type identifiers.
`genres`	comma-separated integers	Filters events by genre identifiers.

Only one of event_types or genres may be specified in the same request.

Examples:

https://api.kulturbytes.de/api/events?event_types=1

Searches events with event type 1.

https://api.kulturbytes.de/api/events?event_types=1,2,5

Searches events matching event type 1, 2, or 5.

https://api.kulturbytes.de/api/events?genres=1001,5004

Searches events matching genre 1001 or 5004.

Note: The integer values correspond to the event type and genre identifiers maintained in the Uranus database.

Space Types

The event search can be filtered by one or more space types. Multiple space types can be specified by separating them with commas.

Parameter	Value	Description
`space_types`	comma-separated strings	Filters events by one or more space types.

Examples:

https://api.kulturbytes.de/api/events?space_types=hall

Searches events taking place in spaces of type hall.

https://api.kulturbytes.de/api/events?space_types=hall,multifunctional_room

Searches events taking place in spaces of type hall, or multifunctional_room.

Countries

The event search can be filtered by one or more countries using their ISO 3166-1 alpha-3 country codes.

Parameter	Value
`countries`	comma-separated country codes

Multiple country codes can be specified by separating them with commas.

Examples:

https://api.kulturbytes.de/api/events?countries=DEU

Searches events in Germany.

https://api.kulturbytes.de/api/events?countries=DEU,DNK,SWE

Searches events in Germany, Denmark, and Sweden.

Full-Text Search

Searches events using a weighted full-text search algorithm. The event search supports free-text queries across multiple text fields. The search algorithm analyzes relevant event information such as titles, subtitles, descriptions, tags, and venue names to find matching events.

Parameter	Value
`search`	string

Example:

https://api.kulturbytes.de/api/events?search=jazz

Search events related to "jazz" across all indexed event information.

Age

The event search can be filtered by age requirements. The parameter accepts either a single age value or an age range. Events are returned when their configured age range contains the requested age or range.

Parameter	Value
`age`	integer or age range (`min,max`)

Examples:

https://api.kulturbytes.de/api/events?age=12

Search events suitable for age 12.

https://api.kulturbytes.de/api/events?age=12,16

Search events suitable for ages 12 to 16.

Price

The event search can be filtered by price type or maximum price. The parameter accepts either a price category or a maximum price value with a currency code.

Parameter	Value
`price`	`free`, `donation`, or `amount,currency`

Currency codes use the ISO 4217 standard and consist of three letters, for example:

Code	Currency
`EUR`	Euro
`DKK`	Danish Krone

Examples:

https://api.kulturbytes.de/api/events?price=free

Search events that are free.

https://api.kulturbytes.de/api/events?price=donation

Search events that accept donations.

https://api.kulturbytes.de/api/events?price=10,EUR

Search events with a minimum price value up to 10 EUR.

Accessibility

The event search can be filtered by accessibility requirements using bit flags. The parameter accepts one or more bit positions separated by commas.

An event matches only if all specified bits are set in its accessibility flags.

Parameter	Value	Description
`accessibility`	comma-separated bit positions	Filters events by accessibility features represented as bit flags.

Multiple accessibility requirements can be combined by specifying multiple bit positions.

Examples:

https://api.kulturbytes.de/api/events?accessibility=0

Searches events where bit 0 is set.

https://api.kulturbytes.de/api/events?accessibility=0,2

Searches events where both bit 0 and bit 2 are set.

Accessibility Flags (bitmask)

Flag	Bit
Wheelchair accessible	0
Accessible parking	1
Elevator available	2
Ramp available	3
Step-free access	4
Accessible restroom	5
Reserved seating	6
Service animals allowed	7
Sign language interpretation	14
Captioning available	15
Hearing loop	16
Assistive listening devices	17
Audio description	24
Braille materials	25
High contrast signage	26
Tactile guides	27
Easy read materials	34
Quiet space	35
Clear signage	36
Trained staff	37
Low light environment	38
Accessible website	44
Screen reader support	45
Keyboard navigation	46
Voice command support	47

Visitor Information

The event search can be filtered by visitor information using bit flags. The parameter accepts one or more bit positions separated by commas.

An event matches only if all specified bits are set in its visitor information flags.

Parameter	Value
`visitor_infos`	comma-separated bit positions

Multiple visitor information requirements can be combined by specifying multiple bit positions.

Examples:

https://api.kulturbytes.de/api/events?visitor_infos=0

Searches events where bit 0 is set.

https://api.kulturbytes.de/api/events?visitor_infos=0,2

Searches events where both bit 0 and bit 2 are set.

Visitor Information Flags (bitmask)

Flag	Bit
Family Friendly	0
Child Suitable	1
Youth/Adult Suitable	2
Queer Friendly	3
Senior Friendly	4
Pet Friendly	5
Outdoor	7
Indoor	8
Weather Alternative	10
Nature Location	11
Online Only Event	14
Seating Available	12
Shade Available	13
Free Water	15
Food Stalls	16
Vegetarian Options	17
Vegan Options	18
Picnic Allowed	19
Alcohol Free	20
Free Seating	21
Shuttle Service	22
USB Charging	23
Power Sockets Available	24
Quiet Room	27
Photography Allowed	25
Streaming Available	26
Free Wifi	29
Wifi with Login	30
Mobile Network Available	31
Event App Available	32
Digital Info Screens	33
Digital Program Guide	34
Awareness Team Present	28
Security Staff On Site	35
Bag Checks	36
Access Control	37
First Aid Available	38
Police Presence	39
Fire Safety Measures	40
Surveillance Cameras	41
Access Wristbands	42

Geographic Radius Search

The event search can be limited to events within a specified radius around a geographic coordinate. The lon, lat, and radius parameters must be provided together. If one of the parameters is missing, no geographic filtering is applied.

Parameter	Value	Description
`lon`	decimal number	Longitude of the search center.
`lat`	decimal number	Latitude of the search center.
`radius`	decimal number	Search radius in meters.

The coordinates use the WGS84 coordinate system. The radius is specified in meters.

Example:

https://api.kulturbytes.de/api/events?lon=9.4333&lat=54.7833&radius=5000

Search events within 5 km of the specified location.

Geolist Region

The event search can be filtered by a geographic region using a hierarchical region identifier. The region is specified by providing a country, state, and region slug separated by commas.

Parameter	Value
`geolist_region`	`country_slug,state_slug,region_slug`

The three parts must be provided in the following order:

Part	Description
`country_slug`	Country identifier
`state_slug`	State or administrative area identifier
`region_slug`	Region identifier

Example:

https://api.kulturbytes.de/api/events?geolist_region=deutschland,schleswig-holstein,flensburg

Searches events located within the specified region (Flensburg, Schleswig-Holstein, Germany).

UUID Filters

The event search can be filtered by specific organizations, venues, or events using UUID values. Multiple UUIDs can be provided by separating them with commas.

All UUID values must be valid UUIDv7 identifiers.

Parameter	Value	Description
`org_uuids`	comma-separated UUIDs	Filters events by one or more organization UUIDs.
`venue_uuids`	comma-separated UUIDs	Filters events by one or more venue UUIDs.
`event_uuids`	comma-separated UUIDs	Filters events by one or more event UUIDs.

Examples:

https://api.kulturbytes.de/api/events?org_uuids=019da55a-3957-70eb-b8dc-3d1be7e3cdfd

Searches events belonging to the specified organization.

https://api.kulturbytes.de/api/events?venue_uuids=019da55d-e172-7198-80ee-29d81972c8b5,019daaea-4c7f-705f-ac38-1f59f29a6795

Searches events at one of the specified venues.

https://api.kulturbytes.de/api/events?event_uuids=019db01b-f059-743c-8a3e-802545d8ed5b

Searches for the specified event.

Sample JSON Response

{
  "service": "Uranus API",
  "api_version": "1.0",
  "response_type": "get-events",
  "status": 200,
  "timestamp": "2026-07-30T15:07:43Z",
  "metadata": {
    "response_time_ms": 1
  },
  "data": {
    "events": [
      {
        "search_rank": 1,
        "uuid": "019df20e-4efc-7c01-8c4a-8880af01f14a",
        "date_uuid": "019df217-9d18-760e-84d6-05f816385bc1",
        "date_slug": "202610111800",
        "title": "triaden tiraden",
        "subtitle": "Lesung und Film",
        "summary": "Drei Frauen stellen ihre literarischen und audiovisuellen Werke an drei Orten vor, die Verknüpfung der obenerdigen Kulturorte bildet das Dreieck über der Gletscherzunge. Untergründig durch die Stadt - Parallel zum Gesagten - Undercover im eigenen Leben.  \n**Dorothee Bachem** liest aus ihrem ersten, noch unveröffentlichten Roman 'Erpelheim, die Stadt'. **Stefanie Oeding** entziffert tägliche Aufzeichnungen aus dem analogen Bibliotheksalltag. **Vaia Paziana** stellt Textfragmente und Videocollagen vor.",
        "start_date": "2026-10-11",
        "start_time": "18:00",
        "all_day": false,
        "space_uuid": "019daf9b-0e23-7ca3-ba04-2adf1043b6a5",
        "space_name": "Theatersaal",
        "space_accessibility_flags": "81",
        "venue_uuid": "019daf99-3496-719b-a3a4-e5c7cc906cb4",
        "venue_name": "Pilkentafel",
        "venue_city": "Flensburg",
        "venue_street": "Pilkentafel",
        "venue_house_number": "2",
        "venue_postal_code": "24937",
        "venue_state": "SH",
        "venue_country": "DEU",
        "venue_lat": 54.7908133546254,
        "venue_lon": 9.43936682354786,
        "image_uuid": "019df21d-d161-79fd-9bce-874b1be874f5",
        "image_path": "https://api.kulturbytes.de/api/image/019df21d-d161-79fd-9bce-874b1be874f5",
        "org_uuid": "019df70e-8af5-73aa-a308-4d95c89f57a2",
        "org_name": "Vaia Paziana",
        "categories": [1, 6],
        "event_types": [
          {
            "type_id": 6,
            "genre_id": 0
          },
          {
            "type_id": 8,
            "genre_id": 8011
          }
        ],
        "languages": [
          "de"
        ],
        "tags": [
          "audiovisuell"
        ],
        "min_age": null,
        "max_age": null,
        "price_type": "not_specified",
        "visitor_info_flags": "4364",
        "release_status": "released"
      }
    ],
    "last_event_date_uuid": "019df217-9d18-760e-84d6-05f816385bc1",
    "last_event_start_at": "2026-10-11T18:00"
  }
}

References

ISO 3166-1 alpha-3: https://en.wikipedia.org/wiki/ISO_3166-1_alpha-3
ISO 4217: https://en.wikipedia.org/wiki/ISO_4217

Value	Category
1	Culture
2	Education
3	Sports
4	Leisure
5	Family
6	Society

Get Events

Categories

Date Range

Time Range

String Matching

Title, Venue, Postal Code, City

Tags

Event Types and Genres

Space Types

Countries

Full-Text Search

Age

Price

Accessibility

Accessibility Flags (bitmask)

Visitor Information

Visitor Information Flags (bitmask)

Geographic Radius Search

Geolist Region

UUID Filters

Sample JSON Response

References