List or create fixed assets
API Documentation / Resources / Fixed assets

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