Events

Search events

Changed on
get/events

Request

  • Base URL
    https://api.ofdb.io/v0
  • URL
    https://api.ofdb.io/v0/events
  • Auth
    none declared

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

  • aa6154da1b55Revision changes
    • info

      added the new optional query request parameter end_max

    • info

      added the new optional query request parameter end_min

  • b2a47c048e83Revision changes
    • breaking

      the / response's property type changed from integer to no type, and format from int64 to no format for status

    • info

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

    • info

      added to the / response property allOf list for the response status

    • info

      added to the / response property allOf list for the response status

    • info

      added to the / response property allOf list for the response status

    • info

      removed from the / response property oneOf list for the response status

    • info

      removed from the / response property oneOf list for the response status