Getting Started
Evento API Reference
Access public events data with our simple, powerful REST API
The Evento API provides a simple way to access public event data. With just one endpoint, you can retrieve all public events associated with any username on the Evento platform.
The Evento API uses RESTful principles and returns JSON responses with a structured wrapper. All data returned is from public events created by the specified user.
Quick Start
Get up and running with the Evento API in minutes.Get API Access
Schedule a call with our team to get your API key.
Make Your First Call
Learn how to fetch events with our GET endpoint.
Explore Response Data
Understand the complete event data structure.
Integration Examples
See code examples in multiple languages.
API Overview
The Evento API is designed with simplicity in mind:- Single Endpoint: One endpoint to get all public events created by a username
- Query Parameter: Username passed as a query parameter for flexibility
- Structured Responses: JSON responses with success, message, and data wrapper
- Public Events Only: Access only to published, publicly visible events
The API provides read-only access to public events created by users. It returns all published events where visibility = “public” - no RSVP filtering is applied.
Authentication
All API requests require authentication using an API key.You must include your API key in the
x-evento-api-key header for all requests.Getting Your API Key
To obtain an API key, please schedule a call with our team:Schedule API Access Call
Our team will provide you with an API key and discuss your use case.
Using Your API Key
Include your API key in the request header:HTTP Status Codes
The Evento API uses standard HTTP status codes to indicate success or failure.200 - Success
200 - Success
The request was successful. Event data is returned in the response body.
400 - Bad Request
400 - Bad Request
Invalid request - missing username, user not found, RPC error, or general failure. All server errors return 400 instead of 500.
401 - Unauthorized
401 - Unauthorized
Response Format
All successful API responses return JSON data with the following structure:All responses include a structured wrapper with success status, message, and data. Each event includes comprehensive details including dates, location, creator information, and event metadata.
Key Features
Event Details
Complete event information including title, description, cost, and location.
Date Handling
Multiple date formats and timezone information for flexible integration.
Creator Info
Event creator details including username, image, and verification status.
Rate Limiting
Currently, there are no rate limits on the Evento API. However, we recommend implementing reasonable request intervals to ensure optimal performance.