cURL
curl --request GET \ --url https://www.referralloop.dev/api/v1/waitlists/{waitlistId}/signups/{signupId} \ --header 'Authorization: Bearer <token>'
200
success
{ "signup": { "id": "789e0123-e89b-12d3-a456-426614174000", "email": "user@example.com", "name": "John Doe", "position": 1, "referral_code": "ABC123", "referral_url": "https://www.referralloop.dev/w/product-launch?ref=ABC123", "referral_count": 5, "status": "waiting", "created_at": "2024-01-15T10:00:00Z" }}
Retrieve a specific signup by ID
Use your API key as the bearer token. API keys can be generated in your dashboard.
Example: Authorization: Bearer pk_live_YOUR_API_KEY
Authorization: Bearer pk_live_YOUR_API_KEY
The ID of the waitlist
The ID of the signup
Successful response
Show child attributes
Unique identifier for the signup
"789e0123-e89b-12d3-a456-426614174000"
Email address of the signup
"user@example.com"
Current position in the waitlist
1
Unique referral code for this signup
"ABC123"
Status of the signup
waiting
approved
rejected
"waiting"
ISO 8601 timestamp when the signup was created
"2024-01-15T10:00:00Z"
Full name of the signup
"John Doe"
Full URL for the referral link
"https://www.referralloop.dev/w/product-launch?ref=ABC123"
Number of referrals made by this signup
5
Custom metadata associated with the signup
{ "source": "landing_page", "campaign": "summer_launch"}