finov.ioDocumentationHome

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