> ## Documentation Index
> Fetch the complete documentation index at: https://docs.signupbreeze.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List an event's signups

> Returns the event's signups oldest first, so paging through them follows the order
people actually signed up. Cursor paginated.

Includes cancelled signups by default — filter with `status` if you only want the
people who are still coming.

Requires the `registrations:read` scope.



## OpenAPI

````yaml https://api.signupbreeze.com/openapi.yaml get /v1/events/{event_id}/registrations
openapi: 3.0.3
info:
  title: SignUpBreeze API
  description: >-
    Manage events, shifts, and signups programmatically — from your own scripts,
    an

    automation platform, or an AI agent.


    ## Authentication


    Every request needs a bearer token, which an organization owner or admin
    creates

    under **Organization settings → API**. Tokens belong to the organization
    rather

    than to the person who created one, so an admin leaving does not break a
    live

    integration.


    Each token carries a set of scopes, and every endpoint states the scope it

    requires. A request whose token lacks the scope is refused with `403`.


    **Every token expires**, after at most a year and by default after exactly
    that.

    An expired token is refused with `401`, the same as a revoked one, so plan
    to

    create a replacement before the expiry date shown in settings — nothing
    using

    the old token keeps working past it.


    ## Rate limiting


    Requests are throttled per API token, not per organization — issuing more

    tokens does not raise the ceiling. The limit varies by plan: 30 requests/min

    on Free and Calendar, 120 on Starter, 300 on Pro.


    Every response carries `X-RateLimit-Limit` and `X-RateLimit-Remaining`.

    Exceeding the limit returns `429`, with `Retry-After` and
    `X-RateLimit-Reset`

    added to that response so you know when to try again.


    ## Idempotency


    Writes accept an `Idempotency-Key` header. Send the same key again and the
    original

    response is replayed rather than the write happening twice — worth using
    anywhere a

    retry is possible, which is most places an agent is involved.


    ## Pagination


    Collections are cursor paginated. Follow `meta.next_cursor` rather than
    assuming

    page numbers.


    ## Scoping


    Everything a token can reach belongs to its organization. Another
    organization's

    record answers `404` rather than `403`, so a token cannot be used to
    discover that

    it exists.
  version: 1.0.0
servers:
  - url: https://api.signupbreeze.com
security:
  - default: []
tags:
  - name: Events
    description: >-

      Create and manage events. Every endpoint is scoped to the organization
      that owns the

      token — another organization's event responds `404`, not `403`, so a token
      cannot be

      used to discover that it exists.
  - name: Organization
    description: |-

      The organization a token belongs to.
  - name: Shifts
    description: >-

      The time slots volunteers sign up for. Shift times are wall-clock strings
      like `14:30`,

      interpreted in the parent event's timezone against its start date — you
      never send a

      date or an offset for a shift.
  - name: Signups
    description: >-

      Who has signed up. Read-only in v1: signups are created through the public
      event page,

      which is deliberately the only way a volunteer is added.
externalDocs:
  description: SignUpBreeze documentation
  url: https://docs.signupbreeze.com/api-reference/introduction
paths:
  /v1/events/{event_id}/registrations:
    parameters:
      - in: path
        name: event_id
        description: The ID of the event.
        example: 019fdf11-4bb2-7039-92c3-9e7f1ee711a1
        required: true
        schema:
          type: string
      - in: path
        name: event
        description: The event's id.
        example: 019fdf11-4bb2-7039-92c3-9e7f1ee711a1
        required: true
        schema:
          type: string
    get:
      tags:
        - Signups
      summary: List an event's signups
      description: >-
        Returns the event's signups oldest first, so paging through them follows
        the order

        people actually signed up. Cursor paginated.


        Includes cancelled signups by default — filter with `status` if you only
        want the

        people who are still coming.


        Requires the `registrations:read` scope.
      operationId: listAnEventsSignups
      parameters:
        - in: query
          name: slot_id
          description: Only signups for one shift.
          example: 019fdf11-4bc7-723f-96f0-fdf57ab20b07
          required: false
          schema:
            type: string
            description: Only signups for one shift.
            example: 019fdf11-4bc7-723f-96f0-fdf57ab20b07
        - in: query
          name: status
          description: 'Filter by status: `confirmed` or `cancelled`.'
          example: confirmed
          required: false
          schema:
            type: string
            description: 'Filter by status: `confirmed` or `cancelled`.'
            example: confirmed
        - in: query
          name: per_page
          description: Results per page, capped at 100.
          example: 25
          required: false
          schema:
            type: integer
            description: Results per page, capped at 100.
            example: 25
        - in: query
          name: cursor
          description: The cursor from a previous response's `meta.next_cursor`.
          example: null
          required: false
          schema:
            type: string
            description: The cursor from a previous response's `meta.next_cursor`.
            example: null
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                example:
                  data:
                    - id: 019ff256-ecf3-7283-bf10-651c69bceee7
                      event_id: null
                      slot_id: 019ff256-ecf3-7283-bf10-651c699ee654
                      name: Morgan Hirthe
                      email: dare.emelie@example.com
                      is_guest: true
                      status: confirmed
                      created_at: '2026-08-11T19:40:10+00:00'
                    - id: 019ff256-ecf7-71bd-99c6-8a6c4a7013f7
                      event_id: null
                      slot_id: 019ff256-ecf7-71bd-99c6-8a6c49f71320
                      name: Abdullah Douglas MD
                      email: tressa41@example.com
                      is_guest: true
                      status: confirmed
                      created_at: '2026-08-11T19:40:10+00:00'
                  links:
                    first: null
                    last: null
                    prev: null
                    next: null
                  meta:
                    path: /
                    per_page: 25
                    next_cursor: null
                    prev_cursor: null
                properties:
                  data:
                    type: array
                    example:
                      - id: 019ff256-ecf3-7283-bf10-651c69bceee7
                        event_id: null
                        slot_id: 019ff256-ecf3-7283-bf10-651c699ee654
                        name: Morgan Hirthe
                        email: dare.emelie@example.com
                        is_guest: true
                        status: confirmed
                        created_at: '2026-08-11T19:40:10+00:00'
                      - id: 019ff256-ecf7-71bd-99c6-8a6c4a7013f7
                        event_id: null
                        slot_id: 019ff256-ecf7-71bd-99c6-8a6c49f71320
                        name: Abdullah Douglas MD
                        email: tressa41@example.com
                        is_guest: true
                        status: confirmed
                        created_at: '2026-08-11T19:40:10+00:00'
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          example: 019ff256-ecf3-7283-bf10-651c69bceee7
                        event_id:
                          type: string
                          example: null
                          nullable: true
                        slot_id:
                          type: string
                          example: 019ff256-ecf3-7283-bf10-651c699ee654
                        name:
                          type: string
                          example: Morgan Hirthe
                        email:
                          type: string
                          example: dare.emelie@example.com
                        is_guest:
                          type: boolean
                          example: true
                        status:
                          type: string
                          example: confirmed
                        created_at:
                          type: string
                          example: '2026-08-11T19:40:10+00:00'
                  links:
                    type: object
                    properties:
                      first:
                        type: string
                        example: null
                        nullable: true
                      last:
                        type: string
                        example: null
                        nullable: true
                      prev:
                        type: string
                        example: null
                        nullable: true
                      next:
                        type: string
                        example: null
                        nullable: true
                  meta:
                    type: object
                    properties:
                      path:
                        type: string
                        example: /
                      per_page:
                        type: integer
                        example: 25
                      next_cursor:
                        type: string
                        example: null
                        description: >-
                          Pass as `cursor` to fetch the next page. Null on the
                          last page.
                      prev_cursor:
                        type: string
                        example: null
                        nullable: true
        '404':
          description: no such event, or it belongs to another organization
          content:
            application/json:
              schema:
                type: object
                example:
                  message: Not found.
                properties:
                  message:
                    type: string
                    example: Not found.
components:
  securitySchemes:
    default:
      type: http
      scheme: bearer
      description: >-
        Create a token under <b>Organization settings → API</b>. Tokens are
        shown once, on creation. They belong to the organization, not to you, so
        they keep working if you leave the team. API access is included on every
        plan; the rate limit depends on the plan.

````