|Available in: Contact Manager, Group, Professional, Enterprise, Performance, Unlimited, Developer, and Database.com Editions|
Use Salesforce Metadata API to define a retention policy for your field history. Then use REST API, SOAP API, and Tooling API to work with your archived data. For information about enabling Field Audit Trail, contact your Salesforce representative.
Field history is copied from the History related list into the FieldHistoryArchive object and then deleted from the History related list. You define one HistoryRetentionPolicy object for your related history lists, such as Account History, to specify Field Audit Trail retention policies for the objects that you want to archive. You can then deploy the object by using the Metadata API (Workbench or Force Migration Tool). In production organizations that have Field Audit Trail enabled, data is archived by default after 18 months. In sandbox organizations, the default is one month. You can update the retention policies as often as you like.
To learn more, see the Field History Retention Implementation Guide.