finov.ioDocumentationHome

Dispose of a fixed asset

API Documentation / Resources / Fixed assets

Dispose of a fixed asset

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

Required OAuth scope: fixedassets:write

Posts the disposal, recognizes proceeds and gain or loss, and prevents further depreciation.

Check Requirement
State Asset is registered or suspended.
Date Unlocked and after prior lifecycle events.
Proceeds Non-negative decimal string.

The resulting events and journals remain available for audit.

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}/dispose HTTP/1.1
Host: api.finov.io
Authorization: Bearer {access_token}
Content-Type: application/json

{
  "disposal_date": "2027-08-31",
  "proceeds": "1800.0000",
  "reason": "Asset sold"
}

Required body fields: disposal_date, proceeds, reason.

Responses

Status Description
200 Fixed asset disposed.
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": "DISPOSED",
    "purchase_date": "2026-08-01",
    "cost": "5050.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": "1925.0000",
    "book_value": "3125.0000",
    "suspended_from": null,
    "disposal_date": "2027-08-31",
    "proceeds": "1800.0000",
    "gain_loss": "-1325.0000",
    "journal_id": "6f92fbdb-249b-474e-936d-b7bf84b174f4",
    "registered_at": "2026-08-10T16:30:00Z",
    "disposed_at": "2027-08-31T18:00:00Z",
    "created_at": "2026-08-10T16:00:00Z",
    "updated_at": "2027-08-31T18:00:00Z"
  }
}