---
title: "List Attendees"
method: GET
path: "/v1/events/{event_slug}/attendees"
tags: ["Attendees"]
---

# List Attendees

`GET /v1/events/{event_slug}/attendees`

## Request

- Base URL: `https://developer.eventship.com` (the document declares no server; this is the origin it was published from)
- URL: `https://developer.eventship.com/v1/events/{event_slug}/attendees`
- Auth: API key in header `X-API-Key`

List attendees for an event.

Access rules:
- Hosts of the event see the full attendee list (name, email, status,
  ticket type, check-in status, registration date). The ``status``
  filter applies, and ``includeAnswers=true`` adds each registrant's
  registration-question answers.
- Confirmed registered attendees see a filtered list (name + public
  profile info only) when the event has ``showGuestList=true``.
  Host-only fields are ``null``. Always limited to confirmed
  registrations; the ``status`` filter is ignored, and
  ``includeAnswers`` is refused.
- API-key auth is always host-only (API keys are scoped to a host).

## Path parameters

- `event_slug` string, required

## Query parameters

- `status` string, nullable: Filter by registration status (host only — ignored for non-host callers)
- `includeAnswers` boolean: Include each registrant's answers to the event's registration questions (host only). Off by default so existing integrations keep their current payload size.
- `page` integer
- `pageSize` integer

## Response `200`

Successful Response

- PaginatedResponseExternalAttendee
  - `data` ExternalAttendee[], required
    - `name` string, required
    - `profileSlug` string, nullable
    - `companyName` string, nullable
    - `email` string, nullable
    - `status` string, nullable
    - `ticketType` string, nullable
    - `checkedIn` boolean, nullable
    - `registeredAt` string, date-time, nullable
    - `answers` ExternalAttendeeAnswer[], nullable: This registrant's answers to the event's registration questions, in the questions' display order. Host view only, and only when the request sets `includeAnswers=true`; `null` otherwise. An answer appears once the registrant submitted it, whether the question is one of yours or one of Eventship's built-in profile questions.
      - `questionId` integer, required
      - `questionKey` string, required
      - `questionText` string, required
      - `questionType` 'text' | 'textarea' | 'select' | 'checkbox' | 'multiselect' | 'address', required: Type of registration question on an event.
      - `isCustom` boolean
      - `answerText` string, nullable
      - `answerJson` string[], nullable: Selected values for multi-choice questions. Populated instead of `answerText` for `multiselect`, and for any answer stored as a list of selections.
  - `total` integer, required
  - `page` integer, required
  - `pageSize` integer
  - `hasMore` boolean, required

## Other responses

- `422`: Validation Error

---

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