Moneybird API

Assets

Endpointhttps://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_id

string | integer · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

id

string | integer · 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 disposal › 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.

reason

string · enum · required

Enum values:

out_of_use

sold

private_withdrawal

divested

Create a disposal › Responses

A disposal

date

string · date

reason

string · enum

Enum values:

out_of_use

sold

private_withdrawal

divested

externally_booked

boolean

asset_id

string | 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-25",
  "reason": "out_of_use"
}
'

shell

Example Request Body

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

json

application/json

Example Responses

{
  "date": "2025-11-25",
  "reason": "out_of_use",
  "externally_booked": false,
  "asset_id": "471699955580405637"
}

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_id

string | integer · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

id

string | integer · pattern: ^\d+$ · required

A unique record identifier

detail_id

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

Example Responses

No example specified for this content type

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_id

string | integer · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

id

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

Add a source to an asset › Request Body

detail_id

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

id

string | integer · pattern: ^\d+$

A unique record identifier

asset_id

string | integer · pattern: ^\d+$

A unique record identifier

detail_id

string | 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": 471699963377616640
}
'

shell

Example Request Body

{
  "detail_id": 471699963377616640
}

json

application/json

Example Responses

{
  "id": "471699963391248127",
  "asset_id": "471699963098695385",
  "detail_id": "471699963377616638"
}

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_id

string | integer · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

id

string | integer · 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 an arbitrary 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.

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 an arbitrary value change › Responses

A value change

type

string · enum

Enum values:

divestment

full_depreciation

manual

arbitrary

linear

date

string · date

description

null | string

externally_booked

boolean

asset_id

string | 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-25",
  "amount": -10,
  "externally_booked": true,
  "description": "some description"
}
'

shell

Example Request Body

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

json

application/json

Example Responses

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

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_id

string | integer · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

id

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

description

null | string

externally_booked

boolean

asset_id

string | 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-25"
}
'

shell

Example Request Body

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

json

application/json

Example Responses

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

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_id

string | integer · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

id

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

description

null | string

externally_booked

boolean

asset_id

string | 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-25",
  "description": "some description"
}
'

shell

Example Request Body

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

json

application/json

Example Responses

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

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_id

string | integer · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

id

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

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

description

null | string

externally_booked

boolean

asset_id

string | 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-25",
  "amount": -10,
  "externally_booked": true,
  "description": "some description"
}
'

shell

Example Request Body

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

json

application/json

Example Responses

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

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_id

string | integer · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

id

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

string | integer | null · pattern: ^\d+$

A unique record identifier

ledger_account_id

string | integer | null · pattern: ^\d+$

A unique record identifier

name

string

purchase_date

string · date

value_change_plan

object | null

object[]

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

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

shell

Example Responses

{
  "id": "471699954887296840",
  "ledger_account_id": "471699954881005383",
  "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": "471699954887296840"
    },
    {
      "type": "arbitrary",
      "date": "2025-08-01",
      "amount": "-50.0",
      "description": "Value change 2",
      "externally_booked": false,
      "asset_id": "471699954887296840"
    },
    {
      "type": "arbitrary",
      "date": "2025-09-01",
      "amount": "-50.0",
      "description": "Value change 3",
      "externally_booked": false,
      "asset_id": "471699954887296840"
    },
    {
      "type": "arbitrary",
      "date": "2025-10-01",
      "amount": "-50.0",
      "description": "Value change 4",
      "externally_booked": false,
      "asset_id": "471699954887296840"
    }
  ],
  "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_id

string | integer · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

id

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

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

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

shell

Example Responses

No example specified for this content type

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_id

string | integer · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

id

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

string | integer | null · pattern: ^\d+$

A unique record identifier

ledger_account_id

string | integer | null · pattern: ^\d+$

A unique record identifier

name

string

purchase_date

string · date

value_change_plan

object | null

object[]

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"
  }
}
'

shell

Example Request Body

{
  "asset": {
    "name": "New Name"
  }
}

json

application/json

Example Responses

{
  "id": "471699958439871684",
  "ledger_account_id": "471699958433580227",
  "name": "New Name",
  "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": "471699958439871684"
    },
    {
      "type": "arbitrary",
      "date": "2025-08-01",
      "amount": "-50.0",
      "description": "Value change 2",
      "externally_booked": false,
      "asset_id": "471699958439871684"
    },
    {
      "type": "arbitrary",
      "date": "2025-09-01",
      "amount": "-50.0",
      "description": "Value change 3",
      "externally_booked": false,
      "asset_id": "471699958439871684"
    },
    {
      "type": "arbitrary",
      "date": "2025-10-01",
      "amount": "-50.0",
      "description": "Value change 4",
      "externally_booked": false,
      "asset_id": "471699958439871684"
    }
  ],
  "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_id

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

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

object[]

id

string | integer | null · pattern: ^\d+$

A unique record identifier

ledger_account_id

string | integer | null · pattern: ^\d+$

A unique record identifier

name

string

purchase_date

string · date

value_change_plan

object | null

object[]

GET/{administration_id}/assets{format}

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

shell

Example Responses

[
  {
    "id": "471699952402171450",
    "ledger_account_id": "471699952396928569",
    "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": "471699952402171450"
      },
      {
        "type": "arbitrary",
        "date": "2025-08-01",
        "amount": "-50.0",
        "description": "Value change 2",
        "externally_booked": false,
        "asset_id": "471699952402171450"
      },
      {
        "type": "arbitrary",
        "date": "2025-09-01",
        "amount": "-50.0",
        "description": "Value change 3",
        "externally_booked": false,
        "asset_id": "471699952402171450"
      },
      {
        "type": "arbitrary",
        "date": "2025-10-01",
        "amount": "-50.0",
        "description": "Value change 4",
        "externally_booked": false,
        "asset_id": "471699952402171450"
      }
    ],
    "sources": []
  },
  {
    "id": "471699952669558366",
    "ledger_account_id": "471699952664315485",
    "name": "Asset 2",
    "purchase_date": "2019-11-25",
    "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": "2025-11-25",
      "reason": "out_of_use",
      "externally_booked": false,
      "asset_id": "471699952669558366"
    },
    "value_changes": [
      {
        "type": "manual",
        "date": "2025-11-25",
        "amount": "-12345.67",
        "description": "Depreciation",
        "externally_booked": false,
        "asset_id": "471699952669558366"
      }
    ],
    "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_id

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

string | integer | null · pattern: ^\d+$

A unique record identifier

ledger_account_id

string | integer | null · pattern: ^\d+$

A unique record identifier

name

string

purchase_date

string · date

value_change_plan

object | null

object[]

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": 471699956473792450,
    "purchase_date": "2025-11-25",
    "purchase_value": 1000,
    "value_change_plan_attributes": {
      "lifespan_in_years": 5,
      "residual_value": 100
    }
  }
}
'

shell

Example Request Body

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

json

application/json

Example Responses

{
  "id": "471699956487423961",
  "ledger_account_id": "471699956473792472",
  "name": "Test Asset",
  "purchase_date": "2025-11-25",
  "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