finov.ioDocumentationHome

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