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

​
Endpoint

GET https://api.evento.so/api/public/v1/users/{username}/past-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 past 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 past event objects sorted by start date (most recent first)

​
Examples

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

​
Response Example

{
  "success": true,
  "message": "Past events fetched successfully for user johndoe",
  "data": [
    {
      "id": "evt_past1",
      "title": "Fall Tech Conference 2024",
      "description": "Annual technology conference with industry leaders",
      "cover": "https://example.com/fall-conf.jpg",
      "location": "Convention Center, San Francisco",
      "start_date": "2024-10-15T09:00:00Z",
      "end_date": "2024-10-15T18:00:00Z",
      "timezone": "America/Los_Angeles",
      "status": "published",
      "visibility": "public",
      "cost": 199.00,
      "created_at": "2024-08-01T10: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": "[email protected]",
        "btc_lightning": null
      }
    },
    {
      "id": "evt_past2",
      "title": "Summer BBQ Meetup",
      "description": "Community gathering with food and networking",
      "cover": "https://example.com/bbq.jpg",
      "location": "Dolores Park, San Francisco",
      "start_date": "2024-07-04T16:00:00Z",
      "end_date": "2024-07-04T20:00:00Z",
      "timezone": "America/Los_Angeles",
      "status": "published",
      "visibility": "public",
      "cost": null,
      "created_at": "2024-06-01T12:00:00Z",
      "creator": {
        "id": "usr_xyz789",
        "username": "johndoe",
        "image": "https://example.com/johndoe.jpg",
        "verification_status": "verified"
      },
      "links": {
        "spotify_url": "https://spotify.com/playlist/summer-vibes",
        "wavlake_url": null
      },
      "contributions": {
        "cashapp": "$johndoe",
        "venmo": "@johndoe",
        "paypal": null,
        "btc_lightning": "[email protected]"
      }
    }
  ]
}

​
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

  • Past means start_date < current_time
  • Events are sorted by start date in descending order (most recent first)
  • Only events created by the specified user are returned
  • Empty array is returned if the user has no past events
  • Use pagination parameters for users with extensive event history
This endpoint is ideal for:
  • Building event history pages
  • Showing a user’s track record
  • Analytics on past event performance
  • Creating event portfolios

Upcoming Events

Get upcoming events hosted by a user

All User Events

Get all events created by a user with date filtering