Skip to main content
GET
/
api
/
public
/
v1
/
events
/
{eventId}
curl https://evento.so/api/public/v1/events/evt_abc123 \
  -H "x-evento-api-key: YOUR_API_KEY"

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

Documentation Index

Fetch the complete documentation index at: https://docs.evento.so/llms.txt

Use this file to discover all available pages before exploring further.

​
Endpoint

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

​
Authentication

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

​
Path parameters

​
eventId
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"

​
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
    }
  }
}

​
Error codes

StatusDescription
400Event ID is missing or invalid
401API key missing or invalid
404Event 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.