WaitlistMaster API

All API requests must include your API key in the Authorization header:

You can generate and manage your API key in API Keys settings.

Get All Projects

GET /projects

[
    {
        "backgroundGradient": "from-purple-400 to-pink-400",
        "createdAt": "2026-07-08T14:45:51.296Z",
        "customDomain": null,
        "disabled": false,
        "headline": "Join the waitlist",
        "id": "6a4e629ff88e15f20c6d1db2",
        "leaderboardEnabled": true,
        "logo": {
            "base64Data": "iVBORw0KGgoAA..",
			"mimeType": "image/png",
            "name": "Sign_Mobile.png"
        },
        "name": "test1",
        "plan": "GROWTH",
        "primaryColor": "black",
        "referralsEnabled": true,
        "slug": "test1",
        "subheadline": "Be the first to know when we launch",
        "updatedAt": "2026-07-09T14:54:06.812Z",
        "userId": "6a4bb43b04914c89e2714180"
    }
]

Get Project Leads

POST /projects/{projectId}/leads/query?page=0&size=5&sort=createdAt,asc

{
    "email": "ma"
}

{
    "content": [
        {
            "_id": "6a5113e0596669aacb5bb7ef",
            "projectId": "6a4e629ff88e15f20c6d1db2",
            "email": "[email protected]",
            "referralCode": "bda61170-7a23-446d-84c6-bb205b7b90e2",
            "referralsCount": 1,
            "confirmed": true,
            "confirmedAt": "2026-07-10T15:51:00.786Z",
            "customPosition": 9223372036854775807,
            "priorityScore": 0,
            "createdAt": "2026-07-10T15:46:40.408Z",
            "updatedAt": "2026-07-10T15:51:00.786Z",
            "notified": false,
            "referralObjects": [
                {
                    "confirmed": true,
                    "confirmedAt": "2026-07-10T15:51:46.351Z",
                    "createdAt": "2026-07-10T15:51:29.486Z",
                    "customPosition": 9223372036854775807,
                    "email": "[email protected]",
                    "id": "6a511501596669aacb5bb7f0",
                    "notified": false,
                    "priorityScore": 0,
                    "projectId": "6a4e629ff88e15f20c6d1db2",
                    "referralCode": "ca013c78-ec4a-4363-9096-87ef2a783de4",
                    "referralsCount": 0,
                    "referrerId": "6a5113e0596669aacb5bb7ef",
                    "updatedAt": "2026-07-10T15:51:46.351Z"
                }
            ]
        },
        {
            "_id": "6a511501596669aacb5bb7f0",
            "projectId": "6a4e629ff88e15f20c6d1db2",
            "email": "[email protected]",
            "referralCode": "ca013c78-ec4a-4363-9096-87ef2a783de4",
            "referrerId": "6a5113e0596669aacb5bb7ef",
            "referralsCount": 0,
            "confirmed": true,
            "confirmedAt": "2026-07-10T15:51:46.351Z",
            "customPosition": 9223372036854775807,
            "priorityScore": 0,
            "createdAt": "2026-07-10T15:51:29.486Z",
            "updatedAt": "2026-07-10T15:51:46.351Z",
            "notified": false,
            "referralObjects": []
        }
    ],
    "empty": false,
    "first": true,
    "last": true,
    "number": 0,
    "numberOfElements": 2,
    "pageable": {
        "offset": 0,
        "pageNumber": 0,
        "pageSize": 5,
        "paged": true,
        "sort": {
            "empty": false,
            "sorted": true,
            "unsorted": false
        },
        "unpaged": false
    },
    "size": 5,
    "sort": {
        "empty": false,
        "sorted": true,
        "unsorted": false
    },
    "totalElements": 2,
    "totalPages": 1
}

Change position

POST /projects/{projectId}/changeWaitListPosition

{
    "email": "ma2.test.com",
	"position": 10
}

{
}

Export Leads as CSV

GET /projects/{projectId}/leads/csv

Returns a downloadable CSV file with all confirmed leads.