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. |
