Get event type and genre summary

Returns aggregate counts for event types and genres matching the supplied filters. The limit and offset parameters are accepted by the filter parser but are ignored by this endpoint.

GET/api/events/type-summary

Query parameters

offsetinteger<int64>

Legacy offset pagination. Integer value.

min 0

limitinteger<int64>

Maximum number of results requested.

min 0

startstring

Start date in YYYY-MM-DD format. Defaults to the current date when omitted.

matches ^\d{4}-\d{2}-\d{2}$

endstring

Inclusive end date in YYYY-MM-DD format.

matches ^\d{4}-\d{2}-\d{2}$

timestring

Event-time filter. The value must contain a start time and an end time, separated by a comma.

Supported time formats:

HH,HH for hours in 24-hour format.
HHMM,HHMM for hours and minutes in 24-hour format.

Examples:

10,14 matches events from 10:00 to 14:00.
1030,1545 matches events from 10:30 to 15:45.

The start time must be before the end time.

categoriesstring

Comma-separated list of one or more category IDs.

Available categories:

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

Multiple categories can be combined using commas.

searchstring

Full-text search query.

venuestring

Venue name/text filter.

space_typesstring

Comma-separated space type values.

countriesstring

Comma-separated country codes.

postal_codestring

Comma-separated list of postal code patterns.

Use * as a wildcard for partial matching:

249* matches postal codes starting with 249.
*509 matches postal codes ending with 509.
*608* matches postal codes containing 608.
249*,2348*,*6000* matches any of the specified patterns.

Without *, an exact match is performed.

titlestring

Title text filter.

citystring

Venue city filter.

event_typesstring

Comma-separated event type IDs. Cannot be used together with genres.

genresstring

Comma-separated genre IDs. Cannot be used together with event_types.

tagsstring

Comma-separated tags.

accessibilitystring

Accessibility filter. Syntax is interpreted by the API filter parser.

visitor_infosstring

Visitor-information filter. Syntax is interpreted by the API filter parser.

agestring

Age filter. Syntax is interpreted by the API filter parser.

pricestring

Price filter. Syntax is interpreted by the API filter parser.

lonnumber<double>

Longitude used for radius filtering.

latnumber<double>

Latitude used for radius filtering.

radiusnumber<double>

Radius used for geographic filtering.

last_event_start_atstring

Cursor timestamp used with last_event_date_uuid for stable pagination.

last_event_date_uuidstring

Cursor event-date UUID used with last_event_start_at.

langstring

Language/locale value accepted by the event filter.

week_startstring

Optional week start date in YYYY-MM-DD format.

matches ^\d{4}-\d{2}-\d{2}$

org_uuidsstring

Comma-separated organization UUID values.

venue_uuidsstring

Comma-separated venue UUID values.

space_uuidsstring

Comma-separated space UUID values.

event_uuidsstring

Comma-separated event UUID values.

geolist_regionstring

Geographic region filter. Must contain exactly three comma-separated components (lon,lat,radius). Cannot be combined with portal.

portalstring

Portal UUID filter. Cannot be combined with geolist_region.

Responses

200

Summary returned successfully.

total_event_countintegerrequired

type_summaryGetEvents.SummaryEntry[]required

Show properties

Array of GetEvents.SummaryEntry

idintegerrequired

countintegerrequired

genre_summaryGetEvents.SummaryEntry[]required

Show properties

Array of GetEvents.SummaryEntry

idintegerrequired

countintegerrequired

400

Invalid request or filter parameter.

object

500

Internal server error.

object

Try it

Server

Base URLCustom base URLOverrides the selected server when set.

Parameters

offsetqueryLegacy offset pagination. Integer value.limitqueryMaximum number of results requested.startqueryStart date in YYYY-MM-DD format. Defaults to the current date when omitted.endqueryInclusive end date in YYYY-MM-DD format.timequeryEvent-time filter. The value must contain a start time and an end time, separated by a comma. Supported time formats: - `HH,HH` for hours in 24-hour format. - `HHMM,HHMM` for hours and minutes in 24-hour format. Examples: - `10,14` matches events from 10:00 to 14:00. - `1030,1545` matches events from 10:30 to 15:45. The start time must be before the end time. categoriesqueryComma-separated list of one or more category IDs. Available categories: - `1` — Culture - `2` — Education - `3` — Sports - `4` — Leisure - `5` — Family - `6` — Society Multiple categories can be combined using commas. searchqueryFull-text search query.venuequeryVenue name/text filter.space_typesqueryComma-separated space type values.countriesqueryComma-separated country codes.postal_codequeryComma-separated list of postal code patterns. Use `*` as a wildcard for partial matching: - `249*` matches postal codes starting with `249`. - `*509` matches postal codes ending with `509`. - `*608*` matches postal codes containing `608`. - `249*,2348*,*6000*` matches any of the specified patterns. Without `*`, an exact match is performed. titlequeryTitle text filter.cityqueryVenue city filter.event_typesqueryComma-separated event type IDs. Cannot be used together with genres. genresqueryComma-separated genre IDs. Cannot be used together with event_types. tagsqueryComma-separated tags.accessibilityqueryAccessibility filter. Syntax is interpreted by the API filter parser.visitor_infosqueryVisitor-information filter. Syntax is interpreted by the API filter parser.agequeryAge filter. Syntax is interpreted by the API filter parser.pricequeryPrice filter. Syntax is interpreted by the API filter parser.lonqueryLongitude used for radius filtering.latqueryLatitude used for radius filtering.radiusqueryRadius used for geographic filtering.last_event_start_atqueryCursor timestamp used with last_event_date_uuid for stable pagination.last_event_date_uuidqueryCursor event-date UUID used with last_event_start_at.langqueryLanguage/locale value accepted by the event filter.week_startqueryOptional week start date in YYYY-MM-DD format.org_uuidsqueryComma-separated organization UUID values.venue_uuidsqueryComma-separated venue UUID values.space_uuidsqueryComma-separated space UUID values.event_uuidsqueryComma-separated event UUID values.geolist_regionqueryGeographic region filter. Must contain exactly three comma-separated components (lon,lat,radius). Cannot be combined with portal. portalqueryPortal UUID filter. Cannot be combined with geolist_region.

Request

curl -X GET "https://api.kulturbytes.de/api/events/type-summary"

const response = await fetch("https://api.kulturbytes.de/api/events/type-summary", {
  method: "GET"
});

import requests

response = requests.get(
    "https://api.kulturbytes.de/api/events/type-summary",
)

Response

{
  "total_event_count": 0,
  "type_summary": [
    {
      "id": 0,
      "count": 0
    }
  ],
  "genre_summary": [
    {
      "id": 0,
      "count": 0
    }
  ]
}

{}

{}