Identities

Retrieve the default identity

GET /identities/default(.:format)

Returns the default identity of this administration.

Example: returns the default identity

Request

    curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
  -XGET \
  https://moneybird.com/api/v2/123/identities/default.json?
    
    

Response

        
          
          Status: 200 OK

{
  "id": "460921990939674441",
  "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": "2025-07-29T11:44:46.647Z",
  "created_at": "2025-07-29T11:44:46.347Z",
  "chamber_of_commerce": "08155914",
  "tax_number": "NL817575546B01"
}

Updates the default identity

PATCH /identities/default(.:format)

Parameters

Parameter	Type	Description
`identity[company_name]`	`String`
`identity[legal_entity_type]`	`String`
`identity[country]`	`String`	ISO two-character country code, e.g. NL or DE.
`identity[city]`	`String`
`identity[zipcode]`	`String`
`identity[address1]`	`String`
`identity[address2]`	`String`
`identity[email]`	`String`	Should be a valid email addresses.
`identity[phone]`	`String`
`identity[bank_account_name]`	`String`
`identity[bank_account_number]`	`String`
`identity[bank_account_bic]`	`String`
`identity[chamber_of_commerce]`	`String`
`identity[tax_number]`	`String`
`identity[tax_number_absence_reason]`	`String`	Can be `below_tax_threshold` or `industry_exemption`.
`identity[custom_fields_attributes][id]`	`Integer`	Required
`identity[custom_fields_attributes][value]`	`String`	Required
`identity[administration_attributes][adyen_processed_funds]`	`Boolean`
`identity[administration_attributes][company_activities_description]`	`String`
`identity[administration_attributes][company_website_url]`	`String`
`identity[administration_attributes][company_website_absent]`	`String`
`identity[administration_attributes][legal_entity_type]`	`String`

Example: updates the default identity

Request

    curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
  -XPATCH \
  -d '{"identity":{"company_name":"Second B.V."}}' \
  https://moneybird.com/api/v2/123/identities/default.json
    
    

Response

        
          
          Status: 200 OK

{
  "id": "460921990939674441",
  "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": "2025-07-29T11:47:24.682Z",
  "created_at": "2025-07-29T11:44:46.347Z",
  "chamber_of_commerce": "08155914",
  "tax_number": "NL817575546B01"
}

Example: returns 422 when updating the default identity with invalid params

Request

    curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
  -XPATCH \
  -d '{"identity":{"company_name":""}}' \
  https://moneybird.com/api/v2/123/identities/default.json
    
    

Response

        
          
          Status: 422 Unprocessable Entity

{
  "error": {
    "company_name": [
      "can't be blank"
    ]
  },
  "details": {
    "company_name": [
      {
        "error": "blank"
      }
    ]
  }
}

Retrieve identities

GET /identities(.:format)

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

Example: returns all identities of an administration

Request

    curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
  -XGET \
  https://moneybird.com/api/v2/123/identities.json?
    
    

Response

        
          
          Status: 200 OK

[
  {
    "id": "460922157186155938",
    "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": "2025-07-29T11:47:24.891Z",
    "created_at": "2025-07-29T11:47:24.891Z",
    "chamber_of_commerce": "08155914",
    "tax_number": "NL817575546B01"
  }
]

Retrieve identity by given id

GET /identities/:id(.:format)

Example: returns a single identity

Request

    curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
  -XGET \
  https://moneybird.com/api/v2/123/identities/460922157311985064.json?
    
    

Response

        
          
          Status: 200 OK

{
  "id": "460922157311985064",
  "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": "2025-07-29T11:47:25.012Z",
  "created_at": "2025-07-29T11:47:25.012Z",
  "chamber_of_commerce": "08155914",
  "tax_number": "NL817575546B01"
}

Example: returns 404 when identity does not exist

Request

    curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
  -XGET \
  https://moneybird.com/api/v2/123/identities/34123123.json?
    
    

Response

        
          
          Status: 404 Not Found

{
  "error": "record not found",
  "symbolic": {
    "id": "not_found"
  }
}

Creates an identity

POST /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.

Parameters

Parameter	Type	Description
`identity[company_name]`	`String`	Required
`identity[country]`	`String`	Required ISO two-character country code, e.g. NL or DE.
`identity[city]`	`String`	Required
`identity[zipcode]`	`String`	Required
`identity[address1]`	`String`	Required
`identity[address2]`	`String`
`identity[email]`	`String`	Required Should be a valid email addresses.
`identity[phone]`	`String`
`identity[bank_account_name]`	`String`
`identity[bank_account_number]`	`String`	Required
`identity[bank_account_bic]`	`String`
`identity[custom_fields_attributes][id]`	`Integer`	Required
`identity[custom_fields_attributes][value]`	`String`	Required

Example: creates an identity

Request

    curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
  -XPOST \
  -d '{"identity":{"company_name":"Foobar B.V.","address1":"Straat 1","zipcode":"Zipcode","city":"Enschede","country":"NL","email":"foobar@example.com"}}' \
  https://moneybird.com/api/v2/123/identities.json
    
    

Response

        
          
          Status: 201 Created

{
  "id": "460922157685278140",
  "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": "2025-07-29T11:47:25.368Z",
  "created_at": "2025-07-29T11:47:25.368Z",
  "chamber_of_commerce": "08155914",
  "tax_number": "NL817575546B01"
}

Example: creates an identity with custom fields

Request

    curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
  -XPOST \
  -d '{"identity":{"company_name":"Foobar B.V.","address1":"Straat 1","zipcode":"Zipcode","city":"Enschede","country":"NL","email":"foobar@example.com","custom_fields_attributes":{"0":{"id":460922157779649987,"value":"my custom value"}}}}' \
  https://moneybird.com/api/v2/123/identities.json
    
    

Response

        
          
          Status: 201 Created

{
  "id": "460922157855147463",
  "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": [
    {
      "id": "460922157779649987",
      "name": "custom_field_84042f889159ca611285",
      "value": "my custom value"
    }
  ],
  "updated_at": "2025-07-29T11:47:25.530Z",
  "created_at": "2025-07-29T11:47:25.530Z",
  "chamber_of_commerce": "08155914",
  "tax_number": "NL817575546B01"
}

Example: returns 422 when required params are missing or invalid

Request

    curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
  -XPOST \
  -d '{"identity":{"company_name":""}}' \
  https://moneybird.com/api/v2/123/identities.json
    
    

Response

        
          
          Status: 422 Unprocessable Entity

{
  "error": {
    "company_name": [
      "can't be blank"
    ],
    "address1": [
      "can't be blank"
    ],
    "zipcode": [
      "can't be blank"
    ],
    "city": [
      "can't be blank"
    ],
    "country": [
      "can't be blank",
      "is invalid"
    ],
    "email": [
      "is not a valid email address"
    ]
  },
  "details": {
    "company_name": [
      {
        "error": "blank"
      }
    ],
    "address1": [
      {
        "error": "blank"
      }
    ],
    "zipcode": [
      {
        "error": "blank"
      }
    ],
    "city": [
      {
        "error": "blank"
      }
    ],
    "country": [
      {
        "error": "blank"
      },
      {
        "error": "invalid",
        "value": null
      }
    ],
    "email": [
      {
        "error": "invalid_email"
      }
    ]
  }
}

Updates an identity

PATCH /identities/:id(.:format)

Parameters

Parameter	Type	Description
`identity[company_name]`	`String`
`identity[country]`	`String`	ISO two-character country code, e.g. NL or DE.
`identity[city]`	`String`
`identity[zipcode]`	`String`
`identity[address1]`	`String`
`identity[address2]`	`String`
`identity[email]`	`String`	Should be a valid email addresses.
`identity[phone]`	`String`
`identity[bank_account_name]`	`String`
`identity[bank_account_number]`	`String`
`identity[bank_account_bic]`	`String`
`identity[custom_fields_attributes][id]`	`Integer`	Required
`identity[custom_fields_attributes][value]`	`String`	Required

Example: updates a identity

Request

    curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
  -XPATCH \
  -d '{"identity":{"company_name":"Second B.V."}}' \
  https://moneybird.com/api/v2/123/identities/460922158059619794.json
    
    

Response

        
          
          Status: 200 OK

{
  "id": "460922158059619794",
  "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": "2025-07-29T11:47:25.793Z",
  "created_at": "2025-07-29T11:47:25.726Z",
  "chamber_of_commerce": "08155914",
  "tax_number": "NL817575546B01"
}

Example: returns 404 when updating a non-existent identity

Request

    curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
  -XPATCH \
  -d '{"identity":{"company_name":"Second B.V."}}' \
  https://moneybird.com/api/v2/123/identities/999999999.json
    
    

Response

        
          
          Status: 404 Not Found

{
  "error": "record not found",
  "symbolic": {
    "id": "not_found"
  }
}

Example: returns 422 when updating an identity with invalid params

Request

    curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
  -XPATCH \
  -d '{"identity":{"company_name":""}}' \
  https://moneybird.com/api/v2/123/identities/460922158320715232.json
    
    

Response

        
          
          Status: 422 Unprocessable Entity

{
  "error": {
    "company_name": [
      "can't be blank"
    ]
  },
  "details": {
    "company_name": [
      {
        "error": "blank"
      }
    ]
  }
}

Deletes an identity

DELETE /identities/:id(.:format)

Example: deletes the identity

Request

    curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
  -XDELETE \
  -d '{}' \
  https://moneybird.com/api/v2/123/identities/460922158531479014.json
    
    

Response

        
          
          Status: 204 No Content

Example: cannot delete the default identity

Request

    curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
  -XDELETE \
  -d '{}' \
  https://moneybird.com/api/v2/123/identities/460921990939674441.json
    
    

Response

        
          
          Status: 404 Not Found

{
  "error": "record not found",
  "symbolic": {
    "id": "not_found"
  }
}