> ## Documentation Index > Fetch the complete documentation index at: https://docs.referralloop.dev/llms.txt > Use this file to discover all available pages before exploring further. # List Waitlists > Retrieve all waitlists for your workspace ## OpenAPI ````yaml GET /waitlists openapi: 3.1.0 info: title: ReferralLoop API description: > The ReferralLoop API allows you to integrate waitlist and referral functionality into your application. ## Authentication All API requests must include your API key in the Authorization header: ``` Authorization: Bearer pk_live_YOUR_API_KEY ``` ## Rate Limits Rate limits vary by plan: - Starter: 1,000 requests/hour - Growth: 10,000 requests/hour - Pro: 100,000 requests/hour Rate limit information is included in response headers: - `X-RateLimit-Limit`: Maximum requests allowed - `X-RateLimit-Remaining`: Requests remaining - `X-RateLimit-Reset`: When the limit resets (ISO 8601) version: 1.0.0 contact: name: ReferralLoop Support url: https://www.referralloop.dev license: name: Proprietary servers: - url: https://www.referralloop.dev/api/v1 description: Production server security: [] tags: - name: Waitlists description: Manage waitlists - name: Signups description: Manage signups paths: /waitlists: get: tags: - Waitlists summary: List Waitlists description: Retrieve all waitlists for your workspace operationId: listWaitlists responses: '200': description: Successful response headers: X-RateLimit-Limit: description: Maximum number of requests allowed schema: type: integer X-RateLimit-Remaining: description: Number of requests remaining schema: type: integer X-RateLimit-Reset: description: ISO 8601 timestamp when rate limit resets schema: type: string format: date-time content: application/json: schema: $ref: '#/components/schemas/WaitlistsResponse' examples: success: value: waitlists: - id: 123e4567-e89b-12d3-a456-426614174000 name: Product Launch slug: product-launch description: Join our waitlist status: active created_at: '2024-01-15T10:00:00Z' count: 1 '401': $ref: '#/components/responses/Unauthorized' '429': $ref: '#/components/responses/RateLimitExceeded' '500': $ref: '#/components/responses/InternalServerError' security: - bearerAuth: [] components: schemas: WaitlistsResponse: type: object required: - waitlists - count properties: waitlists: type: array items: $ref: '#/components/schemas/Waitlist' count: type: integer description: Total number of waitlists example: 1 Waitlist: type: object required: - id - name - slug - status - created_at properties: id: type: string format: uuid description: Unique identifier for the waitlist example: 123e4567-e89b-12d3-a456-426614174000 name: type: string description: Name of the waitlist example: Product Launch slug: type: string description: URL-friendly identifier for the waitlist example: product-launch description: type: string nullable: true description: Description of the waitlist example: Join our waitlist status: type: string enum: - active - inactive description: Status of the waitlist example: active created_at: type: string format: date-time description: ISO 8601 timestamp when the waitlist was created example: '2024-01-15T10:00:00Z' Error: type: object required: - error properties: error: type: string description: Error message describing what went wrong example: Invalid API key message: type: string description: Additional error details example: Upgrade your plan to use the API upgrade_url: type: string format: uri description: URL to upgrade plan (for 403 errors) example: https://www.referralloop.dev/dashboard/billing limit: type: integer description: Rate limit (for 429 errors) example: 1000 reset_at: type: string format: date-time description: When rate limit resets (for 429 errors) example: '2024-01-15T11:00:00Z' signup: $ref: '#/components/schemas/Signup' description: Existing signup information (for 409 errors) Signup: type: object required: - id - email - position - referral_code - status - created_at properties: id: type: string format: uuid description: Unique identifier for the signup example: 789e0123-e89b-12d3-a456-426614174000 email: type: string format: email description: Email address of the signup example: user@example.com name: type: string nullable: true description: Full name of the signup example: John Doe position: type: integer description: Current position in the waitlist example: 1 referral_code: type: string description: Unique referral code for this signup example: ABC123 referral_url: type: string format: uri nullable: true description: Full URL for the referral link example: https://www.referralloop.dev/w/product-launch?ref=ABC123 referral_count: type: integer nullable: true description: Number of referrals made by this signup example: 5 status: type: string enum: - waiting - approved - rejected description: Status of the signup example: waiting created_at: type: string format: date-time description: ISO 8601 timestamp when the signup was created example: '2024-01-15T10:00:00Z' metadata: type: object nullable: true description: Custom metadata associated with the signup additionalProperties: true example: source: landing_page campaign: summer_launch responses: Unauthorized: description: Unauthorized - Invalid or missing API key content: application/json: schema: $ref: '#/components/schemas/Error' examples: missingKey: value: error: Missing or invalid authorization header invalidKey: value: error: Invalid API key RateLimitExceeded: description: Too Many Requests - Rate limit exceeded headers: X-RateLimit-Limit: description: Maximum number of requests allowed schema: type: integer X-RateLimit-Remaining: description: Number of requests remaining (will be 0) schema: type: integer X-RateLimit-Reset: description: ISO 8601 timestamp when rate limit resets schema: type: string format: date-time content: application/json: schema: $ref: '#/components/schemas/Error' examples: rateLimit: value: error: Rate limit exceeded limit: 1000 reset_at: '2024-01-15T11:00:00Z' InternalServerError: description: Internal Server Error content: application/json: schema: $ref: '#/components/schemas/Error' examples: serverError: value: error: Failed to fetch waitlists securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT description: > Use your API key as the bearer token. API keys can be generated in your dashboard. Example: `Authorization: Bearer pk_live_YOUR_API_KEY` ````