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
Fetch
A GET on the endpoint returns the next events — no header, no key.
- 2
Page through
Use
pageandlimitto fetch up to 100 events per request until you reachtotal. - 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.
https://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-titleDefault: 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_OUTCOMPLETEDCANCELLEDPOSTPONEDtype
FESTIVALOPEN_AIRCONCERTCLUB_NIGHTOTHERgenres
TECHNOHOUSETRANCEPSYTRANCEDRUM_AND_BASSBASSHARD_DANCEAMBIENTELECTRONICHIP_HOPRNBAFROBEATSREGGAEPOPROCKINDIEMETALPUNKSOUL_FUNKDISCOJAZZCLASSICALSCHLAGERFOLKLATINSINGER_SONGWRITERWORLDaddress.country
DEATCHNLBELUFRITESPTPLCZDKSENOGBIEHUHRCode 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.