Reference
Fixed Assets
Register, depreciate, and dispose of fixed assets. Monthly depreciation posts automatically.
Fixed assets are long-lived purchases (laptops, vehicles, buildings) that depreciate over time. Register them here, run monthly depreciation, and record disposals with automatic gain/loss computation.
List fixed assets
GET
/v1/fixed-assetsReturns every asset on the books, newest first.
Query parameters
| Field | Type | Required | Notes |
|---|---|---|---|
businessId | string | yes | |
status | string | no | active, disposed, written_off. |
category | string | no | computers, vehicles, furniture, buildings, etc. |
limit | integer | no | Default 50, max 100. |
Get a single asset
GET
/v1/fixed-assets/{id}Fetches one asset with its depreciation schedule.
Response — 200
{
"success": true,
"data": {
"id": "asset_abc",
"assetNumber": "FA-2026-014",
"name": "MacBook Pro M5 — Engineering",
"category": "computers",
"acquisitionDate": "2026-01-15T00:00:00.000Z",
"costKobo": 250_000_000,
"salvageKobo": 25_000_000,
"usefulLifeMonths": 36,
"depreciationMethod": "straight_line",
"accumulatedDepreciationKobo": 18_750_000,
"carryingValueKobo": 231_250_000,
"status": "active",
"schedule": [
{ "month": 2, "year": 2026, "depreciationKobo": 6_250_000 },
{ "month": 3, "year": 2026, "depreciationKobo": 6_250_000 }
]
}
}Register an asset
POST
/v1/fixed-assetsRegisters a new asset. The purchase JE is posted if `postAcquisitionJE: true`.
Body
| Field | Type | Required | Notes |
|---|---|---|---|
name | string | yes | |
category | string | yes | |
cost | number | yes | Naira. |
acquisitionDate | ISO 8601 | yes | |
usefulLifeMonths | integer | yes | Full useful life. |
salvageValue | number | no | Residual value at end of life. Defaults to 0. |
depreciationMethod | string | no | straight_line (default) or declining_balance. |
assetAccountId | string | no | COA account for the asset. Finora Business picks a default by category. |
description, serialNumber, location | string | no | |
postAcquisitionJE | boolean | no | Defaults to true (posts DR Asset, CR Cash/Bank). |
Run monthly depreciation
POST
/v1/fixed-assets/depreciateRuns depreciation for all active assets and posts the combined JE.
Body
| Field | Type | Required | Notes |
|---|---|---|---|
month | integer | yes | 1–12. |
year | integer | yes | |
runDate | ISO 8601 | no | The date to use on the JE. Defaults to last day of the period. |
Dispose an asset
POST
/v1/fixed-assets/{id}/disposeRecords disposal. Computes gain or loss vs carrying value and posts the JE.
Body
| Field | Type | Required | Notes |
|---|---|---|---|
disposalDate | ISO 8601 | yes | |
proceeds | number | no | Naira received. Defaults to 0 for scrap/donation. |
disposalMethod | string | no | sale, scrap, donation, trade_in. |
buyer | string | no | For sale disposals. |
notes | string | no |
Response — 200
{
"success": true,
"data": {
"id": "asset_abc",
"status": "disposed",
"finalCarryingValueKobo": 131_250_000,
"proceedsKobo": 150_000_000,
"gainKobo": 18_750_000,
"lossKobo": 0,
"journalEntryId": "je_xyz"
}
}Related endpoints
- Chart of Accounts — asset and depreciation accounts
- Journal Entries — inspect acquisition, depreciation, and disposal entries
Reference index
Back to all modules