List or create depreciation runs
API Documentation / Resources / Fixed assets

List depreciation runs
GET /v1/tenants/{tenant_id}/subsidiaries/{subsidiary_id}/depreciation-runs
Required OAuth scope: fixedassets:read
Lists posted and rolled-back depreciation runs.
| Query | Behavior |
|---|---|
status |
Restrict by POSTED or ROLLED_BACK. |
period |
Restrict by accounting month in YYYY-MM form. |
Runs are immutable processing records; rollback adds reversing history.
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
tenant_id |
path | Yes | string (uuid) | UUID of the authorized company group. |
subsidiary_id |
path | Yes | string (uuid) | UUID of the subsidiary whose books contain the asset. |
status |
query | No | string: POSTED, ROLLED_BACK | |
period |
query | No | string | |
page |
query | No | integer | |
per_page |
query | No | integer: 25, 50, 100 |
Request
GET /v1/tenants/{tenant_id}/subsidiaries/{subsidiary_id}/depreciation-runs HTTP/1.1
Host: api.finov.io
Authorization: Bearer {access_token}
Responses
| Status | Description |
|---|---|
200 |
A page of depreciation runs. |
401 |
Access token is missing, expired, revoked, or invalid. |
403 |
Token lacks the required scope or granted accounting context. |
422 |
Fixed-asset data, references, or accounting rules failed validation. |
200 example
HTTP/1.1 200 OK
Content-Type: application/json
{
"data": [
{
"id": "28f174b5-0c7d-42a4-9963-09e29dcbe93d",
"period": "2026-08",
"status": "POSTED",
"asset_count": 12,
"total_depreciation": "6840.0000",
"posted_at": "2026-08-31T19:00:00Z",
"rolled_back_at": null
}
],
"meta": {
"current_page": 1,
"per_page": 25,
"last_page": 1,
"total": 1
}
}
Create a depreciation run
POST /v1/tenants/{tenant_id}/subsidiaries/{subsidiary_id}/depreciation-runs
Required OAuth scope: fixedassets:write
Calculates and posts depreciation for every eligible asset in a month.
| Check | Requirement |
|---|---|
| Period | Uses YYYY-MM and is not locked. |
| Duplicate | No posted run already exists for the period. |
| Eligibility | Registration, suspension, and disposal dates are applied. |
Success creates immutable asset events and accounting journals.
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
tenant_id |
path | Yes | string (uuid) | UUID of the authorized company group. |
subsidiary_id |
path | Yes | string (uuid) | UUID of the subsidiary whose books contain the asset. |
Request
POST /v1/tenants/{tenant_id}/subsidiaries/{subsidiary_id}/depreciation-runs HTTP/1.1
Host: api.finov.io
Authorization: Bearer {access_token}
Content-Type: application/json
{
"period": "2026-08"
}
Required body fields: period.
Responses
| Status | Description |
|---|---|
201 |
Depreciation run posted. |
401 |
Access token is missing, expired, revoked, or invalid. |
403 |
Token lacks the required scope or granted accounting context. |
409 |
Resource state, period locks, or dependent history prevent the operation. |
422 |
Fixed-asset data, references, or accounting rules failed validation. |
201 example
HTTP/1.1 201 Created
Content-Type: application/json
{
"data": {
"id": "28f174b5-0c7d-42a4-9963-09e29dcbe93d",
"period": "2026-08",
"status": "POSTED",
"asset_count": 12,
"total_depreciation": "6840.0000",
"posted_at": "2026-08-31T19:00:00Z",
"rolled_back_at": null
}
}