Xero Accounting Endpoint: TrackingCategories

Revision as of 22:56, 16 September 2021 by Nic (talk | contribs) (Created page with "== Overview == The Xero '''TrackingCategories''' endpoint allows you to access the list of tracking categories. A Xero data file may have up to...")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

Overview

The Xero TrackingCategories endpoint allows you to access the list of tracking categories.

A Xero data file may have up to 2 tracking categories active but may have many more defined.

Each tracking category is made up of one or more option.

Fields

The following fields are available for the TrackingCategories endpoint.

TrackingCategoryID
A GUID field representing the internal id of a tracking category.
This field can be linked to other endpoints.
Name
A text field provides the name of the tracking category.
Status
A text field indicates the status of the tracking category.
Possible values are:
  • ACTIVE: Indicate the tracking category can be used on transaction.
  • ARCHIVE: Indicates the tracking category cannot be used on transaction any longer but may have had historical transactions.
Options
A table field provides the list of tracking category option.
See Options Fields for more information.


Options Fields

The Options Fields provides a list of all possible tracking category option (e.g. value) that can be applied to a tracking category.

For example, if Australian States were a tracking category, options would be ACT, NSW, NT, QLD, SA, TAS, VIC, WA.

It contains the following sub fields.

TrackingOptionID
A GUID field representing the internal id of a tracking category option.
This field can be linked to other endpoints.
Name
A text field provides the name of the tracking category option.
Status
A text field indicates the status of the tracking category option.
Possible values are:
  • ACTIVE: Indicate the option can be used on transaction.
  • ARCHIVE: Indicates the option cannot be used on transaction any longer but may have had historical transactions.


Xero API

For a detailed run through of the endpoint, you can see the [developer.xero.com/documentation/api/accounting/trackingcategories Xero API].


Related Fields

None


Related Endpoints

None