Sign in
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/"
  }
]

Changes

Changed in 4 of the 50 revisions of this API.9216

  • aa6154da1b552See the full diff
    • ○

      added the new optional query request parameter end_max

      new-optional-request-parameter

    • ○

      added the new optional query request parameter end_min

      new-optional-request-parameter

  • b2a47c048e8316See the full diff
    • ▲

      the items/created_at response's property type/format changed from integer/int64 to / for status 200

      response-property-type-changed

    • ○

      the response optional property items/created_at became not read-only for the status 200

      response-optional-property-became-not-read-only

    • ○

      added UnixTime to the items/end response property allOf list for the response status 200

      response-property-all-of-added

    • ○

      added UnixTime to the items/start response property allOf list for the response status 200

      response-property-all-of-added

    • ○

      added UnixTimeMillis to the items/created_at response property allOf list for the response status 200

      response-property-all-of-added

    • ○

      removed UnixTime from the items/end response property oneOf list for the response status 200

      response-property-one-of-removed

    • ○

      removed UnixTime from the items/start response property oneOf list for the response status 200

      response-property-one-of-removed

  • bca9ebb2d24a32See the full diff
    • ▲

      the items/email response property's minLength was decreased from 3 to 0 for the response status 200

      response-property-min-length-decreased

    • ▲

      the items/email response's property type/format changed from string/ to / for status 200

      response-property-type-changed

    • ▲

      the items/telephone response's property type/format changed from string/ to / for status 200

      response-property-type-changed

    • ○

      added Email to the items/email response property allOf list for the response status 200

      response-property-all-of-added

    • ○

      added Phone to the items/telephone response property allOf list for the response status 200

      response-property-all-of-added

  • ddfd4e39c98d526See the full diff
    • ▲

      added UnixTime to the items/end response property oneOf list for the response status 200

      response-property-one-of-added

    • ▲

      added UnixTime to the items/start response property oneOf list for the response status 200

      response-property-one-of-added

    • ▲

      the items/created_at response's property type/format changed from / to integer/int64 for status 200

      response-property-type-changed

    • ▲

      the items/email response's property type/format changed from / to string/ for status 200

      response-property-type-changed

    • ▲

      the items/telephone response's property type/format changed from / to string/ for status 200

      response-property-type-changed

    • ●

      deleted the query request parameter end_max

      request-parameter-removed

    • ●

      deleted the query request parameter end_min

      request-parameter-removed

    • ○

      the response optional property items/created_at became read-only for the status 200

      response-optional-property-became-read-only

    • ○

      removed Email from the items/email response property allOf list for the response status 200

      response-property-all-of-removed

    • ○

      removed Phone from the items/telephone response property allOf list for the response status 200

      response-property-all-of-removed

    • ○

      removed UnixTime from the items/end response property allOf list for the response status 200

      response-property-all-of-removed

    • ○

      removed UnixTime from the items/start response property allOf list for the response status 200

      response-property-all-of-removed

    • ○

      removed UnixTimeMillis from the items/created_at response property allOf list for the response status 200

      response-property-all-of-removed

    This revision also has 17 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog