List fixed assets

Operation ID: listFixedAssets

Group: Accounting › Asset Management › Fixed Assets

Open in the interactive reference

GET /fixed-assets

Read-only: Reads and returns; changes nothing.

Lists fixed assets.

Voided assets are not included, even if you filter fixedAssetStatus on 'voided'.

Amounts are in each asset's own currency and are not converted. The exception is soldAmountAmount, which is in soldAmountCurrency. An asset recorded in more than one book has one fixed asset in each. Filter bookId before you add up amounts.

A page has 25 fixed assets by default and at most 100. A larger page[size] is treated as 100.

To include voided assets, use POST fixed-assets/search. To read a voided asset by its id, use GET fixed-assets/:id. To filter by name, assetTag, assetNumber, or serialNumber, use POST fixed-assets/search.

Parameters

Name In Type Required Description
Api-Version header string · v1 yes The API version this request targets, named by its public identifier. Required on every request; omitting it, or naming a version this company does not have, is answered with 400. This document describes version v1.

Query surface

Response

200 Success

Under data, an array of listFixedAssetsRow:

Field Type Required Filter Sort Description
id string no Exact (eq, ne), Range (gt, gte, lt, lte, between), Any of (in, notIn), Pattern (like) yes The unique identifier for the fixed asset. Example: "9d5b1f42-7c30-4e88-b1a6-2f0c7e34d915".
fixedAssetNumber string | null no Exact (eq, ne), Range (gt, gte, lt, lte, between), Any of (in, notIn), Pattern (like) yes The fixed asset number. Unique within the tenant. Each book's fixed asset has its own number, unlike assetNumber, which is the same in every book. Example: 'FA-1'. Example: "FA-000142".
fixedAssetStatus string no Exact (eq, ne), Range (gt, gte, lt, lte, between), Any of (in, notIn), Pattern (like) no The status of the fixed asset. Possible values: 'active', 'voided'. Example: "active".
companyAssetId string no Exact (eq, ne), Range (gt, gte, lt, lte, between), Any of (in, notIn), Pattern (like) no The asset this fixed asset records. Fixed assets of the same asset in different books have the same companyAssetId. Example: "3a7e5c81-9b24-4d0f-8e63-1c95af207b48".
name string | null no no no The name of the asset. Example: "Forklift - Warehouse 2".
entityId string | null no Exact (eq, ne), Range (gt, gte, lt, lte, between), Any of (in, notIn), Pattern (like) no The legal entity that owns the asset. See id on GET base/entities. Example: "c41d8e07-5f62-4a93-b7d1-8e0364f5a2c9".
assetStatus string | null no Exact (eq, ne), Range (gt, gte, lt, lte, between), Any of (in, notIn), Pattern (like) no The physical status of the asset. Possible values: 'available', 'broken', 'inRepair', 'inUse', 'retired', 'disposed'. Disposing of an asset sets assetStatus to 'disposed' and leaves fixedAssetStatus as 'active'. Example: "inUse".
assetNumber string | null no no no The asset number. It is unique within the tenant, and all fixed assets of the same asset have the same number. Example: "CA-0881".
serialNumber string | null no no no The serial number of the asset. It is free text and does not have to be unique. Example: "SN-77120934".
assetTag string | null no no no The asset tag of the asset, such as the code on a label attached to it. It is free text. Example: "WH2-FORK-03".
acquisitionDate date | null no Exact (eq, ne), Range (gt, gte, lt, lte, between), Any of (in, notIn) yes The date the asset was acquired. Format: YYYY-MM-DD. Example: "2024-03-11".
departmentId string | null no Exact (eq, ne), Range (gt, gte, lt, lte, between), Any of (in, notIn), Pattern (like) no The department the asset is assigned to. Absent when the asset has no department. See id on GET people/departments/:id.
businessUnitId string | null no Exact (eq, ne), Range (gt, gte, lt, lte, between), Any of (in, notIn), Pattern (like) no The business unit the asset is assigned to. Absent when the asset has no business unit.
typeId string | null no Exact (eq, ne), Range (gt, gte, lt, lte, between), Any of (in, notIn), Pattern (like) no The type of the fixed asset. Example: "7b2f9d13-4c68-4e51-a0d7-6f39c58e2b4a".
typeName string | null no no no The name of the fixed asset type. Example: 'Machinery'. Example: "Machinery".
bookId string | null no Exact (eq, ne), Range (gt, gte, lt, lte, between), Any of (in, notIn), Pattern (like) no The accounting book the fixed asset is recorded in. See id on GET accounting/books/:id. Example: "e0c37a94-2d15-4b86-9f42-5a7c81de03b6".
currency string | null no Exact (eq, ne), Range (gt, gte, lt, lte, between), Any of (in, notIn), Pattern (like) no The currency of the fixed asset. Format: ISO 4217, for example 'EUR'. Example: "EUR".
inServiceDate date | null no Exact (eq, ne), Range (gt, gte, lt, lte, between), Any of (in, notIn) yes The date the asset was placed in service. The depreciation schedule is calculated from this date. Format: YYYY-MM-DD. Example: "2024-04-01".
depreciationMethod string | null no Exact (eq, ne), Range (gt, gte, lt, lte, between), Any of (in, notIn), Pattern (like) no The depreciation method of the fixed asset. Possible values: 'StraightLine', 'StraightLineProRateFirstLast', 'Degressive', 'Immediate', 'Bypassed', 'StraightLineHalfMonth', 'ExactDays'. Example: "StraightLine".
depreciationInterval string | null no Exact (eq, ne), Range (gt, gte, lt, lte, between), Any of (in, notIn), Pattern (like) no The interval at which depreciation is recorded for the fixed asset. Possible values: 'Monthly', 'Quarterly', 'Yearly'. Example: "Monthly".
depreciationStatus string | null no Exact (eq, ne), Range (gt, gte, lt, lte, between), Any of (in, notIn), Pattern (like) no The depreciation status of the fixed asset. Possible values: 'NotStarted', 'Ongoing', 'Completed', 'Disposed', 'Voided'. A fixed asset with no depreciation schedule also has the value 'Completed', so check depreciatedAmount before you treat a fixed asset as fully depreciated. Example: "Ongoing".
degressionRate decimal | null no no no The yearly rate of declining-balance depreciation, as a decimal fraction. For example, 0.2 is 20%. Used only when depreciationMethod is 'Degressive'.
acquisitionValueAmount decimal | null no no yes The value the fixed asset was capitalized at, in the acquisitionValueCurrency. Example: "42000".
acquisitionValueCurrency string | null no no no The currency of acquisitionValueAmount. Format: ISO 4217, for example 'EUR'.
salvageValueAmount decimal | null no no no The value the asset is expected to have at the end of its useful life (salvage value, also called residual value), in the salvageValueCurrency. Depreciation reduces the asset's net book value to this amount, not to zero.
salvageValueCurrency string | null no no no The currency of salvageValueAmount. Format: ISO 4217, for example 'EUR'.
depreciationStartValueAmount decimal | null no no no The value the fixed asset's depreciation started from, in the currency. Present only for imported fixed assets.
depreciableAmount decimal | null no no no The amount that is depreciated over the useful life of the fixed asset, in the currency. Formula: depreciationStartValueAmount - salvageValueAmount, or when depreciationStartValueAmount is absent, acquisitionValueAmount - salvageValueAmount. Example: "40000".
depreciatedAmount decimal | null no no yes The total depreciation of the fixed asset, in the currency. Formula: initialDepreciatedAmount + the depreciation recorded on the depreciation schedule. Example: "13333.33".
initialDepreciatedAmount decimal | null no no no The depreciation the fixed asset had before it was imported, in the currency. Formula: acquisitionValueAmount - depreciationStartValueAmount, or 0 when depreciationStartValueAmount is absent.
remainingValue decimal | null no no yes The net book value of the fixed asset, in the currency. Formula: acquisitionValueAmount - depreciatedAmount. It is 0 when fixedAssetStatus is 'voided' or assetStatus is 'retired' or 'disposed'. Example: "28666.67".
disposalDate date | null no Exact (eq, ne), Range (gt, gte, lt, lte, between), Any of (in, notIn) yes The date the asset was disposed of. Format: YYYY-MM-DD. Present only when the asset has been disposed of.
disposalAmount decimal | null no no no The value written off when the asset was disposed of, in the currency. Present only when the asset has been disposed of.
disposalEntryId string | null no no no The journal entry that records the disposal. Present only when the asset has been disposed of. See id on GET accounting/journal-entries/:id.
disposalEntryNumber string | null no no no The number of the journal entry that records the disposal. Present only when the asset has been disposed of. Example: 'JE-4412'.
soldAmountAmount decimal | null no no no The amount the asset was sold for, in the soldAmountCurrency. Present only when the asset was sold.
soldAmountCurrency string | null no no no The currency of soldAmountAmount. Format: ISO 4217, for example 'EUR'. It can differ from currency.
saleEntryId string | null no no no Platform id (a UUID) of the journal entry recording the sale. Absent when the asset wasn't sold.
saleEntryNumber string | null no no no Human-readable number of the sale journal entry, carried alongside saleEntryId.
saleReceivingAccountId string | null no no no The account the sale proceeds were received into. Present only when the asset was sold. See id on GET accounting/accounts/:id.
revenueAccountId string | null no no no The revenue account for the sale of the asset. Present only when the asset was sold and a revenue account was chosen for the sale. See id on GET accounting/accounts/:id.
saleDocumentId string | null no no no The invoice for the sale of the asset, created as a manual taxable document. Present only when the asset was sold. See id on GET tax-documents/manual-taxable-documents/:id.
saleDocumentNumber string | null no no no The number of the invoice for the sale of the asset. Present only when the asset was sold. See taxDocumentNumber on GET tax-documents/manual-taxable-documents/:id.
vatPercentageId string | null no no no The tax code applied to the sale of the asset. Present only when the asset was sold and a tax code was applied to the sale. See lines.id on GET accounting/tax-configurations/:id.
valueAllocationId string | null no no no The value accounting tags set on the fixed asset. Absent when the fixed asset has no tags.
lastModifiedDate date-time no Exact (eq, ne), Range (gt, gte, lt, lte, between), Any of (in, notIn) yes Instant the fixed asset record last changed, as ISO 8601 UTC (YYYY-MM-DDTHH:mm:ss.sssZ). NOTE it tracks the FixedAsset row only: renaming or reassigning the underlying CompanyAsset does not move it. Example: "2026-08-18T09:14:22.517Z".
{
  "data": [
    {
      "id": "9d5b1f42-7c30-4e88-b1a6-2f0c7e34d915",
      "fixedAssetNumber": "FA-000142",
      "fixedAssetStatus": "active",
      "companyAssetId": "3a7e5c81-9b24-4d0f-8e63-1c95af207b48",
      "name": "Forklift - Warehouse 2",
      "entityId": "c41d8e07-5f62-4a93-b7d1-8e0364f5a2c9",
      "assetStatus": "inUse",
      "assetNumber": "CA-0881",
      "serialNumber": "SN-77120934",
      "assetTag": "WH2-FORK-03",
      "acquisitionDate": "2024-03-11",
      "departmentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "businessUnitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "typeId": "7b2f9d13-4c68-4e51-a0d7-6f39c58e2b4a",
      "typeName": "Machinery",
      "bookId": "e0c37a94-2d15-4b86-9f42-5a7c81de03b6",
      "currency": "EUR",
      "inServiceDate": "2024-04-01",
      "depreciationMethod": "StraightLine",
      "depreciationInterval": "Monthly",
      "depreciationStatus": "Ongoing",
      "degressionRate": "19.99",
      "acquisitionValueAmount": "42000",
      "acquisitionValueCurrency": "<acquisitionValueCurrency>",
      "salvageValueAmount": "19.99",
      "salvageValueCurrency": "<salvageValueCurrency>",
      "depreciationStartValueAmount": "19.99",
      "depreciableAmount": "40000",
      "depreciatedAmount": "13333.33",
      "initialDepreciatedAmount": "19.99",
      "remainingValue": "28666.67",
      "disposalDate": "2026-01-15",
      "disposalAmount": "19.99",
      "disposalEntryId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "disposalEntryNumber": "<disposalEntryNumber>",
      "soldAmountAmount": "19.99",
      "soldAmountCurrency": "<soldAmountCurrency>",
      "saleEntryId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "saleEntryNumber": "<saleEntryNumber>",
      "saleReceivingAccountId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "revenueAccountId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "saleDocumentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "saleDocumentNumber": "<saleDocumentNumber>",
      "vatPercentageId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "valueAllocationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "lastModifiedDate": "2026-08-18T09:14:22.517Z"
    }
  ],
  "pagination": {
    "hasMore": true,
    "nextCursor": "<nextCursor>"
  }
}

Statuses