Skip to main content

​
Evento API reference

Evento exposes two public-facing API surfaces built for different integration models.

Public API

Read-only event and user data for third-party server integrations.https://evento.so/api/public/v1

Embed API

No-auth, CORS-friendly responses for widgets and client-side embeds.https://evento.so/api/embed/v1

​
API surfaces

Public API

Authenticated with Unkey API keys.Includes event details, user event lists, and guest lists.

Embed API

No authentication required.Built for browser use with full CORS support.

Shared contracts

Consistent success and error formats.Shared status-code and model conventions across surfaces.

​
Rate limiting

Public API keys are limited to 1000 requests per day per key (evento-public-api namespace).

​
Rate limit headers

X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 847
X-RateLimit-Reset: 1640995200
When rate limits are exceeded: 
{
  "success": false,
  "message": "Too many requests. Please try again later."
}

​
Next steps

Authentication

Header formats, auth flows by surface, and security practices.

Response format

Shared success/error payload contracts and pagination schema.

Data models

Event, guest, and pagination object definitions.

Integration guides

Use cases, implementation examples, and source-code patterns.