Introduction

The Lucerna Waitlist API lets your own application capture waitlist signups and redeem invite codes, without a dashboard user in the loop. It is a small, JSON-over-HTTPS REST API — you can call it from any language with curl and a couple of lines of code.

There is no SDK to install. Every example in these docs is either raw curl or plain fetch against the endpoints.

Base URL

All requests go to:

https://api.uselucerna.app

Every public endpoint lives under the /sdk/v1/waitlist prefix.

What you can do

Endpoint	Auth	Purpose
POST /sdk/v1/waitlist/signup	Server key	Add up to 100 signups to a waitlist
GET /sdk/v1/waitlist/invites/{code}	None	Check whether an invite code is live
POST /sdk/v1/waitlist/invites/{code}/accept	None	Redeem an invite code

The signup endpoint is server-to-server and requires a secret server key. The two invite endpoints operate on a single-use code and are public — safe to call from a browser-side join page.

Dashboard-only routes

Everything else — listing entries, analytics, sending invites, editing templates — lives on the admin API used by the Lucerna dashboard and is not part of this public surface.

Conventions

• Requests and responses are always JSON. Send Content-Type: application/json on any request with a body.
• All IDs in this API are the short waitlist id shown in the dashboard (e.g. wl_launch), not an internal database id.
• Errors share one shape: { "code": "...", "message": "..." }. See Errors.

Next: Quickstart →