Catalog / Luma Public Events

Luma Public Events API

luma.com

Live, read-only access to public upcoming Luma events. Search by a Luma place, city name, or coordinates with opaque cursor pagination, then retrieve a full public event record.

  • Other
  • luma
  • events
  • discovery
  • public-data
2 endpointsDocs updated

Endpoint health

Loading verification…

Connect your agent

Connect through MCP so your agent can find this API, read its docs, and call its endpoints.

Setup guide

Add the server from your terminal.

Claude Code · terminal
claude mcp add --transport http agent-data https://agent-data.motie.dev/mcp

In Claude Code, run /mcp, select agent-data, then Authenticate. Sign in to your agent-data account in the browser.

Then ask your agent to use the Luma Public Events API for your task.

Call it over HTTP

Get an API key

Sign up free, generate an API key, and set it as AGENT_DATA_API_KEY in your environment. Your first 100 calls each month are free.

Get a public event record

event_api_id returned by search_events.

View call pricing
cURL · Event details
curl --request GET --get 'https://3kpkg0jfvk.execute-api.us-east-2.amazonaws.com/prod/c250ada8-8ef9-4f6f-a1af-bb51b9594349/v1/event-details' \
  --header "Authorization: Bearer $AGENT_DATA_API_KEY" \
  --data-urlencode 'event_api_id=evt-T70jSfKJxoEgpPQ'

Endpoints

Inputs and response fields for every endpoint in this API.

GETEvent details/v1/event-details

Get a public event record

Input

event_api_idRequiredQuery · string

event_api_id returned by search_events.

Example: evt-T70jSfKJxoEgpPQ

Response

urlstring | null
citystring | null
namestring | null
hostsobject[]
hosts[].biostring | null
hosts[].namestring | null
hosts[].usernamestring | null
hosts[].avatar_urlstring | null
end_atstring (date-time) | null
addressstring | null
countrystring | null
is_freeboolean | null
sold_outboolean | null
start_atstring (date-time) | null
timezonestring | null
cover_urlstring | null
city_statestring | null
coordinatesobject
coordinates.latitudenumber
coordinates.longitudenumber
descriptionstring | null
guest_countinteger | null
event_api_idstring | null
ticket_pricenumber | null
calendar_namestring | null
location_typestring | null
featured_guestsobject[]
featured_guests[].biostring | null
featured_guests[].namestring | null
featured_guests[].usernamestring | null
featured_guests[].avatar_urlstring | null
ticket_currencystring | null
GETSearch events/v1/search-events

Search upcoming public events

Input

cityOptionalQuery · string | null

Exact public Luma city/place name, such as New York.

Example: New York

latitudeOptionalQuery · number, min: -90, max: 90 | null

Latitude for a coordinate search.

Example: 40.73061

longitudeOptionalQuery · number, min: -180, max: 180 | null

Longitude for a coordinate search.

Example: -73.935242

place_idOptionalQuery · string | null

Luma discovery place_id, such as discplace-Izx1rQVSh8njYpP.

Example: discplace-Izx1rQVSh8njYpP

limitOptionalQuery · integer, min: 1, max: 100, default: 25

Maximum events returned in this page.

Example: 25

cursorOptionalQuery · string | null

Opaque cursor returned by a previous search_events response.

Response

eventsobject[]
events[].urlstring | null
events[].citystring | null
events[].namestring | null
events[].hostsobject[]
events[].hosts[].namestring | null
events[].hosts[].avatar_urlstring | null
events[].end_atstring (date-time) | null
events[].addressstring | null
events[].countrystring | null
events[].is_freeboolean | null
events[].start_atstring (date-time) | null
events[].timezonestring | null
events[].cover_urlstring | null
events[].city_statestring | null
events[].descriptionstring | null
events[].guest_countinteger | null
events[].event_api_idstring | null
events[].ticket_pricenumber | null
events[].calendar_namestring | null
events[].location_typestring | null
events[].ticket_currencystring | null
has_moreboolean
next_cursorstring | null
total_returnedinteger

For the next page, pass next_cursor from the response as cursor. Leave it empty on the first call.

Don’t see the endpoint you need?

Ask agent-data to add an endpoint or return more fields. Extensions are free and keep existing endpoints working.