Cookies Settings

Loading

dnb-logo
Direct 2.0
Collapse

Ultimate Beneficial Ownership

Also known as Compliance Beneficial Ownership Structure and Compliance Beneficial Ownership List.

The findUBO feature allows customers to be able to, within a single call, resolve who is the Ultimate Beneficial Owners of a target D-U-N-S.

The Get List structure (CMP_BOL) focuses on the entities of both corporate and natural persons, and their relationship back to the target D-U-N-S with a particular focus on identifying Ultimate Beneficial Owners (UBOs) and Corporate Beneficial Owners (CBOs). This output is optimized for presentation in list format and use within internal or customer workflows.

The Get Full Structure (CMP_BOS) allows customers to understand all entities (corporate and natural persons) along with all of their individual relationships. This output is optimized for visualization purposes.

As part of the Small Business, Enterprise and Employment Act companies are required to supply details of the people who own or control their company (PSCs). Companies will need to keep this information on their own register, in addition to the register of directors and the register of members which they already keep. PSC information must also be filed with the central public register at Companies House.

Update History

  • December 10, 2021 (ALL SOAP & REST): Mapping update for Incorporation year (UK/Ireland)
  • October 08, 2021 (ALL SOAP & REST): Defect fix to suppress principal information of non-English Principal name to avoid incomplete Principal and Management section in the response.
  • September 17, 2021 (ALL SOAP & REST): New Legal Form text values are added for Argentina.
  • September 17, 2021 (ALL SOAP & REST): Indutsry code values are added for Armenia, Azerbaijan, Belarus, Bulgaria, Cyprus, Greece, Georgia, Kazakhstan, Kyrgyzstan, Moldova, Republic of, Romania, Russian Federation, Tajikistan, Turkmenistan, Ukraine and Uzbekistan.
  • August 27, 2021 (ALL SOAP & REST): Defect fix to return the missing NAICS 2012 Industry code.
  • July 16, 2021 (ALL SOAP & REST): New Legal Form text, PositionText, IndustryCode and OrganizationIdentificationNumber values are added for Hungary, Czech Republic, Japan, Poland & Slovakia.
  • June 25, 2021 (ALL SOAP & REST): Defect Fix to add the language code check to populate only English characters.
  • March 12, 2021 (ALL SOAP & REST): New Legal Form text values are added for Switzerland.
  • March 12, 2021 (ALL SOAP & REST): New Organization Identification Number values are added for Hungary.
  • January 29, 2021 (ALL SOAP & REST): PersonID element string length updated to 32 chars.Xpath (applicable to CMP_BOL & CMP_BOS products only): Product.Organization.Linkage.BeneficialOwnership.BeneficialOwners.PersonID
  • January 29, 2021 (ALL SOAP & REST): New Legal Form text values are added for Hungary, Southern Markets, Slovenia, Croatia, Bosnia-Herzegovina & Serbia
  • August 28, 2020 (ALL SOAP & REST): Defect fix to retrieve the success response for SG and MA country DUNS.
  • August 28, 2020 (ALL SOAP & REST): New Legal Form text and Registration Numbers are added for Algeria (AL), Tunisia (TN) and Morocco (MO).
  • April 24, 2020 (ALL SOAP & REST): For European countries, FinancialEmbarrassmentIndicator element will consider additional situations.
  • April 03, 2020 (ALL SOAP & REST): Defect fix to return the Legal Form Code values for Italy (IT) and San Marino (SM).
  • April 03, 2020 (ALL SOAP & REST): Defect fix to sum up both Cash & Cash and Liquid Assets value as single item amount in current asset Financial Statement.
  • February 21, 2020 (ALL SOAP & REST): Defect fix to return the missing Financial currency code value.
  • December 13, 2019 (ALL SOAP & REST): Bug fix to make response is compliance with Service Response Schema for IndividualEmployeeEntityDetails element.
  • November 22, 2019 (ALL SOAP & REST): Mapping fix to return only “Actual” ReliabilityText of ConsolidatedEmployeeDetails & suppress “Estimated” or other ReliabilityText’s of ConsolidatedEmployeeDetails in order to display the aggregate as single occurrence in the response as per schema.
  • September 20, 2019 (ALL SOAP & REST): New Legal Form text are added for UAE (AE), Egypt (EG), Australia (AU), China (CN) and Hong Kong (HK) countries.
  • September 20, 2019 (ALL SOAP & REST): New Registration Numbers are added for New Zealand (NZ) country.
  • August 30, 2019 (ALL SOAP & REST): For Asia Pacific & European countries, Operating status codes: 404(Ceased Trading) will be considered to set value of OutofBusinessIndicator element.
  • August 9, 2019 (ALL SOAP & REST): For Project Apollo, added 4 new registration type code for OrganizationNumber element.
  • August 9, 2019 (ALL SOAP & REST): An error message from the Services Local FeedsDB , when there is NO Match DUNS from CA DUnslink & GSRL has been fixed for Canada.
  • March 29, 2019 (ALL SOAP & REST): TransferDUNSNumberRegistration aggregate and its elements have been suppressed from the response.
  • December 7, 2018 (v1.2 SOAP & REST) version 6.0 is now available for all Compliance Verification products. Added new elements to CMP_BOS, and CMP_BOL products.
  • June 23, 2017 (v5.0 SOAP & REST) Added new response elements to CMP_BOL, and CMP_BOS.
  • May 12, 2017 (v1.2 SOAP & REST) version 5.0 is now available for all Compliance Verification products. Added new elements to CMP_VRF_ID, CMP_VRF_RPT, CMP_BOS, and CMP_BOL products.
  • March 10, 2017 (v1.2 SOAP & REST) version 1.2 is now available for all Compliance Verification products. Added new elements to CMP_BOS, and CMP_BOL products.
  • December 9, 2016 (v1.1 SOAP & REST) version 1.1 is now available for all Compliance Verification products. Added new products CMP_BOS, and CMP_BOL.
  • October 19, 2016 (v1.0 SOAP & REST) Monitoring paths and indicators are now available for CMP_VRF_ID, and CMP_VRF_RPT products.
  • September 16, 2016 (v1.0 SOAP & REST) GBO, SMPL_OWNSHP, CMP_VRF_RPT, CMP_VRF_ID, and KYC products are now available through Compliance Verification Service.
  • July 15, 2016 (v1.0 SOAP & REST): Monitoring for GBO product has been enabled for the following countries; Austria, Belgium, Germany, Italy, Ireland, Luxembourg, Netherlands, Portugal, Spain, Switzerland, and United Kingdom.
  • July 15, 2016 (v1.0 SOAP & REST): SMPL_OWNSHP, GBO and KYC data layers released as part of D&B Direct 2.0 API.
  • July 15, 2016 (v1.0 SOAP & REST): CMP_VRF_ID and CMP_VRF_RPT data layers released as part of D&B Direct Onboard API.
  • January 29, 2021 (ALL SOAP & REST): PersonID element string length updated to 32 chars.Xpath (applicable to CMP_BOL & CMP_BOS products only): Product.Organization.Linkage.BeneficialOwnership.BeneficialOwners.PersonID
  • March 29, 2019 (ALL SOAP & REST): TransferDUNSNumberRegistration aggregate and its elements have been suppressed from the response.
  • December 7, 2018 (v1.2 SOAP & REST) version 6.0 is now available for all Compliance Verification products. Added new elements to CMP_BOS, and CMP_BOL products.
  • June 23, 2017 (v5.0 SOAP & REST) Added new response elements to CMP_BOL, and CMP_BOS.
  • May 12, 2017 (v1.2 SOAP & REST) version 5.0 is now available for all Compliance Verification products. Added new elements to CMP_VRF_ID, CMP_VRF_RPT, CMP_BOS, and CMP_BOL products.
  • March 10, 2017 (v1.2 SOAP & REST) version 1.2 is now available for all Compliance Verification products. Added new elements to CMP_BOS, and CMP_BOL products.
  • December 9, 2016 (v1.1 SOAP & REST) version 1.1 is now available for all Compliance Verification products. Added new products CMP_BOS, and CMP_BOL.
  • October 19, 2016 (v1.0 SOAP & REST) Monitoring paths and indicators are now available for CMP_VRF_ID, and CMP_VRF_RPT products.
  • September 16, 2016 (v1.0 SOAP & REST) GBO, SMPL_OWNSHP, CMP_VRF_RPT, CMP_VRF_ID, and KYC products are now available through Compliance Verification Service.
  • July 15, 2016 (v1.0 SOAP & REST): Monitoring for GBO product has been enabled for the following countries; Austria, Belgium, Germany, Italy, Ireland, Luxembourg, Netherlands, Portugal, Spain, Switzerland, and United Kingdom.
  • July 15, 2016 (v1.0 SOAP & REST): SMPL_OWNSHP, GBO and KYC data layers released as part of D&B Direct 2.0 API.
  • July 15, 2016 (v1.0 SOAP & REST): CMP_VRF_ID and CMP_VRF_RPT data layers released as part of D&B Direct Onboard API.
  • January 29, 2021 (ALL SOAP & REST): PersonID element string length updated to 32 chars.Xpath (applicable to CMP_BOL & CMP_BOS products only): Product.Organization.Linkage.BeneficialOwnership.BeneficialOwners.PersonID
  • March 10, 2017 (v1.2 SOAP & REST) version 1.2 is now available for all Compliance Verification products. Added new elements to CMP_BOS, and CMP_BOL products.
  • January 29, 2021 (ALL SOAP & REST): PersonID element string length updated to 32 chars.Xpath (applicable to CMP_BOL & CMP_BOS products only): Product.Organization.Linkage.BeneficialOwnership.BeneficialOwners.PersonID
  • December 9, 2016 (v1.1 SOAP & REST) version 1.1 is now available for all Compliance Verification products. Added new products CMP_BOS, and CMP_BOL.
  • October 19, 2016 (v1.0 SOAP & REST) Monitoring paths and indicators are now available for CMP_VRF_ID, and CMP_VRF_RPT products.
  • September 16, 2016 (v1.0 SOAP & REST) GBO, SMPL_OWNSHP, CMP_VRF_RPT, CMP_VRF_ID, and KYC products are now available through Compliance Verification Service.
  • July 15, 2016 (v1.0 SOAP & REST): Monitoring for GBO product has been enabled for the following countries; Austria, Belgium, Germany, Italy, Ireland, Luxembourg, Netherlands, Portugal, Spain, Switzerland, and United Kingdom.
  • July 15, 2016 (v1.0 SOAP & REST): SMPL_OWNSHP, GBO and KYC data layers released as part of D&B Direct 2.0 API.
  • July 15, 2016 (v1.0 SOAP & REST): CMP_VRF_ID and CMP_VRF_RPT data layers released as part of D&B Direct Onboard API.

Product Request

IMPORTANT: Due to a known issue, please do not include request values for SubmittingOfficeID.

IMPORTANT: Please see the new Online Services Security Enhancement Release, effective November 09, 2020.

Overview

When requesting this feature, a valid D&B D-U-N-S Number for a company and the appropriate product code will be required. For improved performance, include its country code.

A trade up option exists to request data for the headquarters when the requested organization is a branch.

NOTE: When ordering information for organizations located in Germany, customers are required to provide a valid order reason code.

Global Availability

The CMP_BOL, CMP_BOS data layers are available for businesses domiciled in the following countries:

CMP_BOLCMP_BOSCountryISO Code
YYUnited States of AmericaUS
YYBelgiumBE
YYFranceFR
YYGermanyDE
YYItalyIT
YYNetherlandsNL
YYPortugalPT
YYSpainES
YYUnited KingdomGB
YYAustraliaAU
YYNew ZealandNZ
YYAndorraAD
YYAnguillaAI
YYAntigua & BarbudaAG
YYArubaAW
YYBahamasBS
YYBarbadosBB
YYBelizeBZ
YYBermudaBM
YYBoliviaBO
YYBritish Virgin IslandsVG
YYCanadaCA
YYCayman IslandsKY
YYChileCL
YYColombiaCO
YYCosta RicaCR
YYDenmarkDK
YYDominicaDM
YYDominican RepublicDO
YYEcuadorEC
YYEl SalvadorSV
YYFaero IslandsFO
YYFinlandFI
YYGreenlandGL
YYGrenadaGD
YYGuatemalaGT
YYGuyanaGY
YYHaitiHT
YYHondurasHN
YYIrelandIE
YYJamaicaJM
YYJapanJP
YYLuxembourgLU
YYMexicoMX
YYMonacoMC
YYMontserratMS
YYNetherlands AntillesAN
YYBonaire, Sint Eustatius And SabaBQ
YYCuraçaoCW
YYSint Maarten (dutch)SX
YYNicaraguaNI
YYNorwayNO
YYPanamaPA
YYSaint Kitts & NevisKN
YYSaint LuciaLC
YYSaint VincentVC
YYSan MarinoSM
YYSurinameSR
YYSwedenSE
YYTaiwanTW
YYTrinidad And TobagoTT
YYTurks And CaicosTC
YYVenezuelaVE
YYAfghanistanAF
YYAlbaniaAL
YYAlgeriaDZ
YYAmerican SamoaAS
YYAngolaAO
YYArgentinaAR
YYArmeniaAM
YYAustriaAT
YYAzerbaijanAZ
YYBahrainBH
YYBangladeshBD
YYBenin, Peoples Republic ofBJ
YYBhutanBT
YYBosnia And HerzegovinaBA
YYBotswanaBW
YYBrazilBR
YYBruneiBN
YYBulgariaBG
YYBurkina FasoBF
YYBurma (myanmar)MM
YYBurundiBI
YYBelarusBY
YYKampuchea (prev. Cambodia)KH
YYCameroonCM
YYCape Verde, Republic ofCV
YYCentral Africa RepublicCF
YYChad, Republic ofTD
YYChina, Peoples Republic ofCN
YYChristmas IslandCX
YYComoros RepublicKM
YYCongo Democratic RepublicCD
YYCook IslandsCK
YYCroatiaHR
YYCyprusCY
YYTurkish Republic of Northern CyprusXT
YYCzech RepublicCZ
YYDjiboutiDJ
YYEgyptEG
YYEquatorial GuineaGQ
YYEritreaER
YYEstoniaEE
YYEthiopiaET
YYFalkland IslandsFK
YYFijiFJ
YYFrench GuianaGF
YYFrench Polynesia/ TahitiPF
YYGabon RepublicGA
YYGambiaGM
YYGeorgiaGE
YYGhanaGH
YYGibraltarGI
YYGreeceGR
YYGuadeloupeGP
YYGuamGU
YYGuinea BissauGW
YYGuinea, Republic ofGN
YYHong Kong SARHK
YYHungaryHU
YYIcelandIS
YYIndiaIN
YYIndonesiaID
YYIranIR
YYIraqIQ
YYIsraelIL
YYIvory Coast/ Cote D'IvoireCI
YYJordanJO
YYKazakhstanKZ
YYKenyaKE
YYKiribatiKI
YYKorea, Republic ofKR
YYKuwaitKW
YYKyrgyzstanKG
YYLaosLA
YYLatviaLV
YYLebanonLB
YYLesothoLS
YYLiberiaLR
YYLibyaLY
YYLiechtensteinLI
YYLithuaniaLT
YYMacao SARMO
YYNorth MacedoniaMK
YYMadagasgarMG
YYMalawiMW
YYMalaysiaMY
YYMaldivesMV
YYMaliML
YYMaltaMT
YYMarianas IslandsMP
YYMarshall IslandsMH
YYMartiniqueMQ
YYMauritaniaMR
YYMauritiusMU
YYMoldovaMD
YYMontenegroME
YYMoroccoMA
YYMozambiqueMZ
YYNamibiaNA
YYNauruNR
YYNepalNP
YYNew CaledoniaNC
YYNigerNE
YYNigeriaNG
YYNorfolk IslandNF
YYOmanOM
YYPakistanPK
YYPapua New GuineaPG
YYParaguayPY
YYPeruPE
YYPhilippinesPH
YYPolandPL
YYQatarQA
YYReunion IslandRE
YYRomaniaRO
YYRussian FederationRU
YYRwandaRW
YYSaint HelenaSH
YYSao Tome & PrincipeST
YYSaudi ArabiaSA
YYSenegalSN
YYSerbiaRS
YYSeychellesSC
YYSierra LeoneSL
YYSingaporeSG
YYSlovakiaSK
YYSloveniaSI
YYSolomon IslandsSB
YYSomaliaSO
YYSouth AfricaZA
YYSri LankaLK
YYSudanSD
YYSouth SudanSS
YYEswatiniSZ
YYSwitzerlandCH
YYSyriaSY
YYTajhikstanTJ
YYTanzaniaTZ
YYThailandTH
YYTogoTG
YYTokelau IslandsTK
YYTongaTO
YYTunisiaTN
YYTurkiyeTR
YYTurkmenistanTM
YYTuvaluTV
YYUgandaUG
YYUkraineUA
YYUnited Arab EmiratesAE
YYUruguayUY
YYUzbekistanUZ
YYVanuatuVU
YYVietnamVN
YYWestern SamoaWS
YYYemenYE
YYZambiaZM
YYZimbabweZW
YYCongoCG
YYPuerto RicoPR
YYHoly See (vatican City State)VA
YYKosovoXK
YYMicronesia, Federated States ofFM
YYTimor-LesteTL

Data Layer Entitlement

For customers in U.S. and Canadian markets, the API is provisioned for specific collections of products, reports, and/or features (collectively referred to as data layers) for production and trial usage. Entitlement is not required for testing in the sandbox environment.

  • This particular report is entitled as "Compliance Patriot Act" for D&B Direct 2.0 customers.

For customers in the UK, Ireland, Belgium, Netherlands and Luxembourg markets, the API is provisioned as a specific set of data layers for production, trial, and sandbox usage.

  • This particular data layer is included in the D&B Direct Onboard 2.0 suite.

Specification

NOTE: This sample is for illustrative purposes only and meant to convey general concepts using sample manufactured data. Actual calls using the sample parameters will not necessarily produce the same results.

The D&B Direct 2.0 API supports HTTP compression. To utilize this option, add the following line to the header of your request: Accept-Encoding: gzip,deflate

Sample Request (CMP_BOL)
GET https://direct.dnb.com/V6.0/organizations/214567885/products/CMP_BOL?OwnershipPercentage=10&OwnershipType=BENF_OWRP
Authorization: <Token>
Sample Request (CMP_BOS)
GET https://direct.dnb.com/V6.0/organizations/214567885/products/CMP_BOS?OwnershipPercentage=50&OwnershipType=BENF_OWRP
Authorization: <Token>
CMP_BOL CMP_BOS Name Characteristics
Y Y {version} Element
Y Y ApplicationTransactionID string, up to 64 chars, Optional

A number assigned by the calling application to uniquely identify this request.

Y Y TransactionTimestamp DateTimestamp, Optional

The date and time when this request was created. When the request is from an intermediary, such as a workflow manager or service bus, this is the date and time when the message was sent to the D&B function, i.e., the date and time when the xml document was created by the requesting intermediary.

Y Y SubmittingOfficeID string, up to 64 chars, Optional

A number that identifies the system or the software application from where this request originated. / A number used to uniquely identfy the D&B business segment or delivery channel from where this request originated.

Y Y {DUNS} string, up to 15 chars Pattern: {([0-9a-zA-Z]*)}, Optional

The D-U-N-S Number is D&B's identification number, which provides unique identification of this organization, in accordance with the Data Universal Numbering System (D-U-N-S).

Y Y CountryISOAlpha2Code string, at least 2 chars up to 2 chars, Optional

The two-letter country code, defined in the ISO 3166-1 scheme published by International Organization for Standardization (ISO)identifying the country of the inquired subject.

Y Y {productID} string, Required

An alphanumeric string that uniquely identifies the product being requested.

Y Y LanguagePreferenceCode integer, up to 7 digits, Optional

A D&B code value that defines the language in which the customer wants this product to be rendered.

Possible Values: 39[English]

Y Y OrderReasonCode

integer, up to 7 digits, Optional

Possible values: 6332 [Credit Decision]; 6333 [Assessment of credit solvency for intended business connection]; 6334 [Assessment of credit solvency for ongoing business connection]; 6335 [Debt Collection]; 6336 [Commercial Credit Insurance]; 6337 [Insurance Contract]; 6338 [Leasing Agreement]; 6339 [Rental Agreement]

Y Y OwnershipType

string, Optional

A code that identifies the level of filter to applied on the requested product for the inquired subject, whether to include direct, indirect, both direct and indirect owners, or just beneficial owners etc. When NULL it indicates that there are no restrictions set on the request.

Possible Values: BENF_OWRP, CTLD_OWRP, DIRC_OWRP, IDIR_OWRP

NOTE: Only BENF_OWRP is supported for Ownership Type element in CMP_BOS product.

Y Y OwnershipPercentage

decimal (5,2), Optional

The percentage criteria to be applied on the requested product for the inquired subject. The response would include all results with a shareholding percentage greater than this value inclusive. E.g., 20, 50. When NULL it indicates that there is no restriction or cut off percentage.

Y N ExcludeUndisclosedHoldingsIndicator

boolean, Optional

When turned ON (set to true) this denotes the result set should exclude information on shareholders whose percentage is zero or undisclosed.

When turned OFF (set to false) or set to NULL this denotes the result set should include information on shareholders whose percentage is zero or undisclosed.

Y Y ArchiveProductOptOutIndicator boolean, Optional

When 'true' indicates that the product being ordered is not to be stored. When 'false' indicates that the product being ordered is to be stored; however as this is the assumed condition there is no requirement to create this tag to represent this fact.

Y Y ExtendArchivePeriodIndicator boolean, Optional

When 'true' the duration to archive the data is to be extended. Note: There is an additional cost for extending the archival period of the data purchased. When 'false' the duration to archive the data is not to be extended.

Y Y CustomerReferenceText-n string, up to 240 chars, Optional (up to 5x)

A freeform reference string provided by the customer to be linked to the product in order to support subsequent order reconciliation.

Y Y CustomerBillingEndorsementText string, at least 1 chars, up to 240 chars, Optional

Text that is filled in by customer and commonly contains requesting individual or department name, or customer's own account/reference number and/or name for the case on which the product was provided.This text is a reference used during the billing process.

Y Y PrincipalReferenceText Element, Optional (Array)

A freeform reference string provided by the customer to be linked to the principal information provided in the request for the product in order to support subsequent order reconciliation.

Endpoint

Use the following endpoint for requesting this product. The {version} is dependent on the underlying service delivering the product.

NOTE: While "organizations" is part of this endpoint, there is no service by this name. Many D&B Direct calls have a similar structure; however, the {version} component is based on the SERVICE to which a given product is associated.

Endpoints (UBO Product)
Specified versionGET https://direct.dnb.com/V{version}/organizations/{DUNS}/products/{DNBProductID}
Latest versionGET https://direct.dnb.com/organizations/{DUNS}/products/{DNBProductID}

Testing

This operation is currently unavailable in the D&B Direct sandbox (test) environment.

Trials

When conducting testing in the production environment during a trial period, product requests will be limited to the local market of the customer.

Production

A set of D-U-N-S Numbers is available to D&B Direct 2.0 customers for performing non-billable transactions in the production environment.

Product Response

While data for a particular company may not contain values for each of the business elements, there may be items that are considered by D&B to be "essential" to yield the maximum benefit of a data layer. If any of these essential elements do not contain a value for a particular company, a PD005 response code will be returned, and your organization will not incur a usage credit for the request.

For all codified data delivered by D&B Direct, the response package will include the decoded text value as a data element with the code value attached as an attribute. Refer to the Reference Data Service for access to the D&B standard code tables.

NOTE: The D&B Direct REST implementation uses the BadgerFish approach for JSON with some minor variations.

Specification

The following is a list of the possible data fields returned by this operation in the JSON response. Samples are provided for testing successful and failed retrieval, and to demonstrate the basic layout of a response. The data returned in samples may not represent actual values that this feature will deliver.

NOTE: The D-U-N-S Number returned in the response will be a nine-digit zero-padded, numeric value.

Sample Response (CMP_BOL)
{
  "OrderProductResponse": {
    "TransactionDetail": {
      "ServiceTransactionID": "Id-48d1205cb5ed26b722bf552b-2",
      "TransactionTimestamp": "2018-12-24T07:30:01.867-05:00"
    },
    "TransactionResult": {
      "SeverityText": "Information",
      "ResultID": "CM000",
      "ResultText": "Success"
    },
    "OrderProductResponseDetail": {
      "InquiryDetail": {
        "DUNSNumber": "214567885",
        "CountryISOAlpha2Code": "GB"
      },
      "Product": {
        "DNBProductID": "CMP_BOL",
        "Organization": {
          "SubjectHeader": {
            "DUNSNumber": "214567885"
          },
          "Location": {
            "PrimaryAddress": [
              {
                "StreetAddressLine": [
                  {
                    "LineText": "Marlow International Parkway"
                  }
                ],
                "PrimaryTownName": "MARLOW",
                "CountryISOAlpha2Code": "GB",
                "PostalCode": "SL7 1AJ",
                "CountryOfficialName": "United Kingdom"
              }
            ]
          },
          "OrganizationName": {
            "OrganizationPrimaryName": [
              {
                "OrganizationName": {
                  "$": "D & B SAMPLE CO LTD"
                }
              }
            ]
          },
          "OrganizationDetail": {
            "ControlOwnershipTypeText": {
              "@DNBCodeValue": 9058,
              "$": "Privately owned"
            },
            "OutofBusinessIndicator": false
          },
          "RegisteredDetail": {
            "LegalFormDetails": {
              "LegalFormText": {
                "@DNBCodeValue": 2547,
                "$": "Private Limited Liability Company"
              }
            }
          },
          "IndustryCode": {
            "PrimaryIndustryCode": [
              {
                "@DNBCodeValue": 399,
                "@TypeText": "US SIC (1987)",
                "IndustryCode": "7379",
                "IndustryCodeDescription": [
                  {
                    "@LanguageCode": 39,
                    "@IndustryCodeDescriptionLengthCode": 1441,
                    "$": "Computer related services"
                  }
                ]
              }
            ]
          },
          "Linkage": {
            "GlobalUltimateOrganization": {
              "DUNSNumber": "214567885",
              "OrganizationPrimaryName": [
                {
                  "OrganizationName": {
                    "$": "D & B SAMPLE CO LTD"
                  }
                }
              ]
            },
            "DomesticUltimateOrganization": {
              "DUNSNumber": "214567885",
              "OrganizationPrimaryName": [
                {
                  "OrganizationName": {
                    "$": "D & B SAMPLE CO LTD"
                  }
                }
              ]
            },
            "BeneficialOwnership": {
              "Summary": {
                "BeneficialOwnersCount": 15,
                "RelationshipsCount": 15,
                "OrganizationsCount": 2,
                "IndividualsCount": 12,
                "UnclassifedOwnerCount": 1,
                "CorporateBeneficiariesCount": 0,
                "MaximumDegreeOfSeparation": 2,
                "TotalAllocatedOwnershipPercentage": 68.25,
                "CountrywiseSummary": [
                  {
                    "CountryISOAlpha2Code": "GB",
                    "BeneficialOwnersCount": 6
                  },
                  {
                    "CountryISOAlpha2Code": "IE",
                    "BeneficialOwnersCount": 1
                  }
                ],
                "UnknownCountryBeneficiariesCount": 8,
                "StateOwnedOrganizationsCount": 0,
                "GovernmentOrganizationsCount": 0,
                "PubliclyTradingOrganizationsCount": 0,
                "PrivatelyHeldOrganizationsCount": 2,
                "PSCCount": 1,
                "PSCUniqueTypeCount": 1,
                "TypewisePSCSummary": [
                  {
                    "PSCTypeText": {
                      "@DNBCodeValue": 119,
                      "$": "Individuals"
                    },
                    "PSCCount": 1
                  }
                ],
                "NationalitywisePSCSummary": [
                  {
                    "Nationality": "British",
                    "PSCCount": 1
                  }
                ],
                "CountryUnknownPSCCount": 1
              },
              "BeneficialOwners": [
                {
                  "BeneficiaryIndicator": true,
                  "MemberID": "471381701",
                  "PrimaryName": "Fore Sample Corporate Share holder",
                  "SubjectTypeDescription": {
                    "@DNBCodeValue": 119,
                    "$": "Individuals"
                  },
                  "DirectOwnershipPercentage": 4.35,
                  "BeneficialOwnershipPercentage": 4.35,
                  "DegreeOfSeparation": 1
                },
                {
                  "BeneficiaryIndicator": true,
                  "MemberID": "468255377",
                  "PrimaryName": "HKNJ Surname",
                  "SubjectTypeDescription": {
                    "@DNBCodeValue": 119,
                    "$": "Individuals"
                  },
                  "DirectOwnershipPercentage": 4.35,
                  "BeneficialOwnershipPercentage": 4.35,
                  "DegreeOfSeparation": 1
                },
                {
                  "BeneficiaryIndicator": false,
                  "MemberID": "181707063",
                  "PrimaryName": "D & B SAMPLE PARTNERSHIP",
                  "DUNSNumber": "231824520",
                  "SubjectTypeDescription": {
                    "@DNBCodeValue": 118,
                    "$": "Businesses"
                  },
                  "LegalFormText": {
                    "@DNBCodeValue": 47,
                    "$": "Partnership"
                  },
                  "PrimaryAddress": {
                    "StreetAddressLine": [
                      {
                        "LineText": "Marlow International D & B Sample Partnership"
                      },
                      {
                        "LineText": "Parkway"
                      }
                    ],
                    "PrimaryTownName": "MARLOW",
                    "CountryISOAlpha2Code": "GB",
                    "PostalCode": "SL7 1AJ",
                    "CountryOfficialName": "United Kingdom"
                  },
                  "DirectOwnershipPercentage": 0.43,
                  "OutofBusinessIndicator": true,
                  "DegreeOfSeparation": 1,
                  "ControlOwnershipTypeText": {
                    "@DNBCodeValue": 9058,
                    "$": "Privately owned"
                  }
                },
                {
                  "BeneficiaryIndicator": false,
                  "MemberID": "185500720",
                  "PrimaryName": "D & B SAMPLE HOLDING CO LTD",
                  "DUNSNumber": "233083567",
                  "SubjectTypeDescription": {
                    "@DNBCodeValue": 118,
                    "$": "Businesses"
                  },
                  "LegalFormText": {
                    "@DNBCodeValue": 2547,
                    "$": "Private Limited Liability Company"
                  },
                  "PrimaryAddress": {
                    "StreetAddressLine": [
                      {
                        "LineText": "41 High Street"
                      }
                    ],
                    "PrimaryTownName": "MARKET HARBOROUGH",
                    "CountryISOAlpha2Code": "GB",
                    "PostalCode": "LE16 7NL",
                    "CountryOfficialName": "United Kingdom"
                  },
                  "DirectOwnershipPercentage": 0.87,
                  "OutofBusinessIndicator": false,
                  "DegreeOfSeparation": 1,
                  "ControlOwnershipTypeText": {
                    "@DNBCodeValue": 9058,
                    "$": "Privately owned"
                  }
                },
                {
                  "BeneficiaryIndicator": true,
                  "MemberID": "532652332",
                  "PrimaryName": "Rachel Hardwer",
                  "SubjectTypeDescription": {
                    "@DNBCodeValue": 119,
                    "$": "Individuals"
                  },
                  "DirectOwnershipPercentage": 0.43,
                  "BeneficialOwnershipPercentage": 0.43,
                  "DegreeOfSeparation": 1
                },
                {
                  "BeneficiaryIndicator": true,
                  "MemberID": "458268746",
                  "PrimaryName": "Test Test 2",
                  "SubjectTypeDescription": {
                    "@DNBCodeValue": 119,
                    "$": "Individuals"
                  },
                  "DirectOwnershipPercentage": 0.43,
                  "BeneficialOwnershipPercentage": 0.43,
                  "DegreeOfSeparation": 1
                },
                {
                  "BeneficiaryIndicator": true,
                  "MemberID": "252502820",
                  "PrimaryName": "Test Test 1",
                  "SubjectTypeDescription": {
                    "@DNBCodeValue": 119,
                    "$": "Individuals"
                  },
                  "DirectOwnershipPercentage": 5.22,
                  "BeneficialOwnershipPercentage": 5.22,
                  "DegreeOfSeparation": 1
                },
                {
                  "BeneficiaryIndicator": true,
                  "MemberID": "406569461",
                  "PrimaryName": "123 SHOPS testing4Ä",
                  "SubjectTypeDescription": {
                    "@DNBCodeValue": 119,
                    "$": "Individuals"
                  },
                  "PrimaryAddress": {
                    "StreetAddressLine": [
                      {
                        "LineText": "42 Oakridge Road"
                      }
                    ],
                    "PrimaryTownName": "High Wycombe",
                    "CountryISOAlpha2Code": "GB",
                    "CountryOfficialName": "United Kingdom"
                  },
                  "DirectOwnershipPercentage": 0.43,
                  "BeneficialOwnershipPercentage": 0.43,
                  "DegreeOfSeparation": 1
                },
                {
                  "BeneficiaryIndicator": true,
                  "MemberID": "559024352",
                  "PrimaryName": "Forename Test",
                  "SubjectTypeDescription": {
                    "@DNBCodeValue": 119,
                    "$": "Individuals"
                  },
                  "PrimaryAddress": {
                    "StreetAddressLine": [
                      {
                        "LineText": "XYZ"
                      },
                      {
                        "LineText": "Jk Rowlin"
                      }
                    ],
                    "PrimaryTownName": "Birmingham",
                    "CountryISOAlpha2Code": "GB",
                    "CountryOfficialName": "United Kingdom"
                  },
                  "DirectOwnershipPercentage": 0.43,
                  "BeneficialOwnershipPercentage": 0.43,
                  "DegreeOfSeparation": 1
                },
                {
                  "BeneficiaryIndicator": true,
                  "MemberID": "505207842",
                  "PrimaryName": "LIMIRTED PARTNERSHIP WAREHOUSE",
                  "DirectOwnershipPercentage": 4.35,
                  "BeneficialOwnershipPercentage": 4.35,
                  "DegreeOfSeparation": 1
                },
                {
                  "BeneficiaryIndicator": true,
                  "MemberID": "259921260",
                  "PrimaryName": "Might Ican",
                  "SubjectTypeDescription": {
                    "@DNBCodeValue": 119,
                    "$": "Individuals"
                  },
                  "DirectOwnershipPercentage": 43.48,
                  "BeneficialOwnershipPercentage": 43.48,
                  "DegreeOfSeparation": 1
                },
                {
                  "BeneficiaryIndicator": true,
                  "MemberID": "553843389",
                  "PrimaryName": "OthersChanges Others",
                  "SubjectTypeDescription": {
                    "@DNBCodeValue": 119,
                    "$": "Individuals"
                  },
                  "PrimaryAddress": {
                    "StreetAddressLine": [
                      {
                        "LineText": "Address Check"
                      }
                    ],
                    "PrimaryTownName": "High Wycombe",
                    "CountryISOAlpha2Code": "GB",
                    "CountryOfficialName": "United Kingdom"
                  },
                  "DirectOwnershipPercentage": 0.43,
                  "BeneficialOwnershipPercentage": 0.43,
                  "DegreeOfSeparation": 1
                },
                {
                  "BeneficiaryIndicator": true,
                  "MemberID": "523364285",
                  "PrimaryName": "KMJ HJNM",
                  "SubjectTypeDescription": {
                    "@DNBCodeValue": 119,
                    "$": "Individuals"
                  },
                  "DirectOwnershipPercentage": 4.35,
                  "BeneficialOwnershipPercentage": 4.35,
                  "DegreeOfSeparation": 1
                },
                {
                  "BeneficiaryIndicator": true,
                  "MemberID": "471009273",
                  "SubjectTypeDescription": {
                    "@DNBCodeValue": 119,
                    "$": "Individuals"
                  },
                  "PrimaryAddress": {
                    "StreetAddressLine": [
                      {
                        "LineText": "SHOPS testing4Ä"
                      },
                      {
                        "LineText": "Paulõ"
                      },
                      {
                        "LineText": "aaaaaÖü"
                      }
                    ],
                    "PrimaryTownName": "Gateway1ä",
                    "CountryISOAlpha2Code": "GB",
                    "CountryOfficialName": "United Kingdom"
                  },
                  "DegreeOfSeparation": 2,
                  "UndisclosedIndicator": true
                },
                {
                  "BeneficiaryIndicator": true,
                  "MemberID": "266707889",
                  "PrimaryName": "Test Test",
                  "SubjectTypeDescription": {
                    "@DNBCodeValue": 119,
                    "$": "Individuals"
                  },
                  "PrimaryAddress": {
                    "StreetAddressLine": [
                      {
                        "LineText": "sss"
                      }
                    ],
                    "PrimaryTownName": "sss",
                    "CountryISOAlpha2Code": "IE",
                    "CountryOfficialName": "Ireland"
                  },
                  "IndirectOwnershipPercentage": 0,
                  "BeneficialOwnershipPercentage": 0,
                  "DegreeOfSeparation": 2,
                  "ResidenceCountryName": "England",
                  "NatureOfControlDescription": [
                    {
                      "@DNBCodeValue": 30850,
                      "$": "Ownership of 75% to 100% of shares"
                    }
                  ],
                  "NatureOfControlClassDescription": [
                    {
                      "@DNBCodeValue": 33476,
                      "$": "Ownership or voting rights of 75% to 100%"
                    }
                  ],
                  "NatureOfControlStartDate": "2016-07-11",
                  "PSCIndicator": true
                }
              ]
            }
          }
        },
        "ArchiveDetail": {
          "PortfolioAssetID": 89142716
        }
      }
    }
  }
}

Sample Response (CMP_BOS)
{"OrderProductResponse": {
   "TransactionDetail":    {
      "ServiceTransactionID": "Id-24d2205c10f070655ee213a9-2",
      "TransactionTimestamp": "2018-12-24T07:33:42.576-05:00"
   },
   "TransactionResult":    {
      "SeverityText": "Information",
      "ResultID": "CM000",
      "ResultText": "Success"
   },
   "OrderProductResponseDetail":    {
      "InquiryDetail":       {
         "DUNSNumber": "214567885",
         "CountryISOAlpha2Code": "GB"
      },
      "Product":       {
         "DNBProductID": "CMP_BOS",
         "Organization":          {
            "SubjectHeader": {"DUNSNumber": "214567885"},
            "Location": {"PrimaryAddress": [            {
               "StreetAddressLine": [{"LineText": "Marlow International Parkway"}],
               "PrimaryTownName": "MARLOW",
               "CountryISOAlpha2Code": "GB",
               "PostalCode": "SL7 1AJ",
               "CountryOfficialName": "United Kingdom"
            }]},
            "OrganizationName": {"OrganizationPrimaryName": [{"OrganizationName": {"$": "D & B SAMPLE CO LTD"}}]},
            "OrganizationDetail":             {
               "ControlOwnershipTypeText":                {
                  "@DNBCodeValue": 9058,
                  "$": "Privately owned"
               },
               "OutofBusinessIndicator": false
            },
            "RegisteredDetail": {"LegalFormDetails": {"LegalFormText":             {
               "@DNBCodeValue": 2547,
               "$": "Private Limited Liability Company"
            }}},
            "IndustryCode": {"PrimaryIndustryCode": [            {
               "@DNBCodeValue": 399,
               "@TypeText": "US SIC (1987)",
               "IndustryCode": "7379",
               "IndustryCodeDescription": [               {
                  "@LanguageCode": 39,
                  "@IndustryCodeDescriptionLengthCode": 1441,
                  "$": "Computer related services"
               }]
            }]},
            "Linkage":             {
               "GlobalUltimateOrganization":                {
                  "DUNSNumber": "214567885",
                  "OrganizationPrimaryName": [{"OrganizationName": {"$": "D & B SAMPLE CO LTD"}}]
               },
               "DomesticUltimateOrganization":                {
                  "DUNSNumber": "214567885",
                  "OrganizationPrimaryName": [{"OrganizationName": {"$": "D & B SAMPLE CO LTD"}}]
               },
               "BeneficialOwnership":                {
                  "Summary":                   {
                     "BeneficialOwnersCount": 15,
                     "RelationshipsCount": 15,
                     "OrganizationsCount": 3,
                     "IndividualsCount": 12,
                     "UnclassifedOwnerCount": 0,
                     "CorporateBeneficiariesCount": 0,
                     "MaximumDegreeOfSeparation": 2,
                     "TotalAllocatedOwnershipPercentage": 68.25,
                     "CountrywiseSummary":                      [
                                                {
                           "CountryISOAlpha2Code": "GB",
                           "BeneficialOwnersCount": 6
                        },
                                                {
                           "CountryISOAlpha2Code": "IE",
                           "BeneficialOwnersCount": 1
                        }
                     ],
                     "UnknownCountryBeneficiariesCount": 8,
                     "StateOwnedOrganizationsCount": 0,
                     "GovernmentOrganizationsCount": 0,
                     "PubliclyTradingOrganizationsCount": 0,
                     "PrivatelyHeldOrganizationsCount": 2,
                     "PSCCount": 1,
                     "PSCUniqueTypeCount": 1,
					 "TypewisePSCSummary": [                  {
                     "PSCTypeText":                      {
                        "@DNBCodeValue": 119,
                        "$": "Individuals"
                     },
                     "PSCCount": 1
                  }],
                  "NationalitywisePSCSummary": [                  {
                     "Nationality": "British",
                     "PSCCount": 1
                  }],
                  "CountryUnknownPSCCount": 1
                  },
                  "BeneficialOwners":                   [
                                          {
                        "BeneficiaryIndicator": false,
                        "MemberID": "170660440",
                        "PrimaryName": "D & B SAMPLE CO LTD",
                        "DUNSNumber": "214567885",
                        "SubjectTypeDescription":                         {
                           "@DNBCodeValue": 118,
                           "$": "Businesses"
                        },
                        "LegalFormText":                         {
                           "@DNBCodeValue": 2547,
                           "$": "Private Limited Liability Company"
                        },
                        "PrimaryAddress":                         {
                           "StreetAddressLine": [{"LineText": "Marlow International Parkway"}],
                           "PrimaryTownName": "MARLOW",
                           "CountryISOAlpha2Code": "GB",
                           "PostalCode": "SL7 1AJ",
                           "CountryOfficialName": "United Kingdom"
                        },
                        "OutofBusinessIndicator": false,
                        "DegreeOfSeparation": 0,
                        "ControlOwnershipTypeText":                         {
                           "@DNBCodeValue": 9058,
                           "$": "Privately owned"
                        }
                     },
                                          {
                        "BeneficiaryIndicator": true,
                        "MemberID": "471381701",
                        "PrimaryName": "Fore Sample Corporate Share holder",
                        "SubjectTypeDescription":                         {
                           "@DNBCodeValue": 119,
                           "$": "Individuals"
                        },
                        "DirectOwnershipPercentage": 4.35,
                        "BeneficialOwnershipPercentage": 4.35,
                        "DegreeOfSeparation": 1
                     },
                                          {
                        "BeneficiaryIndicator": true,
                        "MemberID": "468255377",
                        "PrimaryName": "HKNJ Surname",
                        "SubjectTypeDescription":                         {
                           "@DNBCodeValue": 119,
                           "$": "Individuals"
                        },
                        "DirectOwnershipPercentage": 4.35,
                        "BeneficialOwnershipPercentage": 4.35,
                        "DegreeOfSeparation": 1
                     },
                                          {
                        "BeneficiaryIndicator": false,
                        "MemberID": "181707063",
                        "PrimaryName": "D & B SAMPLE PARTNERSHIP",
                        "DUNSNumber": "231824520",
                        "SubjectTypeDescription":                         {
                           "@DNBCodeValue": 118,
                           "$": "Businesses"
                        },
                        "LegalFormText":                         {
                           "@DNBCodeValue": 47,
                           "$": "Partnership"
                        },
                        "PrimaryAddress":                         {
                           "StreetAddressLine":                            [
                              {"LineText": "Marlow International D & B Sample Partnership"},
                              {"LineText": "Parkway"}
                           ],
                           "PrimaryTownName": "MARLOW",
                           "CountryISOAlpha2Code": "GB",
                           "PostalCode": "SL7 1AJ",
                           "CountryOfficialName": "United Kingdom"
                        },
                        "DirectOwnershipPercentage": 0.43,
                        "OutofBusinessIndicator": true,
                        "DegreeOfSeparation": 1,
                        "ControlOwnershipTypeText":                         {
                           "@DNBCodeValue": 9058,
                           "$": "Privately owned"
                        }
                     },
                                          {
                        "BeneficiaryIndicator": false,
                        "MemberID": "185500720",
                        "PrimaryName": "D & B SAMPLE HOLDING CO LTD",
                        "DUNSNumber": "233083567",
                        "SubjectTypeDescription":                         {
                           "@DNBCodeValue": 118,
                           "$": "Businesses"
                        },
                        "LegalFormText":                         {
                           "@DNBCodeValue": 2547,
                           "$": "Private Limited Liability Company"
                        },
                        "PrimaryAddress":                         {
                           "StreetAddressLine": [{"LineText": "41 High Street"}],
                           "PrimaryTownName": "MARKET HARBOROUGH",
                           "CountryISOAlpha2Code": "GB",
                           "PostalCode": "LE16 7NL",
                           "CountryOfficialName": "United Kingdom"
                        },
                        "DirectOwnershipPercentage": 0.87,
                        "OutofBusinessIndicator": false,
                        "DegreeOfSeparation": 1,
                        "ControlOwnershipTypeText":                         {
                           "@DNBCodeValue": 9058,
                           "$": "Privately owned"
                        }
                     },
                                          {
                        "BeneficiaryIndicator": true,
                        "MemberID": "532652332",
                        "PrimaryName": "Rachel Hardwer",
                        "SubjectTypeDescription":                         {
                           "@DNBCodeValue": 119,
                           "$": "Individuals"
                        },
                        "DirectOwnershipPercentage": 0.43,
                        "BeneficialOwnershipPercentage": 0.43,
                        "DegreeOfSeparation": 1
                     },
                                          {
                        "BeneficiaryIndicator": true,
                        "MemberID": "458268746",
                        "PrimaryName": "Test Test 2",
                        "SubjectTypeDescription":                         {
                           "@DNBCodeValue": 119,
                           "$": "Individuals"
                        },
                        "DirectOwnershipPercentage": 0.43,
                        "BeneficialOwnershipPercentage": 0.43,
                        "DegreeOfSeparation": 1
                     },
                                          {
                        "BeneficiaryIndicator": true,
                        "MemberID": "252502820",
                        "PrimaryName": "Test Test 1",
                        "SubjectTypeDescription":                         {
                           "@DNBCodeValue": 119,
                           "$": "Individuals"
                        },
                        "DirectOwnershipPercentage": 5.22,
                        "BeneficialOwnershipPercentage": 5.22,
                        "DegreeOfSeparation": 1
                     },
                                          {
                        "BeneficiaryIndicator": true,
                        "MemberID": "406569461",
                        "PrimaryName": "123 SHOPS testing4Ä",
                        "SubjectTypeDescription":                         {
                           "@DNBCodeValue": 119,
                           "$": "Individuals"
                        },
                        "PrimaryAddress":                         {
                           "StreetAddressLine": [{"LineText": "42 Oakridge Road"}],
                           "PrimaryTownName": "High Wycombe",
                           "CountryISOAlpha2Code": "GB",
                           "CountryOfficialName": "United Kingdom"
                        },
                        "DirectOwnershipPercentage": 0.43,
                        "BeneficialOwnershipPercentage": 0.43,
                        "DegreeOfSeparation": 1
                     },
                                          {
                        "BeneficiaryIndicator": true,
                        "MemberID": "559024352",
                        "PrimaryName": "Forename Test",
                        "SubjectTypeDescription":                         {
                           "@DNBCodeValue": 119,
                           "$": "Individuals"
                        },
                        "PrimaryAddress":                         {
                           "StreetAddressLine":                            [
                              {"LineText": "XYZ"},
                              {"LineText": "Jk Rowlin"}
                           ],
                           "PrimaryTownName": "Birmingham",
                           "CountryISOAlpha2Code": "GB",
                           "CountryOfficialName": "United Kingdom"
                        },
                        "DirectOwnershipPercentage": 0.43,
                        "BeneficialOwnershipPercentage": 0.43,
                        "DegreeOfSeparation": 1
                     },
                                          {
                        "BeneficiaryIndicator": true,
                        "MemberID": "505207842",
                        "PrimaryName": "LIMIRTED PARTNERSHIP WAREHOUSE",
                        "SubjectTypeDescription":                         {
                           "@DNBCodeValue": 118,
                           "$": "Businesses"
                        },
                        "DirectOwnershipPercentage": 4.35,
                        "BeneficialOwnershipPercentage": 4.35,
                        "DegreeOfSeparation": 1
                     },
                                          {
                        "BeneficiaryIndicator": true,
                        "MemberID": "259921260",
                        "PrimaryName": "Might Ican",
                        "SubjectTypeDescription":                         {
                           "@DNBCodeValue": 119,
                           "$": "Individuals"
                        },
                        "DirectOwnershipPercentage": 43.48,
                        "BeneficialOwnershipPercentage": 43.48,
                        "DegreeOfSeparation": 1
                     },
                                          {
                        "BeneficiaryIndicator": true,
                        "MemberID": "553843389",
                        "PrimaryName": "OthersChanges Others",
                        "SubjectTypeDescription":                         {
                           "@DNBCodeValue": 119,
                           "$": "Individuals"
                        },
                        "PrimaryAddress":                         {
                           "StreetAddressLine": [{"LineText": "Address Check"}],
                           "PrimaryTownName": "High Wycombe",
                           "CountryISOAlpha2Code": "GB",
                           "CountryOfficialName": "United Kingdom"
                        },
                        "DirectOwnershipPercentage": 0.43,
                        "BeneficialOwnershipPercentage": 0.43,
                        "DegreeOfSeparation": 1
                     },
                                          {
                        "BeneficiaryIndicator": true,
                        "MemberID": "523364285",
                        "PrimaryName": "KMJ HJNM",
                        "SubjectTypeDescription":                         {
                           "@DNBCodeValue": 119,
                           "$": "Individuals"
                        },
                        "DirectOwnershipPercentage": 4.35,
                        "BeneficialOwnershipPercentage": 4.35,
                        "DegreeOfSeparation": 1
                     },
                                          {
                        "BeneficiaryIndicator": true,
                        "MemberID": "471009273",
                        "SubjectTypeDescription":                         {
                           "@DNBCodeValue": 119,
                           "$": "Individuals"
                        },
                        "PrimaryAddress":                         {
                           "StreetAddressLine":                            [
                              {"LineText": "SHOPS testing4Ä"},
                              {"LineText": "Paulõ"},
                              {"LineText": "aaaaaÖü"}
                           ],
                           "PrimaryTownName": "Gateway1ä",
                           "CountryISOAlpha2Code": "GB",
                           "CountryOfficialName": "United Kingdom"
                        },
                        "DegreeOfSeparation": 2
                     },
                                          {
                        "BeneficiaryIndicator": true,
                        "MemberID": "266707889",
                        "PrimaryName": "Test Test",
                        "SubjectTypeDescription":                         {
                           "@DNBCodeValue": 119,
                           "$": "Individuals"
                        },
                        "PrimaryAddress":                         {
                           "StreetAddressLine": [{"LineText": "sss"}],
                           "PrimaryTownName": "sss",
                           "CountryISOAlpha2Code": "IE",
                           "CountryOfficialName": "Ireland"
                        },
                        "IndirectOwnershipPercentage": 0,
                        "BeneficialOwnershipPercentage": 0,
                        "DegreeOfSeparation": 2
                     }
                  ],
                  "Relationships":                   [
                                          {
                        "RelationshipID": "304752799",
                        "SourceMemberID": "170660440",
                        "TargetMemberID": "471381701",
                        "RelationshipTypeDescription":                         {
                           "@DNBCodeValue": 137,
                           "$": "Share Ownership"
                        },
                        "ShareHoldingPercentage": 4.35
                     },
                                          {
                        "RelationshipID": "131608421",
                        "SourceMemberID": "170660440",
                        "TargetMemberID": "468255377",
                        "RelationshipTypeDescription":                         {
                           "@DNBCodeValue": 137,
                           "$": "Share Ownership"
                        },
                        "ShareHoldingPercentage": 4.35
                     },
                                          {
                        "RelationshipID": "307721852",
                        "SourceMemberID": "170660440",
                        "TargetMemberID": "181707063",
                        "RelationshipTypeDescription":                         {
                           "@DNBCodeValue": 137,
                           "$": "Share Ownership"
                        },
                        "ShareHoldingPercentage": 0.43
                     },
                                          {
                        "RelationshipID": "272391846",
                        "SourceMemberID": "170660440",
                        "TargetMemberID": "185500720",
                        "RelationshipTypeDescription":                         {
                           "@DNBCodeValue": 137,
                           "$": "Share Ownership"
                        },
                        "ShareHoldingPercentage": 0.87
                     },
                                          {
                        "RelationshipID": "348803789",
                        "SourceMemberID": "170660440",
                        "TargetMemberID": "532652332",
                        "RelationshipTypeDescription":                         {
                           "@DNBCodeValue": 137,
                           "$": "Share Ownership"
                        },
                        "ShareHoldingPercentage": 0.43
                     },
                                          {
                        "RelationshipID": "271200260",
                        "SourceMemberID": "170660440",
                        "TargetMemberID": "458268746",
                        "RelationshipTypeDescription":                         {
                           "@DNBCodeValue": 137,
                           "$": "Share Ownership"
                        },
                        "ShareHoldingPercentage": 0.43
                     },
                                          {
                        "RelationshipID": "224837955",
                        "SourceMemberID": "170660440",
                        "TargetMemberID": "252502820",
                        "RelationshipTypeDescription":                         {
                           "@DNBCodeValue": 137,
                           "$": "Share Ownership"
                        },
                        "ShareHoldingPercentage": 5.22
                     },
                                          {
                        "RelationshipID": "270749272",
                        "SourceMemberID": "170660440",
                        "TargetMemberID": "406569461",
                        "RelationshipTypeDescription":                         {
                           "@DNBCodeValue": 137,
                           "$": "Share Ownership"
                        },
                        "ShareHoldingPercentage": 0.43
                     },
                                          {
                        "RelationshipID": "302746009",
                        "SourceMemberID": "170660440",
                        "TargetMemberID": "559024352",
                        "RelationshipTypeDescription":                         {
                           "@DNBCodeValue": 137,
                           "$": "Share Ownership"
                        },
                        "ShareHoldingPercentage": 0.43
                     },
                                          {
                        "RelationshipID": "269736876",
                        "SourceMemberID": "170660440",
                        "TargetMemberID": "505207842",
                        "RelationshipTypeDescription":                         {
                           "@DNBCodeValue": 137,
                           "$": "Share Ownership"
                        },
                        "ShareHoldingPercentage": 4.35
                     },
                                          {
                        "RelationshipID": "300865245",
                        "SourceMemberID": "170660440",
                        "TargetMemberID": "259921260",
                        "RelationshipTypeDescription":                         {
                           "@DNBCodeValue": 137,
                           "$": "Share Ownership"
                        },
                        "ShareHoldingPercentage": 43.48
                     },
                                          {
                        "RelationshipID": "267938254",
                        "SourceMemberID": "170660440",
                        "TargetMemberID": "553843389",
                        "RelationshipTypeDescription":                         {
                           "@DNBCodeValue": 137,
                           "$": "Share Ownership"
                        },
                        "ShareHoldingPercentage": 0.43
                     },
                                          {
                        "RelationshipID": "237716524",
                        "SourceMemberID": "170660440",
                        "TargetMemberID": "523364285",
                        "RelationshipTypeDescription":                         {
                           "@DNBCodeValue": 137,
                           "$": "Share Ownership"
                        },
                        "ShareHoldingPercentage": 4.35
                     },
                                          {
                        "RelationshipID": "27767544",
                        "SourceMemberID": "181707063",
                        "TargetMemberID": "471009273",
                        "RelationshipTypeDescription":                         {
                           "@DNBCodeValue": 137,
                           "$": "Share Ownership"
                        }
                     },
                                          {
                        "RelationshipID": "36919080",
                        "SourceMemberID": "185500720",
                        "TargetMemberID": "266707889",
                        "RelationshipTypeDescription":                         {
                        "@DNBCodeValue": 33700,
                        "$": "Persons of Significant Control"
                        },
                     "NatureOfControlDescription": [                     {
                        "@DNBCodeValue": 30850,
                        "$": "Ownership of 75% to 100% of shares"
                     }],
                     "NatureOfControlClassDescription": [                     {
                        "@DNBCodeValue": 33476,
                        "$": "Ownership or voting rights of 75% to 100%"
                     }],
                     "NatureOfControlStartDate": "2016-07-11"
                     }
                  ]
               }
            }
         },
         "ArchiveDetail": {"PortfolioAssetID": 89142921}
      }
   }
}}

CMP_BOL CMP_BOS Name Characteristics
Y Y OrderProductResponse { TransactionDetail Aggregate, Required

Records information necessary to process a particular request. Examples of a request is the ordering of a product.

Y Y OrderProductResponse { TransactionDetail { ApplicationTransactionID Element, string, up to 64 chars., Optional

A number assigned by the calling application to uniquely identify this request.

Y Y OrderProductResponse { TransactionDetail { ServiceTransactionID Element, string, up to 64 chars., Required

A number assigned by the D&B service to uniquely identify this transaction.

Y Y OrderProductResponse { TransactionDetail { TransactionTimestamp Element, date & time, Required

The date and time when this request was submitted or the date and time when the requesting intermediary, such as a workflow manager or service bus, sent the message to the D&B function, i.e., the date and time when the xml document was created by the requesting intermediary.

Y Y End: OrderProductResponse { TransactionDetail Aggregate, Required
Y Y OrderProductResponse { TransactionResult Aggregate, Required

An aggregate that can repeat multiple times to record the different outcomes of the transaction.

Y Y OrderProductResponse { TransactionResult { SeverityText Element, string, up to 16 chars., Required

Text that records the criticality of the outcome, e.g., Information, Warning, Error, Fatal.

Y Y OrderProductResponse { TransactionResult { ResultID Element, string, up to 32 chars., Required

An alphanumeric string that uniquely identifies the outcome of the transaction.

Y Y OrderProductResponse { TransactionResult { ResultText Element, string, up to 512 chars., Optional

Text that explains the outcome of the transaction.

Y Y OrderProductResponse { TransactionResult { ResultMessage Aggregate, Optional (Array)

An aggregate that can repeat multiple times to record textual data that expands on the ResultID and ResultText to provide additional information to the user regarding the status of the transaction. If the status implies that there is a problem this may also provide guidance to the user on how to address it.

Y Y OrderProductResponse { TransactionResult { ResultMessage { ResultDescription Element, string, up to 512 chars., Required

Text that describes the additional information regarding the outcome of the transaction.

Y Y End: OrderProductResponse { TransactionResult { ResultMessage Aggregate
Y Y End: OrderProductResponse { TransactionResult Aggregate
Y Y OrderProductResponse { OrderProductResponseDetail Aggregate, Optional

Records the data being returned to the customer as a result of a product request.

Y Y OrderProductResponse { OrderProductResponseDetail { InquiryDetail Aggregate, Required

Records data that allows the customer to specify identifying information about the subject being inquired, e.g., the DUNS Number, the address, the telephone number.

Y Y OrderProductResponse { OrderProductResponseDetail { InquiryDetail { DUNSNumber Element, string, up to 15 chars. Pattern: {([0-9a-zA-Z]*)}., Required

Business Element: DUNS Number


The D-U-N-S Number is D&B's identification number, which provides unique identification of this organization, in accordance with the Data Universal Numbering System (D-U-N-S).

Y Y OrderProductResponse { OrderProductResponseDetail { InquiryDetail { CountryISOAlpha2Code Element, Optional

The two-letter country/market code, defined in the ISO 3166-1 scheme published by International Organization for Standardization (ISO)identifying the country/market of the inquired subject.

Y Y End: OrderProductResponse { OrderProductResponseDetail { InquiryDetail Aggregate
Y Y OrderProductResponse { OrderProductResponseDetail { Product Aggregate, Required

Records data about the product ordered by the customer and data about the organization on which the customer has placed this order.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { DNBProductID Element, string, up to 64 chars., Optional

An alphanumeric string that uniquely identifies this product.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { LanguageCode Element, integer, up to 7 digits., Optional

A D&B code value that defines the language in which the requested product is fulfilled.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization Aggregate, Required

Records data about an organization, a legal or commercial entity established to provide products and/or services in the marketplace or to the community.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { SubjectHeader Aggregate, Required

Records high level information about the subject such as the primary language of the subject and the primary currency in which this subject trades. When the subject is an organizantion, this may also include details such as DUNS Number.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { SubjectHeader { DUNSNumber Element, string, up to 15 chars. Pattern: {([0-9a-zA-Z]*)}., Optional

Business Element: DUNS Number


The D-U-N-S Number is D&B's identification number, which provides unique identification of this organization, in accordance with the Data Universal Numbering System (D-U-N-S).

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { SubjectHeader { CountryISOAlpha2Code Element, Optional

Business Element: Country/Market Code


The two-letter country/market code, defined in the ISO 3166-1 scheme published by International Organization for Standardization (ISO), identifying the country/market where the subject is located

Y Y End: OrderProductResponse { OrderProductResponseDetail { Product { Organization { SubjectHeader Aggregate
Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location Aggregate, Optional

Records the address details for a subject. An address is the designation of a place where a subject can be located or may be communicated with, e.g., primary address, registered address, mailing address.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { PrimaryAddress Aggregate, Optional (Array)

An entry loop to allow the recording of a single primary or physical address of the subject in multiple languages and/or writing scripts. For an organization this is the principal address at which the organization is located. For an individual, this is the home address.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { PrimaryAddress @LanguageCode Attribute
Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { PrimaryAddress @WritingScriptCode Attribute
Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { PrimaryAddress { StreetAddressLine Aggregate, Optional (Array)

Business Element: Address Line


An entry loop which can repeat multiple times to allow the recording of several lines where each address line contains one or more named address elements. Examples of named address elements are Street Name, Street Number, Building Name, Estate Name. They are called “lines” because an addres can be divided into multiple lines. When there are multiple lines the sequence of the lines must be preserved.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { PrimaryAddress { StreetAddressLine { LineText Element, string, up to 240 chars., Required

Text that records the street address components as it would be presented on an address label. This includes, but is not limited to, details such as street name, street number, building name, estate name.

Y Y End: OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { PrimaryAddress { StreetAddressLine Aggregate
Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { PrimaryAddress { PrimaryTownName Element, string, up to 64 chars., Optional

Business Element: Primary Town


The name of the town or city recognized by the Postal Authority for delivering mail.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { PrimaryAddress { CountryISOAlpha2Code Element, Optional

Business Element: Country/Market Code


The two-letter country/market code, defined in the ISO 3166-1 scheme published by International Organization for Standardization (ISO), identifying the country/market for this address.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { PrimaryAddress { TerritoryName Element, string, up to 128 chars., Optional

Business Element: Province or State


The name of the locally governed area which forms part of a centrally governed nation as received by D&B. Clarification Note: As a guiding principle this is a geographic area which could theoretically exist as a separate nation. In the U.S. this would be a State. In the UK this would be one of the Home Nations.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { PrimaryAddress { PostalCode Element, string, up to 16 chars., Optional

Business Element: Postal Code


An identifier used by the local country Postal Authority to identify a particular geographic location. For example, in Belgium, Postal Code 9000 identifies the town of GHENT.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { PrimaryAddress { CountryOfficialName Element, string, up to 64 chars., Optional

Business Element: Country Name


The legal name of the country for this address.

Y Y End: OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { PrimaryAddress Aggregate
Y Y End: OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location Aggregate
Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationName Aggregate, Optional

Records the different names of the organization by which it is known as well as names of other organizations that have a similar name to this organization.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationName { OrganizationPrimaryName Aggregate, Optional (Array)

An entry loop which can repeat multiple times to allow the recording of a single name by which the organization is primarily known / identified in different languages and/or writing scripts.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationName { OrganizationPrimaryName { OrganizationName Element, string, up to 256 chars., Required

Business Element: Organization Name


Text recording a name of this organization in the specified language and/or writing script.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationName { OrganizationPrimaryName { OrganizationName @LanguageCode Attribute
Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationName { OrganizationPrimaryName { OrganizationName @WritingScriptISOAlpha4Code Attribute
Y Y End: OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationName { OrganizationPrimaryName Aggregate
Y Y End: OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationName Aggregate
Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationDetail Aggregate, Optional

Records fundamental information about a Subject which may vary over time.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationDetail { ControlOwnershipTypeText Element, string, up to 256 chars., Optional

Business Element: Subject/ Target Control Type Description


Text that describes the type of controlling ownership, e.g., publicly owned, privately owned, state owned. Note: For some countries, controlling ownership can be derived from the legal form.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationDetail { ControlOwnershipTypeText @DNBCodeValue Attribute, integer, up to 7 digits, Optional

Business Element: Subject/ Target Control Type Code


A unique number assigned by D&B to identify the fact recorded in this data element.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationDetail { OutofBusinessIndicator Element, boolean, Optional

Business Element: Operating Status


When turned ON (set to TRUE) it indicates that this organization is no longer functional / trading. When turned OFF (set to FALSE) it indicates that this organization is functioning / trading.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationDetail { ControlOwnershipTypeConfidenceLevel Element, string, up to 256 chars., Optional

Business Element: Subject/ Target Control Type Confidence Description


Text that specifies the level of the confidence for the reported control type within the spectrum, e.g., Low, Medium, High.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationDetail { ControlOwnershipTypeConfidenceLevel @DNBCodeValue Attribute, integer, up to 7 digits, Optional

Business Element: Subject/ Target Control Type Confidence Code


A unique number assigned by D&B to identify the fact recorded in this data element.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationDetail { OwnershipUnavailableReason Aggregate, Optional (Infinite)

Records information on why ownership information is unavailable for this Organization.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationDetail { OwnershipUnavailableReason { UnavailableReasonText Element, string, up to 256 chars., Required

Business Element: Graceful CBO Notifications


A text identifying the reason why ownership information for this Organization is unavailable.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationDetail { OwnershipUnavailableReason { UnavailableReasonText @DNBCodeValue Attribute, integer, up to 7 digits, Optional

A unique number assigned by D&B to identify the fact recorded in this data element.

Y Y End:OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationDetail { OwnershipUnavailableReason Aggregate, Optional
Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationDetail { PSCUnavailableReason Aggregate, Optional (Infinite)

Records information on why Persons of Significant control information is unavailable for this Organization.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationDetail { PSCUnavailableReason { UnavailableReasonDescription Element, string, up to 256 chars., Required

Business Element: Significant Person Notifications


A text identifying the reason why Persons of Significant control information for this Organization is unavailable.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationDetail { PSCUnavailableReason { UnavailableReasonDescription @DNBCodeValue Attribute, integer, up to 7 digits, Optional

A unique number assigned by D&B to identify the fact recorded in this data element.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationDetail { PSCUnavailableReason { StartDate Element, string, Optional

The date from when the Persons of Significant control information for this Organization is unavailable.

Y Y End:OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationDetail { PSCUnavailableReason Aggregate, Optional
Y Y End: OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationDetail Aggregate
Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { RegisteredDetail Aggregate, Optional

Records the constitutional status of a subject as defined under the laws of a country E.g.; Limited Company, Partnership, co-operative Society and the Stock Equity or share structure employed by a business according to the legal form and rules of incorporation. The owners of the stock or shares are the owners of the business.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { RegisteredDetail { LegalFormDetails Aggregate, Optional

Records the details on the current legal form of a subject.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { RegisteredDetail { LegalFormDetails { LegalFormText Element, string, up to 256 chars., Required

Business Element: Legal Form Code


Text that describes the legal form or structure of a business, as registered with government authorities, e.g., partnership, corporation, private limited company, government department, proprietorship.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { RegisteredDetail { LegalFormDetails { LegalFormText @DNBCodeValue Attribute
Y Y End: OrderProductResponse { OrderProductResponseDetail { Product { Organization { RegisteredDetail { LegalFormDetails Aggregate
Y Y End: OrderProductResponse { OrderProductResponseDetail { Product { Organization { RegisteredDetail Aggregate
Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { IndustryCode Aggregate, Optional

Records the business activities in which an organization is actively engaged using standardized coding schemes such as European NACE and U.S. Standard Industry Classifications (SIC). Examples of business activities are: commercial printing, legal services, drug store, sheet metalwork fabricator.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { IndustryCode { PrimaryIndustryCode Aggregate, Optional (Array)

An entry loop which can repeat multiple times to allow the recording of the primary business activity in which an organization is actively engaged using standardized coding schemes such as European NACE and U.S. Standard Industry Classifications (SIC) where each entry loop occurrence records a primary business activity in a different standardized coding scheme.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { IndustryCode { PrimaryIndustryCode @DNBCodeValue Attribute
Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { IndustryCode { PrimaryIndustryCode @TypeText Attribute
Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { IndustryCode { PrimaryIndustryCode { IndustryCode Element, string, up to 16 chars., Required

Business Element: SIC Code


An alphanumeric value identifying a business activity based on the scheme specified by the typeText. For instance, 1611 represents the highway and street construction industry in the U.S. SIC (Standard Industrial Classification) system. Clarification Note: These are generally external codes created by an external authoritative body, like the U.S. Office of Management and Budget (OMB), but D&B may have created extensions to more precisely define an activity, as in the case of the SIC 2+2 (the last 4 digits of an 8-digit SIC).

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { IndustryCode { PrimaryIndustryCode { IndustryCodeDescription Element, Optional (Array)

Business Element: SIC Code Description


Text that describes the business activity based on the scheme specified by the attribute typeText. E.g., 'highway and street construction' is the description of industry code 1611 in the U.S. SIC (Standard Industrial Classification) system.

Y Y End: OrderProductResponse { OrderProductResponseDetail { Product { Organization { IndustryCode { PrimaryIndustryCode Aggregate
Y Y End: OrderProductResponse { OrderProductResponseDetail { Product { Organization { IndustryCode Aggregate
Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage Aggregate, Optional

Records the relationship between the subject and the next subject UP in the family tree. E.g. Its Parent, HQ, Joint Parent or shareholder. Also records names, addresses and registration numbers for the related subject. This data topic may also be used to record the details of the relationship between the subject and the business founder; however if a simple textual reference to the business founder is all that is required then the 'Started By' element in 'Subject Details' should be used

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { GlobalUltimateOrganization Aggregate, Optional

Records information about the top most business in the family tree, tracing each parent up to its own parent. For example, Company A is a business based in the US and has company B as its parent also in the US. In turn company B is owned by company C, also in the US, which is owned by company D which is in the UK. Thus the Global Ultimate" of this family tree (and therefore of each member of the family tree) is Company D.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { GlobalUltimateOrganization { DUNSNumber Element, string, up to 15 chars. Pattern: {([0-9a-zA-Z]*)}., Optional

Business Element: Global Ultimate DUNS


The D-U-N-S Number is D&B's identification number, which provides unique identification of this organization, in accordance with the Data Universal Numbering System (D-U-N-S).

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { GlobalUltimateOrganization { OrganizationPrimaryName Aggregate, Optional (Array)

An entry loop which can repeat multiple times to allow the recording of a single name by which the organization is primarily known / identified in different languages and/or writing scripts.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { GlobalUltimateOrganization { OrganizationPrimaryName { OrganizationName Element, string, up to 256 chars., Required

Business Element: Global Ultimate Name


Text recording a name of this organization in the specified language and/or writing script.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { GlobalUltimateOrganization { OrganizationPrimaryName { OrganizationName @LanguageCode Attribute
Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { GlobalUltimateOrganization { OrganizationPrimaryName { OrganizationName @WritingScriptISOAlpha4Code Attribute
Y Y End: OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { GlobalUltimateOrganization { OrganizationPrimaryName Aggregate
Y Y End: OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { GlobalUltimateOrganization Aggregate
Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { DomesticUltimateOrganization Aggregate, Optional

Records information about the last business in the tree, when reviewing upwards, which is in the same country as the other subject. For example, Company A is a business based in the US and has company B as its parent also in the US. In turn company B is owned by company C, also in the US, which is owned by company D which is in the UK. Thus the Domestic Ultimate" of Company A is actually Company C as this is the last business in the parent chain which is in the US

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { DomesticUltimateOrganization { DUNSNumber Element, string, up to 15 chars. Pattern: {([0-9a-zA-Z]*)}., Optional

Business Element: Domestic Ultimate DUNS


The D-U-N-S Number is D&B's identification number, which provides unique identification of this organization, in accordance with the Data Universal Numbering System (D-U-N-S).

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { DomesticUltimateOrganization { OrganizationPrimaryName Aggregate, Optional (Array)

An entry loop which can repeat multiple times to allow the recording of a single name by which the organization is primarily known / identified in different languages and/or writing scripts.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { DomesticUltimateOrganization { OrganizationPrimaryName { OrganizationName Element, string, up to 256 chars., Required

Business Element: Domestic Ultimate Name


Text recording a name of this organization in the specified language and/or writing script.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { DomesticUltimateOrganization { OrganizationPrimaryName { OrganizationName @LanguageCode Attribute
Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { DomesticUltimateOrganization { OrganizationPrimaryName { OrganizationName @WritingScriptISOAlpha4Code Attribute
Y Y End: OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { DomesticUltimateOrganization { OrganizationPrimaryName Aggregate
Y Y End: OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { DomesticUltimateOrganization Aggregate
Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization Aggregate, Optional

Records information about the organization which owns more than 50% of the subject and the organization at the very top of the legal family.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { DUNSNumber Element, string, up to 15 chars. Pattern: {([0-9a-zA-Z]*)}., Optional

Business Element: Parent DUNS


The D-U-N-S Number is D&B's identification number, which provides unique identification of this organization, in accordance with the Data Universal Numbering System (D-U-N-S).

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { OrganizationPrimaryName Aggregate, Optional (Array)

An entry loop which can repeat multiple times to allow the recording of a single name by which the organization is primarily known / identified in different languages and/or writing scripts.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { OrganizationPrimaryName { OrganizationName Element, string, up to 256 chars., Required

Business Element: Parent Name


Text recording a name of this organization in the specified language and/or writing script.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { OrganizationPrimaryName { OrganizationName @LanguageCode Attribute
Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { OrganizationPrimaryName { OrganizationName @WritingScriptISOAlpha4Code Attribute
Y Y End: OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { OrganizationPrimaryName Aggregate
Y Y End: OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization Aggregate
Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { BeneficialOwnership Aggregate, Optional

Records the details of the owners of the subject company that can include direct, indirect and beneficial owners.The details under this section can be used to generate/visualize the ownership structure at this point.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { BeneficialOwnership { Summary Aggregate, Optional

Records the indicative or derived information about the ownership structure of the subject company.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { BeneficialOwnership { Summary { BeneficialOwnersCount Element, unsignedInt, Required if Aggregate present

Business Element: Total Number of Nodes


The number of owners of the subject company that can include direct, indirect and beneficial owners.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { BeneficialOwnership { Summary { RelationshipsCount Element, unsignedInt, Required if Aggregate present

Business Element: Number of Relationships


The number of relationships between members in an ownership structure for a subject company.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { BeneficialOwnership { Summary { OrganizationsCount Element, unsignedInt, Required if Aggregate present

Business Element: Total Number of Organizations


The number of owners of the subject company that are identified as business entities

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { BeneficialOwnership { Summary { IndividualsCount Element, unsignedInt, Required if Aggregate present

Business Element: Total Number of Individuals


The number of owners of the subject company that are identified as individuals.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { BeneficialOwnership { Summary { UnclassifedOwnerCount Element, unsignedInt, Required if Aggregate present

Business Element: Total Number of Entities


The number of owners of the subject company that are not categorized as individual or organization.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { BeneficialOwnership { Summary { CorporateBeneficiariesCount Element, unsignedInt, Required if Aggregate present

Business Element: Total Number of CBOs


The number of ultimate beneficiaries of the subject company that are identified as legally setup corporate businesses.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { BeneficialOwnership { Summary { MaximumDegreeOfSeparation Element, unsignedInt, Required if Aggregate present

Business Element: Maximum Degree of Separation


The farthest distance between the subject company and another owner within the ownership structure.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { BeneficialOwnership { Summary { TotalAllocatedOwnershipPercentage Element, decimal, up to 5 digits. Maximum of 2 decimal, places., Required if Aggregate present

Business Element: Total Allocated Beneficial Ownership Percentage


This denotes the overall percentage of shares of the subject company that are known to be allocated to share owners.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { BeneficialOwnership { Summary { CountrywiseSummary Aggregate, Optional (Array)

Business Element: Country Wise Split up of Nodes


Records the indicative or derived information about the owners of the subject company in each country.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { BeneficialOwnership { Summary { CountrywiseSummary { CountryISOAlpha2Code Element, string, at least 2 chars up to 2 chars, Required if Aggregate present

Business Element: Country/Market Code


The two-letter country/market code, defined in the ISO 3166-1 scheme published by International Organization for Standardization (ISO)identifying the country/market of the inquired subject.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { BeneficialOwnership { Summary { CountrywiseSummary { BeneficialOwnersCount Element, unsignedInt, Required if Aggregate present

The number of owners of the subject company that can include direct, indirect and beneficial owners.

Y Y End: OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { BeneficialOwnership { Summary { CountrywiseSummary Aggregate
Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { BeneficialOwnership { Summary { UnknownCountryBeneficiariesCount Element, unsignedInt, Optional

Business Element: Number of Nodes with Unknown Country


The number of owners of the subject company for which the owner's country is not known.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { BeneficialOwnership { Summary { StateOwnedOrganizationsCount Element, unsignedInt, Required

Business Element: Number of State Owned Organizations


The number of owners of the subject company that are classified as State Owned Organization. This does not include the subject company.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { BeneficialOwnership { Summary { GovernmentOrganizationsCount Element, unsignedInt, Required

Business Element: Number of Government Organizations


The number of owners of the subject company that are classified as Government Organization. This does not include the subject company.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { BeneficialOwnership { Summary { PubliclyTradingOrganizationsCount Element, unsignedInt, Required

Business Element: Number of Publicly Trading Organizations


The number of owners of the subject company that are classified as Publicly Trading Organization. This does not include the subject company.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { BeneficialOwnership { Summary { PrivatelyHeldOrganizationsCount Element, unsignedInt, Required

Business Element: Number of Privately Held Organizations


The number of owners of the subject company that are classified as Privately Held Organization. This does not include the subject company.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { BeneficialOwnership { Summary { PSCCount Element, unsignedInt, Optional

Business Element: Significant person Count


The number of owners of the subject company that are classified as Persons of Significant Control Organization. This does not include the subject company.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { BeneficialOwnership { Summary { PSCUniqueTypeCount Element, unsignedInt, Optional

Business Element: Significant unique person Count


The number of distinct types of Persons of Significant Control present for the subject company.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { BeneficialOwnership { Summary { TypewisePSCSummary Aggregate, Optional (Infinite)

Records information on the count of owners of the subject company per type of Persons of Significant Control

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { BeneficialOwnership { Summary { TypewisePSCSummary { PSCTypeText Element, string, up to 256 chars., Required

Business Element: Type of Significant Controls


The text denotes the type of Persons of Significant Control For e.g., Individual, Corporates, Legal persons, Super Secure.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { BeneficialOwnership { Summary { TypewisePSCSummary { PSCTypeText @DNBCodeValue Attribute, integer, up to 7 chars., Optional

Business Element: Type code of Significant Controls


A unique number assigned by D&B to identify the fact recorded in this data element.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { BeneficialOwnership { Summary { TypewisePSCSummary { PSCCount Element, unsignedInt, Required

Business Element: Typewise Significant person Count


The number of owners of the subject company that are classified as Persons of Significant Control type.

Y Y End: OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { BeneficialOwnership { Summary { TypewisePSCSummary Aggregate
Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { BeneficialOwnership { Summary { NationalitywisePSCSummary Aggregate, Optional (Infinite)

Records information on the count of owners of the subject company per nationality.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { BeneficialOwnership { Summary { NationalitywisePSCSummary { Nationality Element, string, up to 64 chars., Required

Business Element: Nationality


The nationality of the Person of Significant control.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { BeneficialOwnership { Summary { NationalitywisePSCSummary { PSCCount Element, unsignedInt, Required

Business Element: Nationwise Significant person Count


The number of owners of the subject company that are classified as Persons of Significant Control type.

Y Y End: OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { BeneficialOwnership { Summary { NationalitywisePSCSummary Aggregate
Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { BeneficialOwnership { Summary { NationalityUnknownPSCCount Element, unsignedInt, Optional

Business Element: Unknown Significant person Count


The number of unknown nationality owners of the subject company.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { BeneficialOwnership { Summary { CountrywisePSCSummary Aggregate, Optional (Infinite)

Business Element: Owner count


Records information on the count of owners of the subject company per country.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { BeneficialOwnership { Summary { CountrywisePSCSummary { CountryISOAlpha2Code Element, string, up to 2 chars., Required

Business Element: Country/Market Code


The two-letter country/market code, defined in the ISO 3166-1 scheme published by International Organization for Standardization (ISO)identifying the country/market of the inquired subject.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { BeneficialOwnership { Summary { CountrywisePSCSummary { PSCCount Element, unsignedInt, Required

Business Element: Countrywise Significant person Count


The number of owners of the subject company for this country.

Y Y End: OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { BeneficialOwnership { Summary { CountrywisePSCSummary Aggregate
Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { BeneficialOwnership { Summary { CountryUnknownPSCCount Element, unsignedInt, Optional

Business Element: Countrywise Unknown Significant person Count


The number of unknown country owners of the subject company.

Y Y End: OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { BeneficialOwnership { Summary Aggregate
Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { BeneficialOwnership { BeneficialOwners Aggregate, Required (Array)

An entry loop that can repeat multiple times to allow the recording of the details of the Beneficiaries of the subject company

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { BeneficialOwnership { BeneficialOwners { BeneficiaryIndicator Element, boolean, Required

Business Element: Beneficiary Indicator


When turned ON (set to TRUE) it indicates that this owner is identified as a beneficiary. When turned OFF (set to FALSE) it indicates that this owner is not identified as a beneficiary.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { BeneficialOwnership { BeneficialOwners { MemberID Element, string, up to 16 chars., Optional

Business Element: Member ID


A unique identifier assigned by D&B at this point of time for a node, entity associated in this structure. This system generated ID is bound to change at a later point of time. Note: This element is mandatory to create the ownership structure

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { BeneficialOwnership { BeneficialOwners { PrimaryName Element, string, up to 256 chars., Optional

Business Element: Member Name


Records the single name by which the individual / organization is primarily known / identified.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { BeneficialOwnership { BeneficialOwners { DUNSNumber Element, string, up to 15 chars. Pattern: {([0-9a-zA-Z]*)}., Optional

Business Element: D-U-N-S Number


The D-U-N-S Number is D&B's identification number, which provides unique identification of this organization, in accordance with the Data Universal Numbering System (D-U-N-S).

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { BeneficialOwnership { BeneficialOwners { PersonID Element, string, up to 32 chars., Optional

Business Element: Person identifier


The personal identification number or shareholder number assigned by an external body that helps to identify a shareholder.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { BeneficialOwnership { BeneficialOwners { SubjectTypeDescription Element, string, up to 256 chars., Optional

Business Element: Member Type Code


Text identifying whether the owner is an Individual or a Company or that this is Unknown.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { BeneficialOwnership { BeneficialOwners { SubjectTypeDescription @DNBCodeValue Attribute
Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { BeneficialOwnership { BeneficialOwners { LegalFormText Element, string, up to 256 chars., Optional

Business Element: Legal Form Code


Text that denotes the legal form or structure of this owner business as registered with government authorities, e.g., partnership, corporation, private limited company, government department, proprietorship.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { BeneficialOwnership { BeneficialOwners { LegalFormText @DNBCodeValue Attribute
Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { BeneficialOwnership { BeneficialOwners { PrimaryAddress Aggregate, Optional (Array)

Business Element: Primary Address


An entry loop to allow the recording of a single primary or physical address of the subject in multiple languages and/or writing scripts. For an organization this is the principal address at which the organization is located. For an individual, this is the home address.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { BeneficialOwnership { BeneficialOwners { PrimaryAddress @LanguageCode Attribute
Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { BeneficialOwnership { BeneficialOwners { PrimaryAddress @WritingScriptCode Attribute
Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { BeneficialOwnership { BeneficialOwners { PrimaryAddress { StreetAddressLine Aggregate, Optional (Array)

Business Element: Street Address Line Text


An entry loop which can repeat multiple times to allow the recording of several lines where each address line contains one or more named address elements. Examples of named address elements are Street Name, Street Number, Building Name, Estate Name. They are called “lines” because an address can be divided into multiple lines. When there are multiple lines the sequence of the lines must be preserved.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { BeneficialOwnership { BeneficialOwners { PrimaryAddress { StreetAddressLine { LineText Element, string, up to 240 chars., Required

Text that records the street address components as it would be presented on an address label. This includes, but is not limited to, details such as street name, street number, building name, estate name.

Y Y End: OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { BeneficialOwnership { BeneficialOwners { PrimaryAddress { StreetAddressLine Aggregate
Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { BeneficialOwnership { BeneficialOwners { PrimaryAddress { PrimaryTownName Element, string, up to 64 chars., Optional

Business Element: Primary Town


The name of the town or city recognized by the Postal Authority for delivering mail.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { BeneficialOwnership { BeneficialOwners { PrimaryAddress { CountryISOAlpha2Code Element, Optional

Business Element: Country/Market Code


The two-letter country/market code, defined in the ISO 3166-1 scheme published by International Organization for Standardization (ISO), identifying the country/market for this address.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { BeneficialOwnership { BeneficialOwners { PrimaryAddress { TerritoryName Element, string, up to 128 chars., Optional

Business Element: State


The name of the locally governed area which forms part of a centrally governed nation as received by D&B Clarification. Note: As a guiding principle this is a geographic area which could theoretically exist as a separate nation. In the U.S. this would be a State. In the UK this would be one of the Home Nations.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { BeneficialOwnership { BeneficialOwners { PrimaryAddress { PostalCode Element, string, up to 16 chars., Optional

Business Element: Postal Code


An identifier used by the local country Postal Authority to identify a particular geographic location. For example, in Belgium, Postal Code 9000 identifies the town of GHENT.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { BeneficialOwnership { BeneficialOwners { PrimaryAddress { CountryOfficialName Element, string, up to 128 chars., Optional

Business Element: Country Name


The country name, defined in the scheme published by International Organization for Standardization (ISO) identifying the country of the inquired subject.

Y Y End: OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { BeneficialOwnership { BeneficialOwners { PrimaryAddress Aggregate
Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { BeneficialOwnership { BeneficialOwners { DirectOwnershipPercentage Element, decimal, up to 5 digits. Maximum of 2 decimal, places., Optional

Business Element: Direct Ownership Percentage


This denotes the owner's direct shareholding percentage.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { BeneficialOwnership { BeneficialOwners { IndirectOwnershipPercentage Element, decimal, up to 5 digits. Maximum of 2 decimal, places., Optional

Business Element: Indirect Ownership Percentage


This denotes the owner's indirect shareholding percentage.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { BeneficialOwnership { BeneficialOwners { BeneficialOwnershipPercentage Element, decimal, up to 5 digits. Maximum of 2 decimal, places., Optional

Business Element: Beneficial Ownership Percentage


This denotes the owner's actual shareholding percentage.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { BeneficialOwnership { BeneficialOwners { Nationality Element, string, up to 256 chars., Optional

Business Element: Nationality


The nationality of the owner if the owner is an individual.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { BeneficialOwnership { BeneficialOwners { BirthDate Element, string, up to 16 chars., Optional

Business Element: Date Of Birth


The date of birth of the owner if the owner is an individual.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { BeneficialOwnership { BeneficialOwners { MinorityOwnershipIndicator Element, boolean, Optional

Business Element: Minority Shareholder Indicator


When turned ON (set to TRUE) it indicates that the named shareholder is a minor or minority shareholder, i.e. holds less than 50% of the shares and is not considered to own a significant stake in the organization, although the precise amount of the shareholding is not known

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { BeneficialOwnership { BeneficialOwners { OutofBusinessIndicator Element, boolean, Optional

Business Element: Operating Status Indicator


When turned ON (set to TRUE) it indicates that the owner company is currently Out of Business.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { BeneficialOwnership { BeneficialOwners { DegreeOfSeparation Element, integer, Optional

Business Element: Degree of Separation


A number that denotes the distance between this beneficiary and the subject within the ownership structure.

Y N OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { BeneficialOwnership { BeneficialOwners { UndisclosedIndicator Element, boolean, Optional

Business Element: Undisclosed Indicator


When turned ON (set to TRUE) it indicates that either an ownership percentage is not reported for the beneficiary or it has not been able to calculate the ownership percentage for the beneficiary. This is not populated when the ownership percentage for this beneficiary has been reported or calculated.

N Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { BeneficialOwnership { BeneficialOwners { FilteredOutIndicator Element, boolean, Optional

Business Element: UBO Filtered Out indicator


When turned ON (set to TRUE) it indicates that the member has not met the filter criteria set in the request. This element is not populated for FALSE condition and when there is no filter set in the request.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { BeneficialOwnership { BeneficialOwners { OwnershipUnavailableReason Aggregate, Optional (Array)

Business Element: Graceful CBO Notifications


Records information on why ownership information is unavailable for this Organization.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { BeneficialOwnership { BeneficialOwners { OwnershipUnavailableReason { UnavailableReasonText Element, string, up to 256 chars., Required

A text identifying the reason why ownership information for this Organization is unavailable.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { BeneficialOwnership { BeneficialOwners { OwnershipUnavailableReason { UnavailableReasonText @DNBCodeValue Attribute, integer up to 7 chars., Optional

A unique number assigned by D&amp;B to identify the fact recorded in this data element.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { BeneficialOwnership { BeneficialOwners { OwnershipUnavailableReason Aggregate
Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { BeneficialOwnership { BeneficialOwners { ControlOwnershipTypeText Element, string, up to 256 chars., Optional

Business Element: Member Beneficial Owners Control Type Description


Text that describes the type of controlling ownership, e.g., publicly owned, privately owned, state owned. Note: For some countries, controlling ownership can be derived from the legal form.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { BeneficialOwnership { BeneficialOwners { ControlOwnershipTypeText @DNBCodeValue Element, integer up to 7 digits, Optional

Business Element: Member Beneficial Owners Control Type Code


A unique number assigned by D&B to identify the fact recorded in this data element.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { BeneficialOwnership { BeneficialOwners { ControlOwnershipTypeConfidenceLevel Element, string, up to 256 chars., Optional

Business Element: Member Beneficial Owners Control Type Confidence Description


Text that specifies the level of the confidence for the reported control type within the spectrum, e.g., Low, Medium, High.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { BeneficialOwnership { BeneficialOwners { ControlOwnershipTypeConfidenceLevel @DNBCodeValue Element, integer up to 7 digits, Optional

Business Element: Member Beneficial Owners Control Type Confidence Code


A unique number assigned by D&B to identify the fact recorded in this data element.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { BeneficialOwnership { BeneficialOwners { ResidenceCountryName Element, string, up to 64 chars., Optional

Business Element: Country Name


The name of the country in which this beneficiary usually resides.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { BeneficialOwnership { BeneficialOwners { LegalAuthority Element, string, up to 256 chars., Optional

Business Element: Legal Authority


The name of the government body or the law, which supervises or regulates the individual or the company, who exercises significant influence over the beneficiary. e.g., Limited Liability Partnership Act 2000, Supreme Court Of Gibraltar.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { BeneficialOwnership { BeneficialOwners { LegalForm Element, string, up to 256 chars., Optional

Business Element: LegalFreeFormText


The textual description of the legal form or structure of the company, who exercises significant influence over the beneficiary, as registered with government authorities, e.g., Limited Company, Limited Liability Partnerships.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { BeneficialOwnership { BeneficialOwners { NatureOfControlDescription Element, string, up to 256 chars., Optional

Business Element: Nature of Control Type Description


Text that describes the broad class into which the type of control the individual or the company holds on the subject is categorized, e.g., ownership or voting rights between 25% to 50%.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { BeneficialOwnership { BeneficialOwners { NatureOfControlDescription @DNBCodeValue Attribute, integer, up to 7 digits, Optional

Business Element: Nature of Control Type Code


A unique number assigned by D&B to identify the fact recorded in this data element.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { BeneficialOwnership { BeneficialOwners { NatureOfControlClassDescription Element, string, up to 256 chars., Optional

Business Element: Nature of Control class Type Description


Text that describes the broad class into which the type of control the individual or the company holds on the subject is categorized, e.g., ownership or voting rights between 25% to 50%.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { BeneficialOwnership { BeneficialOwners { NatureOfControlClassDescription @DNBCodeValue Attribute, integer, up to 7 digits, Optional

Business Element: Nature of Control class Type Code


A unique number assigned by D&B to identify the fact recorded in this data element.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { BeneficialOwnership { BeneficialOwners { NatureOfControlStartDate Element, date, Optional

Business Element: Start Date


The date when the individual or the company has acquired significant influence over the subject.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { BeneficialOwnership { BeneficialOwners { PSCIndicator Element, boolean, Optional

Business Element: PSC Indicator


When set to TRUE this indicates the beneficiary is a person with significant control. This is not populated when the beneficiary is not a person of significant control.

Y Y End: OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { BeneficialOwnership { BeneficialOwners Aggregate
N Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { BeneficialOwnership { Relationships Aggregate, Optional (Array)

An entry loop which can repeat multiple times to allow the recording of details of the relationships between members in an ownership structure for a subject company.

N Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { BeneficialOwnership { Relationships { RelationshipID Element, string, up to 16 chars., Required

Business Element: Relationship ID


A unique identifier assigned by D&B at this point of time for a relationship between two entities associated in this structure.This system generated ID is bound to change at a later point of time.

N Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { BeneficialOwnership { Relationships { SourceMemberID Element, string, up to 16 chars., Required

Business Element: Source Member


A unique identifier assigned by D&B at this point of time to the source node associated based on RelationshipTypeText to the target node denoted by the TargetMemberID. This system generated ID is bound to change at a later point of time.

N Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { BeneficialOwnership { Relationships { TargetMemberID Element, string, up to 16 chars., Required

Business Element: Target Member


A unique identifier assigned by D&B at this point of time to the receiving node associated based on RelationshipTypeText to the source node denoted by the SourceMemberID. This system generated ID is bound to change at a later point of time.

N Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { BeneficialOwnership { Relationships { RelationshipTypeDescription Element, string, up to 256 chars., Required

Business Element: Relationship Type


Text that defines the type of relationship exists between the source and target members

N Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { BeneficialOwnership { Relationships { RelationshipTypeDescription @DNBCodeValue Attribute,

Possible values: 137 [Owned Subject/Shareowner], 101 [Parent/Subsidiary]

N Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { BeneficialOwnership { Relationships { ShareHoldingPercentage Element, decimal, up to 5 digits. Maximum of 2 decimal, places., Optional

Business Element: Share Percentage


The total percentage of the shares (or other instrument of ownership) of the subject directly held/owned by the Shareholder.

N Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { BeneficialOwnership { Relationships { FilteredOutIndicator Element, boolean, Optional

Business Element: UBO Filtered Out indicator


When turned ON (set to TRUE) it indicates that the relationship has not met the filter criteria set in the request. This element is not populated for FALSE condition and when there is no filter set in the request.

N Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { BeneficialOwnership { Relationships { NatureOfControlDescription Element, string, up to 256 chars., Optional

Business Element: Nature of Control Type Description


Text that describes the type of control the individual or the company holds on the subject, e.g., ownership of 25% to 50% of shares, voting rights of 25% to 50%.

N Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { BeneficialOwnership { Relationships { NatureOfControlDescription @DNBCodeValue Attribute, integer, up to 7 digits, Optional

Business Element: Nature of Control Type Code


A unique number assigned by D&B to identify the fact recorded in this data element.

N Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { BeneficialOwnership { Relationships { NatureOfControlClassDescription Element, string, up to 256 chars., Optional

Business Element: Nature of Control class Type Description


Text that describes the broad class into which the type of control the individual or the company holds on the subject is categorized, e.g., ownership or voting rights between 25% to 50%.

N Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { BeneficialOwnership { Relationships { NatureOfControlClassDescription @DNBCodeValue Attribute, integer, up to 7 digits, Optional

Business Element: Nature of Control class Type Code


A unique number assigned by D&B to identify the fact recorded in this data element.

N Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { BeneficialOwnership { Relationships { NatureOfControlStartDate Element, string, Optional

Business Element: Start Date


The date when the individual or the company has acquired significant influence over the subject.

N Y End: OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { BeneficialOwnership { Relationships Aggregate
Y Y End: OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { BeneficialOwnership Aggregate
Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ShareOwner { Linkage { ParentOrganization { OrganizationPrimaryName Aggregate, Optional (Array)

An entry loop which can repeat multiple times to allow the recording of a single name by which the organization is primarily known / identified in different languages and/or writing scripts.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ShareOwner { Linkage { ParentOrganization { OrganizationPrimaryName { OrganizationName @LanguageCode Attribute
Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ShareOwner { Linkage { ParentOrganization { OrganizationPrimaryName { OrganizationName @WritingScriptISOAlpha4Code Attribute
Y Y End: OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage Aggregate
Y Y End: OrderProductResponse { OrderProductResponseDetail { Product { Organization Aggregate
Y Y OrderProductResponse { OrderProductResponseDetail { Product { ArchiveDetail Aggregate, Optional

Records data about the archival details of the product requested.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { ArchiveDetail { PortfolioAssetID Element, Required

A number used to uniquely identify this product in the location where it is stored.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { ArchiveDetail { PortfolioAssetContainerID Element, long, Optional

A number used to uniquely identify the location where this product is stored.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { ArchiveDetail { ExtendedArchiveIndicator Element, boolean, Optional

When turned ON (set to TRUE), the duration to archive the data has been extended. When turned OFF (set to FALSE), the duration to archive the data was not extended; however as this is the assumed condition there is no requirement to create this tag to represent this fact.

Y Y End: OrderProductResponse { OrderProductResponseDetail { Product { ArchiveDetail Aggregate
Y Y OrderProductResponse { OrderProductResponseDetail { Product { CopyrightNoticeText Element, string, up to 128 chars., Optional

Text that specifies the underlying claim to copyright ownership of this product.

Y Y End: OrderProductResponse { OrderProductResponseDetail { Product Aggregate
Y Y OrderProductResponse { OrderProductResponseDetail { InquiryReferenceDetail Aggregate, Optional

Records data that allows the customer to specify information to be linked to the request in order to support subsequent order reconciliation.

Y Y OrderProductResponse { OrderProductResponseDetail { InquiryReferenceDetail { CustomerReferenceText Element, string, up to 240 chars., Optional(Up to 5x)

A freeform reference string provided by the customer to be linked to the product in order to support subsequent order reconciliation.

Y Y OrderProductResponse { OrderProductResponseDetail { InquiryReferenceDetail { CustomerBillingEndorsementText Element, string, at least 1 chars. up to 240 chars., Optional

Text that is filled in by customer and commonly contains requesting individual or department name, or customer's own account/reference number and/or name for the case on which the product was provided. This text is a reference used during the billing process.

Y Y OrderProductResponse { OrderProductResponseDetail { InquiryReferenceDetail { PrincipalReferenceText Element, Optional (Array)

A freeform reference string provided by the customer to be linked to the principal information provided in the request for the product in order to support subsequent order reconciliation.

Y Y OrderProductResponse { OrderProductResponseDetail { InquiryReferenceDetail { PrincipalReferenceText @PrincipalImportanceLevel Element
Y Y End: OrderProductResponse { OrderProductResponseDetail { InquiryReferenceDetail Aggregate
Y Y End: OrderProductResponse { OrderProductResponseDetail Aggregate
Y Y End: OrderProductResponse Aggregate

Ownership Percentage

Ownership %

Exclude Undisclosed Holding Indicator

Behavior Included in Response

100

TRUE

The Shareholders with 100% ownership across the full list

Excluded from the response: Full list of Undisclosed Shareholders (i.e. Ownership % = Null, 0)

100

FALSE

The Shareholders with 100% ownership across the full list.

Full list of Undisclosed Shareholders (i.e. Ownership % = Null, 0)

100

Empty/Not specified in request

The Shareholders with 100% ownership across the full list.

Full list of Undisclosed Shareholders (i.e. Ownership % = Null, 0)

NOTE: Null values for the Undisclosed Shareholders filters should be treated as ‘FALSE/ OFF/ Include’

Any Percentage between 1 and 99

TRUE

The Shareholders with ≥ Requested% ownership across the full list.

Excluded from the response: Full list of Undisclosed Shareholders (i.e. Ownership % = Null, 0)

Any Percentage between 1 and 99

FALSE

The Shareholders with ≥ Requested% ownership across the full list.

Full list of Undisclosed Shareholders (i.e. Ownership % = Null, 0)

Any Percentage between 1 and 99

Empty/Not specified in request

The Shareholders with ≥ Requested% ownership across the full list.

Full list of Undisclosed Shareholders (i.e. Ownership % = Null, 0)

NOTE: Null values for the Undisclosed Shareholders filters should be treated as ‘FALSE/ OFF / Include’

0

TRUE

The Shareholders with ≥ 0%  ownership across the full list.

Excluded from the response: Full list of Undisclosed Shareholders (i.e. Ownership % = Null, 0)

0

FALSE

The Shareholders with ≥ 0% ownership across the full list.

Full list of Undisclosed Shareholders (i.e. Ownership % = Null, 0)

0

Empty/Not specified in request

The Shareholders with ≥ 0% ownership across the full list.

Full list of Undisclosed Shareholders (i.e. Ownership % = Null, 0)

NOTE: Null values for the Undisclosed Shareholders filters should be treated as ‘FALSE/ OFF / Include’

Empty/Not specified in request

TRUE

Full list of Shareholders.

Excluded from the response: Full list of Undisclosed Shareholders (i.e. Ownership % = Null, 0)

Empty/Not specified in request

FALSE

Full list of Shareholders.

Full list of Undisclosed Shareholders (i.e. Ownership % = Null, 0)

Empty/Not specified in request

Empty/Not specified in request

Full list of Shareholders.

Full list of Undisclosed Shareholders (i.e. Ownership % = Null, 0)

NOTE: Null values for the Undisclosed Shareholders filters should be treated as ‘FALSE/ OFF / Include’

Response Codes & Error Handling

Successful service requests will return a CM000 response code in the TransactionResult ResultID field. Otherwise, one of the D&B Direct standard response codes will be returned.

This operation may return the following response codes: CM001-CM005, CM007-CM012, CM014, CM017, CM018, PD001, PD003, PD005, PD006, PD015, PD016,PD019 and SC001-SC012.

IMPORTANT: PD006 code - Applicable only for US/CA cases when TradeUpIndicator="true" for Risk packets.

D&B Direct 2.0 API requests are provided on a metered basis; and may require entitlement prior to use in the production environment. In addition, a concurrency limit (QPS) is monitored to ensure that it is not exceeded. An error code will be returned in the event that a transaction is throttled.

Qualified usage (e.g., a successful response) is tracked and billed according to the terms & conditions of the customer's contract. The response codes CM000, CM010, PD002 and PD015 are considered successful. A built-in feature exists to prevent duplicate billing when multiple successful requests with the same D-U-N-S Number and product code are submitted on the same calendar day (which is based on Eastern Standard Time [GMT-5]).

Operation-specific supplemental response code explanations:

Retrieving Archived Copies

An option exists to retain the results from all successful requests for this product in a Product Request Archive, which may be retrieved without incurring additional usage charges.

NOTE: The default value for ArchiveProductOptOutIndicator is 'true', indicating that the request will NOT be automatically archived.