finov.ioDocumentationHome

Suspend a fixed asset

API Documentation / Resources / Fixed assets

Suspend a fixed asset

POST /v1/tenants/{tenant_id}/subsidiaries/{subsidiary_id}/fixed-assets/{asset_id}/suspend

Required OAuth scope: fixedassets:write

Stops depreciation prospectively while retaining the asset and its accounting history.

Check Requirement
State Asset is registered and active.
Date Not locked and not before the latest posted event.
Reason Required for the immutable event record.

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.
asset_id path Yes string (uuid) UUID of a fixed asset.

Request

POST /v1/tenants/{tenant_id}/subsidiaries/{subsidiary_id}/fixed-assets/{asset_id}/suspend HTTP/1.1
Host: api.finov.io
Authorization: Bearer {access_token}
Content-Type: application/json

{
  "effective_date": "2026-09-01",
  "reason": "Asset held for repair"
}

Required body fields: effective_date, reason.

Responses

Status Description
200 Fixed asset suspended.
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": "72a89038-aa5d-4762-9f22-b35aa4d04589",
    "name": "Design workstation 07",
    "asset_number": "FA-2026-0007",
    "asset_type_id": "c52c7454-df1e-4294-a4c9-f0b871e28d29",
    "status": "SUSPENDED",
    "purchase_date": "2026-08-01",
    "cost": "4800.0000",
    "currency_code": "NZD",
    "serial_number": "WS-2026-0007",
    "description": null,
    "dimension_element_ids": [],
    "depreciation_start_date": "2026-08-01",
    "method": "straight_line",
    "useful_life_months": 36,
    "residual_value": "300.0000",
    "accumulated_depreciation": "125.0000",
    "book_value": "4675.0000",
    "suspended_from": "2026-09-01",
    "disposal_date": null,
    "proceeds": null,
    "gain_loss": null,
    "journal_id": "a87fc69e-9c34-4151-ad8b-22e5d9a0b697",
    "registered_at": "2026-08-10T16:30:00Z",
    "disposed_at": null,
    "created_at": "2026-08-10T16:00:00Z",
    "updated_at": "2026-09-01T08:00:00Z"
  }
}