Identities

Retrieve the default identity

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": "433546158546093901",
  "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": "2024-09-30T07:37:38.425Z",
  "created_at": "2024-09-30T07:37:38.071Z",
  "chamber_of_commerce": "08155914",
  "tax_number": "NL817575546B01"
}
      

Updates the default identity

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": "433546158546093901",
  "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": "2024-09-30T07:39:21.422Z",
  "created_at": "2024-09-30T07:37:38.071Z",
  "chamber_of_commerce": "08155914",
  "tax_number": "NL817575546B01"
}
      

Retrieve identities

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": "433546266971997598",
    "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": "2024-09-30T07:39:21.475Z",
    "created_at": "2024-09-30T07:39:21.475Z",
    "chamber_of_commerce": "08155914",
    "tax_number": "NL817575546B01"
  }
]
      

Retrieve identity by given id

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/433546267070563748.json?
    

Response

        
          
          Status: 200 OK
        
      
{
  "id": "433546267070563748",
  "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": "2024-09-30T07:39:21.570Z",
  "created_at": "2024-09-30T07:39:21.570Z",
  "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

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": "433546267358922168",
  "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": "2024-09-30T07:39:21.845Z",
  "created_at": "2024-09-30T07:39:21.845Z",
  "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":433546267420788159,"value":"my custom value"}}}}' \
  https://moneybird.com/api/v2/123/identities.json
    

Response

        
          
          Status: 201 Created
        
      
{
  "id": "433546267497334211",
  "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": "433546267420788159",
      "name": "custom_field_7c1281fe8fb42ba87fdc",
      "value": "my custom value"
    }
  ],
  "updated_at": "2024-09-30T07:39:21.976Z",
  "created_at": "2024-09-30T07:39:21.976Z",
  "chamber_of_commerce": "08155914",
  "tax_number": "NL817575546B01"
}
      

Updates an identity

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/433546267551860166.json
    

Response

        
          
          Status: 200 OK
        
      
{
  "id": "433546267551860166",
  "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": "2024-09-30T07:39:22.091Z",
  "created_at": "2024-09-30T07:39:22.029Z",
  "chamber_of_commerce": "08155914",
  "tax_number": "NL817575546B01"
}
      

Deletes an identity

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/433546267668252110.json
    

Response

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/433546158546093901.json
    

Response

        
          
          Status: 404 Not Found
        
      
{
  "error": "record not found",
  "symbolic": {
    "id": "not_found"
  }
}