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. 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

​
id
string
required
Unique identifier for the asset.
​
business_id
string
required
ID of the Business that owns the asset.
​
external_id
string
Unique ID of the asset in your system for linking purposes.
​
name
string
required
Name of the asset.
​
asset_type
enum
required
The type of fixed asset. Values can be: RIGHT_OF_USE_ASSET, VEHICLE, EQUIPMENT, GOODWILL
​
ledger_account
ChartAccount object
required
The dedicated ledger account for this asset.
​
accumulated_depreciation_account
ChartAccount object
The accumulated depreciation account for this asset, if configured. Required before recording DEPRECIATION_AMORTIZATION value updates.
​
original_value
integer
Original purchase value, in cents.
​
salvage_value
integer
Estimated salvage (residual) value, in cents.
​
useful_life_months
integer
Useful life of the asset, in months.
​
archived_at
ISO8601 timestamp
When the asset was archived, if applicable.
​
memo
string
Internal note about the asset.
​
metadata
object
Arbitrary JSON object you can attach for your own use. Layer stores and returns it unchanged.
​
reference_number
string
Reference number for the asset.
​
transaction_tags
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

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