Ownership Entity

🚧

In development

A legacy version of the Merchant Boarding API is live currently, however a new enhanced version is in development. For new consumers, it is highly recommended to use the new version of the API expected in Q3 2022.

Please note the API specification may change while it's in development

Ownership Entities Resource

An ownership entity contain the details about the legal entity and the owners of it i.e. the directors and/or main beneficiaries.

Mandatory Fields

AttributeTypeDescriptionExample / ENUMS
foundationDatedateThe foundation date for the business2015-01-01
legalNamestringThe legal/registered name of the customer's businessJohn Smith Shoe Shop Ltd
ownershipEntityTypestringThe legal form of the business (e.g. sole trader, etc)ASSOCIATION
OwnersArrayThe ID's of owners497f6eca-6276-4993-bfeb-53cbbbba6f08

Conditional Fields

AttributeTypeDescriptionExample / ENUMS
charityRegistrationNumberstringThe registered charity number. Mandatory if the legal form = CH123456782345678 - Mandatory if legal form = CH (charity)
companyRegistrationNumberstringThe company registration number used to identify a businessLP003129 (depends on business type/legal form: mandatory for Limited Company and Limited Liability Partnership.

Examples

Example Request

{
     "legalName": "John Smith Shoe Shop Ltd",
     "foundationDate": "2022-04-07",
     "ownershipEntityType": "ASSOCIATION",
     "companyRegistrationNumber": "71242341",
     "charityRegistrationNumber": "2",
     "taxId": "12345",
     "owners": [
          {
               "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08"
          }
     ]
}

Example Response

{
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "legalName": "John Smith Shoe Shop Ltd",
  "foundationDate": "2022-04-07",
  "ownershipEntityType": "ASSOCIATION",
  "companyRegistrationNumber": "71242341",
  "charityRegistrationNumber": "2",
  "taxId": "12345",
  "owners": [
    {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08"
    }
  ]
}

Did this page help you?