> This page is for Docs.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://zuora.ferndocs.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://zuora.ferndocs.com/_mcp/server.

# Retrieve Subscription Changes

> Learn how to track changes in subscription versions using data queries.

Learn how to track changes in subscription versions using data queries.

For multiple-versioned subscriptions, audit trail treats each version of a subscription and rate plan charge as a distinct object. So, you can track the changes of a specific version identified by ID, instead of all the changes throughout the subscription lifecycle. This is an example of querying subscription custom field value changes by subscription id:

Submit a [data query](/docs/platform/data/data-query) job through UI or API with the following SQL query:

```
SELECT username    AS Username,
       action      AS Action,
       objecttype  AS ObjectType,
       objectname  AS ObjectName,
       objectid    AS ObjectId,
       attributeid AS Attribute,
       oldvalue    AS OldValue,
       newvalue    AS NewValue,
       timestamp   AS Timestamp 
FROM   auditobjectchangeevent 
WHERE  objecttype = 'Subscription' 
       AND action = 'UPDATED' 
       AND objectid = '86d4889a19b9ae883a5afbdfaafe021c'
ORDER  BY timestamp DESC, transactionid
LIMIT  100
```

Check the status of the query job through UI or [Get data query](https://www.zuora.com/developer/api-references/api/operation/GET_DataQueryJob) job API operation.

Download the query result when the job is completed. See the following example of the query result.

```
Username,Action,ObjectType,ObjectName,ObjectId,Attribute,OldValue,NewValue,Timestamp
user@company.com,UPDATED,Subscription,A-S00148280,86d4889a19b9ae883a5afbdfaafe021c,state__c,,New Jersey,2025-12-08T03:12:39Z
```