Tracking Categories


Overview

URL https://api.xero.com/api.xro/2.0/TrackingCategories
Methods Supported GET
Description Returns the list of of tracking categories and tracking options for a Xero organisation

Elements for Tracking Categories

TrackingCategoryID The Xero identifier for a tracking category
e.g. 297c2dc5-cc47-4afd-8ec8-74990b8761e9
Name The name of the tracking category e.g. Department, Region
Status The status of a tracking category
Options See Tracking Options

Elements for Tracking Options

TrackingOptionID The Xero identifier for a tracking option
e.g. ae777a87-5ef3-4fa0-a4f0-d10e1f13073a
Name The name of the tracking option e.g. Marketing, East
Status The status of a tracking option

GET TrackingCategories

Optional parameters for GET TrackingCategories

TrackingCategoryID Filter by a tracking category
e.g. 297c2dc5-cc47-4afd-8ec8-74990b8761e9
Where Filter by an any element (see Filters)
order Order by any element returned (see Order By)
includeArchived e.g. includeArchived=true – Categories and options with a status of ARCHIVED will be included in the response

Example response for GET TrackingCategories

<TrackingCategories>
    <TrackingCategory>
      <Name>Region</Name>
      <Status>ACTIVE</Status>
      <TrackingCategoryID>093af706-c2aa-4d97-a4ce-2d205a017eac</TrackingCategoryID>
      <Options>
        <Option>
          <TrackingOptionID>ae777a87-5ef3-4fa0-a4f0-d10e1f13073a</TrackingOptionID>
          <Name>Eastside</Name>
          <Status>ACTIVE</Status>
        </Option>
        <Option>
          <TrackingOptionID>3f05cdf9-246b-46a2-bf6f-441da1b09b89</TrackingOptionID>
          <Name>North</Name>
          <Status>ACTIVE</Status>
        </Option>
        <Option>
          <TrackingOptionID>9f93bb09-3c8c-4d43-a6fe-862772d77bd9</TrackingOptionID>
          <Name>South</Name>
          <Status>ACTIVE</Status>
        </Option>
        <Option>
          <TrackingOptionID>2ba6a2af-11cb-452d-9867-dce88add6856</TrackingOptionID>
          <Name>West Coast</Name>
          <Status>ACTIVE</Status>
        </Option>
      </Options>
    </TrackingCategory>
  </TrackingCategories>