# List depreciation schedules

Operation ID: `depreciationSchedules`

Group: Accounting › Fixed Assets › Depreciation Schedules

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

`GET /fixed-assets/depreciation-schedules`

Read-only: Reads and returns; changes nothing.

Lists depreciation schedules. Each schedule has the same fields as `GET fixed-assets/depreciation-schedules/:id`.

Recording depreciation doesn't always update `lastModifiedDate`. It changes `depreciatedAmount` and `remainingValue`. It updates `lastModifiedDate` only when the schedule's `status` changes.

## 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
- `scheduleNumber` — filter by eq, ne, gt, gte, lt, lte, in, notIn, between, like
- `fixedAssetId` — filter by eq, ne, gt, gte, lt, lte, in, notIn, between
- `entityId` — filter by eq, ne, gt, gte, lt, lte, in, notIn, between
- `bookId` — filter by eq, ne, gt, gte, lt, lte, in, notIn, between
- `depreciationRuleId` — filter by eq, ne, gt, gte, lt, lte, in, notIn, between
- `status` — filter by eq, ne, gt, gte, lt, lte, in, notIn, between, like
- `acquisitionDate` — filter by eq, ne, gt, gte, lt, lte, in, notIn, between
- `startDate` — filter by eq, ne, gt, gte, lt, lte, in, notIn, between
- `endDate` — filter by eq, ne, gt, gte, lt, lte, in, notIn, between
- `currency` — filter by eq, ne, gt, gte, lt, lte, in, notIn, between, like
- `lastModifiedDate` — filter by eq, ne, gt, gte, lt, lte, in, notIn, between
- Orderable: id, scheduleNumber, fixedAssetId, status, acquisitionDate, startDate, endDate, lastModifiedDate
- Selectable: id, scheduleNumber, fixedAssetId, entityId, bookId, depreciationRuleId, status, acquisitionDate, startDate, endDate, currency, acquisitionValue, depreciableAmount, depreciatedAmount, remainingValue, lastModifiedDate
- `page[size]` — Page size
- `page[cursor]` — Opaque continuation cursor

## Response

`200` Success

Under `data`, an array of depreciationSchedulesRow:

| 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 depreciation schedule. Example: `"7c2e5a91-3f84-4b60-9d17-a5e8f2c04b39"`. |
| `scheduleNumber` | string \| null | no | Exact (`eq`, `ne`), Range (`gt`, `gte`, `lt`, `lte`, `between`), Any of (`in`, `notIn`), Pattern (`like`) | yes | The depreciation schedule number. Unique within the tenant. Example: 'DS-0042'. Example: `"DS-0042"`. |
| `fixedAssetId` | number | no | Exact (`eq`, `ne`), Range (`gt`, `gte`, `lt`, `lte`, `between`), Any of (`in`, `notIn`) | yes | The internal number of the fixed asset the schedule depreciates. It is not the `id` that the fixed asset endpoints use. Example: `3187`. |
| `entityId` | number | no | Exact (`eq`, `ne`), Range (`gt`, `gte`, `lt`, `lte`, `between`), Any of (`in`, `notIn`) | no | The internal number of the legal entity that owns the fixed asset. It is not the `id` that the legal entity endpoints use. Example: `1`. |
| `bookId` | number | no | Exact (`eq`, `ne`), Range (`gt`, `gte`, `lt`, `lte`, `between`), Any of (`in`, `notIn`) | no | The internal number of the accounting book the fixed asset is tracked in. It is not the `id` that the accounting book endpoints use, or the `bookId` on a depreciation policy. Example: `1`. |
| `depreciationRuleId` | number | no | Exact (`eq`, `ne`), Range (`gt`, `gte`, `lt`, `lte`, `between`), Any of (`in`, `notIn`) | no | The internal number of the depreciation rule applied to the fixed asset. A rule links a depreciation policy to a fixed asset type and sets the useful life. Example: `12`. |
| `status` | string | no | Exact (`eq`, `ne`), Range (`gt`, `gte`, `lt`, `lte`, `between`), Any of (`in`, `notIn`), Pattern (`like`) | yes | The status of the schedule. Possible values: 'NotStarted' (no line has been recorded), 'Ongoing' (some lines have been recorded), 'Completed' (every line has been recorded), 'Disposed' (the fixed asset was disposed of), 'Voided' (the fixed asset was voided). Example: `"Ongoing"`. |
| `acquisitionDate` | date | no | Exact (`eq`, `ne`), Range (`gt`, `gte`, `lt`, `lte`, `between`), Any of (`in`, `notIn`) | yes | The date the fixed asset was acquired. Format: YYYY-MM-DD. It can be earlier than startDate. Example: `"2024-01-15"`. |
| `startDate` | date | no | Exact (`eq`, `ne`), Range (`gt`, `gte`, `lt`, `lte`, `between`), Any of (`in`, `notIn`) | yes | The date depreciation starts. Format: YYYY-MM-DD. Example: `"2024-02-01"`. |
| `endDate` | date | no | Exact (`eq`, `ne`), Range (`gt`, `gte`, `lt`, `lte`, `between`), Any of (`in`, `notIn`) | yes | The last day of depreciation. Format: YYYY-MM-DD. Example: `"2029-01-31"`. |
| `currency` | string | 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"`. |
| `acquisitionValue` | decimal | no | no | no | The acquisition cost of the fixed asset, in the `currency`. Example: `"24000.00"`. |
| `depreciableAmount` | decimal | no | no | no | The total amount to depreciate over the schedule, in the `currency`. Formula: the fixed asset's depreciationStartValueAmount - salvageValueAmount, or when depreciationStartValueAmount is absent, acquisitionValue - salvageValueAmount. See depreciationStartValueAmount and salvageValueAmount on GET fixed-assets/:id. Example: `"21600.00"`. |
| `depreciatedAmount` | decimal | no | no | no | The depreciation recorded on this schedule, in the `currency`. Formula: the sum of the recorded schedule lines. Lines that have not been recorded do not count, whatever their dates. Example: `"7560.00"`. |
| `remainingValue` | decimal | no | no | no | The net book value of the fixed asset, in the `currency`. Formula: acquisitionValue - depreciatedAmount, or when the fixed asset has a depreciationStartValueAmount, depreciationStartValueAmount - depreciatedAmount. It is 0 once the fixed asset is voided, retired, or disposed of. Example: `"16440.00"`. |
| `lastModifiedDate` | date-time | no | Exact (`eq`, `ne`), Range (`gt`, `gte`, `lt`, `lte`, `between`), Any of (`in`, `notIn`) | yes | The date and time the depreciation schedule last changed, in UTC. Format: YYYY-MM-DDTHH:mm:ss.sssZ. Recording depreciation changes depreciatedAmount and remainingValue. It updates lastModifiedDate only when the schedule's status changes. Example: `"2026-08-14T09:12:33.000Z"`. |

```json
{
  "data": [
    {
      "id": "7c2e5a91-3f84-4b60-9d17-a5e8f2c04b39",
      "scheduleNumber": "DS-0042",
      "fixedAssetId": 3187,
      "entityId": 1,
      "bookId": 1,
      "depreciationRuleId": 12,
      "status": "Ongoing",
      "acquisitionDate": "2024-01-15",
      "startDate": "2024-02-01",
      "endDate": "2029-01-31",
      "currency": "EUR",
      "acquisitionValue": "24000.00",
      "depreciableAmount": "21600.00",
      "depreciatedAmount": "7560.00",
      "remainingValue": "16440.00",
      "lastModifiedDate": "2026-08-14T09:12:33.000Z"
    }
  ],
  "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