# List fixed assets

Operation ID: `listFixedAssets`

Group: Accounting › Asset Management › Fixed Assets

[Open in the interactive reference](https://docs.api.lensing.ai/lensing/v1/endpoints/listFixedAssets)

`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, like
- `fixedAssetNumber` — filter by eq, ne, gt, gte, lt, lte, in, notIn, between, like
- `fixedAssetStatus` — filter by eq, ne, gt, gte, lt, lte, in, notIn, between, like
- `companyAssetId` — filter by eq, ne, gt, gte, lt, lte, in, notIn, between, like
- `entityId` — filter by eq, ne, gt, gte, lt, lte, in, notIn, between, like
- `assetStatus` — filter by eq, ne, gt, gte, lt, lte, in, notIn, between, like
- `acquisitionDate` — filter by eq, ne, gt, gte, lt, lte, in, notIn, between
- `departmentId` — filter by eq, ne, gt, gte, lt, lte, in, notIn, between, like
- `businessUnitId` — filter by eq, ne, gt, gte, lt, lte, in, notIn, between, like
- `typeId` — filter by eq, ne, gt, gte, lt, lte, in, notIn, between, like
- `bookId` — filter by eq, ne, gt, gte, lt, lte, in, notIn, between, like
- `currency` — filter by eq, ne, gt, gte, lt, lte, in, notIn, between, like
- `inServiceDate` — filter by eq, ne, gt, gte, lt, lte, in, notIn, between
- `depreciationMethod` — filter by eq, ne, gt, gte, lt, lte, in, notIn, between, like
- `depreciationInterval` — filter by eq, ne, gt, gte, lt, lte, in, notIn, between, like
- `depreciationStatus` — filter by eq, ne, gt, gte, lt, lte, in, notIn, between, like
- `disposalDate` — filter by eq, ne, gt, gte, lt, lte, in, notIn, between
- `lastModifiedDate` — 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 size
- `page[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"`. |

```json
{
  "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 failure
- `401` — The request carries no valid access token.
- `403` — Not authorized
- `404` — Not found
- `429` — Too many requests from this client address. The response has no body and no `Retry-After` header.
- `500` — Internal server error