finov.ioDocumentationHome

Preview a depreciation run

API Documentation / Resources / Fixed assets

Finovio Post depreciation preview showing period assets included and amount to post
Preview the required period and aggregate depreciation before posting.

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"
  }
}