REST API
WaitKit REST API reference. Base URL, Bearer token authentication, rate limiting, and available endpoints for collecting waitlist signups and querying subscriber counts.
The REST API is the foundation of all WaitKit integrations. The JavaScript SDK wraps these endpoints directly.
Base URL
https://api.waitkit.devAuthentication
All public endpoints require an API key sent as a Bearer token in the Authorization header:
Authorization: Bearer wk_...API keys are generated per project from the dashboard. Each request without a valid key returns 401 Unauthorized.
Content type
All requests and responses use application/json.
Rate limiting
Rate limits apply per API key. Exceeded limits return 429 Too Many Requests with a Retry-After header.
Endpoints
| Method | Path | Auth | Description |
|---|---|---|---|
POST | /v1/waitlist/:slug/join | API key | Add a subscriber |
GET | /v1/waitlist/:slug/count | API key | Get subscriber count |
See the individual endpoint pages for request and response schemas.
SDK Errors
Handle WaitKitError thrown by the JavaScript SDK. Learn try-catch patterns, error status codes (400, 401, 404, 409, 429), and how to parse validation issues from API responses.
Join Waitlist
POST /v1/waitlist/:slug/join endpoint. Add a subscriber email to your waitlist with name, source tracking, and custom metadata. Request params, response format, and HTTP status codes.