---
title: "List signups for the calling organization"
method: GET
path: "/signups"
tags: ["Signups"]
---

# List signups for the calling organization

`GET /signups`

## Request

- Base URL: `https://thesignup.app/api/v1`
- URL: `https://thesignup.app/api/v1/signups`
- Auth: HTTP bearer

Cursor-paginated. Default page size is 20; max is 100. Stable order is `eventDate DESC, id DESC`. Pass the `nextCursor` from a previous response to advance.

## Query parameters

- `status` 'draft' | 'published' | 'closed'
- `limit` integer: 1–100. Defaults to 20.
- `cursor` string

## Response `200`

Page of signups

- ListSignupsResponse
  - `data` SignupSummary[], required
    - `id` string, uuid, required
    - `organizationId` string, required
    - `slug` string, required
    - `title` string, required
    - `status` 'draft' | 'published' | 'closed', required
    - `eventDate` string, date-time, required: ISO-8601 UTC.
    - `signupCloseDate` string, date-time, nullable, required: ISO-8601 UTC. Null = signups never close until the event.
    - `location` string, nullable, required
    - `isPrivate` boolean, required
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
  - `nextCursor` string, nullable, required: Pass to the next call to fetch the following page. Null when no more pages.

## Other responses

- `401`: Unauthenticated — credentials missing, malformed, invalid, or revoked
- `422`: Validation failed — request body / query / path is structurally wrong
- `429`: Rate limited or daily ceiling exceeded
- `500`: Internal server error

---

[API](https://skmtc.dev/thesignup/apis/thesignup-api.md) · [All operations](https://skmtc.dev/thesignup/apis/thesignup-api/llms.txt) · [OpenAPI document](https://skmtc.dev/thesignup/apis/thesignup-api/revisions/c6da7cf92172?raw)