About the API

The Luma API is a JSON-based API that allows you to programmatically manage your events and guests.

Base URL: https://public-api.luma.com

Requirements

To use the Luma API, you need a Luma Plus subscription.

Creating an API Key

API keys are scoped to a single calendar. Each calendar you want to manage via the API needs its own key, and each key only grants access to the calendar it was created on.

Go to luma.com/calendar/manage/api-keys and select the calendar you want a key for
Generate an API key
Store it securely

Warning: Be careful with this API key since it grants full access to the calendar it's scoped to.

Authentication

Authenticate your requests by including your API key in the x-luma-api-key header.

Example: Test Authentication

curl -H "x-luma-api-key: $LUMA_API_KEY" https://public-api.luma.com/v1/user/get-self

This will return information about the authenticated user if the API key is valid.

OpenAPI Spec

The full OpenAPI 3.1 specification is available at:

https://public-api.luma.com/openapi.json

No authentication is required. You can use this to generate client libraries, import into tools like Postman, or build integrations with AI agents.

Next Steps

Review the API Conventions guide to understand our routing and versioning approach
Review the API Formats guide to understand date, duration, and location formatting
Check out code examples for implementation ideas
Explore the API endpoints in the reference documentation