Get or update a fixed-asset type
API Documentation / Resources / Fixed assets
Get a fixed-asset type
GET /v1/tenants/{tenant_id}/subsidiaries/{subsidiary_id}/fixed-asset-types/{type_id}
Required OAuth scope: fixedassets:read
Returns one normalized fixed-asset type and its account mappings.
| Identifier | Scope |
|---|---|
type_id |
Must identify a type in the granted subsidiary. |
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. |
type_id |
path | Yes | string (uuid) | UUID of a fixed-asset type. |
Request
GET /v1/tenants/{tenant_id}/subsidiaries/{subsidiary_id}/fixed-asset-types/{type_id} HTTP/1.1
Host: api.finov.io
Authorization: Bearer {access_token}
Responses
| Status | Description |
|---|---|
200 |
Fixed-asset type 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": "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"
}
}
Update a fixed-asset type
PATCH /v1/tenants/{tenant_id}/subsidiaries/{subsidiary_id}/fixed-asset-types/{type_id}
Required OAuth scope: fixedassets:write
Updates only supplied fields. Omitted fields remain unchanged.
| Change | Effect |
|---|---|
| Depreciation defaults | Applies to future registrations only. |
| Account mappings | Applies to future registrations only. |
active: false |
Prevents selection for new assets. |
Registered assets retain their copied accounting settings.
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. |
type_id |
path | Yes | string (uuid) | UUID of a fixed-asset type. |
Request
PATCH /v1/tenants/{tenant_id}/subsidiaries/{subsidiary_id}/fixed-asset-types/{type_id} HTTP/1.1
Host: api.finov.io
Authorization: Bearer {access_token}
Content-Type: application/json
{
"useful_life_months": 48
}
Required body fields: None.
Responses
| Status | Description |
|---|---|
200 |
Fixed-asset type 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": "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"
}
}