Moneybird logo
Moneybird API

Assets

Endpoint:https://moneybird.com/api/v2

Create a disposal

POST
https://moneybird.com/api/v2
/{administration_id}/assets/{id}/disposals{format}

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.

Create a disposal › path Parameters

  • administration_idstring | integer · pattern: ^\d+$ · required

    The unique identifier of the administration

    A unique record identifier of an administration

  • idstring | integer · pattern: ^\d+$ · required

    A unique record identifier

  • formatstring · pattern: ^(.(json|xml))?$ · required

    The format in which the response is given, can be empty to use the default format

    Default: .json

Create a disposal › Request Body

  • datestring · date · required

    Has 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 · required
    Enum values:
    out_of_use
    sold
    private_withdrawal
    divested

Create a disposal › Responses

A disposal

  • datestring · date
  • reasonstring · enum
    Enum values:
    out_of_use
    sold
    private_withdrawal
    divested
  • externally_bookedboolean
  • asset_idstring | integer · pattern: ^\d+$

    A unique record identifier

Delete a source

DELETE
https://moneybird.com/api/v2
/{administration_id}/assets/{id}/sources/{detail_id}{format}

Deletes a source from an asset. Does not delete the detail or the asset

Delete a source › path Parameters

  • administration_idstring | integer · pattern: ^\d+$ · required

    The unique identifier of the administration

    A unique record identifier of an administration

  • idstring | integer · pattern: ^\d+$ · required

    A unique record identifier

  • detail_idstring | integer · pattern: ^\d+$ · required

    A unique record identifier

  • formatstring · pattern: ^(.(json|xml))?$ · required

    The format in which the response is given, can be empty to use the default format

    Default: .json

Delete a source › Responses

Source deleted

No data returned

Add a source to an asset

POST
https://moneybird.com/api/v2
/{administration_id}/assets/{id}/sources{format}

Adds a detail as a source to an asset. The detail must have the same ledger account as the asset.

Add a source to an asset › path Parameters

  • administration_idstring | integer · pattern: ^\d+$ · required

    The unique identifier of the administration

    A unique record identifier of an administration

  • idstring | integer · pattern: ^\d+$ · required

    A unique record identifier

  • formatstring · pattern: ^(.(json|xml))?$ · required

    The format in which the response is given, can be empty to use the default format

    Default: .json

Add a source to an asset › Request Body

  • detail_idstring | integer · pattern: ^\d+$ · required

    A unique record identifier

Add a source to an asset › 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

POST
https://moneybird.com/api/v2
/{administration_id}/assets/{id}/value_changes/arbitrary{format}

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.

Create an arbitrary value change › path Parameters

  • administration_idstring | integer · pattern: ^\d+$ · required

    The unique identifier of the administration

    A unique record identifier of an administration

  • idstring | integer · pattern: ^\d+$ · required

    A unique record identifier

  • formatstring · pattern: ^(.(json|xml))?$ · required

    The format in which the response is given, can be empty to use the default format

    Default: .json

Create an arbitrary value change › Request Body

  • datestring · date · required

    Has to be after the purchase date of the asset, and cannot be in the future or in the locked period of the administration.

  • amountrequired

    Note that a negative amount means the asset decreases in value while a positive amount means the asset increases in value.

  • descriptionstring · required
  • externally_bookedboolean

    Set to true if the value change is already externally booked and doesn't need to be booked by Moneybird.

    Default: false

Create an arbitrary value change › Responses

A value change

  • typestring · enum
    Enum values:
    divestment
    full_depreciation
    manual
    arbitrary
    linear
  • datestring · date
  • amount
  • descriptionnull | string
  • externally_bookedboolean
  • asset_idstring | integer · pattern: ^\d+$

    A unique record identifier

Create a divestment value change

POST
https://moneybird.com/api/v2
/{administration_id}/assets/{id}/value_changes/divestment{format}

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.

Create a divestment value change › path Parameters

  • administration_idstring | integer · pattern: ^\d+$ · required

    The unique identifier of the administration

    A unique record identifier of an administration

  • idstring | integer · pattern: ^\d+$ · required

    A unique record identifier

  • formatstring · pattern: ^(.(json|xml))?$ · required

    The format in which the response is given, can be empty to use the default format

    Default: .json

Create a divestment value change › Request Body

  • datestring · date · required

    Has to be after the purchase date of the asset, and cannot be in the future or in the locked period of the administration.

Create a divestment value change › Responses

A value change

  • typestring · enum
    Enum values:
    divestment
    full_depreciation
    manual
    arbitrary
    linear
  • datestring · date
  • amount
  • descriptionnull | string
  • externally_bookedboolean
  • asset_idstring | integer · pattern: ^\d+$

    A unique record identifier

Create a full depreciation value change

POST
https://moneybird.com/api/v2
/{administration_id}/assets/{id}/value_changes/full_depreciation{format}

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.

Create a full depreciation value change › path Parameters

  • administration_idstring | integer · pattern: ^\d+$ · required

    The unique identifier of the administration

    A unique record identifier of an administration

  • idstring | integer · pattern: ^\d+$ · required

    A unique record identifier

  • formatstring · pattern: ^(.(json|xml))?$ · required

    The format in which the response is given, can be empty to use the default format

    Default: .json

Create a full depreciation value change › Request Body

  • datestring · date · required

    Has 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

Create a full depreciation value change › Responses

A value change

  • typestring · enum
    Enum values:
    divestment
    full_depreciation
    manual
    arbitrary
    linear
  • datestring · date
  • amount
  • descriptionnull | string
  • externally_bookedboolean
  • asset_idstring | integer · pattern: ^\d+$

    A unique record identifier

Create a manual value change

POST
https://moneybird.com/api/v2
/{administration_id}/assets/{id}/value_changes/manual{format}

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.

Create a manual value change › path Parameters

  • administration_idstring | integer · pattern: ^\d+$ · required

    The unique identifier of the administration

    A unique record identifier of an administration

  • idstring | integer · pattern: ^\d+$ · required

    A unique record identifier

  • formatstring · pattern: ^(.(json|xml))?$ · required

    The format in which the response is given, can be empty to use the default format

    Default: .json

Create a manual value change › Request Body

  • datestring · date · required

    Has to be after the purchase date of the asset, and cannot be in the future or in the locked period of the administration.

  • amountrequired

    Note that a negative amount means the asset decreases in value while a positive amount means the asset increases in value.

  • descriptionstring · required
  • externally_bookedboolean

    Set to true if the value change is already externally booked and doesn't need to be booked by Moneybird.

    Default: false

Create a manual value change › Responses

A value change

  • typestring · enum
    Enum values:
    divestment
    full_depreciation
    manual
    arbitrary
    linear
  • datestring · date
  • amount
  • descriptionnull | string
  • externally_bookedboolean
  • asset_idstring | integer · pattern: ^\d+$

    A unique record identifier

Get an asset by ID

GET
https://moneybird.com/api/v2
/{administration_id}/assets/{id}{format}

Returns the asset with the given ID.

Get an asset by ID › path Parameters

  • administration_idstring | integer · pattern: ^\d+$ · required

    The unique identifier of the administration

    A unique record identifier of an administration

  • idstring | integer · pattern: ^\d+$ · required

    A unique record identifier

  • formatstring · pattern: ^(.(json|xml))?$ · required

    The format in which the response is given, can be empty to use the default format

    Default: .json

Get an asset by ID › Responses

An asset

  • idstring | integer | null · pattern: ^\d+$

    A unique record identifier

  • ledger_account_idstring | integer | null · pattern: ^\d+$

    A unique record identifier

  • namestring
  • purchase_datestring · date
  • purchase_value
  • current_value
  • value_change_planobject | null
  • disposal
  • value_changesobject[]
  • sourcesobject[]

Delete an asset

DELETE
https://moneybird.com/api/v2
/{administration_id}/assets/{id}{format}

Deletes the asset with the given ID.

Delete an asset › path Parameters

  • administration_idstring | integer · pattern: ^\d+$ · required

    The unique identifier of the administration

    A unique record identifier of an administration

  • idstring | integer · pattern: ^\d+$ · required

    A unique record identifier

  • formatstring · pattern: ^(.(json|xml))?$ · required

    The format in which the response is given, can be empty to use the default format

    Default: .json

Delete an asset › Responses

Asset deleted

No data returned

Update an asset

PATCH
https://moneybird.com/api/v2
/{administration_id}/assets/{id}{format}

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.

Update an asset › path Parameters

  • administration_idstring | integer · pattern: ^\d+$ · required

    The unique identifier of the administration

    A unique record identifier of an administration

  • idstring | integer · pattern: ^\d+$ · required

    A unique record identifier

  • formatstring · pattern: ^(.(json|xml))?$ · required

    The format in which the response is given, can be empty to use the default format

    Default: .json

Update an asset › Request Body

  • assetobject · required

Update an asset › Responses

Asset updated

  • idstring | integer | null · pattern: ^\d+$

    A unique record identifier

  • ledger_account_idstring | integer | null · pattern: ^\d+$

    A unique record identifier

  • namestring
  • purchase_datestring · date
  • purchase_value
  • current_value
  • value_change_planobject | null
  • disposal
  • value_changesobject[]
  • sourcesobject[]

List all assets

GET
https://moneybird.com/api/v2
/{administration_id}/assets{format}

Returns a list of all assets.

List all assets › path Parameters

  • administration_idstring | integer · pattern: ^\d+$ · required

    The unique identifier of the administration

    A unique record identifier of an administration

  • formatstring · pattern: ^(.(json|xml))?$ · required

    The format in which the response is given, can be empty to use the default format

    Default: .json

List all assets › query Parameters

  • ledger_account_idstring | integer · pattern: ^\d+$

    Filter on the ID of the ledger account

    A unique record identifier

  • activeboolean | string

    Whether to include only active assets

    Default: true

List all assets › 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

  • namestring
  • purchase_datestring · date
  • purchase_value
  • current_value
  • value_change_planobject | null
  • disposal
  • value_changesobject[]
  • sourcesobject[]

Create a new asset

POST
https://moneybird.com/api/v2
/{administration_id}/assets{format}

Creates a new asset.

Create a new asset › path Parameters

  • administration_idstring | integer · pattern: ^\d+$ · required

    The unique identifier of the administration

    A unique record identifier of an administration

  • formatstring · pattern: ^(.(json|xml))?$ · required

    The format in which the response is given, can be empty to use the default format

    Default: .json

Create a new asset › Request Body

  • assetobject

Create a new asset › Responses

Asset created

  • idstring | integer | null · pattern: ^\d+$

    A unique record identifier

  • ledger_account_idstring | integer | null · pattern: ^\d+$

    A unique record identifier

  • namestring
  • purchase_datestring · date
  • purchase_value
  • current_value
  • value_change_planobject | null
  • disposal
  • value_changesobject[]
  • sourcesobject[]
Workflows