Axiomatic

Fixed Assets

API reference for fixed asset lifecycle, depreciation, disposal, impairment, and revaluation.

Fixed asset creation, updates, disposal, impairment, revaluation, and CIP capitalization. All endpoints require tenant context via entityId.

Authentication

  • Session cookie — set when signed in via the web app
  • API key — pass via the x-api-key header

All endpoints require authentication and entity access.


Endpoints

List and create

MethodEndpointDescription
GET/api/fixed-assets?entityId=List assets
POST/api/fixed-assetsCreate asset or actions: dispose, impair, revalue, capitalizeCIP
PUT/api/fixed-assetsUpdate asset
DELETE/api/fixed-assetsDelete asset

GET /api/fixed-assets

Query parameters:

ParameterTypeRequiredDescription
entityIdstringYesEntity ID for tenant context
statusstringNoFilter: active, disposed, fully-depreciated
asOfDatestringNoDate for depreciation/valuation (YYYY-MM-DD)

Response: Array of assets with ID, description, acquisition date, cost, useful life, depreciation method, accumulated depreciation, and net book value.


POST /api/fixed-assets

Request body varies by intent:

Create asset:

{
  "entityId": "string",
  "description": "string",
  "acquisitionDate": "YYYY-MM-DD",
  "cost": 0,
  "currency": "USD",
  "usefulLifeYears": 0,
  "depreciationMethod": "straight-line" | "declining-balance" | "units-of-production",
  "assetAccountId": "string",
  "accumulatedDepreciationAccountId": "string",
  "depreciationExpenseAccountId": "string",
  "salvageValue": 0
}

Actions (dispose, impair, revalue, capitalizeCIP):

{
  "entityId": "string",
  "action": "dispose" | "impair" | "revalue" | "capitalizeCIP",
  "assetId": "string",
  "disposalDate": "YYYY-MM-DD",
  "proceeds": 0,
  "impairmentAmount": 0,
  "newCarryingValue": 0,
  "revaluationAmount": 0,
  "cipProjectId": "string"
}
ActionDescription
disposeRecord disposal; write off remaining NBV, record proceeds/gain or loss
impairRecord impairment loss; reduce carrying value
revalueRevalue asset (e.g., fair value model under IAS 16)
capitalizeCIPCapitalize construction-in-progress to fixed asset

PUT /api/fixed-assets

Request body:

{
  "entityId": "string",
  "assetId": "string",
  "description": "string",
  "usefulLifeYears": 0,
  "depreciationMethod": "string",
  "salvageValue": 0
}

DELETE /api/fixed-assets

Request body or query:

ParameterTypeRequiredDescription
entityIdstringYesEntity ID for tenant context
assetIdstringYesAsset ID to delete

Deletes the asset record. Use dispose for proper accounting treatment of active assets.