Identities

Identities are the different profiles or trade names under which you can send documents from your administration.

Retrieve the default identity

GET

https://moneybird.com/api/v2

/{administration_id}/identities/default{format}

Returns the default identity of this administration.

Required scope(s)

settings

Retrieve the default identity › 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

Retrieve the default identity › Responses

200

A list of identities

identity_response

id

identifier · pattern: ^\d+$

A unique record identifier

administration_id

administration_id · pattern: ^\d+$

A unique record identifier

company_name

string | null

city

string | null

country

string | null

zipcode

string | null

address1

string | null

address2

string | null

email

string | null

phone

string | null

bank_account_name

string | null

bank_account_number

string | null

bank_account_bic

string | null

custom_field_value_response[]

updated_at

timestamp · date-time

created_at

timestamp · date-time

chamber_of_commerce

string | null

tax_number

string | null

GET/{administration_id}/identities/default{format}

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

Example Responses

{
  "id": "499053793810318443",
  "administration_id": 123,
  "company_name": "Parkietje B.V.",
  "city": "Enschede",
  "country": "NL",
  "zipcode": "7523XD",
  "address1": "Brouwerijstraat 26",
  "address2": null,
  "email": "info@dev.null.moneybird.net",
  "phone": "0612345678",
  "bank_account_name": null,
  "bank_account_number": "NL50TEST0166567191",
  "bank_account_bic": null,
  "custom_fields": [],
  "updated_at": "2026-09-23T09:13:27.378Z",
  "created_at": "2026-09-23T09:13:27.378Z",
  "chamber_of_commerce": "08155914",
  "tax_number": "NL817575546B01"
}

json

application/json

Updates the default identity

PATCH

https://moneybird.com/api/v2

/{administration_id}/identities/default{format}

Updates the default identity.

Required scope(s)

settings

Updates the default identity › 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

Updates the default identity › Request Body

object

Updates the default identity › Responses

A list of identities

identity_response

id

identifier · pattern: ^\d+$

A unique record identifier

administration_id

administration_id · pattern: ^\d+$

A unique record identifier

company_name

string | null

city

string | null

country

string | null

zipcode

string | null

address1

string | null

address2

string | null

email

string | null

phone

string | null

bank_account_name

string | null

bank_account_number

string | null

bank_account_bic

string | null

custom_field_value_response[]

updated_at

timestamp · date-time

created_at

timestamp · date-time

chamber_of_commerce

string | null

tax_number

string | null

PATCH/{administration_id}/identities/default{format}

curl https://moneybird.com/api/v2/:administration_id/identities/default:format \
  --request PATCH \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "identity": {
    "company_name": "Second B.V."
  }
}'

Example Request Body

{
  "identity": {
    "company_name": "Second B.V."
  }
}

json

application/json

Example Responses

{
  "id": "499053793810318443",
  "administration_id": 123,
  "company_name": "Second B.V.",
  "city": "Enschede",
  "country": "NL",
  "zipcode": "7523XD",
  "address1": "Brouwerijstraat 26",
  "address2": null,
  "email": "info@dev.null.moneybird.net",
  "phone": "0612345678",
  "bank_account_name": null,
  "bank_account_number": "NL50TEST0166567191",
  "bank_account_bic": null,
  "custom_fields": [],
  "updated_at": "2026-09-23T09:17:06.616Z",
  "created_at": "2026-09-23T09:13:27.378Z",
  "chamber_of_commerce": "08155914",
  "tax_number": "NL817575546B01"
}

json

application/json

Retrieve identity by given id

GET

https://moneybird.com/api/v2

/{administration_id}/identities/{id}{format}

Returns the identity with the given id.

Required scope(s)

settings

Retrieve identity by given 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

Retrieve identity by given id › Responses

A identity

identity_response

id

identifier · pattern: ^\d+$

A unique record identifier

administration_id

administration_id · pattern: ^\d+$

A unique record identifier

company_name

string | null

city

string | null

country

string | null

zipcode

string | null

address1

string | null

address2

string | null

email

string | null

phone

string | null

bank_account_name

string | null

bank_account_number

string | null

bank_account_bic

string | null

custom_field_value_response[]

updated_at

timestamp · date-time

created_at

timestamp · date-time

chamber_of_commerce

string | null

tax_number

string | null

GET/{administration_id}/identities/{id}{format}

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

Example Responses

{
  "id": "499054023592117487",
  "administration_id": 123,
  "company_name": "Parkietje B.V.",
  "city": "Den Haag",
  "country": "NL",
  "zipcode": "4321XY",
  "address1": "Brouwersplein 62",
  "address2": null,
  "email": "info@dev.null.moneybird.net",
  "phone": "1234-5678900",
  "bank_account_name": "Foobar B.V.",
  "bank_account_number": "NL80TEST0252789466",
  "bank_account_bic": null,
  "custom_fields": [],
  "updated_at": "2026-09-23T09:17:06.519Z",
  "created_at": "2026-09-23T09:17:06.519Z",
  "chamber_of_commerce": "08155914",
  "tax_number": "NL817575546B01"
}

json

application/json

Deletes an identity

DELETE

https://moneybird.com/api/v2

/{administration_id}/identities/{id}{format}

Deletes an identity. Always returns a 204 status code even if the identity could not be deleted.

Required scope(s)

settings

Deletes an identity › 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

Deletes an identity › Responses

Identity deleted

No data returned

Updates an identity

PATCH

https://moneybird.com/api/v2

/{administration_id}/identities/{id}{format}

Updates an identity.

Required scope(s)

settings

Updates an identity › 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

Updates an identity › Request Body

object

Updates an identity › Responses

Identity updated

identity_response

id

identifier · pattern: ^\d+$

A unique record identifier

administration_id

administration_id · pattern: ^\d+$

A unique record identifier

company_name

string | null

city

string | null

country

string | null

zipcode

string | null

address1

string | null

address2

string | null

email

string | null

phone

string | null

bank_account_name

string | null

bank_account_number

string | null

bank_account_bic

string | null

custom_field_value_response[]

updated_at

timestamp · date-time

created_at

timestamp · date-time

chamber_of_commerce

string | null

tax_number

string | null

PATCH/{administration_id}/identities/{id}{format}

curl https://moneybird.com/api/v2/:administration_id/identities/:id:format \
  --request PATCH \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "identity": {
    "company_name": "Second B.V."
  }
}'

Example Request Body

{
  "identity": {
    "company_name": "Second B.V."
  }
}

json

application/json

Example Responses

{
  "id": "499054023493551329",
  "administration_id": 123,
  "company_name": "Second B.V.",
  "city": "Den Haag",
  "country": "NL",
  "zipcode": "4321XY",
  "address1": "Brouwersplein 62",
  "address2": null,
  "email": "info@dev.null.moneybird.net",
  "phone": "1234-5678900",
  "bank_account_name": "Foobar B.V.",
  "bank_account_number": "NL80TEST0252789466",
  "bank_account_bic": null,
  "custom_fields": [],
  "updated_at": "2026-09-23T09:17:06.448Z",
  "created_at": "2026-09-23T09:17:06.426Z",
  "chamber_of_commerce": "08155914",
  "tax_number": "NL817575546B01"
}

json

application/json

Retrieve identities

GET

https://moneybird.com/api/v2

/{administration_id}/identities{format}

An administration can have multiple identities, for example to cover multiple tradenames or offices. This does not include the default identity.

Required scope(s)

settings

Retrieve identities › 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

Retrieve identities › Responses

200

A list of identities

identity_response[]

identity_response

id

identifier · pattern: ^\d+$

A unique record identifier

administration_id

administration_id · pattern: ^\d+$

A unique record identifier

company_name

string | null

city

string | null

country

string | null

zipcode

string | null

address1

string | null

address2

string | null

email

string | null

phone

string | null

bank_account_name

string | null

bank_account_number

string | null

bank_account_bic

string | null

custom_field_value_response[]

updated_at

timestamp · date-time

created_at

timestamp · date-time

chamber_of_commerce

string | null

tax_number

string | null

GET/{administration_id}/identities{format}

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

Example Responses

[
  {
    "id": "499054023067829411",
    "administration_id": 123,
    "company_name": "Parkietje B.V.",
    "city": "Den Haag",
    "country": "NL",
    "zipcode": "4321XY",
    "address1": "Brouwersplein 62",
    "address2": null,
    "email": "info@dev.null.moneybird.net",
    "phone": "1234-5678900",
    "bank_account_name": "Foobar B.V.",
    "bank_account_number": "NL80TEST0252789466",
    "bank_account_bic": null,
    "custom_fields": [],
    "updated_at": "2026-09-23T09:17:06.020Z",
    "created_at": "2026-09-23T09:17:06.020Z",
    "chamber_of_commerce": "08155914",
    "tax_number": "NL817575546B01"
  }
]

json

application/json

Creates an identity

POST

https://moneybird.com/api/v2

/{administration_id}/identities{format}

Most fields for an identity are required. You can provide zero or more custom fields, for each provided custom field value the id and value are required.

Required scope(s)

settings

Creates an identity › 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

Creates an identity › Request Body

object

Creates an identity › Responses

Identity created

identity_response

id

identifier · pattern: ^\d+$

A unique record identifier

administration_id

administration_id · pattern: ^\d+$

A unique record identifier

company_name

string | null

city

string | null

country

string | null

zipcode

string | null

address1

string | null

address2

string | null

email

string | null

phone

string | null

bank_account_name

string | null

bank_account_number

string | null

bank_account_bic

string | null

custom_field_value_response[]

updated_at

timestamp · date-time

created_at

timestamp · date-time

chamber_of_commerce

string | null

tax_number

string | null

POST/{administration_id}/identities{format}

curl https://moneybird.com/api/v2/:administration_id/identities:format \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "identity": {
    "company_name": "Foobar B.V.",
    "address1": "Straat 1",
    "zipcode": "Zipcode",
    "city": "Enschede",
    "country": "NL",
    "email": "foobar@example.com"
  }
}'

Example Request Body

{
  "identity": {
    "company_name": "Foobar B.V.",
    "address1": "Straat 1",
    "zipcode": "Zipcode",
    "city": "Enschede",
    "country": "NL",
    "email": "foobar@example.com"
  }
}

json

application/json

Example Responses

{
  "id": "499054023282787525",
  "administration_id": 123,
  "company_name": "Foobar B.V.",
  "city": "Enschede",
  "country": "NL",
  "zipcode": "Zipcode",
  "address1": "Straat 1",
  "address2": null,
  "email": "foobar@example.com",
  "phone": null,
  "bank_account_name": null,
  "bank_account_number": null,
  "bank_account_bic": null,
  "custom_fields": [],
  "updated_at": "2026-09-23T09:17:06.224Z",
  "created_at": "2026-09-23T09:17:06.224Z",
  "chamber_of_commerce": "08155914",
  "tax_number": "NL817575546B01"
}

json

application/json

Financial statements Ledger accounts