> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gomry.com/llms.txt
> Use this file to discover all available pages before exploring further.
# List Attendees
> List attendees for an event with pagination and status filtering
# List Attendees
Returns a paginated list of attendees (ticket holders) for an event.
## Path Parameters
The unique identifier of the event.
## Query Parameters
Page number (starts at 1).
Number of attendees per page. Maximum: `200`.
Comma-separated list of ticket statuses to include.
Allowed values: `valid`, `checked_in`, `pending_approval`, `invited`.
Example: `?status=valid,checked_in`
Resolve a Gomry ticket QR code to its attendee(s). QR codes encode a URL of
the form `https://gomry.com/ticket/{eventId}?pk={pk}` — pass that `pk` here
to look up the matching ticket(s). The value may be a paymentID (group
purchases return all tickets under the payment) or a ticket document ID.
Filtered to the same `status` set; `page` and `page_size` still apply.
## Response
Unique ticket identifier
Ticket status
ID of the ticket class (product)
Name of the ticket class
Ticket barcode
Attendee first name
Attendee last name
Attendee email address
ISO 8601 check-in timestamp
ISO 8601 registration timestamp
ISO 8601 last-updated timestamp
Total number of matching attendees
Current page number
Items per page
Total number of pages
```bash cURL theme={null}
curl -H "X-API-KEY: your_api_key" \
"https://www.gomry.com/api/v1/events/AbCdEfGhIjKlMnOpQrSt/attendees?page=1&page_size=50"
```
```javascript JavaScript theme={null}
const response = await fetch(
"https://www.gomry.com/api/v1/events/AbCdEfGhIjKlMnOpQrSt/attendees?page=1&page_size=50",
{ headers: { "X-API-KEY": "your_api_key" } }
);
const { data, pagination } = await response.json();
```
```json 200 theme={null}
{
"data": [
{
"id": "ticket_001",
"status": "valid",
"ticket_class_id": "prod_general",
"ticket_class_name": "General Admission",
"barcode": "GOMRY-A1B2C3",
"first_name": "Jane",
"last_name": "Doe",
"email": "jane@example.com",
"checked_in_at": null,
"created_at": "2025-06-01T12:00:00.000Z",
"updated_at": "2025-06-01T12:00:00.000Z"
},
{
"id": "ticket_002",
"status": "checked_in",
"ticket_class_id": "prod_vip",
"ticket_class_name": "VIP",
"barcode": "GOMRY-D4E5F6",
"first_name": "John",
"last_name": "Smith",
"email": "john@example.com",
"checked_in_at": "2025-07-15T14:30:00.000Z",
"created_at": "2025-05-20T09:00:00.000Z",
"updated_at": "2025-07-15T14:30:00.000Z"
}
],
"pagination": {
"total": 234,
"page": 1,
"page_size": 50,
"total_pages": 5
}
}
```