finov.ioDocumentationHome

Get or update 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.

Get a fixed asset

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

Required OAuth scope: fixedassets:read

Returns the normalized asset, current lifecycle state, and book values.

Value Representation
Cost and book values Decimal strings.
Lifecycle timestamps RFC 3339 timestamps or null.

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

GET /v1/tenants/{tenant_id}/subsidiaries/{subsidiary_id}/fixed-assets/{asset_id} HTTP/1.1
Host: api.finov.io
Authorization: Bearer {access_token}

Responses

Status Description
200 Fixed-asset details.
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.

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": "DRAFT",
    "purchase_date": "2026-08-01",
    "cost": "4800.0000",
    "currency_code": "NZD",
    "serial_number": "WS-2026-0007",
    "description": null,
    "dimension_element_ids": [],
    "depreciation_start_date": null,
    "method": null,
    "useful_life_months": null,
    "residual_value": null,
    "accumulated_depreciation": "0.0000",
    "book_value": "4800.0000",
    "suspended_from": null,
    "disposal_date": null,
    "proceeds": null,
    "gain_loss": null,
    "journal_id": null,
    "registered_at": null,
    "disposed_at": null,
    "created_at": "2026-08-10T16:00:00Z",
    "updated_at": "2026-08-10T16:00:00Z"
  }
}

Update a fixed-asset draft

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

Required OAuth scope: fixedassets:write

Updates supplied draft fields; omitted fields remain unchanged.

State Mutation rule
DRAFT Creation fields may be changed.
Registered or later Accounting values change only through lifecycle actions.

Attempts to rewrite lifecycle-controlled values return a conflict.

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

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

{
  "name": "Design workstation 07A",
  "description": "Primary rendering workstation"
}

Required body fields: None.

Responses

Status Description
200 Fixed-asset draft updated.
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": "DRAFT",
    "purchase_date": "2026-08-01",
    "cost": "4800.0000",
    "currency_code": "NZD",
    "serial_number": "WS-2026-0007",
    "description": null,
    "dimension_element_ids": [],
    "depreciation_start_date": null,
    "method": null,
    "useful_life_months": null,
    "residual_value": null,
    "accumulated_depreciation": "0.0000",
    "book_value": "4800.0000",
    "suspended_from": null,
    "disposal_date": null,
    "proceeds": null,
    "gain_loss": null,
    "journal_id": null,
    "registered_at": null,
    "disposed_at": null,
    "created_at": "2026-08-10T16:00:00Z",
    "updated_at": "2026-08-10T16:00:00Z"
  }
}