For developers

Public events API

Event platforms, calendars and city magazines fetch Alpha Events listings as JSON — with address and coordinates, event type, genres, ticket shop link, current prices and the visitor app. No sign-up, no API key.

  • REST + JSON
  • No API key
  • Open CORS
  • Free
$ curl "https://alphaevents.tech/api/public/events?limit=1"

{
  "events": [
    {
      "title": "Summer Open Air 2027",
      "startDate": "2027-07-16T14:00:00.000Z",
      "location": "Stadtpark, 22303 Hamburg",
      "ticketShopUrl": "https://…/shop/summer-open-air-2027",
      …
    }
  ],
  "page": 1,
  "limit": 1,
  "total": 1
}

Quickstart

Three steps from your first request to a daily sync.

  1. 1

    Fetch

    A GET on the endpoint returns the next events — no header, no key.

  2. 2

    Page through

    Use page and limit to fetch up to 100 events per request until you reach total.

  3. 3

    Sync daily

    Load the full list once a day and remove everything that is no longer in it.

Endpoint

Returns every released event that is running or upcoming. Running and soonest events come first.

GEThttps://alphaevents.tech/api/public/events
Authentication
None
Format
JSON · UTF-8
CORS
Allow-Origin: *
Cache
max-age=60

Query parameters

All parameters are optional. Invalid values are answered with 400.

pageinteger

Page, from 1.

Default: 1

limitinteger

Events per page, 1–100.

Default: 50

sortstring

Sort order. A leading "-" sorts descending; ties are broken by ID so pages never overlap.

startDate-startDateupdatedAt-updatedAttitle-title

Default: startDate

updatedSinceISO 8601

Only events changed since this point in time — for quick incremental syncs.

Default: —

Response

Every response is a JSON object with the page of matches and the total count.

eventsEvent[]
Events of this page.
pageinteger
Current page.
limitinteger
Events per page.
totalinteger
Number of all matches across all pages.

The event object

Fields that can be missing are null — never omitted.

idstring
Unique, permanent ID — the key for your sync.
slugstring | null
Readable short name from the URL.
titlestring
Name of the event.
descriptionstring | null
Description as text.
startDateISO 8601
Start (UTC).
endDateISO 8601
End (UTC).
timeZonestring
The event's time zone (IANA, e.g. Europe/Berlin), from the address country. Local time = startDate/endDate in this zone.
locationstring
Place as readable text, built from the address.
addressobject | null
Postal address of the event.
address.namestring | null
Name of the venue.
address.streetstring | null
Street and house number.
address.zipstring | null
Postcode.
address.citystring | null
City.
address.countrystring
ISO 3166-1 alpha-2 country code.
address.latnumber | null
Latitude, derived from the postcode.
address.lngnumber | null
Longitude, derived from the postcode.
typeenum
Kind of event.
genresenum[]
Up to three genres.
statusenum
Status of the event.
imageUrlstring | null
Logo of the event.
organizerobject
Organiser.
organizer.namestring
Name of the organiser.
ticketShopUrlstring | null
Link to the ticket shop while it is selling.
ticketsTicket[]
Ticket types. Empty while no shop is selling.
tickets.namestring
Name of the ticket type.
tickets.pricestring
Price as a decimal, e.g. "79.00".
tickets.currency"EUR"
Currency.
tickets.soldOutboolean
true when sold out.
visitorAppUrlstring | null
Link to the visitor app while it is open.
updatedAtISO 8601
Last change.
{
  "events": [
    {
      "id": "6710a1b2c3d4e5f601234567",
      "slug": "summer-open-air-2027",
      "title": "Summer Open Air 2027",
      "description": "Two days, three stages, open air.",
      "startDate": "2027-07-16T14:00:00.000Z",
      "endDate": "2027-07-17T22:00:00.000Z",
      "timeZone": "Europe/Berlin",
      "location": "Stadtpark, 22303 Hamburg",
      "address": {
        "name": "Stadtpark",
        "street": "Saarlandstraße 1",
        "zip": "22303",
        "city": "Hamburg",
        "country": "DE",
        "lat": 53.5961,
        "lng": 10.0247
      },
      "type": "OPEN_AIR",
      "genres": [
        "TECHNO",
        "HOUSE"
      ],
      "status": "UPCOMING",
      "imageUrl": "https://…/logo.webp",
      "organizer": {
        "name": "Example Events GmbH"
      },
      "ticketShopUrl": "https://…/shop/summer-open-air-2027",
      "tickets": [
        {
          "name": "Weekend Ticket",
          "price": "79.00",
          "currency": "EUR",
          "soldOut": false
        },
        {
          "name": "Early Bird",
          "price": "59.00",
          "currency": "EUR",
          "soldOut": true
        }
      ],
      "visitorAppUrl": "https://…/app/summer-open-air-2027",
      "updatedAt": "2027-05-02T09:30:00.000Z"
    }
  ],
  "page": 1,
  "limit": 50,
  "total": 1
}

Fixed values

These values are stable and never renamed. New values may be added — please handle unknown ones gracefully.

status

UPCOMINGSOLD_OUTCOMPLETEDCANCELLEDPOSTPONED

type

FESTIVALOPEN_AIRCONCERTCLUB_NIGHTOTHER

genres

TECHNOHOUSETRANCEPSYTRANCEDRUM_AND_BASSBASSHARD_DANCEAMBIENTELECTRONICHIP_HOPRNBAFROBEATSREGGAEPOPROCKINDIEMETALPUNKSOUL_FUNKDISCOJAZZCLASSICALSCHLAGERFOLKLATINSINGER_SONGWRITERWORLD

address.country

DEATCHNLBELUFRITESPTPLCZDKSENOGBIEHUHR

Code examples

Ready to copy for the terminal, the browser and Node.js 18+.

# Next 20 events, soonest first
curl "https://alphaevents.tech/api/public/events?limit=20&sort=startDate"

# Only events changed since a point in time
curl "https://alphaevents.tech/api/public/events?updatedSince=2027-05-01T00:00:00Z"

5 requests per minute

Per IP address. Above that the API answers 429 with a Retry-After header.

One sync per day

Is plenty: fetch all pages with limit=100 one after another.

60 second cache

Responses may be cached for one minute.

Open CORS

Fetching straight from the browser works — no cookies, no credentials.

Removed events

Events that are no longer released, archived or over simply drop out of the list. To remove them on your side, sync the full list regularly.

Errors

Errors come as JSON with an error field, e.g. { "error": "invalid-sort" }.

400invalid-page
page is not a positive whole number.
400invalid-limit
limit is not between 1 and 100.
400invalid-sort
sort is not one of the allowed values.
400invalid-updated-since
updatedSince is not a valid ISO 8601 timestamp.
429rate-limited
Too many requests — retry after Retry-After seconds.
503unavailable
Temporarily unavailable — try again later.

Organising events yourself?

Only events you release show up in the API: in the back office under Event → General → "List publicly". The event needs an event type, postcode and city for that.

Start for free