GET
/
api
/
public
/
v1
/
users
/
{username}
/
events
Get User Events
curl --request GET \
  --url https://api.evento.so/api/public/v1/users/{username}/events \
  --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 all public events created by a specific user on the Evento platform.
This endpoint returns all public events created by the specified user. To get events the user is attending (RSVP’d), use the profile-events endpoint instead.

​
Endpoint

GET https://api.evento.so/api/public/v1/users/{username}/events

​
Path Parameters

​
username
string
required
The username of the Evento userExample: johndoe

​
Query Parameters

​
since
string
Filter events starting from this date (inclusive)Format: ISO 8601 (YYYY-MM-DDTHH:mm:ssZ)Example: 2024-01-01T00:00:00Z
​
from
string
Alias for since parameterFormat: ISO 8601 (YYYY-MM-DDTHH:mm:ssZ)
​
to
string
Filter events up to this date (inclusive)Format: ISO 8601 (YYYY-MM-DDTHH:mm:ssZ)Example: 2024-12-31T23:59:59Z

​
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 including the username
​
data
array
An array of event objects representing all public events created by the user

​
Examples

curl -X GET "https://api.evento.so/api/public/v1/users/johndoe/events?since=2024-01-01T00:00:00Z" \
  -H "x-evento-api-key: YOUR_API_KEY"

​
Response Example

{
  "success": true,
  "message": "Events fetched successfully for user johndoe",
  "data": [
    {
      "id": "evt_abc123",
      "title": "Summer Music Festival 2024",
      "description": "An outdoor music festival featuring local artists",
      "cover": "https://example.com/summer-fest.jpg",
      "location": "Golden Gate Park, San Francisco",
      "start_date": "2024-07-15T12:00:00Z",
      "end_date": "2024-07-15T22:00:00Z",
      "timezone": "America/Los_Angeles",
      "status": "published",
      "visibility": "public",
      "cost": 45.00,
      "created_at": "2024-05-01T10:00:00Z",
      "creator": {
        "id": "usr_xyz789",
        "username": "johndoe",
        "image": "https://example.com/johndoe.jpg",
        "verification_status": "verified"
      },
      "links": {
        "spotify_url": "https://spotify.com/playlist/summer2024",
        "wavlake_url": null
      },
      "contributions": {
        "cashapp": "$johndoe",
        "venmo": "@johndoe",
        "paypal": "[email protected]",
        "btc_lightning": null
      }
    },
    {
      "id": "evt_def456",
      "title": "Tech Talk Tuesday",
      "description": "Weekly tech talks on emerging technologies",
      "cover": "https://example.com/tech-talk.jpg",
      "location": "Online",
      "start_date": "2024-08-20T18:00:00Z",
      "end_date": "2024-08-20T19:30:00Z",
      "timezone": "America/Los_Angeles",
      "status": "published",
      "visibility": "public",
      "cost": null,
      "created_at": "2024-07-15T14:00:00Z",
      "creator": {
        "id": "usr_xyz789",
        "username": "johndoe",
        "image": "https://example.com/johndoe.jpg",
        "verification_status": "verified"
      },
      "links": {
        "spotify_url": null,
        "wavlake_url": null
      },
      "contributions": {
        "cashapp": "$johndoe",
        "venmo": null,
        "paypal": null,
        "btc_lightning": "[email protected]"
      }
    }
  ]
}

​
Error Responses

​
Notes

  • This endpoint returns events created by the user, not events they’re attending
  • Events are sorted by creation date (most recent first)
  • Only published, public events are returned
  • Date filtering applies to the event’s start date
  • An empty array is returned if no events match the criteria
Use date filtering to reduce the response size and improve performance when dealing with users who have many events.

Profile Events

Get events created by or RSVP’d to by a user

Upcoming Events

Get only upcoming events for a user