Skip to main content
GET
/
api
/
public
/
v1
/
events
/
{eventId}
/
guests
Fetch event guests
curl --request GET \
  --url https://evento.so/api/public/v1/events/{eventId}/guests

​
Endpoint

GET /api/public/v1/events/{eventId}/guests

​
Authentication

This endpoint requires a public API key.
x-evento-api-key: YOUR_API_KEY

​
Path parameters

​
eventId
string
required
Unique event identifier.

​
Query parameters

​
limit
integer
default:"10"
Results per page (1-100).
​
offset
integer
default:"0"
Pagination offset.
​
status
string
default:"yes"
RSVP filter: yes, maybe, no, or all.

​
Request example

curl "https://evento.so/api/public/v1/events/evt_abc123/guests?limit=20&status=yes" \
  -H "x-evento-api-key: YOUR_API_KEY"

​
Response

{
  "success": true,
  "message": "Guest list fetched successfully for event evt_abc123",
  "data": [
    {
      "id": "usr_123",
      "username": "johndoe",
      "name": "John Doe",
      "image": "https://cdn.evento.so/avatars/123.jpg",
      "verification_status": "verified",
      "rsvp_status": "yes",
      "rsvp_date": "2026-06-01T10:30:00Z"
    }
  ]
}

​
Privacy rules

Guest lists are returned only for events with visibility: public and status: published.
Emails, phone numbers, and private contact details are never returned.
Only guests linked to user profiles are included.

​
Error codes

StatusDescription
400Invalid query parameters
401API key missing or invalid
404Event not found or not public

​
Next steps

Get /events/{eventId}

Fetch the parent event object and metadata.

Get /users/{username}/events

Use organizer-level event listings with pagination.