> ## Documentation Index
> Fetch the complete documentation index at: https://zerodrift.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# List Activities

> List Activity Center events for your account

Return a newest-first, eventually-consistent activity feed for your account.
Date ranges are capped at 30 days.

## Query Parameters

<ParamField query="from" type="string">
  Start of the window (ISO 8601 date-time)
</ParamField>

<ParamField query="to" type="string">
  End of the window (ISO 8601 date-time)
</ParamField>

<ParamField query="status" type="array">
  Filter by status. Repeatable. Values: `auto_fixed`, `blocked`, `warned`, `passed`
</ParamField>

<ParamField query="agent_id" type="array">
  Filter by agent ID. Repeatable.
</ParamField>

<ParamField query="source" type="array">
  Filter by source. Repeatable.
</ParamField>

<ParamField query="rule_id" type="array">
  Filter by rule ID. Repeatable.
</ParamField>

<ParamField query="search" type="string">
  Free-text search
</ParamField>

<ParamField query="cursor" type="string">
  Opaque pagination cursor from a previous response
</ParamField>

<ParamField query="limit" type="integer">
  Page size (1–100)
</ParamField>

## Response

<ResponseField name="items" type="array">
  Activity summaries

  <Expandable title="item properties">
    <ResponseField name="activity_id" type="string">
      Activity identifier
    </ResponseField>

    <ResponseField name="occurred_at" type="string">
      ISO 8601 timestamp
    </ResponseField>

    <ResponseField name="event_name" type="string">
      Event label
    </ResponseField>

    <ResponseField name="status" type="string">
      `auto_fixed`, `blocked`, `warned`, or `passed`
    </ResponseField>

    <ResponseField name="source" type="string">
      Originating source
    </ResponseField>

    <ResponseField name="provider" type="string">
      LLM provider when applicable
    </ResponseField>

    <ResponseField name="model" type="string">
      Model name when applicable
    </ResponseField>

    <ResponseField name="agent" type="object">
      Agent `{ id, name }`
    </ResponseField>

    <ResponseField name="rules" type="array">
      Rule summaries with `id`, `name`, `severity`, `type`, and `policy`
    </ResponseField>

    <ResponseField name="rule_count" type="integer">
      Total rules associated with the activity
    </ResponseField>

    <ResponseField name="truncated_rule_count" type="integer">
      Number of rules omitted from the summary payload
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="next_cursor" type="string">
  Cursor for the next page, or `null` when finished
</ResponseField>

<ResponseField name="meta" type="object">
  Pagination metadata

  <Expandable title="meta properties">
    <ResponseField name="total_pages" type="integer">
      Total pages for the current query
    </ResponseField>

    <ResponseField name="current_page" type="integer">
      Current 1-based page
    </ResponseField>
  </Expandable>
</ResponseField>

## Errors

| Status | Meaning                              |
| ------ | ------------------------------------ |
| `400`  | Invalid date range (maximum 30 days) |
| `401`  | Invalid API key                      |

## Example

```bash theme={null}
curl "https://api.zerodrift.ai/api/activities?limit=25&status=blocked&status=warned" \
  -H "x-api-key: YOUR_API_KEY"
```