Skip to main content
An Asset represents a fixed asset a Business owns: such as a vehicle, a piece of equipment, a right-of-use asset, or goodwill. Creating an asset opens a dedicated ledger account for it (under Fixed Assets by default), so its value and any changes flow through the Business’s books. Once an asset exists, you record changes to its carrying value over time with value updates: depreciation, improvements, impairments, and revaluations. See the Asset Value Update object. If the asset already had value before you started tracking it in Layer, set an opening balance: a starting value recorded against Opening Balance Equity as of a specific date, rather than built up from value updates. Set it when you create the asset, and replace or clear it later with Update an asset. Assets can also be tied to a loan: an ASSET loan proceed can create or link an asset that the loan financed. See Create a loan.

​
Attributes

​
string
required
Unique identifier for the asset.
​
string
required
ID of the Business that owns the asset.
​
string
Unique ID of the asset in your system for linking purposes.
​
string
required
Name of the asset.
​
enum
required
The type of fixed asset. Values can be: RIGHT_OF_USE_ASSET, VEHICLE, EQUIPMENT, GOODWILL
​
ChartAccount object
required
The dedicated ledger account for this asset.
​
ChartAccount object
The accumulated depreciation account for this asset, if configured. Required before recording DEPRECIATION_AMORTIZATION value updates.
​
integer
Original purchase value, in cents.
​
integer
Estimated salvage (residual) value, in cents.
​
integer
Useful life of the asset, in months.
​
Opening Balance object
The asset’s opening balance, if one is set. Contains balance (in cents) and effective_at.
​
ISO8601 timestamp
When the asset was archived, if applicable.
​
string
Internal note about the asset.
​
object
Arbitrary JSON object you can attach for your own use. Layer stores and returns it unchanged.
​
string
Reference number for the asset.
​
array of Tag objects
Tags applied to this asset.

​
Asset Value Update object

An Asset Value Update is a recorded change to an asset’s carrying value. Each update posts a journal entry between the asset (or its accumulated depreciation account) and a counter account. DEPRECIATION_AMORTIZATION, IMPAIRMENT, and REVALUATION_DOWN decrease the asset’s value; IMPROVEMENT and REVALUATION_UP increase it. Depreciation requires the asset to have an accumulated_depreciation_account configured.

​
Attributes

​
string
required
Unique identifier for the value update.
​
string
required
ID of the Business that owns the asset.
​
string
Unique ID of the value update in your system for linking purposes.
​
string
required
ID of the asset this value update applies to.
​
integer
required
Amount of the value change, in cents.
​
enum
required
The kind of value change. Values can be: DEPRECIATION_AMORTIZATION, IMPROVEMENT, IMPAIRMENT, REVALUATION_UP, REVALUATION_DOWN
​
ISO8601 timestamp
required
Date of the value update.
​
ISO8601 timestamp
When the value update was archived, if applicable.
​
string
Internal note about the value update.
​
object
Arbitrary JSON object you can attach for your own use.
​
string
Reference number for the value update.
​
array of Tag objects
Tags applied to this value update.