finov.ioDocumentationHome

Register a fixed asset

API Documentation / Resources / Fixed assets

Registered fixed asset detail showing overview depreciation position and register history
Registration changes the status and adds a REGISTER event to the asset history.

Register a fixed asset

POST /v1/tenants/{tenant_id}/subsidiaries/{subsidiary_id}/fixed-assets/{asset_id}/register

Required OAuth scope: fixedassets:write

Validates and registers a complete draft, posts acquisition accounting, and makes its accounting settings lifecycle-controlled.

Check Requirement
State Asset is DRAFT.
Period Depreciation start date is not locked.
Overrides Values comply with the selected type.
Accounts Required mappings remain active.

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.
asset_id path Yes string (uuid) UUID of a fixed asset.

Request

POST /v1/tenants/{tenant_id}/subsidiaries/{subsidiary_id}/fixed-assets/{asset_id}/register HTTP/1.1
Host: api.finov.io
Authorization: Bearer {access_token}
Content-Type: application/json

{
  "depreciation_start_date": "2026-08-01",
  "residual_value": "300.0000"
}

Required body fields: depreciation_start_date.

Responses

Status Description
200 Fixed asset registered.
401 Access token is missing, expired, revoked, or invalid.
403 Token lacks the required scope or granted accounting context.
404 Fixed-asset resource does not exist in the 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": {
    "id": "72a89038-aa5d-4762-9f22-b35aa4d04589",
    "name": "Design workstation 07",
    "asset_number": "FA-2026-0007",
    "asset_type_id": "c52c7454-df1e-4294-a4c9-f0b871e28d29",
    "status": "REGISTERED",
    "purchase_date": "2026-08-01",
    "cost": "4800.0000",
    "currency_code": "NZD",
    "serial_number": "WS-2026-0007",
    "description": null,
    "dimension_element_ids": [],
    "depreciation_start_date": "2026-08-01",
    "method": "straight_line",
    "useful_life_months": 36,
    "residual_value": "300.0000",
    "accumulated_depreciation": "0.0000",
    "book_value": "4800.0000",
    "suspended_from": null,
    "disposal_date": null,
    "proceeds": null,
    "gain_loss": null,
    "journal_id": "a87fc69e-9c34-4151-ad8b-22e5d9a0b697",
    "registered_at": "2026-08-10T16:30:00Z",
    "disposed_at": null,
    "created_at": "2026-08-10T16:00:00Z",
    "updated_at": "2026-08-10T16:30:00Z"
  }
}