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