Get Ad Entity Change History
GET/api/advertising/entities/:type/:id/history
Returns every recorded change to one ad entity, newest first: SKU.io change lines (kind: sku_change) merged with changes someone made directly on the ad platform that SKU.io detected during sync (kind: external_change). History is kept indefinitely and is not paginated.
advertising:readGrant this scope to your token under Settings → Developer → Personal Access Tokens.
type is one of campaign, ad_group, item, target, feed_product, product_set; id is the entity's SKU.io ID. Any other type, or a non-numeric ID, returns 404. An entity with no history returns an empty array.
SKU.io entries carry the operation, line status, set source, change_set_id, change_id, set summary, any error and the actor (the approver, or the creator when nobody approved). External entries carry only kind, at, before, after and the summary "Changed outside SKU.io". at is UTC ISO-8601.
Requires the advertising.view permission. Personal access tokens need the advertising:read scope.
Request
Responses
- 200
- 401
- 403
- 404
- 429
OK
Response Headers
Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.
Forbidden — the token lacks a required scope, the endpoint is not available to API tokens, or the user behind the token lacks the permission. A human must adjust the token scopes or user permissions; do not retry.
Not Found
Response Headers
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.