Moneybird API

Assets

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

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

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

POST /{administration_id}/assets/{id}/disposals{format}

curl --request POST \
  --url https://moneybird.com/api/v2/:administration_id/assets/:id/disposals:format \
  --header 'Content-Type: application/json' \
  --data '
{
  "date": "2025-11-19",
  "reason": "out_of_use"
}
'

shell

Show example in

Request Body Example

{
  "date": "2025-11-19",
  "reason": "out_of_use"
}

json

application/json

Example Responses

{
  "date": "2025-11-19",
  "reason": "out_of_use",
  "externally_booked": false,
  "asset_id": "471150214291391514"
}

json

application/json

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

DELETE /{administration_id}/assets/{id}/sources/{detail_id}{format}

curl --request DELETE \
  --url https://moneybird.com/api/v2/:administration_id/assets/:id/sources/:detail_id:format

shell

Show example in

Example Responses

No example

plain

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

POST /{administration_id}/assets/{id}/sources{format}

curl --request POST \
  --url https://moneybird.com/api/v2/:administration_id/assets/:id/sources:format \
  --header 'Content-Type: application/json' \
  --data '
{
  "detail_id": 471150206460626200
}
'

shell

Show example in

Request Body Example

{
  "detail_id": 471150206460626200
}

json

application/json

Example Responses

{
  "id": "471150206473209058",
  "asset_id": "471150206212113604",
  "detail_id": "471150206460626145"
}

json

application/json

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

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

curl --request POST \
  --url https://moneybird.com/api/v2/:administration_id/assets/:id/value_changes/arbitrary:format \
  --header 'Content-Type: application/json' \
  --data '
{
  "date": "2025-11-19",
  "amount": -10,
  "externally_booked": true,
  "description": "some description"
}
'

shell

Show example in

Request Body Example

{
  "date": "2025-11-19",
  "amount": -10,
  "externally_booked": true,
  "description": "some description"
}

json

application/json

Example Responses

{
  "type": "arbitrary",
  "date": "2025-11-19",
  "amount": "-10.0",
  "description": "some description",
  "externally_booked": true,
  "asset_id": "471150210413758095"
}

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.

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

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

curl --request POST \
  --url https://moneybird.com/api/v2/:administration_id/assets/:id/value_changes/divestment:format \
  --header 'Content-Type: application/json' \
  --data '
{
  "date": "2025-11-19"
}
'

shell

Show example in

Request Body Example

{
  "date": "2025-11-19"
}

json

application/json

Example Responses

{
  "type": "divestment",
  "date": "2025-11-19",
  "amount": "-12145.67",
  "description": null,
  "externally_booked": false,
  "asset_id": "471150213382277051"
}

json

application/json

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

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

curl --request POST \
  --url https://moneybird.com/api/v2/:administration_id/assets/:id/value_changes/full_depreciation:format \
  --header 'Content-Type: application/json' \
  --data '
{
  "date": "2025-11-19",
  "description": "some description"
}
'

shell

Show example in

Request Body Example

{
  "date": "2025-11-19",
  "description": "some description"
}

json

application/json

Example Responses

{
  "type": "full_depreciation",
  "date": "2025-11-19",
  "amount": "-12145.67",
  "description": "some description",
  "externally_booked": false,
  "asset_id": "471150207192532263"
}

json

application/json

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

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

curl --request POST \
  --url https://moneybird.com/api/v2/:administration_id/assets/:id/value_changes/manual:format \
  --header 'Content-Type: application/json' \
  --data '
{
  "date": "2025-11-19",
  "amount": -10,
  "externally_booked": true,
  "description": "some description"
}
'

shell

Show example in

Request Body Example

{
  "date": "2025-11-19",
  "amount": -10,
  "externally_booked": true,
  "description": "some description"
}

json

application/json

Example Responses

{
  "type": "manual",
  "date": "2025-11-19",
  "amount": "-10.0",
  "description": "some description",
  "externally_booked": true,
  "asset_id": "471150208329188779"
}

json

application/json

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[]

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

curl --request GET \
  --url https://moneybird.com/api/v2/:administration_id/assets/:id:format

shell

Show example in

Example Responses

{
  "id": "471150215065240668",
  "ledger_account_id": "471150215058949211",
  "name": "Asset 1",
  "purchase_date": "2025-06-01",
  "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": "2025-07-01",
      "amount": "-50.0",
      "description": "Value change 1",
      "externally_booked": false,
      "asset_id": "471150215065240668"
    },
    {
      "type": "arbitrary",
      "date": "2025-08-01",
      "amount": "-50.0",
      "description": "Value change 2",
      "externally_booked": false,
      "asset_id": "471150215065240668"
    },
    {
      "type": "arbitrary",
      "date": "2025-09-01",
      "amount": "-50.0",
      "description": "Value change 3",
      "externally_booked": false,
      "asset_id": "471150215065240668"
    },
    {
      "type": "arbitrary",
      "date": "2025-10-01",
      "amount": "-50.0",
      "description": "Value change 4",
      "externally_booked": false,
      "asset_id": "471150215065240668"
    }
  ],
  "sources": []
}

json

application/json

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

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

curl --request DELETE \
  --url https://moneybird.com/api/v2/:administration_id/assets/:id:format

shell

Show example in

Example Responses

No example

plain

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[]

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

curl --request PATCH \
  --url https://moneybird.com/api/v2/:administration_id/assets/:id:format \
  --header 'Content-Type: application/json' \
  --data '
{
  "asset": {
    "name": "New Name",
    "ledger_account_id": 471150209154418200,
    "purchase_date": "2025-11-19",
    "purchase_value": 10000,
    "value_change_plan_attributes": {
      "lifespan_in_years": 10,
      "residual_value": 500
    }
  }
}
'

shell

Show example in

Request Body Example

{
  "asset": {
    "name": "New Name",
    "ledger_account_id": 471150209154418200,
    "purchase_date": "2025-11-19",
    "purchase_value": 10000,
    "value_change_plan_attributes": {
      "lifespan_in_years": 10,
      "residual_value": 500
    }
  }
}

json

application/json

Example Responses

{
  "id": "471150209162806786",
  "ledger_account_id": "471150209154418176",
  "name": "New Name",
  "purchase_date": "2025-11-19",
  "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": []
}

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.

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
per_pageinteger | string · min: 1 · max: 100 · pattern: ^\d+$
pageinteger | string

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[]

GET /{administration_id}/assets{format}

curl --request GET \
  --url https://moneybird.com/api/v2/:administration_id/assets:format

shell

Show example in

Example Responses

[
  {
    "id": "471150211659466516",
    "ledger_account_id": "471150211654223635",
    "name": "Asset 3",
    "purchase_date": "2025-06-01",
    "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": "2025-07-01",
        "amount": "-50.0",
        "description": "Value change 1",
        "externally_booked": false,
        "asset_id": "471150211659466516"
      },
      {
        "type": "arbitrary",
        "date": "2025-08-01",
        "amount": "-50.0",
        "description": "Value change 2",
        "externally_booked": false,
        "asset_id": "471150211659466516"
      },
      {
        "type": "arbitrary",
        "date": "2025-09-01",
        "amount": "-50.0",
        "description": "Value change 3",
        "externally_booked": false,
        "asset_id": "471150211659466516"
      },
      {
        "type": "arbitrary",
        "date": "2025-10-01",
        "amount": "-50.0",
        "description": "Value change 4",
        "externally_booked": false,
        "asset_id": "471150211659466516"
      }
    ],
    "sources": []
  }
]

json

application/json

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[]

POST /{administration_id}/assets{format}

curl --request POST \
  --url https://moneybird.com/api/v2/:administration_id/assets:format \
  --header 'Content-Type: application/json' \
  --data '
{
  "asset": {
    "name": "Test Asset",
    "ledger_account_id": 471150206572823800,
    "purchase_date": "2025-11-19",
    "purchase_value": 1000,
    "value_change_plan_attributes": {
      "lifespan_in_years": 5,
      "residual_value": 100
    }
  }
}
'

shell

Show example in

Request Body Example

{
  "asset": {
    "name": "Test Asset",
    "ledger_account_id": 471150206572823800,
    "purchase_date": "2025-11-19",
    "purchase_value": 1000,
    "value_change_plan_attributes": {
      "lifespan_in_years": 5,
      "residual_value": 100
    }
  }
}

json

application/json

Example Responses

{
  "id": "471150206584358122",
  "ledger_account_id": "471150206572823785",
  "name": "Test Asset",
  "purchase_date": "2025-11-19",
  "purchase_value": "1000.0",
  "current_value": "1000.0",
  "value_change_plan": {
    "lifespan_in_years": 5,
    "residual_value": "100.0",
    "active": true,
    "monthly_depreciation": "15.0"
  },
  "disposal": null,
  "value_changes": [],
  "sources": []
}

json

application/json

Administrations Contacts

Moneybird API

Assets

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

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

POST

https://moneybird.com/api/v2

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

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

POST /{administration_id}/assets/{id}/disposals{format}

curl --request POST \
  --url https://moneybird.com/api/v2/:administration_id/assets/:id/disposals:format \
  --header 'Content-Type: application/json' \
  --data '
{
  "date": "2025-11-19",
  "reason": "out_of_use"
}
'

shell

Show example in

Request Body Example

{
  "date": "2025-11-19",
  "reason": "out_of_use"
}

json

application/json

Example Responses

{
  "date": "2025-11-19",
  "reason": "out_of_use",
  "externally_booked": false,
  "asset_id": "471150214291391514"
}

json

application/json

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

DELETE /{administration_id}/assets/{id}/sources/{detail_id}{format}

curl --request DELETE \
  --url https://moneybird.com/api/v2/:administration_id/assets/:id/sources/:detail_id:format

shell

Show example in

Example Responses

No example

plain

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

POST /{administration_id}/assets/{id}/sources{format}

curl --request POST \
  --url https://moneybird.com/api/v2/:administration_id/assets/:id/sources:format \
  --header 'Content-Type: application/json' \
  --data '
{
  "detail_id": 471150206460626200
}
'

shell

Show example in

Request Body Example

{
  "detail_id": 471150206460626200
}

json

application/json

Example Responses

{
  "id": "471150206473209058",
  "asset_id": "471150206212113604",
  "detail_id": "471150206460626145"
}

json

application/json

Create an arbitrary value change

POST

https://moneybird.com/api/v2

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

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

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

curl --request POST \
  --url https://moneybird.com/api/v2/:administration_id/assets/:id/value_changes/arbitrary:format \
  --header 'Content-Type: application/json' \
  --data '
{
  "date": "2025-11-19",
  "amount": -10,
  "externally_booked": true,
  "description": "some description"
}
'

shell

Show example in

Request Body Example

{
  "date": "2025-11-19",
  "amount": -10,
  "externally_booked": true,
  "description": "some description"
}

json

application/json

Example Responses

{
  "type": "arbitrary",
  "date": "2025-11-19",
  "amount": "-10.0",
  "description": "some description",
  "externally_booked": true,
  "asset_id": "471150210413758095"
}

json

application/json

Create a divestment value change

POST

https://moneybird.com/api/v2

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

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

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

curl --request POST \
  --url https://moneybird.com/api/v2/:administration_id/assets/:id/value_changes/divestment:format \
  --header 'Content-Type: application/json' \
  --data '
{
  "date": "2025-11-19"
}
'

shell

Show example in

Request Body Example

{
  "date": "2025-11-19"
}

json

application/json

Example Responses

{
  "type": "divestment",
  "date": "2025-11-19",
  "amount": "-12145.67",
  "description": null,
  "externally_booked": false,
  "asset_id": "471150213382277051"
}

json

application/json

Create a full depreciation value change

POST

https://moneybird.com/api/v2

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

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

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

curl --request POST \
  --url https://moneybird.com/api/v2/:administration_id/assets/:id/value_changes/full_depreciation:format \
  --header 'Content-Type: application/json' \
  --data '
{
  "date": "2025-11-19",
  "description": "some description"
}
'

shell

Show example in

Request Body Example

{
  "date": "2025-11-19",
  "description": "some description"
}

json

application/json

Example Responses

{
  "type": "full_depreciation",
  "date": "2025-11-19",
  "amount": "-12145.67",
  "description": "some description",
  "externally_booked": false,
  "asset_id": "471150207192532263"
}

json

application/json

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

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

curl --request POST \
  --url https://moneybird.com/api/v2/:administration_id/assets/:id/value_changes/manual:format \
  --header 'Content-Type: application/json' \
  --data '
{
  "date": "2025-11-19",
  "amount": -10,
  "externally_booked": true,
  "description": "some description"
}
'

shell

Show example in

Request Body Example

{
  "date": "2025-11-19",
  "amount": -10,
  "externally_booked": true,
  "description": "some description"
}

json

application/json

Example Responses

{
  "type": "manual",
  "date": "2025-11-19",
  "amount": "-10.0",
  "description": "some description",
  "externally_booked": true,
  "asset_id": "471150208329188779"
}

json

application/json

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[]

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

curl --request GET \
  --url https://moneybird.com/api/v2/:administration_id/assets/:id:format

shell

Show example in

Example Responses

{
  "id": "471150215065240668",
  "ledger_account_id": "471150215058949211",
  "name": "Asset 1",
  "purchase_date": "2025-06-01",
  "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": "2025-07-01",
      "amount": "-50.0",
      "description": "Value change 1",
      "externally_booked": false,
      "asset_id": "471150215065240668"
    },
    {
      "type": "arbitrary",
      "date": "2025-08-01",
      "amount": "-50.0",
      "description": "Value change 2",
      "externally_booked": false,
      "asset_id": "471150215065240668"
    },
    {
      "type": "arbitrary",
      "date": "2025-09-01",
      "amount": "-50.0",
      "description": "Value change 3",
      "externally_booked": false,
      "asset_id": "471150215065240668"
    },
    {
      "type": "arbitrary",
      "date": "2025-10-01",
      "amount": "-50.0",
      "description": "Value change 4",
      "externally_booked": false,
      "asset_id": "471150215065240668"
    }
  ],
  "sources": []
}

json

application/json

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

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

curl --request DELETE \
  --url https://moneybird.com/api/v2/:administration_id/assets/:id:format

shell

Show example in

Example Responses

No example

plain

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[]

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

curl --request PATCH \
  --url https://moneybird.com/api/v2/:administration_id/assets/:id:format \
  --header 'Content-Type: application/json' \
  --data '
{
  "asset": {
    "name": "New Name",
    "ledger_account_id": 471150209154418200,
    "purchase_date": "2025-11-19",
    "purchase_value": 10000,
    "value_change_plan_attributes": {
      "lifespan_in_years": 10,
      "residual_value": 500
    }
  }
}
'

shell

Show example in

Request Body Example

{
  "asset": {
    "name": "New Name",
    "ledger_account_id": 471150209154418200,
    "purchase_date": "2025-11-19",
    "purchase_value": 10000,
    "value_change_plan_attributes": {
      "lifespan_in_years": 10,
      "residual_value": 500
    }
  }
}

json

application/json

Example Responses

{
  "id": "471150209162806786",
  "ledger_account_id": "471150209154418176",
  "name": "New Name",
  "purchase_date": "2025-11-19",
  "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": []
}

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.

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
per_pageinteger | string · min: 1 · max: 100 · pattern: ^\d+$
pageinteger | string

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[]

GET /{administration_id}/assets{format}

curl --request GET \
  --url https://moneybird.com/api/v2/:administration_id/assets:format

shell

Show example in

Example Responses

[
  {
    "id": "471150211659466516",
    "ledger_account_id": "471150211654223635",
    "name": "Asset 3",
    "purchase_date": "2025-06-01",
    "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": "2025-07-01",
        "amount": "-50.0",
        "description": "Value change 1",
        "externally_booked": false,
        "asset_id": "471150211659466516"
      },
      {
        "type": "arbitrary",
        "date": "2025-08-01",
        "amount": "-50.0",
        "description": "Value change 2",
        "externally_booked": false,
        "asset_id": "471150211659466516"
      },
      {
        "type": "arbitrary",
        "date": "2025-09-01",
        "amount": "-50.0",
        "description": "Value change 3",
        "externally_booked": false,
        "asset_id": "471150211659466516"
      },
      {
        "type": "arbitrary",
        "date": "2025-10-01",
        "amount": "-50.0",
        "description": "Value change 4",
        "externally_booked": false,
        "asset_id": "471150211659466516"
      }
    ],
    "sources": []
  }
]

json

application/json

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[]

POST /{administration_id}/assets{format}

curl --request POST \
  --url https://moneybird.com/api/v2/:administration_id/assets:format \
  --header 'Content-Type: application/json' \
  --data '
{
  "asset": {
    "name": "Test Asset",
    "ledger_account_id": 471150206572823800,
    "purchase_date": "2025-11-19",
    "purchase_value": 1000,
    "value_change_plan_attributes": {
      "lifespan_in_years": 5,
      "residual_value": 100
    }
  }
}
'

shell

Show example in

Request Body Example

{
  "asset": {
    "name": "Test Asset",
    "ledger_account_id": 471150206572823800,
    "purchase_date": "2025-11-19",
    "purchase_value": 1000,
    "value_change_plan_attributes": {
      "lifespan_in_years": 5,
      "residual_value": 100
    }
  }
}

json

application/json

Example Responses

{
  "id": "471150206584358122",
  "ledger_account_id": "471150206572823785",
  "name": "Test Asset",
  "purchase_date": "2025-11-19",
  "purchase_value": "1000.0",
  "current_value": "1000.0",
  "value_change_plan": {
    "lifespan_in_years": 5,
    "residual_value": "100.0",
    "active": true,
    "monthly_depreciation": "15.0"
  },
  "disposal": null,
  "value_changes": [],
  "sources": []
}

json

application/json

Administrations Contacts