---
title: Get Change History Detail
framework: Apple Ads Platform API
role: symbol
role_heading: Web Service Endpoint
platforms: [apple ads platform api 1.0+]
path: apple-ads-platform-api/get-change-details-by-detailid
---

# Get Change History Detail

Retrieve field-level before and after values for a single entity change by its detail ID.

## URL

GET https://api.ads.apple.com/v1/change-history/{detailId}

## Path Parameters

detailId: The composite identifier for the entity change to retrieve, in the form EntityType.entityId.txnId (for example, Campaign.444555666.txn_abc123def456). Path parameter.

## Query Parameters

limit: Maximum number of entries to return from the changes array. Defaults to 100. offset: Zero-based index of the first changes entry to return. Defaults to 0.

## Header Parameters

X-Ap-Context:

## Response Codes

200 OK: Successful operation. Returns ChangeDetailsResponse (result: array of ChangeDetails). 400 Bad Request: Bad Request. Returns ErrorMessage. 401 Unauthorized: Unauthorized. 403 Forbidden: Forbidden. 404 Not Found: Not Found. Returns ErrorMessage. 429 Too Many Requests: Rate Limit Exceeded. Returns ErrorMessage. 500 Internal Server Error: Internal Server Error. Returns ErrorMessage.

## Discussion

Discussion This endpoint returns the complete field-level change record for a single entity within a transaction. The response contains a details array of ActivityDetail objects, each holding a changes array of field change objects. Each change object captures the field name, oldValues, and newValues as string arrays. To page through a large changes array, use limit and offset. What populates oldValues and newValues depends on the event type that produced the change.  |  |   |  |   |  |   |  |  Payload Examples

## See Also

- [Query Change History](apple-ads-platform-api/query-audit-summary-_-grouped-by-transaction.md)