curl https://evento.so/api/public/v1/events/evt_abc123 \
-H "x-evento-api-key: YOUR_API_KEY"
const response = await fetch(
'https://evento.so/api/public/v1/events/evt_abc123',
{
headers: {
'x-evento-api-key': process.env.EVENTO_API_KEY
}
}
);
const payload = await response.json();
import os
import requests
response = requests.get(
'https://evento.so/api/public/v1/events/evt_abc123',
headers={'x-evento-api-key': os.environ['EVENTO_API_KEY']}
)
payload = response.json()
{
"success": true,
"message": "Event details fetched successfully",
"data": {
"id": "evt_abc123",
"title": "Tech Meetup 2026",
"description": "Join us for an evening of talks and demos",
"cover": "https://cdn.evento.so/covers/abc123.jpg",
"location": "San Francisco, CA",
"start_date": "2026-06-15T18:00:00Z",
"end_date": "2026-06-15T21:00:00Z",
"timezone": "America/Los_Angeles",
"status": "published",
"visibility": "public",
"cost": 25.0,
"created_at": "2026-05-20T10:00:00Z",
"creator": {
"id": "usr_xyz789",
"username": "techorg",
"image": "https://cdn.evento.so/avatars/xyz789.jpg",
"verification_status": "verified"
},
"links": {
"spotify_url": "https://open.spotify.com/playlist/example",
"wavlake_url": null
},
"contributions": {
"cashapp": "$techorg",
"venmo": "@techorg",
"paypal": "donate@techorg.com",
"btc_lightning": null
}
}
}
{
"success": false,
"message": "Resource not found."
}
Public API
Fetch event
Retrieve detailed information for a published public event
GET
/
api
/
public
/
v1
/
events
/
{eventId}
curl https://evento.so/api/public/v1/events/evt_abc123 \
-H "x-evento-api-key: YOUR_API_KEY"
const response = await fetch(
'https://evento.so/api/public/v1/events/evt_abc123',
{
headers: {
'x-evento-api-key': process.env.EVENTO_API_KEY
}
}
);
const payload = await response.json();
import os
import requests
response = requests.get(
'https://evento.so/api/public/v1/events/evt_abc123',
headers={'x-evento-api-key': os.environ['EVENTO_API_KEY']}
)
payload = response.json()
{
"success": true,
"message": "Event details fetched successfully",
"data": {
"id": "evt_abc123",
"title": "Tech Meetup 2026",
"description": "Join us for an evening of talks and demos",
"cover": "https://cdn.evento.so/covers/abc123.jpg",
"location": "San Francisco, CA",
"start_date": "2026-06-15T18:00:00Z",
"end_date": "2026-06-15T21:00:00Z",
"timezone": "America/Los_Angeles",
"status": "published",
"visibility": "public",
"cost": 25.0,
"created_at": "2026-05-20T10:00:00Z",
"creator": {
"id": "usr_xyz789",
"username": "techorg",
"image": "https://cdn.evento.so/avatars/xyz789.jpg",
"verification_status": "verified"
},
"links": {
"spotify_url": "https://open.spotify.com/playlist/example",
"wavlake_url": null
},
"contributions": {
"cashapp": "$techorg",
"venmo": "@techorg",
"paypal": "donate@techorg.com",
"btc_lightning": null
}
}
}
{
"success": false,
"message": "Resource not found."
}
Endpoint
GET /api/public/v1/events/{eventId}
Authentication
This endpoint requires a public API key.
x-evento-api-key: YOUR_API_KEY
Path parameters
string
required
Unique event identifier.
Request example
curl https://evento.so/api/public/v1/events/evt_abc123 \
-H "x-evento-api-key: YOUR_API_KEY"
const response = await fetch(
'https://evento.so/api/public/v1/events/evt_abc123',
{
headers: {
'x-evento-api-key': process.env.EVENTO_API_KEY
}
}
);
const payload = await response.json();
import os
import requests
response = requests.get(
'https://evento.so/api/public/v1/events/evt_abc123',
headers={'x-evento-api-key': os.environ['EVENTO_API_KEY']}
)
payload = response.json()
Response
{
"success": true,
"message": "Event details fetched successfully",
"data": {
"id": "evt_abc123",
"title": "Tech Meetup 2026",
"description": "Join us for an evening of talks and demos",
"cover": "https://cdn.evento.so/covers/abc123.jpg",
"location": "San Francisco, CA",
"start_date": "2026-06-15T18:00:00Z",
"end_date": "2026-06-15T21:00:00Z",
"timezone": "America/Los_Angeles",
"status": "published",
"visibility": "public",
"cost": 25.0,
"created_at": "2026-05-20T10:00:00Z",
"creator": {
"id": "usr_xyz789",
"username": "techorg",
"image": "https://cdn.evento.so/avatars/xyz789.jpg",
"verification_status": "verified"
},
"links": {
"spotify_url": "https://open.spotify.com/playlist/example",
"wavlake_url": null
},
"contributions": {
"cashapp": "$techorg",
"venmo": "@techorg",
"paypal": "donate@techorg.com",
"btc_lightning": null
}
}
}
{
"success": false,
"message": "Resource not found."
}
Error codes
| Status | Description |
|---|---|
400 | Event ID is missing or invalid |
401 | API key missing or invalid |
404 | Event not found or not public |
Use cases
Event detail pages
Render public event pages with creator, links, and contribution metadata.
Calendar ingestion
Import event metadata into scheduling products.
Discovery features
Build ranked discovery around public event objects.
Content sync
Refresh local caches for event data consumers.
Next steps
Get /events/{eventId}/guests
Retrieve RSVP guests for a public event.
Get /users/{username}/events
List public events for an organizer profile.
⌘I