---
title: "Search the network's actions log"
type: reference
method: GET
path: /rest-api/action-log/search.do
tag: "Actions Log"
---

# Search the network's actions log

`GET https://YOUR-NETWORK-DOMAIN/rest-api/action-log/search.do`

Who did what in this network, newest first: the audit trail of every operation run in the console, over the REST API and through the AI assistant (MCP), reads and sign-ins included. Use it to answer who changed, created or deleted something, what an account was doing at a given time, and which administrator acted as whom. Each entry carries id, at (ISO-8601 instant), via (UI, REST_API, LEGACY_REST, MCP, AI_CHAT or SYSTEM; null for an entry logged before the source was recorded), user (the account the operation ran as), role (the role that account held when the entry was written; null on entries older than the column), by (the administrator who was signed in as that account, null when the account acted for itself), action (the operation's log name), pathIds (the ids in the operation's path, comma-separated), ip and details (the arguments, and for a change made through MCP or the REST API before: the values it replaced; a value under a name that carries a secret is masked as ***). A viewer reads their own entries and those of an author whose role their own role may access or manage, so an account never reads what a role above it did. Page with start, by position in the log, so entries logged in the same second never fall between pages. Requires the Actions Log console permission; an account without it is refused.

## Query params

| Name | Type | Required | Example | Description |
|---|---|---|---|---|
| `user` | string | no | `northwind` | Only this author's entries - a username or a user id. An author the caller may not read answers nothing |
| `by` | string | no | `serg` | Only entries made while an administrator was signed in as the author - their username or user id |
| `action` | string | no | `delete` | Only operations whose log name contains this, case-insensitively - e.g. delete, campaign, mcp_ |
| `contains` | string | no | `Northwind` | Only entries whose logged arguments contain this text; several words all have to appear |
| `ip` | string | no | `10.0.0.` | Only entries from an address containing this |
| `from` | string | no | `2026-10-05T08:00:00Z` | Only entries logged at or after this moment, ISO-8601 (e.g. 2026-10-05T08:00:00Z). Default: 24 hours ago |
| `to` | string | no | `2026-10-06T08:00:00Z` | Only entries logged at or before this moment, ISO-8601. Default: now |
| `start` | integer | no | `0` | Skip this many entries (zero-based position in the newest-first list). Default 0 |
| `limit` | integer | no | `100` | How many entries to return, 1-1000. Default 100 |

## Responses

- `200` — {success, entries:[{id, at, via, user, role, by, action, pathIds, ip, details}], returned, more}
- `400` — limit outside 1-1000, start below 0, or from/to not an ISO-8601 instant
- `401` — Authentication error
- `403` — The caller does not hold the Actions Log permission

## Example request

```bash
curl --request GET \
  --url 'https://YOUR-NETWORK-DOMAIN/rest-api/action-log/search.do?user=northwind&by=serg&action=delete' \
  --header 'X-Api-Key: YOUR_API_KEY'
```

Source: https://epom.com/ad-server/docs/api/actions-log/get-action-log-search