Assets are significant purchases, like company cars, laptops or furniture, that are used over multiple years. They are recorded to manage depreciation and comply with tax regulations.
Create a disposal
Creates a disposal for the asset at the given date. Requires the asset to not have a disposal already. Furthermore, the asset must be fully depreciated so the value of the asset at the disposal date must be zero.
path Parameters
administration_idstring | integer · pattern:^\d+$· requiredThe unique identifier of the administration
A unique record identifier of an administration
idstring | integer · pattern:^\d+$· requiredA unique record identifier
formatstring · pattern:^(.(json|xml))?$· requiredThe format in which the response is given, can be empty to use the default format
Default: .json
Request Body
datestring · date · requiredHas to be after the purchase date of the asset, and cannot be in the future or in the locked period of the administration.
reasonstring · enum · requiredEnum values:out_of_usesoldprivate_withdrawaldivested
Responses
A disposal
datestring · datereasonstring · enumEnum values:out_of_usesoldprivate_withdrawaldivestedexternally_bookedbooleanasset_idstring | integer · pattern:^\d+$A unique record identifier
Delete a source
Deletes a source from an asset. Does not delete the detail or the asset
path Parameters
administration_idstring | integer · pattern:^\d+$· requiredThe unique identifier of the administration
A unique record identifier of an administration
idstring | integer · pattern:^\d+$· requiredA unique record identifier
detail_idstring | integer · pattern:^\d+$· requiredA unique record identifier
formatstring · pattern:^(.(json|xml))?$· requiredThe format in which the response is given, can be empty to use the default format
Default: .json
Responses
Source deleted
Add a source to an asset
Adds a detail as a source to an asset. The detail must have the same ledger account as the asset.
path Parameters
administration_idstring | integer · pattern:^\d+$· requiredThe unique identifier of the administration
A unique record identifier of an administration
idstring | integer · pattern:^\d+$· requiredA unique record identifier
formatstring · pattern:^(.(json|xml))?$· requiredThe format in which the response is given, can be empty to use the default format
Default: .json
Responses
A detail that is added as a source to an asset
idstring | integer · pattern:^\d+$A unique record identifier
asset_idstring | integer · pattern:^\d+$A unique record identifier
detail_idstring | integer · pattern:^\d+$A unique record identifier
Create an arbitrary value change
Creates an arbitrary value change for the asset at the given date. If the amount is larger than the value of the asset at the given date, a 422 error will be returned. Any existing linear value changes after the given date will be removed.
path Parameters
administration_idstring | integer · pattern:^\d+$· requiredThe unique identifier of the administration
A unique record identifier of an administration
idstring | integer · pattern:^\d+$· requiredA unique record identifier
formatstring · pattern:^(.(json|xml))?$· requiredThe format in which the response is given, can be empty to use the default format
Default: .json
Request Body
datestring · date · requiredHas to be after the purchase date of the asset, and cannot be in the future or in the locked period of the administration.
amountrequiredNote that a negative amount means the asset decreases in value while a positive amount means the asset increases in value.
descriptionstring · required
externally_bookedbooleanSet to true if the value change is already externally booked and doesn't need to be booked by Moneybird.
Default: false
Responses
A value change
typestring · enumEnum values:divestmentfull_depreciationmanualarbitrarylineardatestring · dateamountdescriptionnull | stringexternally_bookedbooleanasset_idstring | integer · pattern:^\d+$A unique record identifier
Create a divestment value change
Creates a divestment value change for the asset at the given date. The remaining value of the asset will be taken from the balance sheet and the profit will be booked as book result. The amount of the value change will automatically be set to the value of the asset at the given date. If the value change is created successfully, a disposal will be created for the asset. Any existing linear value changes after the given date will be removed.
path Parameters
administration_idstring | integer · pattern:^\d+$· requiredThe unique identifier of the administration
A unique record identifier of an administration
idstring | integer · pattern:^\d+$· requiredA unique record identifier
formatstring · pattern:^(.(json|xml))?$· requiredThe format in which the response is given, can be empty to use the default format
Default: .json
Request Body
datestring · date · requiredHas to be after the purchase date of the asset, and cannot be in the future or in the locked period of the administration.
Responses
A value change
typestring · enumEnum values:divestmentfull_depreciationmanualarbitrarylineardatestring · dateamountdescriptionnull | stringexternally_bookedbooleanasset_idstring | integer · pattern:^\d+$A unique record identifier
Create a full depreciation value change
Creates a full depreciation value change for the asset at the given date. The remaining value of the asset will be taken from the balance sheet. The amount of the value change will automatically be set to the value of the asset at the given date. If the value change is created successfully, a disposal will be created for the asset. Any existing linear value changes after the given date will be removed.
path Parameters
administration_idstring | integer · pattern:^\d+$· requiredThe unique identifier of the administration
A unique record identifier of an administration
idstring | integer · pattern:^\d+$· requiredA unique record identifier
formatstring · pattern:^(.(json|xml))?$· requiredThe format in which the response is given, can be empty to use the default format
Default: .json
Request Body
datestring · date · requiredHas to be after the purchase date of the asset, and cannot be in the future or in the locked period of the administration.
descriptionstring · required
Responses
A value change
typestring · enumEnum values:divestmentfull_depreciationmanualarbitrarylineardatestring · dateamountdescriptionnull | stringexternally_bookedbooleanasset_idstring | integer · pattern:^\d+$A unique record identifier
Create a manual value change
Creates a manual value change for the asset at the given date. If the amount is larger than the value of the asset at the given date, a 422 error will be returned.
path Parameters
administration_idstring | integer · pattern:^\d+$· requiredThe unique identifier of the administration
A unique record identifier of an administration
idstring | integer · pattern:^\d+$· requiredA unique record identifier
formatstring · pattern:^(.(json|xml))?$· requiredThe format in which the response is given, can be empty to use the default format
Default: .json
Request Body
datestring · date · requiredHas to be after the purchase date of the asset, and cannot be in the future or in the locked period of the administration.
amountrequiredNote that a negative amount means the asset decreases in value while a positive amount means the asset increases in value.
descriptionstring · required
externally_bookedbooleanSet to true if the value change is already externally booked and doesn't need to be booked by Moneybird.
Default: false
Responses
A value change
typestring · enumEnum values:divestmentfull_depreciationmanualarbitrarylineardatestring · dateamountdescriptionnull | stringexternally_bookedbooleanasset_idstring | integer · pattern:^\d+$A unique record identifier
Get an asset by ID
Returns the asset with the given ID.
path Parameters
administration_idstring | integer · pattern:^\d+$· requiredThe unique identifier of the administration
A unique record identifier of an administration
idstring | integer · pattern:^\d+$· requiredA unique record identifier
formatstring · pattern:^(.(json|xml))?$· requiredThe format in which the response is given, can be empty to use the default format
Default: .json
Responses
An asset
idstring | integer | null · pattern:^\d+$A unique record identifier
ledger_account_idstring | integer | null · pattern:^\d+$A unique record identifier
namestringpurchase_datestring · datepurchase_valuecurrent_valuevalue_change_planobject | nulldisposalvalue_changesobject[]sourcesobject[]
Delete an asset
Deletes the asset with the given ID.
path Parameters
administration_idstring | integer · pattern:^\d+$· requiredThe unique identifier of the administration
A unique record identifier of an administration
idstring | integer · pattern:^\d+$· requiredA unique record identifier
formatstring · pattern:^(.(json|xml))?$· requiredThe format in which the response is given, can be empty to use the default format
Default: .json
Responses
Asset deleted
Update an asset
Updates the asset with the given ID.
If the asset is active (the purchase date is in the past), only the name can be updated.
path Parameters
administration_idstring | integer · pattern:^\d+$· requiredThe unique identifier of the administration
A unique record identifier of an administration
idstring | integer · pattern:^\d+$· requiredA unique record identifier
formatstring · pattern:^(.(json|xml))?$· requiredThe format in which the response is given, can be empty to use the default format
Default: .json
Responses
Asset updated
idstring | integer | null · pattern:^\d+$A unique record identifier
ledger_account_idstring | integer | null · pattern:^\d+$A unique record identifier
namestringpurchase_datestring · datepurchase_valuecurrent_valuevalue_change_planobject | nulldisposalvalue_changesobject[]sourcesobject[]
List all assets
Returns a list of all assets.
The list is paginated. Use the per_page and page parameters to control the pagination.
path Parameters
administration_idstring | integer · pattern:^\d+$· requiredThe unique identifier of the administration
A unique record identifier of an administration
formatstring · pattern:^(.(json|xml))?$· requiredThe format in which the response is given, can be empty to use the default format
Default: .json
query Parameters
ledger_account_idstring | integer · pattern:^\d+$Filter on the ID of the ledger account
A unique record identifier
activeboolean | stringWhether to include only active assets
Default: trueper_pageinteger | string · min: 1 · max: 100 · pattern:^\d+$pageinteger | string
Responses
A list of assets
idstring | integer | null · pattern:^\d+$A unique record identifier
ledger_account_idstring | integer | null · pattern:^\d+$A unique record identifier
namestringpurchase_datestring · datepurchase_valuecurrent_valuevalue_change_planobject | nulldisposalvalue_changesobject[]sourcesobject[]
Create a new asset
Creates a new asset.
path Parameters
administration_idstring | integer · pattern:^\d+$· requiredThe unique identifier of the administration
A unique record identifier of an administration
formatstring · pattern:^(.(json|xml))?$· requiredThe format in which the response is given, can be empty to use the default format
Default: .json
Responses
Asset created
idstring | integer | null · pattern:^\d+$A unique record identifier
ledger_account_idstring | integer | null · pattern:^\d+$A unique record identifier
namestringpurchase_datestring · datepurchase_valuecurrent_valuevalue_change_planobject | nulldisposalvalue_changesobject[]sourcesobject[]