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
id— filter by eq, ne, gt, gte, lt, lte, in, notIn, between, likefixedAssetNumber— filter by eq, ne, gt, gte, lt, lte, in, notIn, between, likefixedAssetStatus— filter by eq, ne, gt, gte, lt, lte, in, notIn, between, likecompanyAssetId— filter by eq, ne, gt, gte, lt, lte, in, notIn, between, likeentityId— filter by eq, ne, gt, gte, lt, lte, in, notIn, between, likeassetStatus— filter by eq, ne, gt, gte, lt, lte, in, notIn, between, likeacquisitionDate— filter by eq, ne, gt, gte, lt, lte, in, notIn, betweendepartmentId— filter by eq, ne, gt, gte, lt, lte, in, notIn, between, likebusinessUnitId— filter by eq, ne, gt, gte, lt, lte, in, notIn, between, liketypeId— filter by eq, ne, gt, gte, lt, lte, in, notIn, between, likebookId— filter by eq, ne, gt, gte, lt, lte, in, notIn, between, likecurrency— filter by eq, ne, gt, gte, lt, lte, in, notIn, between, likeinServiceDate— filter by eq, ne, gt, gte, lt, lte, in, notIn, betweendepreciationMethod— filter by eq, ne, gt, gte, lt, lte, in, notIn, between, likedepreciationInterval— filter by eq, ne, gt, gte, lt, lte, in, notIn, between, likedepreciationStatus— filter by eq, ne, gt, gte, lt, lte, in, notIn, between, likedisposalDate— filter by eq, ne, gt, gte, lt, lte, in, notIn, betweenlastModifiedDate— filter by eq, ne, gt, gte, lt, lte, in, notIn, between- Orderable: id, fixedAssetNumber, inServiceDate, acquisitionDate, acquisitionValueAmount, remainingValue, depreciatedAmount, disposalDate, lastModifiedDate
- Selectable: id, fixedAssetNumber, fixedAssetStatus, companyAssetId, name, entityId, assetStatus, assetNumber, serialNumber, assetTag, acquisitionDate, departmentId, businessUnitId, typeId, typeName, bookId, currency, inServiceDate, depreciationMethod, depreciationInterval, depreciationStatus, degressionRate, acquisitionValueAmount, acquisitionValueCurrency, salvageValueAmount, salvageValueCurrency, depreciationStartValueAmount, depreciableAmount, depreciatedAmount, initialDepreciatedAmount, remainingValue, disposalDate, disposalAmount, disposalEntryId, disposalEntryNumber, soldAmountAmount, soldAmountCurrency, saleEntryId, saleEntryNumber, saleReceivingAccountId, revenueAccountId, saleDocumentId, saleDocumentNumber, vatPercentageId, valueAllocationId, lastModifiedDate
page[size]— Page sizepage[cursor]— Opaque continuation cursor
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
400— Invalid request or business failure401— The request carries no valid access token.403— Not authorized404— Not found429— Too many requests from this client address. The response has no body and noRetry-Afterheader.500— Internal server error