---
source_url: https://www.pubnub.com/docs/admin-api/retrieve-action-log
title: Retrieve action log
---

# Retrieve action log

> For AI agents: documentation index at https://www.pubnub.com/llms-full.txt

Retrieves historical action execution logs for a decision. All parameters are **query strings** — no request body.

### Pagination & limits

* **No date range:** Returns the 50 most recent records.
* **With date range:** Up to 10,000 records. Use `limit` and `page` for pagination.

### Query parameters

| Parameter | Type | Default | Description |
| --- | --- | --- | --- |
| `format` | string | `json` | `json` or `csv` |
| `startDate` | string | — | ISO 8601 UTC (no milliseconds), e.g. `2025-10-01T00:00:00Z` |
| `endDate` | string | — | ISO 8601 UTC (must be after `startDate`) |
| `success` | boolean | — | Filter by success/failure. Omit to return all. |
| `search` | string | — | Case-insensitive, max 256 chars. Searches `actionName`, `errorMessage`, `triggeringConditions`, `outputValues`. |
| `sort` | string | `timestamp:desc` | Format: `column:direction`. Sortable: `actionName`, `actionType`, `errorMessage`, `success`, `timestamp`. |
| `limit` | number | `50` | Records per page |
| `page` | number | `1` | Page number |

> **Note:** All timestamps in the response are UTC, ISO 8601 without milliseconds.

## Request