Skip to main content
GET
/
v1
/
events
curl https://api.flux.dev/v1/events?type=user.signup&limit=10 \
  -H "Authorization: Bearer sk_live_..."

{
  "data": [
    {
      "id": "evt_1a2b3c4d",
      "type": "user.signup",
      "created": "2024-01-15T10:30:00Z",
      "data": {
        "userId": "usr_123",
        "email": "jane@example.com"
      }
    },
    {
      "id": "evt_5e6f7g8h",
      "type": "user.signup",
      "created": "2024-01-15T09:15:00Z",
      "data": {
        "userId": "usr_456",
        "email": "john@example.com"
      }
    }
  ],
  "hasMore": true,
  "nextCursor": "cur_xyz789"
}
Returns a paginated list of events. Events are returned in reverse chronological order (newest first).
​
type
string
Filter by event type (e.g., user.signup)
​
limit
integer
default:"20"
Number of events to return. Maximum is 100.
​
cursor
string
Cursor for pagination. Use the nextCursor from a previous response.
​
startDate
string
Filter events created after this date (ISO 8601)
​
endDate
string
Filter events created before this date (ISO 8601)
curl https://api.flux.dev/v1/events?type=user.signup&limit=10 \
  -H "Authorization: Bearer sk_live_..."

{
  "data": [
    {
      "id": "evt_1a2b3c4d",
      "type": "user.signup",
      "created": "2024-01-15T10:30:00Z",
      "data": {
        "userId": "usr_123",
        "email": "jane@example.com"
      }
    },
    {
      "id": "evt_5e6f7g8h",
      "type": "user.signup",
      "created": "2024-01-15T09:15:00Z",
      "data": {
        "userId": "usr_456",
        "email": "john@example.com"
      }
    }
  ],
  "hasMore": true,
  "nextCursor": "cur_xyz789"
}