Skip to main content
GET
https://api.evento.so
/
api
/
public
/
v1
/
events
/
{eventId}
Get Event by ID
curl --request GET \
  --url https://api.evento.so/api/public/v1/events/{eventId} \
  --header 'x-evento-api-key: <x-evento-api-key>'
{
  "success": true,
  "message": "<string>",
  "data": {
    "id": "<string>",
    "title": "<string>",
    "description": "<string>",
    "cover": "<string>",
    "location": "<string>",
    "start_date": "<string>",
    "end_date": {},
    "timezone": "<string>",
    "status": "<string>",
    "visibility": "<string>",
    "cost": {},
    "created_at": "<string>",
    "creator": {
      "id": "<string>",
      "username": "<string>",
      "image": "<string>",
      "verification_status": {}
    },
    "links": {
      "spotify_url": {},
      "wavlake_url": {}
    },
    "contributions": {
      "cashapp": {},
      "venmo": {},
      "paypal": {},
      "btc_lightning": {}
    }
  }
}
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

​
eventId
string
required
The unique identifier of the eventExample: evt_abc123

​
Headers

​
x-evento-api-key
string
required
Your API key for authentication

​
Response

​
Success Response (200)

​
success
boolean
Indicates whether the request was successful
​
message
string
Success message confirming event details were fetched
​
data
object
The event object containing all event details

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

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

Get API Access

Schedule a call to get your API key.

Contact Support

Get technical support from our team.