finov.ioDocumentationHome

List or create fixed assets

API Documentation / Resources / Fixed assets

Finovio New asset form populated for warehouse shelving
Enter asset-specific details after choosing the policy supplied by an asset type.

List fixed assets

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

Required OAuth scope: fixedassets:read

Lists draft and lifecycle-controlled assets in the subsidiary.

Query Behavior
status Restrict by lifecycle state.
asset_type_id Restrict by the selected type UUID.
updated_since Return assets changed at or after the timestamp.
search Match name, asset number, serial number, or description.

The default order is name ASC, followed by stable resource order.

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: DRAFT, REGISTERED, SUSPENDED, DISPOSED
asset_type_id query No string (uuid)
updated_since query No string (date-time)
search query No string
page query No integer
per_page query No integer: 25, 50, 100
sort query No string: name, purchase_date, created_at, updated_at
order query No string: asc, desc

Request

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

Responses

Status Description
200 A page of fixed assets.
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": "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"
    }
  ],
  "meta": {
    "current_page": 1,
    "per_page": 25,
    "last_page": 1,
    "total": 1
  }
}

Create a fixed-asset draft

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

Required OAuth scope: fixedassets:write

Creates a draft asset without posting accounting entries.

Field Rule
cost Non-negative decimal string, up to four fractional digits.
currency_code Three-letter uppercase currency code.
Dimension elements At most one element from each dimension.

Registration separately validates depreciation settings, period locks, and account mappings before creating accounting 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.

Request

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

{
  "name": "Design workstation 07",
  "asset_type_id": "c52c7454-df1e-4294-a4c9-f0b871e28d29",
  "purchase_date": "2026-08-01",
  "cost": "4800.0000",
  "currency_code": "NZD",
  "serial_number": "WS-2026-0007"
}

Required body fields: name, asset_type_id, purchase_date, cost, currency_code.

Responses

Status Description
201 Fixed-asset draft created.
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": "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"
  }
}