Xero Accounting Endpoint: GetHistoryContact

Overview

The Xero GetHistoryContact endpoint provides a method to download the history and change logs for a single contact.

Two variations of this function exists.

  • GetHistoryContact works for a single data file.
  • GetHistoryContactDataFile is recommended when using the consolidation OData Feed.

This function requires a single call to Xero for a single contact. As such, it should only be used for a few contacts otherwise Xero will quickly impose the 5000 calls daily limit.

It is a function that accepts a series of parameters.


Parameters

The GetHistoryContact is a function that accepts the following parameters.

DataFile (for GetHistoryContactDataFile only)
A text field that accepts the data file id, name or code.
ContactID
A GUID field that accepts the id of the contact.


Fields

The following fields are available for the GetHistoryContact endpoint.

DataFileID
A GUID field representing the internal id of the data file within OdataLink. This field can be used to link to the data files endpoints.
DataFileName
A text field used as the data file name.
DataFileCode
A text field used as the data file code.
ContactID
A guid field that provides the id of the contact.
Changes
A text field that provides the type of change.
Possible values are:
  • Created
  • Edited
  • Approved
  • Reconciled
  • Deleted
  • Voided
  • (other values also possible)
Details
A text field that provides the details or note of the change.
User
A text field that provides the user name of the person that made the changes.
DateUTC
A date time field that indicates the date and time the changes were made.


Xero API

For a detailed run through of the endpoint, you can see the Xero API.


Related Fields

None


Related Endpoints

Contacts --- ContactsExpanded


Related Topics

Xero Accounting Models
Xero Accounting Endpoints