finov.ioDocumentationHome

List or create depreciation runs

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.

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