> ## Documentation Index
> Fetch the complete documentation index at: https://docsrewrite.vercel.app/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# List Events

> Retrieve a list of events

Returns a paginated list of events. Events are returned in reverse chronological order (newest first).

<ParamField query="type" type="string">
  Filter by event type (e.g., `user.signup`)
</ParamField>

<ParamField query="limit" type="integer" default="20">
  Number of events to return. Maximum is 100.
</ParamField>

<ParamField query="cursor" type="string">
  Cursor for pagination. Use the `nextCursor` from a previous response.
</ParamField>

<ParamField query="startDate" type="string">
  Filter events created after this date (ISO 8601)
</ParamField>

<ParamField query="endDate" type="string">
  Filter events created before this date (ISO 8601)
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl https://api.flux.dev/v1/events?type=user.signup&limit=10 \
    -H "Authorization: Bearer sk_live_..."
  ```

  ```typescript Node.js theme={null}
  const events = await flux.events.list({
    type: 'user.signup',
    limit: 10
  });
  ```

  ```python Python theme={null}
  events = flux.events.list(
      type="user.signup",
      limit=10
  )
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "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"
  }
  ```
</ResponseExample>