List or create fixed-asset types
API Documentation / Resources / Fixed assets
List fixed-asset types
GET /v1/tenants/{tenant_id}/subsidiaries/{subsidiary_id}/fixed-asset-types
Required OAuth scope: fixedassets:read
Lists the subsidiary's fixed-asset type templates. Types supply defaults when an asset is registered; later type changes never rewrite registered assets.
| Query | Behavior |
|---|---|
active |
Restrict results by active state. |
search |
Match the type name. |
sort |
Sort by name, created_at, or updated_at. |
order |
Apply ascending or descending order. |
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. |
active |
query | No | boolean | |
search |
query | No | string | |
page |
query | No | integer | |
per_page |
query | No | integer: 25, 50, 100 | |
sort |
query | No | string: name, created_at, updated_at | |
order |
query | No | string: asc, desc |
Request
GET /v1/tenants/{tenant_id}/subsidiaries/{subsidiary_id}/fixed-asset-types HTTP/1.1
Host: api.finov.io
Authorization: Bearer {access_token}
Responses
| Status | Description |
|---|---|
200 |
A page of fixed-asset types. |
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": "c52c7454-df1e-4294-a4c9-f0b871e28d29",
"name": "Computer equipment",
"method": "straight_line",
"useful_life_months": 36,
"depreciation_rate": null,
"asset_account_id": "7ca99701-b04a-4744-af68-e1c468642387",
"accumulated_depreciation_account_id": "7ca99701-b04a-4744-af68-e1c468642388",
"depreciation_expense_account_id": "7ca99701-b04a-4744-af68-e1c468642389",
"disposal_account_id": "7ca99701-b04a-4744-af68-e1c468642390",
"active": true,
"created_at": "2026-08-10T15:30:00Z",
"updated_at": "2026-08-10T15:30:00Z"
}
],
"meta": {
"current_page": 1,
"per_page": 25,
"last_page": 1,
"total": 1
}
}
Create a fixed-asset type
POST /v1/tenants/{tenant_id}/subsidiaries/{subsidiary_id}/fixed-asset-types
Required OAuth scope: fixedassets:write
Creates a reusable depreciation and account-mapping template.
| Rule | Requirement |
|---|---|
| Accounts | All four account UUIDs must belong to the subsidiary. |
| Method | Use straight_line or diminishing_value. |
| Useful life | Supply a positive whole number of months. |
Assets copy these settings at registration so accounting history remains stable if the type is later changed or deactivated.
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-asset-types HTTP/1.1
Host: api.finov.io
Authorization: Bearer {access_token}
Content-Type: application/json
{
"name": "Computer equipment",
"method": "straight_line",
"useful_life_months": 36,
"asset_account_id": "7ca99701-b04a-4744-af68-e1c468642387",
"accumulated_depreciation_account_id": "7ca99701-b04a-4744-af68-e1c468642388",
"depreciation_expense_account_id": "7ca99701-b04a-4744-af68-e1c468642389",
"disposal_account_id": "7ca99701-b04a-4744-af68-e1c468642390"
}
Required body fields: name, method, useful_life_months, asset_account_id, accumulated_depreciation_account_id, depreciation_expense_account_id, disposal_account_id.
Responses
| Status | Description |
|---|---|
201 |
Fixed-asset type 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": "c52c7454-df1e-4294-a4c9-f0b871e28d29",
"name": "Computer equipment",
"method": "straight_line",
"useful_life_months": 36,
"depreciation_rate": null,
"asset_account_id": "7ca99701-b04a-4744-af68-e1c468642387",
"accumulated_depreciation_account_id": "7ca99701-b04a-4744-af68-e1c468642388",
"depreciation_expense_account_id": "7ca99701-b04a-4744-af68-e1c468642389",
"disposal_account_id": "7ca99701-b04a-4744-af68-e1c468642390",
"active": true,
"created_at": "2026-08-10T15:30:00Z",
"updated_at": "2026-08-10T15:30:00Z"
}
}