Retrieve detailed information about a specific event using its unique identifier.
This endpoint returns complete details for a single public event, including creator information, contribution methods, and external links.
Endpoint
GET https://api.evento.so/api/public/v1/events/{eventId}
Path Parameters
The unique identifier of the eventExample: evt_abc123
Your API key for authentication
Response
Success Response (200)
Indicates whether the request was successful
Success message confirming event details were fetched
The event object containing all event detailsShow Event Object Properties
Unique identifier for the event
Detailed description of the event (may contain markdown)
URL to the event’s cover image
Location details for the event
Event start date and time in ISO 8601 format
Event end date and time in ISO 8601 format (optional)
Timezone for the event (IANA timezone identifier)
Event status (always “published” for public API)
Event visibility (always “public” for public API)
Event cost in USD (null indicates free event)
Timestamp when the event was created (ISO 8601)
Information about the event creator
Unique identifier for the user
Username of the event creator
URL to the user’s profile image
Verification status of the user account
External links associated with the event
Spotify playlist URL for the event
Wavlake URL for the event
Payment and contribution methods for the eventShow Contribution Properties
CashApp handle for contributions
Venmo handle for contributions
PayPal email or handle for contributions
Bitcoin Lightning address for contributions
Examples
curl -X GET "https://api.evento.so/api/public/v1/events/evt_abc123" \
-H "x-evento-api-key: YOUR_API_KEY"
Response Example
{
"success": true,
"message": "Event details fetched successfully",
"data": {
"id": "evt_abc123",
"title": "Tech Meetup 2024",
"description": "Join us for an evening of tech talks and networking with industry leaders",
"cover": "https://example.com/event-cover.jpg",
"location": "San Francisco, CA",
"start_date": "2024-12-15T18:00:00Z",
"end_date": "2024-12-15T21:00:00Z",
"timezone": "America/Los_Angeles",
"status": "published",
"visibility": "public",
"cost": 0,
"created_at": "2024-11-01T10:00:00Z",
"creator": {
"id": "usr_xyz789",
"username": "techorg",
"image": "https://example.com/avatar.jpg",
"verification_status": "verified"
},
"links": {
"spotify_url": null,
"wavlake_url": null
},
"contributions": {
"cashapp": "$techorg",
"venmo": "@techorg",
"paypal": null,
"btc_lightning": null
}
}
}
Error Responses
{
"success": false,
"message": "Invalid event ID format"
}
{
"success": false,
"message": "Not authenticated."
}
{
"success": false,
"message": "Not found."
}
500 - Internal Server Error
{
"success": false,
"message": "Internal server error"
}
Notes
- This endpoint only returns events with
status: "published" and visibility: "public"
- Event costs are in USD; a
null value indicates the event is free
- All dates are returned in ISO 8601 format with timezone information
- The creator object includes verification status when available
Cache event data appropriately to reduce API calls, especially for events that don’t change frequently.
Need Help?
