GET
/
api
/
ext
/
v1
/
events
curl --request GET \
  --url https://evento.so/api/ext/v1/events \
  --header 'x-evento-api-key: <x-evento-api-key>'
{
  "success": true,
  "message": "<string>",
  "data": [
    {
      "id": "<string>",
      "title": "<string>",
      "description": "<string>",
      "cost": "<string>",
      "cover": "<string>",
      "location": "<string>",
      "status": "<string>",
      "visibility": "<string>",
      "timezone": "<string>",
      "date": "<string>",
      "end_date": "<string>",
      "is_time_set": true,
      "computed_start_date": "<string>",
      "computed_end_date": "<string>",
      "start_date_day": 123,
      "start_date_month": 123,
      "start_date_year": 123,
      "start_date_hours": 123,
      "start_date_minutes": 123,
      "end_date_day": 123,
      "end_date_month": 123,
      "end_date_year": 123,
      "end_date_hours": 123,
      "end_date_minutes": 123,
      "user_details": {
        "id": "<string>",
        "username": "<string>",
        "image": "<string>",
        "verification_status": "<string>"
      }
    }
  ]
}

Retrieve all public events created by a specific username on the Evento platform.

This endpoint returns all public events created by the specified user where visibility = “public” and status = “published”.

​
Endpoint

GET https://evento.so/api/ext/v1/events

​
Query Parameters

​
username
string
required

The username of the Evento user whose public events you want to retrieve

​
Headers

​
x-evento-api-key
string
required

Your API key for authentication. Contact our team to obtain one.

​
Response

​
Success Response (200)

​
success
boolean

Indicates whether the request was successful

​
message
string

Success message including the username that was requested

​
data
array

An array of event objects representing all public events created by the specified username

​
Examples

curl -X GET "https://evento.so/api/ext/v1/events?username=johndoe" \
  -H "x-evento-api-key: your_api_key_here"

​
Response Example

{
  "success": true,
  "message": "Successfully retrieved events for username: johndoe",
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "title": "Tech Conference 2025",
      "description": "Annual technology conference featuring the latest innovations",
      "cost": "$99",
      "cover": "https://evento.so/images/events/tech-conf-2025.jpg",
      "location": "San Francisco Convention Center",
      "status": "published",
      "visibility": "public",
      "timezone": "America/Los_Angeles",
      "date": null,
      "end_date": null,
      "is_time_set": true,
      "computed_start_date": "2025-03-15T09:00:00-07:00",
      "computed_end_date": "2025-03-15T17:00:00-07:00",
      "start_date_day": 15,
      "start_date_month": 3,
      "start_date_year": 2025,
      "start_date_hours": 9,
      "start_date_minutes": 0,
      "end_date_day": 15,
      "end_date_month": 3,
      "end_date_year": 2025,
      "end_date_hours": 17,
      "end_date_minutes": 0,
      "user_details": {
        "id": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
        "username": "johndoe",
        "image": "https://evento.so/profiles/johndoe.jpg",
        "verification_status": "verified"
      }
    }
  ]
}

​
Error Responses

​
Event Filtering

This endpoint returns all public events created by the specified user where:

  • visibility = “public”
  • status = “published”

No RSVP filtering is applied.

All “not found” scenarios return 400 Bad Request, not 404. All server errors are caught and returned as 400 Bad Request with “Failed to fetch events” message.

The success response always includes the wrapper structure with success, message, and data fields. The message is dynamic and includes the actual username that was requested.

​
Need Help?

Get API Access

Schedule a call to get your API key.

Contact Support

Get technical support from our team.