GET
/
api
/
public
/
v1
/
users
/
{username}
/
profile-events
Get User Profile Events
curl --request GET \
  --url https://api.evento.so/api/public/v1/users/{username}/profile-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 that a user has either created or RSVP’d to attend.
This endpoint combines both hosted events and events the user is attending, making it perfect for displaying a user’s complete event activity profile.

​
Endpoint

GET https://api.evento.so/api/public/v1/users/{username}/profile-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 events associated with the user

​
Examples

curl -X GET "https://api.evento.so/api/public/v1/users/johndoe/profile-events" \
  -H "x-evento-api-key: YOUR_API_KEY"

​
Response Example

{
  "success": true,
  "message": "Profile events fetched successfully for user johndoe",
  "data": [
    {
      "id": "evt_hosted123",
      "title": "JavaScript Workshop",
      "description": "Learn modern JavaScript development",
      "cover": "https://example.com/js-workshop.jpg",
      "location": "Tech Hub, San Francisco",
      "start_date": "2024-09-15T14:00:00Z",
      "end_date": "2024-09-15T17:00:00Z",
      "timezone": "America/Los_Angeles",
      "status": "published",
      "visibility": "public",
      "cost": null,
      "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": null,
        "btc_lightning": null
      }
    },
    {
      "id": "evt_attending456",
      "title": "Community Meetup",
      "description": "Monthly community gathering",
      "cover": "https://example.com/meetup.jpg",
      "location": "Community Center, Oakland",
      "start_date": "2024-09-20T18:00:00Z",
      "end_date": "2024-09-20T20:00:00Z",
      "timezone": "America/Los_Angeles",
      "status": "published",
      "visibility": "public",
      "cost": 10.00,
      "created_at": "2024-08-10T12:00:00Z",
      "creator": {
        "id": "usr_abc456",
        "username": "communityorg",
        "image": "https://example.com/community.jpg",
        "verification_status": "verified"
      },
      "links": {
        "spotify_url": null,
        "wavlake_url": null
      },
      "contributions": {
        "cashapp": "$community",
        "venmo": "@community",
        "paypal": "[email protected]",
        "btc_lightning": null
      }
    }
  ]
}

​
Error Responses

​
Notes

  • This endpoint returns both:
    • Events created by the user
    • Events the user has RSVP’d to attend
  • You can distinguish between them by checking if the creator.username matches the requested username
  • Events are sorted by creation date (most recent first)
  • Only published, public events are returned
This endpoint is ideal for building user profile pages that showcase all event activity. Use the creator information to differentiate between hosted and attending events.

User Events

Get only events created by a user

Upcoming Events

Get only upcoming events for a user