Skip to main content
GET
/
events
/
{eventId}
/
attendees
curl -H "X-API-KEY: your_api_key" \
  "https://www.gomry.com/api/v1/events/AbCdEfGhIjKlMnOpQrSt/attendees?page=1&page_size=50"

{
  "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
  }
}

​
List Attendees

Returns a paginated list of attendees (ticket holders) for an event.

​
Path Parameters

​
eventId
string
required
The unique identifier of the event.

​
Query Parameters

​
page
integer
default:"1"
Page number (starts at 1).
​
page_size
integer
default:"50"
Number of attendees per page. Maximum: 200.
​
status
string
default:"valid,checked_in"
Comma-separated list of ticket statuses to include.Allowed values: valid, checked_in, pending_approval, invited.Example: ?status=valid,checked_in
​
pk
string
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

​
data
array
​
pagination
object
curl -H "X-API-KEY: your_api_key" \
  "https://www.gomry.com/api/v1/events/AbCdEfGhIjKlMnOpQrSt/attendees?page=1&page_size=50"

{
  "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
  }
}