API Documentation

v1.0 • REST API

Integrate Jumpwait into your applications with our REST API. Create waitlists, manage entries, and enable position trading programmatically.

Getting Started

The Jumpwait API is organized around REST. It accepts JSON-encoded request bodies, returns JSON-encoded responses, and uses standard HTTP response codes.

Base URL
https://api.jumpwait.com/v1

🚧 API Status: The public API is currently in beta. Some endpoints may change before the stable release. Contact us at api@jumpwait.com for early access.

Authentication

Authenticate API requests using Bearer tokens. You can generate API keys from your dashboard settings.

# Include in request headers
Authorization: Bearer your_api_key_here

Endpoints

GET/api/v1/waitlists

List all public waitlists

GET/api/v1/waitlists/:id

Get a specific waitlist by ID

POST/api/v1/waitlists/:id/join
Auth required

Join a waitlist

GET/api/v1/waitlists/:id/entries

List entries in a waitlist

GET/api/v1/entries/:id
Auth required

Get details of a specific entry

POST/api/v1/entries/:id/list
Auth required

List your position for sale

DELETE/api/v1/entries/:id/list
Auth required

Remove your position from sale

GET/api/v1/bids
Auth required

List bids on your positions

POST/api/v1/bids
Auth required

Place a bid on a position

POST/api/v1/bids/:id/accept
Auth required

Accept a bid on your position

Webhooks

Receive real-time notifications when events happen in your waitlists. Configure webhook endpoints in your business dashboard.

Available Events

  • entry.created - New signup on your waitlist
  • entry.listed - Position listed for sale
  • bid.placed - New bid on a position
  • trade.completed - Position successfully traded

Rate Limits

API requests are rate limited to ensure fair usage.

Free Tier
100 requests/min
Pro Tier
1,000 requests/min

Error Handling

The API uses conventional HTTP response codes to indicate success or failure.

200Success
400Bad Request - Invalid parameters
401Unauthorized - Invalid or missing API key
403Forbidden - Insufficient permissions
404Not Found - Resource doesn't exist
429Rate Limited - Too many requests
500Server Error - Something went wrong

Ready to integrate?

Request API access to start building with Jumpwait.

Request API Access
API Documentation - Jumpwait | Jumpwait