Get all Ultimate Beneficial Owners Associated with a Payment Account

GetUltimateBeneficialOwner

How it works

By calling this method, you will get all the Ultimate Beneficial Owners associated with a legal payment account.

XML

<GetUltimateBeneficialOwner xmlns="Service_mb">
   <wlLogin>string</wlLogin>
   <wlPass>string</wlPass>
   <wallet>string</wallet>
   <language>string</language>
   <version>string</version>
   <walletIp>string</walletIp>
   <walletUa>string</walletUa>
</GetUltimateBeneficialOwner>

<GetUltimateBeneficialOwnerResponse xmlns="Service_mb">
      <GetUltimateBeneficialOwnerResult>
        <ULTIMATEBENEFICIALOWNER>
          <id>long</id>
          <firstName>string</firstName>
          <lastName>string</lastName>
          <nationality>string</nationality>
          <dateOfBirth>string</dateOfBirth>
          <cityOfBirth>string</cityOfBirth>
          <countryOfBirth>string</countryOfBirth>
          <countryOfResidence>string</countryOfResidence>
          <startDate>string</startDate>
          <endDate>string</endDate>
        </ULTIMATEBENEFICIALOWNER>
        <ULTIMATEBENEFICIALOWNER>
          <id>long</id>
          <firstName>string</firstName>
          <lastName>string</lastName>
          <nationality>string</nationality>
          <dateOfBirth>string</dateOfBirth>
          <cityOfBirth>string</cityOfBirth>
          <countryOfBirth>string</countryOfBirth>
          <countryOfResidence>string</countryOfResidence>
          <startDate>string</startDate>
          <endDate>string</endDate>
        </ULTIMATEBENEFICIALOWNER>
      </GetUltimateBeneficialOwnerResult>
</GetUltimateBeneficialOwnerResponse>

JSON

{
  "p": {
    "wlLogin": "string",
    "wlPass": "string",
    "wallet": "string",
    "language": "string",
    "version": "string",
    "walletIp": "string",
    "walletUa": "string"
  }
}

{
  "GetUltimateBeneficialOwnerResponse": {
    "-xmlns": "Service_mb_json",
    "GetUltimateBeneficialOwnerResult": {
      "ULTIMATEBENEFICIALOWNER": [
        {
          "id": "long",
          "firstName": "string",
          "lastName": "string",
          "nationality": "string",
          "dateOfBirth": "string",
          "cityOfBirth": "string",
          "countryOfBirth": "string",
          "countryOfResidence": "string",
          "startDate": "string",
          "endDate": "string"
        },
        {
          "id": "long",
          "firstName": "string",
          "lastName": "string",
          "nationality": "string",
          "dateOfBirth": "string",
          "cityOfBirth": "string",
          "countryOfBirth": "string",
          "countryOfResidence": "string",
          "startDate": "string",
          "endDate": "string"
        }
      ]
    }
  }
}

Item	Description	Mandatory	Format	Example
wallet	Wallet ID of the legal payment account	Yes	`[1:100]` char	33612345678
ultimateBeneficialOwnerId	Ultimate Beneficial Owner's ID	Yes	`[1:100]` char	54589812458
firstName	Ultimate Beneficial Owner's first name	Yes	`[2:256]` char	Pierre
lastName	Ultimate Beneficial Owner's last name	Yes	`[2:256]` char	Dupont
nationality	Ultimate Beneficial Owner's Nationality, using ISO-3 format.	No	`[0:19]` char	FRA, USA
	Please separate multiple nationalities with a comma.
dateOfBirth	Ultimate Beneficial Owner's birthdate	Yes	dd/mm/yyyy	21/03/1985
cityOfBirth	Ultimate Beneficial Owner's city of birth	Yes	`[0:140]` char	Montreuil
countryOfBirth	Ultimate Beneficial Owner's country of birth using ISO-3	Yes	`[3]` char	FRA
countryOfResidence	Ultimate Beneficial Owner's country of residence using ISO-3	No	`[3]` char	FRA
isActive	Indicate if the Ultimate Beneficial Owner is active or not	No	`[1]` char	0
	0: no (default)
	1: yes