---
title: "List registrations on a signup"
method: GET
path: "/signups/{id}/registrations"
tags: ["Participants"]
---

# List registrations on a signup

`GET /signups/{id}/registrations`

## Request

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

One row per person, with commitments (slot/item picks) embedded. Supersedes `/signups/{id}/participants` (one row per commitment), which stays available for a deprecation window — the legacy endpoint sets `Deprecation: true` and a `Link: rel="successor-version"` header pointing here.

## Path parameters

- `id` string, uuid, required

## Response `200`

Registration list

- ListRegistrationsResponse
  - `data` Registration[], required
    - `id` string, uuid, required
    - `eventId` string, uuid, required
    - `name` string, required
    - `email` string, email, required
    - `phone` string, nullable, required
    - `attending` boolean, required
    - `attendOnly` boolean, required
    - `attendees` integer, required: How many people this registration covers, the person included.
    - `nameVisible` boolean, required: Whether the person's name is shown on the public signup page's list of who signed up.
    - `eventCustomFieldResponse` string, nullable, required
    - `dayCustomFieldResponses` object, nullable, required
    - `days` string[], required: The event days (`event_days.id`) this person is attending, sorted by id. Includes the day a slot they hold is on, unless it was removed with `days`.
    - `createdAt` string, date-time, required
    - `lastModifiedAt` string, date-time, required
    - `commitments` Commitment[], required
      - union
        - SlotCommitment
          - `kind` 'slot', required
          - `id` string, uuid, required
          - `participantId` string, uuid, required
          - `slotId` string, uuid, required
          - `title` string, nullable, required
          - `startTime` string, date-time, required
          - `endTime` string, date-time, required
          - `quantity` integer, required
          - `customFieldResponse` string, nullable, required
        - ItemCommitment
          - `kind` 'item', required
          - `id` string, uuid, required
          - `participantId` string, uuid, required
          - `itemId` string, uuid, required
          - `name` string, required
          - `quantity` integer, required
          - `customFieldResponse` string, nullable, required

## Other responses

- `401`: Unauthenticated — credentials missing, malformed, invalid, or revoked
- `404`: Not found
- `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)