Assets

type

string · enum

Enum values:

divestment

full_depreciation

manual

arbitrary

linear

date

string · date

number

description

null | string

externally_booked

boolean

asset_id

identifier · pattern: ^\d+$

A unique record identifier

POST/{administration_id}/assets/{id}/value_changes/arbitrary{format}

curl https://moneybird.com/api/v2/:administration_id/assets/:id/value_changes/arbitrary:format \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "date": "2026-09-23",
  "amount": -10,
  "externally_booked": true,
  "description": "some description"
}'

Example Request Body

{
  "date": "2026-09-23",
  "amount": -10,
  "externally_booked": true,
  "description": "some description"
}

json

application/json

Example Responses

{
  "type": "arbitrary",
  "date": "2026-09-23",
  "amount": "-10.0",
  "description": "some description",
  "externally_booked": true,
  "asset_id": "499053834612508652"
}

json

application/json

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.

Required scope(s)

documents

Create a divestment value change › path Parameters

administration_id

administration_id · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

id

identifier · pattern: ^\d+$ · required

A unique record identifier

format

string · 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

date

string · 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

type

string · enum

Enum values:

divestment

full_depreciation

manual

arbitrary

linear

date

string · date

number

description

null | string

externally_booked

boolean

asset_id

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

Required scope(s)

documents

Create a full depreciation value change › path Parameters

administration_id

administration_id · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

id

identifier · pattern: ^\d+$ · required

A unique record identifier

format

string · 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

date

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

description

string · required

Create a full depreciation value change › Responses

A value change

type

string · enum

Enum values:

divestment

full_depreciation

manual

arbitrary

linear

date

string · date

number

description

null | string

externally_booked

boolean

asset_id

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

Required scope(s)

documents

Create a manual value change › path Parameters

administration_id

administration_id · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

id

identifier · pattern: ^\d+$ · required

A unique record identifier

format

string · 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

date

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

money · required

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

description

string · required

externally_booked

boolean

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

type

string · enum

Enum values:

divestment

full_depreciation

manual

arbitrary

linear

date

string · date

number

description

null | string

externally_booked

boolean

asset_id

identifier · pattern: ^\d+$

A unique record identifier

POST/{administration_id}/assets/{id}/value_changes/manual{format}

curl https://moneybird.com/api/v2/:administration_id/assets/:id/value_changes/manual:format \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "date": "2026-09-23",
  "amount": -10,
  "externally_booked": true,
  "description": "some description"
}'

Example Request Body

{
  "date": "2026-09-23",
  "amount": -10,
  "externally_booked": true,
  "description": "some description"
}

json

application/json

Example Responses

{
  "type": "manual",
  "date": "2026-09-23",
  "amount": "-10.0",
  "description": "some description",
  "externally_booked": true,
  "asset_id": "499053827457025375"
}

json

application/json

Create linear value changes retroactively

POST

https://moneybird.com/api/v2

/{administration_id}/assets/{id}/value_changes/retroactive_linear_value_changes{format}

Creates linear value changes that were not created yet. Use this if a new asset has just been created or if an arbitrary value change was created and the missing linear value changes need to be recalculated and recreated. This will create missing value changes for all months between the purchase date of the asset or the date of the last arbitrary value change and the last month of the administration. Requires a asset with a value change plan (so no assets that belong to a land or building category). Also requires that the asset has remaining value, has missing value changes at the end of some months and that all missing linear value changes are outside the locked period. This process will be performed asynchronously so no result will be returned. Use Get /assets/:id to check the result after a while.

Required scope(s)

documents

Create linear value changes retroactively › path Parameters

administration_id

administration_id · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

id

identifier · pattern: ^\d+$ · required

A unique record identifier

format

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

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

Default: .json

Create linear value changes retroactively › Responses

No content

No data returned

Get an asset by ID

GET

https://moneybird.com/api/v2

/{administration_id}/assets/{id}{format}

Returns the asset with the given ID.

Required scope(s)

documents

Get an asset by ID › path Parameters

administration_id

administration_id · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

id

identifier · pattern: ^\d+$ · required

A unique record identifier

format

string · 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

id

identifier_nullable · pattern: ^\d+$

A unique record identifier

ledger_account_id

identifier_nullable · pattern: ^\d+$

A unique record identifier

name

string

purchase_date

string · date

number

Purchase value reduced by any reinvestment reserve purchase applied to the asset.

number

value_change_plan

object | null

GET/{administration_id}/assets/{id}{format}

curl https://moneybird.com/api/v2/:administration_id/assets/:id:format \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "id": "499053827958244749",
  "ledger_account_id": "499053827949856140",
  "name": "Asset 1",
  "purchase_date": "2020-09-23",
  "purchase_value": "12345.67",
  "calculated_purchase_value": "12345.67",
  "current_value": "0.0",
  "value_change_plan": {
    "lifespan_in_years": 5,
    "residual_value": "10.0",
    "active": false,
    "monthly_depreciation": "205.59"
  },
  "disposal": {
    "date": "2026-09-23",
    "reason": "out_of_use",
    "externally_booked": false,
    "asset_id": "499053827958244749",
    "reinvestment_reserve_sale": null
  },
  "value_changes": [
    {
      "type": "manual",
      "date": "2026-09-23",
      "amount": "-12345.67",
      "description": "Depreciation",
      "externally_booked": false,
      "asset_id": "499053827958244749"
    }
  ],
  "sources": [],
  "reinvestment_reserve_purchase": null
}

json

application/json

Delete an asset

DELETE

https://moneybird.com/api/v2

/{administration_id}/assets/{id}{format}

Deletes the asset with the given ID.

Required scope(s)

documents

Delete an asset › path Parameters

administration_id

administration_id · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

id

identifier · pattern: ^\d+$ · required

A unique record identifier

format

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

Required scope(s)

documents

Update an asset › path Parameters

administration_id

administration_id · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

id

identifier · pattern: ^\d+$ · required

A unique record identifier

format

string · 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

object · required

Update an asset › Responses

Asset updated

id

identifier_nullable · pattern: ^\d+$

A unique record identifier

ledger_account_id

identifier_nullable · pattern: ^\d+$

A unique record identifier

name

string

purchase_date

string · date

number

Purchase value reduced by any reinvestment reserve purchase applied to the asset.

number

value_change_plan

object | null

PATCH/{administration_id}/assets/{id}{format}

curl https://moneybird.com/api/v2/:administration_id/assets/:id:format \
  --request PATCH \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "asset": {
    "name": "New Name",
    "ledger_account_id": 499053824703464600,
    "purchase_date": "2026-09-23",
    "purchase_value": 10000,
    "value_change_plan_attributes": {
      "lifespan_in_years": 10,
      "residual_value": 500
    }
  }
}'

Example Request Body

{
  "asset": {
    "name": "New Name",
    "ledger_account_id": 499053824703464600,
    "purchase_date": "2026-09-23",
    "purchase_value": 10000,
    "value_change_plan_attributes": {
      "lifespan_in_years": 10,
      "residual_value": 500
    }
  }
}

json

application/json

Example Responses

{
  "id": "499053824719193248",
  "ledger_account_id": "499053824703464606",
  "name": "New Name",
  "purchase_date": "2026-09-23",
  "purchase_value": "10000.0",
  "calculated_purchase_value": "10000.0",
  "current_value": "10000.0",
  "value_change_plan": {
    "lifespan_in_years": 10,
    "residual_value": "500.0",
    "active": true,
    "monthly_depreciation": "79.17"
  },
  "disposal": null,
  "value_changes": [],
  "sources": [],
  "reinvestment_reserve_purchase": null
}

json

application/json

List all assets

GET

https://moneybird.com/api/v2

/{administration_id}/assets{format}

Returns a list of all assets. The list is paginated. Use the per_page and page parameters to control the pagination.

Required scope(s)

documents

List all assets › path Parameters

administration_id

administration_id · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

format

string · 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_id

identifier · pattern: ^\d+$

Filter on the ID of the ledger account

A unique record identifier

active

boolean | string

Whether to include only active assets

Default: true

per_page

integer | string · min: 1 · max: 100 · pattern: ^\d+$

page

integer | string

List all assets › Responses

200

A list of assets

asset_response[]

id

identifier_nullable · pattern: ^\d+$

A unique record identifier

ledger_account_id

identifier_nullable · pattern: ^\d+$

A unique record identifier

name

string

purchase_date

string · date

number

Purchase value reduced by any reinvestment reserve purchase applied to the asset.

number

value_change_plan

object | null

GET/{administration_id}/assets{format}

curl https://moneybird.com/api/v2/:administration_id/assets:format \
  --header 'Authorization: Bearer <token>'

Example Responses

[
  {
    "id": "499053842647746289",
    "ledger_account_id": "499053842638309104",
    "name": "Asset 1",
    "purchase_date": "2026-04-01",
    "purchase_value": "12345.67",
    "calculated_purchase_value": "12345.67",
    "current_value": "12145.67",
    "value_change_plan": {
      "lifespan_in_years": 5,
      "residual_value": "10.0",
      "active": true,
      "monthly_depreciation": "216.71"
    },
    "disposal": null,
    "value_changes": [
      {
        "type": "arbitrary",
        "date": "2026-05-01",
        "amount": "-50.0",
        "description": "Value change 1",
        "externally_booked": false,
        "asset_id": "499053842647746289"
      },
      {
        "type": "arbitrary",
        "date": "2026-06-01",
        "amount": "-50.0",
        "description": "Value change 2",
        "externally_booked": false,
        "asset_id": "499053842647746289"
      },
      {
        "type": "arbitrary",
        "date": "2026-07-01",
        "amount": "-50.0",
        "description": "Value change 3",
        "externally_booked": false,
        "asset_id": "499053842647746289"
      },
      {
        "type": "arbitrary",
        "date": "2026-08-01",
        "amount": "-50.0",
        "description": "Value change 4",
        "externally_booked": false,
        "asset_id": "499053842647746289"
      }
    ],
    "sources": [],
    "reinvestment_reserve_purchase": null
  }
]

json

application/json

Create a new asset

POST

https://moneybird.com/api/v2

/{administration_id}/assets{format}

Creates a new asset.

An asset on a land or building ledger account never has a depreciation plan. Leave out value_change_plan_attributes for those. Every other ledger account requires one.

Required scope(s)

documents

Create a new asset › path Parameters

administration_id

administration_id · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

format

string · 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

object

Create a new asset › Responses

Asset created

id

identifier_nullable · pattern: ^\d+$

A unique record identifier

ledger_account_id

identifier_nullable · pattern: ^\d+$

A unique record identifier

name

string

purchase_date

string · date

number

Purchase value reduced by any reinvestment reserve purchase applied to the asset.

number

value_change_plan

object | null