Luma Public Events API
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.
Endpoint health
Loading verification…
Connect your agent
Connect through MCP so your agent can find this API, read its docs, and call its endpoints.
Add the server from your terminal.
claude mcp add --transport http agent-data https://agent-data.motie.dev/mcpIn 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 keySign 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.
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 · stringevent_api_id returned by search_events.
Example: evt-T70jSfKJxoEgpPQ
Response
urlstring | nullcitystring | nullnamestring | nullhostsobject[]hosts[].biostring | nullhosts[].namestring | nullhosts[].usernamestring | nullhosts[].avatar_urlstring | nullend_atstring (date-time) | nulladdressstring | nullcountrystring | nullis_freeboolean | nullsold_outboolean | nullstart_atstring (date-time) | nulltimezonestring | nullcover_urlstring | nullcity_statestring | nullcoordinatesobjectcoordinates.latitudenumbercoordinates.longitudenumberdescriptionstring | nullguest_countinteger | nullevent_api_idstring | nullticket_pricenumber | nullcalendar_namestring | nulllocation_typestring | nullfeatured_guestsobject[]featured_guests[].biostring | nullfeatured_guests[].namestring | nullfeatured_guests[].usernamestring | nullfeatured_guests[].avatar_urlstring | nullticket_currencystring | nullGETSearch events/v1/search-events
Search upcoming public events
Input
cityOptionalQuery · string | nullExact public Luma city/place name, such as New York.
Example: New York
latitudeOptionalQuery · number, min: -90, max: 90 | nullLatitude for a coordinate search.
Example: 40.73061
longitudeOptionalQuery · number, min: -180, max: 180 | nullLongitude for a coordinate search.
Example: -73.935242
place_idOptionalQuery · string | nullLuma discovery place_id, such as discplace-Izx1rQVSh8njYpP.
Example: discplace-Izx1rQVSh8njYpP
limitOptionalQuery · integer, min: 1, max: 100, default: 25Maximum events returned in this page.
Example: 25
cursorOptionalQuery · string | nullOpaque cursor returned by a previous search_events response.
Response
eventsobject[]events[].urlstring | nullevents[].citystring | nullevents[].namestring | nullevents[].hostsobject[]events[].hosts[].namestring | nullevents[].hosts[].avatar_urlstring | nullevents[].end_atstring (date-time) | nullevents[].addressstring | nullevents[].countrystring | nullevents[].is_freeboolean | nullevents[].start_atstring (date-time) | nullevents[].timezonestring | nullevents[].cover_urlstring | nullevents[].city_statestring | nullevents[].descriptionstring | nullevents[].guest_countinteger | nullevents[].event_api_idstring | nullevents[].ticket_pricenumber | nullevents[].calendar_namestring | nullevents[].location_typestring | nullevents[].ticket_currencystring | nullhas_morebooleannext_cursorstring | nulltotal_returnedintegerFor 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.
An account is required to submit an extension. Prepare your request, then sign in to build.