Skip to main content
GET
https://api.evento.so
/
api
/
public
/
v1
/
users
/
{username}
/
upcoming-events
Get User Upcoming Events
curl --request GET \
  --url https://api.evento.so/api/public/v1/users/{username}/upcoming-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 upcoming public events hosted by a specific user, sorted chronologically.
This endpoint returns only future events created by the user, sorted by start date (earliest first). Perfect for displaying a user’s event schedule.

​
Endpoint

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

​
Path Parameters

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

​
Query Parameters

​
limit
integer
default:"10"
Number of results to return per page
  • Minimum: 1
  • Maximum: 100
  • Default: All upcoming events (no limit)
Example: 10
​
offset
integer
default:"0"
Number of results to skip for pagination
  • Minimum: 0
  • Default: 0
Example: 20 (skip first 20 results)

​
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 upcoming event objects sorted by start date (earliest first)

​
Examples

curl -X GET "https://api.evento.so/api/public/v1/users/johndoe/upcoming-events?limit=5" \
  -H "x-evento-api-key: YOUR_API_KEY"

​
Response Example

{
  "success": true,
  "message": "Upcoming events fetched successfully for user johndoe",
  "data": [
    {
      "id": "evt_future1",
      "title": "Web Development Workshop",
      "description": "Learn modern web development techniques",
      "cover": "https://example.com/webdev.jpg",
      "location": "Tech Center, San Francisco",
      "start_date": "2025-01-15T18:00:00Z",
      "end_date": "2025-01-15T21:00:00Z",
      "timezone": "America/Los_Angeles",
      "status": "published",
      "visibility": "public",
      "cost": null,
      "created_at": "2024-11-20T10: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": "@johndoe",
        "paypal": null,
        "btc_lightning": null
      }
    },
    {
      "id": "evt_future2",
      "title": "Spring Music Festival",
      "description": "Annual outdoor music festival",
      "cover": "https://example.com/spring-fest.jpg",
      "location": "Golden Gate Park, San Francisco",
      "start_date": "2025-03-21T12:00:00Z",
      "end_date": "2025-03-21T22:00:00Z",
      "timezone": "America/Los_Angeles",
      "status": "published",
      "visibility": "public",
      "cost": 55.00,
      "created_at": "2024-11-15T14:00:00Z",
      "creator": {
        "id": "usr_xyz789",
        "username": "johndoe",
        "image": "https://example.com/johndoe.jpg",
        "verification_status": "verified"
      },
      "links": {
        "spotify_url": "https://spotify.com/playlist/spring2025",
        "wavlake_url": null
      },
      "contributions": {
        "cashapp": "$johndoe",
        "venmo": "@johndoe",
        "paypal": "[email protected]",
        "btc_lightning": null
      }
    }
  ]
}

​
Error Responses

{
  "success": false,
  "message": "Limit must be between 1 and 100"
}

{
  "success": false,
  "message": "Username is required"
}

{
  "success": false,
  "message": "Not authenticated."
}

{
  "success": false,
  "message": "User not found"
}

​
Notes

  • Upcoming means start_date >= current_time
  • Events are sorted by start date in ascending order (earliest first)
  • Only events created by the specified user are returned
  • Empty array is returned if the user has no upcoming events
  • Use pagination parameters for large result sets
Combine limit and offset for efficient pagination. For example:
  • Page 1: limit=10&offset=0
  • Page 2: limit=10&offset=10
  • Page 3: limit=10&offset=20

Past Events

Get past events hosted by a user

All User Events

Get all events created by a user