Preview a depreciation run
API Documentation / Resources / Fixed assets

Preview a depreciation run
POST /v1/tenants/{tenant_id}/subsidiaries/{subsidiary_id}/depreciation-runs/preview
Required OAuth scope: fixedassets:write
Calculates a depreciation run without creating events or journals.
| Input | Effect |
|---|---|
period |
Applies current eligibility and period-lock rules. |
asset_type_id |
Optionally limits the preview to one type. |
Preview results are transient and may change before posting.
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/preview 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 |
|---|---|
200 |
Depreciation preview calculated. |
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. |
200 example
HTTP/1.1 200 OK
Content-Type: application/json
{
"data": {
"period": "2026-08",
"asset_count": 12,
"total_depreciation": "6840.0000",
"assets": [
{
"asset_id": "72a89038-aa5d-4762-9f22-b35aa4d04589",
"depreciation": "125.0000",
"closing_book_value": "4675.0000"
}
],
"generated_at": "2026-08-30T09:00:00Z"
}
}