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

# Get Account History

> Retrieves historical account activity and changes for Spotify Ads accounts: who changed what and when, with before and after values

Retrieves historical account activity and changes for Spotify Ads accounts: who changed what and when, with before and after values. Spotify keeps 180 days of history.

| | |
| - | - |
| **App** | Spotify Ads |
| **Operation ID** | `spotify_ads_get_account_history` |
| **Type** | Action |
| **Connection** | `spotify_ads` (required) |
| **Credits per run** | 1 |
| **Agent / MCP tool** | Yes |

## Inputs

| Field | Type | Required | Default | Description |
| - | - | - | - | - |
| `accounts` | array (also accepts a comma-separated string) | Yes | - | Select Spotify Ads accounts to retrieve history for |
| `time_range` | string or SelectableOption | No | - | Select time period for the account history. Available options: 'last\_30\_days' (Last 30 days), 'last\_14\_days' (Last 14 days), 'last\_7\_days' (Last 7 days), 'today' (Today only), 'yesterday' (Yesterday only). Spotify keeps 180 days of history. |
| `entity_type` | enum (`CAMPAIGN`, `AD_SET`, `AD_ACCOUNT`, `BUSINESS`, `CREATIVE`) | No | - | Only return changes to this kind of entity: CAMPAIGN, AD\_SET, AD\_ACCOUNT, BUSINESS, or CREATIVE. |
| `entity_ids` | string or array of string | No | - | Only return changes to these entity ids. Accepts a list or a comma-separated string. |
| `entity_name` | string | No | - | Only return changes to entities whose name contains this text. |
| `change_category` | enum (`STATUS`, `BUDGET`, `TARGETING`, `CREATIVE`, `SCHEDULING`, `SETTINGS`, `BILLING`) | No | - | Only return changes in this category: STATUS, BUDGET, TARGETING, CREATIVE, SCHEDULING, SETTINGS, or BILLING. |
| `principal_type` | enum (`USER`, `SERVICE`) | No | - | Only return changes made by a USER or by a SERVICE (API integration). |
| `limit` | integer | No | `100` | Maximum number of history records to return. Default: 100. |

### SelectableOption

| Field | Type | Required | Default | Description |
| - | - | - | - | - |
| `value` | string | Yes | - | |
| `label` | string | Yes | - | |

## Output

**Type**: `List[Dict]`

Returns account activity history with the entity changed, the operation, the actor, and each field's before and after values.

**Fields**: dynamic (depend on the inputs)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.