API Reference

Make your first request in just a few minutes.

The Luma API is a JSON-based RESTful API that allows you to read data and take actions on your Luma events and guests. You can create events, embed upcoming events, pull information about guests, and add guests to events.

About the API

  • Base URL: https://api.lu.ma
  • All requests and responses use JSON format

Requirements

To use the Luma API, you'll need to pay for Luma Plus. See our pricing page.

Create an API Key

To authenticate your requests, you'll need an API key.

You can generate an API key on your Luma dashboard.

Be careful with this API key since it will give full access to your Luma account.

Test Authentication

You will authenticate requests by putting your API key in the x-luma-api-key header field.

Here is an example CURL request to run to check that you are authenticated properly:

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