List depreciation schedules

Operation ID: depreciationSchedules

Group: Accounting › Fixed Assets › Depreciation Schedules

Open in the interactive reference

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

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". 
{
  "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