Sign in

v1

latestOpenAPI 3.0.3AGPLv32026-07-17448054.1 KB
Events

Search events

get/events

Query parameters

bboxstring
Example:42.27,-7.97,52.58,38.25

Bounding Box

limitinteger
Example:100

Maximum number of items to return or implicit/unlimited if unspecified.

tagstring

Comma-separated list of tags

Example:organic,non-profit

Filter events by tags

start_mininteger

Unix time (number of seconds since 00:00::00 1. January, 1970, UTC)

Example:1547403509

Filter events by event.start >= start_min

start_maxinteger

Unix time (number of seconds since 00:00::00 1. January, 1970, UTC)

Example:1547403509

Filter events by event.start <= start_max

end_mininteger

Unix time (number of seconds since 00:00::00 1. January, 1970, UTC)

Example:1547403509

Filter events by event.end >= end_min

end_maxinteger

Unix time (number of seconds since 00:00::00 1. January, 1970, UTC)

Example:1547403509

Filter events by event.end <= end_max

textstring

Filter events by textual terms. Hashtags starting with '#' will be extracted from the given text and handled as tag filters.

created_bystring

An e-mail address.

Example:john.smith@example.com

The email address of the event creator. Requests with this parameter will be rejected without a valid API token!

Response

Successful response

idstring

Identifier of a resource

titlestring
descriptionstring
startinteger

Unix time (number of seconds since 00:00::00 1. January, 1970, UTC)

endinteger

Unix time (number of seconds since 00:00::00 1. January, 1970, UTC)

created_atinteger

Precise Unix time (number of milliseconds since 00:00::00.000 1. January, 1970, UTC) for system-generated time stamps

created_bystring

The email address of the user who is responsible for the content. This information is only available for authorized organizations.

latnumber double

Geographic latitude (in degrees)

lngnumber double

Geographic longitude (in degrees)

streetstring
zipstring
citystring
countrystring
statestring
emailstring

An e-mail address.

telephonestring
tagsTag[]
homepagestring
registration'email' | 'telephone' | 'homepage'

Type of registration

organizerstring
image_urlstring
image_link_urlstring

Example response

[
  {
    "id": "7cee99c287094a94acbdcf29ffff2e85",
    "title": "A great event",
    "description": "Detailed description of the event",
    "start": 1547403509,
    "end": 1547403509,
    "created_at": 1547403509000,
    "lat": 37.2,
    "lng": 120.7,
    "email": "john.smith@example.com",
    "telephone": "001 123456789",
    "tags": [
      "organic",
      "non-profit"
    ],
    "homepage": "https://www.slowtec.de/",
    "registration": "telephone",
    "image_url": "https://www.slowtec.de/",
    "image_link_url": "https://www.slowtec.de/"
  }
]