v51

latestOpenAPI 3.0.0MITraw.githubusercontent.com2026-07-2161237.1 KB

Asset

Retrieves fixed asset by id

By passing in the appropriate asset id, you can search for a specific fixed asset in the system

get/Assets/{id}

Path parameters

idstring uuid required

Example:00000000-0000-0000-0000-000000000000

fixed asset id for single object

Response

search results matching criteria

assetIdstring uuid

The Xero-generated Id for the asset

assetNamestring required

The name of the asset

assetTypeIdstring uuid

The Xero-generated Id for the asset type

assetNumberstring

Must be unique.

purchaseDatestring date

The date the asset was purchased YYYY-MM-DD

purchasePricenumber double

The purchase price of the asset

disposalDatestring date

The date the asset was disposed

disposalPricenumber double

The price the asset was disposed at

assetStatus'Draft' | 'Registered' | 'Disposed'

See Asset Status Codes.

warrantyExpiryDatestring

The date the asset’s warranty expires (if needed) YYYY-MM-DD

serialNumberstring

The asset's serial number

canRollbackboolean

Boolean to indicate whether depreciation can be rolled back for this asset individually. This is true if it doesn't have 'legacy' journal entries and if there is no lock period that would prevent this asset from rolling back.

accountingBookValuenumber double

The accounting value of the asset

isDeleteEnabledForDateboolean

Boolean to indicate whether delete is enabled

Example response

{
  "assetId": "3b5b3a38-5649-495f-87a1-14a4e5918634",
  "assetName": "Awesome Truck 3",
  "assetTypeId": "3b5b3a38-5649-495f-87a1-14a4e5918634",
  "assetNumber": "FA-0013",
  "purchaseDate": "2015-07-01T00:00:00",
  "disposalDate": "2020-07-01T00:00:00",
  "assetStatus": "Draft",
  "warrantyExpiryDate": "ca4c6b39-4f4f-43e8-98da-5e1f350a6694",
  "serialNumber": "ca4c6b39-4f4f-43e8-98da-5e1f350a6694",
  "bookDepreciationSetting": {
    "depreciationMethod": "StraightLine",
    "averagingMethod": "ActualDays",
    "depreciationRate": 0.05,
    "effectiveLifeYears": 5,
    "depreciationCalculationMethod": "None",
    "depreciableObjectId": "68f17094-af97-4f1b-b36b-013b45b6ad3c",
    "depreciableObjectType": "Asset",
    "bookEffectiveDateOfChangeId": "68f17094-af97-4f1b-b36b-013b45b6ad3c"
  },
  "bookDepreciationDetail": {
    "currentCapitalGain": 5.25,
    "currentGainLoss": 10.5,
    "depreciationStartDate": "2015-07-01T00:00:00",
    "costLimit": 9000,
    "residualValue": 10000,
    "priorAccumDepreciationAmount": 0.45,
    "currentAccumDepreciationAmount": 5
  },
  "canRollback": true,
  "isDeleteEnabledForDate": true
}