List event registrations
GET /event-registrations
Requires the event_registrations:read permission. Returns records belonging to the authenticated organisation, including unpublished or inactive records unless filtered.
Authorization
X-API-Key required
Parameters
| Name | Location | Type | Required | Default | Limits | Description |
|---|---|---|---|---|---|---|
page | query | integer | No | 1 | min 1, max 1000000 | Page number |
limit | query | integer | No | 10 | min 1, max 100 | Results per page |
eventId | query | string | No | RemyPass event _id | ||
memberId | query | string | No | RemyPass member _id | ||
orderId | query | string | No | RemyPass event order _id | ||
status | query | pending, active, cancelled | No | Registration status | ||
paymentStatus | query | free, paid, pending, refund_pending, refund_failed, refunded, disputed | No | Registration payment status | ||
role | query | buyer, guest | No | Registrant role | ||
email | query | string (email) | No | Exact registrant email, case-insensitive | ||
updatedSince | query | string (date-time) | No | Inclusive ISO 8601 lower bound on updatedAt | ||
createdAfter | query | string (date-time) | No | Inclusive ISO 8601 lower bound on createdAt | ||
createdBefore | query | string (date-time) | No | Inclusive ISO 8601 upper bound on createdAt |
Data and reconciliation
Amounts use major currency units (for example, GBP 25.50 is returned as 25.5). Currency codes are lowercase. Relationship fields contain RemyPass record IDs; use the matching get endpoint to fetch related records. Optional relationships and dates may be absent or null. Checkout tokens, internal metadata, payment-provider credentials and worker leases are excluded.
List responses sort by updatedAt ascending, then _id ascending. Keep the same filters while paging. updatedSince is inclusive and requires a timezone. See incremental sync for overlap, deduplication and deletion handling.
Use ticketPassInstance with GET /scans?passInstanceId=PASS_ID to retrieve attendance scans. Use order with GET /event-orders/{id} to fetch the order.
Request Examples
curl -X GET "https://api.remypass.com/api/v1/public/event-registrations" \
-H "Accept: application/json" \
-H "X-API-Key: YOUR_API_KEY"Responses
| Status | Description |
|---|---|
200 | Success |
400 | Bad request. The top-level message explains what is invalid and, where applicable, the errors array contains structured field details. |
401 | Missing or invalid API key. |
403 | The caller is not allowed to access this resource. |
429 | Rate limit exceeded. |
500 | Server error. |
200 Response Example
{
"success": true,
"message": "Success",
"data": [
{
"_id": "507f1f77bcf86cd799439011",
"createdAt": "2026-10-06T12:00:00.000Z",
"updatedAt": "2026-10-06T12:00:00.000Z",
"event": "507f1f77bcf86cd799439011",
"member": "507f1f77bcf86cd799439011",
"order": "507f1f77bcf86cd799439011",
"registrantIndex": 0,
"role": "buyer",
"registrant": {
"name": "Example",
"email": "person@example.com",
"memberId": "example",
"membershipVerificationStatus": "unverified"
},
"deliveryEmail": "person@example.com",
"ticketPassInstance": "507f1f77bcf86cd799439011",
"buyer": {
"name": "Example",
"email": "person@example.com"
},
"status": "active",
"paymentStatus": "free",
"amountPaid": 0,
"currency": "gbp",
"purchaseProtectionSelected": false,
"purchaseProtectionAmount": 0,
"addOnsAmount": 0,
"formSubmission": "507f1f77bcf86cd799439011",
"reservationExpiresAt": "2026-10-06T12:00:00.000Z"
}
],
"pagination": {
"currentPage": 1,
"totalPages": 5,
"totalItems": 47,
"itemsPerPage": 10,
"hasNextPage": true,
"hasPrevPage": false
}
}
Response Fields
| Field | Type | Description | Attributes |
|---|---|---|---|
success | boolean | ||
message | string | ||
data | array of object | Show child attributes
| |
pagination | object | Show child attributes
|