---
title: "Search events"
method: GET
path: "/events"
tags: ["Events"]
---

# Search events

`GET /events`

## Query parameters

- `bbox` string
- `limit` integer
- `tag` string — Comma-separated list of tags
- `start_min` integer — Unix time (number of seconds since 00:00::00 1. January, 1970, UTC)
- `start_max` integer — Unix time (number of seconds since 00:00::00 1. January, 1970, UTC)
- `end_min` integer — Unix time (number of seconds since 00:00::00 1. January, 1970, UTC)
- `end_max` integer — Unix time (number of seconds since 00:00::00 1. January, 1970, UTC)
- `text` string
- `created_by` string — An e-mail address.

## Response `200`

Successful response

- Event[]
  - `id` string — Identifier of a resource
  - `title` string
  - `description` string
  - `start` integer — Unix time (number of seconds since 00:00::00 1. January, 1970, UTC)
  - `end` integer — Unix time (number of seconds since 00:00::00 1. January, 1970, UTC)
  - `created_at` integer — Precise Unix time (number of milliseconds since 00:00::00.000 1. January, 1970, UTC) for system-generated time stamps
  - `created_by` string — The email address of the user who is responsible for the content. This information is only available for authorized organizations.
  - `lat` number, double — Geographic latitude (in degrees)
  - `lng` number, double — Geographic longitude (in degrees)
  - `street` string
  - `zip` string
  - `city` string
  - `country` string
  - `state` string
  - `email` string — An e-mail address.
  - `telephone` string
  - `tags` Tag[]
  - `homepage` string
  - `registration` 'email' | 'telephone' | 'homepage' — Type of registration
  - `organizer` string
  - `image_url` string
  - `image_link_url` string

## Changes

- **2021-08-12** `aa6154da1b55` — 2 info
  - added the new optional `query` request parameter `end_max`
  - added the new optional `query` request parameter `end_min`
- **2020-08-13** `b2a47c048e83` — 1 breaking, 6 info
  - the `items/created_at` response's property type/format changed from `integer`/`int64` to ``/`` for status `200`
  - the response optional property `items/created_at` became not read-only for the status `200`
  - added `#/components/schemas/UnixTime` to the `items/end` response property `allOf` list for the response status `200`
  - added `#/components/schemas/UnixTime` to the `items/start` response property `allOf` list for the response status `200`
  - …3 more
- **2020-08-13** `bca9ebb2d24a` — 3 breaking, 2 info
  - the `items/email` response property's minLength was decreased from `3` to `0` for the response status `200`
  - the `items/email` response's property type/format changed from `string`/`` to ``/`` for status `200`
  - the `items/telephone` response's property type/format changed from `string`/`` to ``/`` for status `200`
  - added `#/components/schemas/Email` to the `items/email` response property `allOf` list for the response status `200`
  - …1 more
- …earlier changes not shown

[Full history](https://skmtc.dev/kartevonmorgen/apis/openfairdb-api/changes/events/get.md)

---

[API](https://skmtc.dev/kartevonmorgen/apis/openfairdb-api.md) · [All operations](https://skmtc.dev/kartevonmorgen/apis/openfairdb-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/kartevonmorgen/openfairdb-api/revisions/4c454390b099/schema)