Ultimate Beneficial Ownership
Also known as Compliance Beneficial Ownership Structure and Compliance Beneficial Ownership List.
Product | D&B Direct 2.0, D&B Direct Onboard |
Product Code(s) | CMP_BOL, CMP_BOS |
Level(s) | Standard |
Monitoring Available | No |
Interface | SOAP |
WSDL | download |
Format(s) | XML |
Service | ComplianceVerification |
Operation | OrderProduct |
{version} | 6.0 |
6.0 Released On | December 7, 2018 |
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_BOL | CMP_BOS | Country | ISO Code |
---|---|---|---|
Y | Y | United States of America | US |
Y | Y | Belgium | BE |
Y | Y | France | FR |
Y | Y | Germany | DE |
Y | Y | Italy | IT |
Y | Y | Netherlands | NL |
Y | Y | Portugal | PT |
Y | Y | Spain | ES |
Y | Y | United Kingdom | GB |
Y | Y | Australia | AU |
Y | Y | New Zealand | NZ |
Y | Y | Andorra | AD |
Y | Y | Anguilla | AI |
Y | Y | Antigua & Barbuda | AG |
Y | Y | Aruba | AW |
Y | Y | Bahamas | BS |
Y | Y | Barbados | BB |
Y | Y | Belize | BZ |
Y | Y | Bermuda | BM |
Y | Y | Bolivia | BO |
Y | Y | British Virgin Islands | VG |
Y | Y | Canada | CA |
Y | Y | Cayman Islands | KY |
Y | Y | Chile | CL |
Y | Y | Colombia | CO |
Y | Y | Costa Rica | CR |
Y | Y | Denmark | DK |
Y | Y | Dominica | DM |
Y | Y | Dominican Republic | DO |
Y | Y | Ecuador | EC |
Y | Y | El Salvador | SV |
Y | Y | Faero Islands | FO |
Y | Y | Finland | FI |
Y | Y | Greenland | GL |
Y | Y | Grenada | GD |
Y | Y | Guatemala | GT |
Y | Y | Guyana | GY |
Y | Y | Haiti | HT |
Y | Y | Honduras | HN |
Y | Y | Ireland | IE |
Y | Y | Jamaica | JM |
Y | Y | Japan | JP |
Y | Y | Luxembourg | LU |
Y | Y | Mexico | MX |
Y | Y | Monaco | MC |
Y | Y | Montserrat | MS |
Y | Y | Netherlands Antilles | AN |
Y | Y | Bonaire, Sint Eustatius And Saba | BQ |
Y | Y | Curaçao | CW |
Y | Y | Sint Maarten (dutch) | SX |
Y | Y | Nicaragua | NI |
Y | Y | Norway | NO |
Y | Y | Panama | PA |
Y | Y | Saint Kitts & Nevis | KN |
Y | Y | Saint Lucia | LC |
Y | Y | Saint Vincent | VC |
Y | Y | San Marino | SM |
Y | Y | Suriname | SR |
Y | Y | Sweden | SE |
Y | Y | Taiwan | TW |
Y | Y | Trinidad And Tobago | TT |
Y | Y | Turks And Caicos | TC |
Y | Y | Venezuela | VE |
Y | Y | Afghanistan | AF |
Y | Y | Albania | AL |
Y | Y | Algeria | DZ |
Y | Y | American Samoa | AS |
Y | Y | Angola | AO |
Y | Y | Argentina | AR |
Y | Y | Armenia | AM |
Y | Y | Austria | AT |
Y | Y | Azerbaijan | AZ |
Y | Y | Bahrain | BH |
Y | Y | Bangladesh | BD |
Y | Y | Benin, Peoples Republic of | BJ |
Y | Y | Bhutan | BT |
Y | Y | Bosnia And Herzegovina | BA |
Y | Y | Botswana | BW |
Y | Y | Brazil | BR |
Y | Y | Brunei | BN |
Y | Y | Bulgaria | BG |
Y | Y | Burkina Faso | BF |
Y | Y | Burma (myanmar) | MM |
Y | Y | Burundi | BI |
Y | Y | Belarus | BY |
Y | Y | Kampuchea (prev. Cambodia) | KH |
Y | Y | Cameroon | CM |
Y | Y | Cape Verde, Republic of | CV |
Y | Y | Central Africa Republic | CF |
Y | Y | Chad, Republic of | TD |
Y | Y | China, Peoples Republic of | CN |
Y | Y | Christmas Island | CX |
Y | Y | Comoros Republic | KM |
Y | Y | Congo Democratic Republic | CD |
Y | Y | Cook Islands | CK |
Y | Y | Croatia | HR |
Y | Y | Cyprus | CY |
Y | Y | Turkish Republic of Northern Cyprus | XT |
Y | Y | Czech Republic | CZ |
Y | Y | Djibouti | DJ |
Y | Y | Egypt | EG |
Y | Y | Equatorial Guinea | GQ |
Y | Y | Eritrea | ER |
Y | Y | Estonia | EE |
Y | Y | Ethiopia | ET |
Y | Y | Falkland Islands | FK |
Y | Y | Fiji | FJ |
Y | Y | French Guiana | GF |
Y | Y | French Polynesia/ Tahiti | PF |
Y | Y | Gabon Republic | GA |
Y | Y | Gambia | GM |
Y | Y | Georgia | GE |
Y | Y | Ghana | GH |
Y | Y | Gibraltar | GI |
Y | Y | Greece | GR |
Y | Y | Guadeloupe | GP |
Y | Y | Guam | GU |
Y | Y | Guinea Bissau | GW |
Y | Y | Guinea, Republic of | GN |
Y | Y | Hong Kong SAR | HK |
Y | Y | Hungary | HU |
Y | Y | Iceland | IS |
Y | Y | India | IN |
Y | Y | Indonesia | ID |
Y | Y | Iran | IR |
Y | Y | Iraq | IQ |
Y | Y | Israel | IL |
Y | Y | Ivory Coast/ Cote D'Ivoire | CI |
Y | Y | Jordan | JO |
Y | Y | Kazakhstan | KZ |
Y | Y | Kenya | KE |
Y | Y | Kiribati | KI |
Y | Y | Korea, Republic of | KR |
Y | Y | Kuwait | KW |
Y | Y | Kyrgyzstan | KG |
Y | Y | Laos | LA |
Y | Y | Latvia | LV |
Y | Y | Lebanon | LB |
Y | Y | Lesotho | LS |
Y | Y | Liberia | LR |
Y | Y | Libya | LY |
Y | Y | Liechtenstein | LI |
Y | Y | Lithuania | LT |
Y | Y | Macao SAR | MO |
Y | Y | North Macedonia | MK |
Y | Y | Madagasgar | MG |
Y | Y | Malawi | MW |
Y | Y | Malaysia | MY |
Y | Y | Maldives | MV |
Y | Y | Mali | ML |
Y | Y | Malta | MT |
Y | Y | Marianas Islands | MP |
Y | Y | Marshall Islands | MH |
Y | Y | Martinique | MQ |
Y | Y | Mauritania | MR |
Y | Y | Mauritius | MU |
Y | Y | Moldova | MD |
Y | Y | Montenegro | ME |
Y | Y | Morocco | MA |
Y | Y | Mozambique | MZ |
Y | Y | Namibia | NA |
Y | Y | Nauru | NR |
Y | Y | Nepal | NP |
Y | Y | New Caledonia | NC |
Y | Y | Niger | NE |
Y | Y | Nigeria | NG |
Y | Y | Norfolk Island | NF |
Y | Y | Oman | OM |
Y | Y | Pakistan | PK |
Y | Y | Papua New Guinea | PG |
Y | Y | Paraguay | PY |
Y | Y | Peru | PE |
Y | Y | Philippines | PH |
Y | Y | Poland | PL |
Y | Y | Qatar | QA |
Y | Y | Reunion Island | RE |
Y | Y | Romania | RO |
Y | Y | Russian Federation | RU |
Y | Y | Rwanda | RW |
Y | Y | Saint Helena | SH |
Y | Y | Sao Tome & Principe | ST |
Y | Y | Saudi Arabia | SA |
Y | Y | Senegal | SN |
Y | Y | Serbia | RS |
Y | Y | Seychelles | SC |
Y | Y | Sierra Leone | SL |
Y | Y | Singapore | SG |
Y | Y | Slovakia | SK |
Y | Y | Slovenia | SI |
Y | Y | Solomon Islands | SB |
Y | Y | Somalia | SO |
Y | Y | South Africa | ZA |
Y | Y | Sri Lanka | LK |
Y | Y | Sudan | SD |
Y | Y | South Sudan | SS |
Y | Y | Eswatini | SZ |
Y | Y | Switzerland | CH |
Y | Y | Syria | SY |
Y | Y | Tajhikstan | TJ |
Y | Y | Tanzania | TZ |
Y | Y | Thailand | TH |
Y | Y | Togo | TG |
Y | Y | Tokelau Islands | TK |
Y | Y | Tonga | TO |
Y | Y | Tunisia | TN |
Y | Y | Turkiye | TR |
Y | Y | Turkmenistan | TM |
Y | Y | Tuvalu | TV |
Y | Y | Uganda | UG |
Y | Y | Ukraine | UA |
Y | Y | United Arab Emirates | AE |
Y | Y | Uruguay | UY |
Y | Y | Uzbekistan | UZ |
Y | Y | Vanuatu | VU |
Y | Y | Vietnam | VN |
Y | Y | Western Samoa | WS |
Y | Y | Yemen | YE |
Y | Y | Zambia | ZM |
Y | Y | Zimbabwe | ZW |
Y | Y | Congo | CG |
Y | Y | Puerto Rico | PR |
Y | Y | Holy See (vatican City State) | VA |
Y | Y | Kosovo | XK |
Y | Y | Micronesia, Federated States of | FM |
Y | Y | Timor-Leste | TL |
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
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
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:com="http://services.dnb.com/ComplianceVerificationServiceV1.0"> <soapenv:Header> <wsse:Security soapenv:mustUnderstand="1" xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd" xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd"> <wsse:UsernameToken wsu:Id="UsernameToken-57"> <wsse:Username>MyUserName</wsse:Username> <wsse:Password Type="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-profile-1.0#PasswordText">MyPassword</wsse:Password> </wsse:UsernameToken> </wsse:Security> </soapenv:Header> <soapenv:Body> <com:OrderProductRequest> <TransactionDetail> <ApplicationTransactionID>ubotesting</ApplicationTransactionID> </TransactionDetail> <OrderProductRequestDetail> <InquiryDetail> <DUNSNumber>214567885</DUNSNumber> <CountryISOAlpha2Code>US</CountryISOAlpha2Code> </InquiryDetail> <ProductSpecification> <DNBProductID>CMP_BOL</DNBProductID> <LanguagePreferenceCode>39</LanguagePreferenceCode> <OwnershipType>BENF_OWRP</OwnershipType> <OwnershipPercentage>60.0</OwnershipPercentage> </ProductSpecification> <ArchiveDetail> <ArchiveProductOptOutIndicator>true</ArchiveProductOptOutIndicator> <ExtendArchivePeriodIndicator>true</ExtendArchivePeriodIndicator> </ArchiveDetail> <InquiryReferenceDetail> <CustomerReferenceText>UBO_Billing_Ref</CustomerReferenceText> <CustomerBillingEndorsementText>UBO_Billing</CustomerBillingEndorsementText> </InquiryReferenceDetail> </OrderProductRequestDetail> </com:OrderProductRequest> </soapenv:Body> </soapenv:Envelope>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:com="http://services.dnb.com/ComplianceVerificationServiceV1.0"> <soapenv:Header> <wsse:Security soapenv:mustUnderstand="1" xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd" xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd"> <wsse:UsernameToken wsu:Id="UsernameToken-57"> <wsse:Username>MyUserName</wsse:Username> <wsse:Password Type="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-profile-1.0#PasswordText">MyPassword</wsse:Password> </wsse:UsernameToken> </wsse:Security> </soapenv:Header> <soapenv:Body> <com:OrderProductRequest> <TransactionDetail> <ApplicationTransactionID>ubotesting</ApplicationTransactionID> </TransactionDetail> <OrderProductRequestDetail> <InquiryDetail> <DUNSNumber>214567885</DUNSNumber> <CountryISOAlpha2Code>US</CountryISOAlpha2Code> </InquiryDetail> <ProductSpecification> <DNBProductID>CMP_BOS</DNBProductID> <LanguagePreferenceCode>39</LanguagePreferenceCode> <OwnershipType>BENF_OWRP</OwnershipType> <OwnershipPercentage>60.0</OwnershipPercentage> </ProductSpecification> <ArchiveDetail> <ArchiveProductOptOutIndicator>true</ArchiveProductOptOutIndicator> <ExtendArchivePeriodIndicator>true</ExtendArchivePeriodIndicator> </ArchiveDetail> <InquiryReferenceDetail> <CustomerReferenceText>UBO_Billing_Ref</CustomerReferenceText> <CustomerBillingEndorsementText>UBO_Billing</CustomerBillingEndorsementText> </InquiryReferenceDetail> </OrderProductRequestDetail> </com:OrderProductRequest> </soapenv:Body> </soapenv:Envelope>
CMP_BOL | CMP_BOS | Name | Characteristics |
---|---|---|---|
Y | Y | OrderProductRequest | Aggregate |
Y | Y | OrderProductRequest. TransactionDetail | Aggregate, Optional Records information necessary to process this request. |
Y | Y | OrderProductRequest. TransactionDetail. ApplicationTransactionID | string, up to 64 chars, Optional A number assigned by the calling application to uniquely identify this request. |
Y | Y | OrderProductRequest. TransactionDetail. 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 | OrderProductRequest. TransactionDetail. 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 | End: OrderProductRequest. TransactionDetail | /Aggregate |
Y | Y | OrderProductRequest. OrderProductRequestDetail | Aggregate, Optional Records data relating to requests for a product. This may include such details as the product required, the subject about which the product should be produced, the content of the product. |
Y | Y | OrderProductRequest. OrderProductRequestDetail. 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 | OrderProductRequest. OrderProductRequestDetail. InquiryDetail. DUNSNumber | 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 | OrderProductRequest. OrderProductRequestDetail. InquiryDetail. 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 | End: OrderProductRequest. OrderProductRequestDetail. InquiryDetail | /Aggregate |
Y | Y | OrderProductRequest. OrderProductRequestDetail. ProductSpecification | Aggregate, Required Records data that allows the customer to specify the details of the requested product. This may include details such as the identifier of the product, the language in which the product needs to be rendered, the format in which the product needs to be rendered. |
Y | Y | OrderProductRequest. OrderProductRequestDetail. ProductSpecification. DNBProductID | string, Optional An alphanumeric string that uniquely identifies the product being requested. |
Y | Y | OrderProductRequest. OrderProductRequestDetail. ProductSpecification. 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 | OrderProductRequest. OrderProductRequestDetail. ProductSpecification. 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 | OrderProductRequest. OrderProductRequestDetail. ProductSpecification. 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 | OrderProductRequest. OrderProductRequestDetail. ProductSpecification. 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 | OrderProductRequest. OrderProductRequestDetail. ProductSpecification. 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 | End: OrderProductRequest. OrderProductRequestDetail. ProductSpecification | /Aggregate |
Y | Y | OrderProductRequest. OrderProductRequestDetail. ArchiveDetail | Aggregate, Optional |
Y | Y | OrderProductRequest. OrderProductRequestDetail. ArchiveDetail. 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 | OrderProductRequest. OrderProductRequestDetail. ArchiveDetail. 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 | End: OrderProductRequest. OrderProductRequestDetail. ArchiveDetail | /Aggregate |
Y | Y | OrderProductRequest. OrderProductRequestDetail. 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 | OrderProductRequest. OrderProductRequestDetail. InquiryReferenceDetail. CustomerReferenceText | 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 | OrderProductRequest. OrderProductRequestDetail. InquiryReferenceDetail. 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 | OrderProductRequest. OrderProductRequestDetail. 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 | OrderProductRequest. OrderProductRequestDetail. InquiryReferenceDetail. PrincipalReferenceText @PrincipalImportanceLevel | Attribute, |
Y | Y | End: OrderProductRequest. OrderProductRequestDetail. InquiryReferenceDetail | /Aggregate |
Y | Y | End: OrderProductRequest. OrderProductRequestDetail | /Aggregate |
Y | Y | End: OrderProductRequest | /Aggregate |
Endpoint
Use the following endpoint with the downloadable WSDL to request this product.
Endpoint (UBO Products) |
---|
https://direct.dnb.com/ComplianceVerification/V{version} |
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.
Specification
The following is a list of the possible data fields returned by this operation in the XML 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.
The specific data fields pre-configured for each data product will be located in the response package as noted.
NOTE: The D-U-N-S Number returned in the response will be a nine-digit zero-padded, numeric value.
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"> <soap-env:Body xmlns:soap-env="http://schemas.xmlsoap.org/soap/envelope/"> <com:OrderProductResponse xmlns:com="http://services.dnb.com/ComplianceVerificationServiceV1.0"> <TransactionDetail> <ServiceTransactionID>Id-7baf125a520b74c64b7b34f3-2</ServiceTransactionID> <TransactionTimestamp>2017-11-20T05:33:31.868-05:00</TransactionTimestamp> </TransactionDetail> <TransactionResult> <SeverityText>Information</SeverityText> <ResultID>CM000</ResultID> <ResultText>Success</ResultText> </TransactionResult> <OrderProductResponseDetail> <InquiryDetail> <DUNSNumber>214567885</DUNSNumber> <CountryISOAlpha2Code>GB</CountryISOAlpha2Code> </InquiryDetail> <Product> <DNBProductID>CMP_BOL</DNBProductID> <Organization> <SubjectHeader> <DUNSNumber>214567885</DUNSNumber> </SubjectHeader> <Location> <PrimaryAddress> <StreetAddressLine> <LineText>Marlow International Parkway</LineText> </StreetAddressLine> <PrimaryTownName>MARLOW</PrimaryTownName> <CountryISOAlpha2Code>GB</CountryISOAlpha2Code> <PostalCode>SL7 1AJ</PostalCode> <CountryOfficialName>United Kingdom</CountryOfficialName> </PrimaryAddress> </Location> <OrganizationName> <OrganizationPrimaryName> <OrganizationName>D & B SAMPLE CO LTD</OrganizationName> </OrganizationPrimaryName> </OrganizationName> <OrganizationDetail> <OutofBusinessIndicator>false</OutofBusinessIndicator> </OrganizationDetail> <RegisteredDetail> <LegalFormDetails> <LegalFormText DNBCodeValue="2547">Private Limited Liability Company</LegalFormText> </LegalFormDetails> </RegisteredDetail> <IndustryCode> <PrimaryIndustryCode DNBCodeValue="399" TypeText="US SIC (1987)"> <IndustryCode>7379</IndustryCode> <IndustryCodeDescription LanguageCode="39" IndustryCodeDescriptionLengthCode="1441">Computer related services</IndustryCodeDescription> </PrimaryIndustryCode> </IndustryCode> <Linkage> <GlobalUltimateOrganization> <DUNSNumber>214567885</DUNSNumber> <OrganizationPrimaryName> <OrganizationName>D & B SAMPLE CO LTD</OrganizationName> </OrganizationPrimaryName> </GlobalUltimateOrganization> <DomesticUltimateOrganization> <DUNSNumber>214567885</DUNSNumber> <OrganizationPrimaryName> <OrganizationName>D & B SAMPLE CO LTD</OrganizationName> </OrganizationPrimaryName> </DomesticUltimateOrganization> <BeneficialOwnership> <Summary> <BeneficialOwnersCount>8</BeneficialOwnersCount> <RelationshipsCount>8</RelationshipsCount> <OrganizationsCount>1</OrganizationsCount> <IndividualsCount>6</IndividualsCount> <UnclassifedOwnerCount>1</UnclassifedOwnerCount> <CorporateBeneficiariesCount>0</CorporateBeneficiariesCount> <MaximumDegreeOfSeparation>2</MaximumDegreeOfSeparation> <TotalAllocatedOwnershipPercentage>20.0</TotalAllocatedOwnershipPercentage> <CountrywiseSummary> <CountryISOAlpha2Code>GB</CountryISOAlpha2Code> <BeneficialOwnersCount>2</BeneficialOwnersCount> </CountrywiseSummary> <CountrywiseSummary> <CountryISOAlpha2Code>IE</CountryISOAlpha2Code> <BeneficialOwnersCount>1</BeneficialOwnersCount> </CountrywiseSummary> <UnknownCountryBeneficiariesCount>5</UnknownCountryBeneficiariesCount> <StateOwnedOrganizationsCount>0</StateOwnedOrganizationsCount> <GovernmentOrganizationsCount>0</GovernmentOrganizationsCount> <PubliclyTradingOrganizationsCount>0</PubliclyTradingOrganizationsCount> <PrivatelyHeldOrganizationsCount>0</PrivatelyHeldOrganizationsCount> <PSCCount>1</PSCCount> <PSCUniqueTypeCount>1</PSCUniqueTypeCount> <TypewisePSCSummary> <PSCTypeText DNBCodeValue="119">Individuals</PSCTypeText> <PSCCount>1</PSCCount> </TypewisePSCSummary> <NationalitywisePSCSummary> <Nationality>British</Nationality> <PSCCount>1</PSCCount> </NationalitywisePSCSummary> <CountryUnknownPSCCount>1</CountryUnknownPSCCount> </Summary> <BeneficialOwners> <BeneficiaryIndicator>true</BeneficiaryIndicator> <MemberID>491911575</MemberID> <PrimaryName>Lauren Franklyns</PrimaryName> <SubjectTypeDescription DNBCodeValue="119">Individuals</SubjectTypeDescription> <DegreeOfSeparation>1</DegreeOfSeparation> <UndisclosedIndicator>true</UndisclosedIndicator> </BeneficialOwners> <BeneficialOwners> <BeneficiaryIndicator>true</BeneficiaryIndicator> <MemberID>256649461</MemberID> <SubjectTypeDescription DNBCodeValue="119">Individuals</SubjectTypeDescription> <DirectOwnershipPercentage>20.0</DirectOwnershipPercentage> <BeneficialOwnershipPercentage>20.0</BeneficialOwnershipPercentage> <DegreeOfSeparation>1</DegreeOfSeparation> </BeneficialOwners> <BeneficialOwners> <BeneficiaryIndicator>false</BeneficiaryIndicator> <MemberID>185500720</MemberID> <PrimaryName>D & B SAMPLE HOLDING CO LTD</PrimaryName> <DUNSNumber>233083567</DUNSNumber> <SubjectTypeDescription DNBCodeValue="118">Businesses</SubjectTypeDescription> <LegalFormText DNBCodeValue="2547">Private Limited Liability Company</LegalFormText> <PrimaryAddress> <StreetAddressLine> <LineText>7 Hill Street</LineText> </StreetAddressLine> <PrimaryTownName>BIRMINGHAM</PrimaryTownName> <CountryISOAlpha2Code>GB</CountryISOAlpha2Code> <PostalCode>B5 4UU</PostalCode> <CountryOfficialName>United Kingdom</CountryOfficialName> </PrimaryAddress> <OutofBusinessIndicator>false</OutofBusinessIndicator> <DegreeOfSeparation>1</DegreeOfSeparation> <UndisclosedIndicator>true</UndisclosedIndicator> </BeneficialOwners> <BeneficialOwners> <BeneficiaryIndicator>true</BeneficiaryIndicator> <MemberID>460015575</MemberID> <PrimaryName>Prefe rencee</PrimaryName> <SubjectTypeDescription DNBCodeValue="119">Individuals</SubjectTypeDescription> <DegreeOfSeparation>1</DegreeOfSeparation> <UndisclosedIndicator>true</UndisclosedIndicator> </BeneficialOwners> <BeneficialOwners> <BeneficiaryIndicator>true</BeneficiaryIndicator> <MemberID>483759250</MemberID> <PrimaryName>Testing VMAX SAN</PrimaryName> <SubjectTypeDescription DNBCodeValue="119">Individuals</SubjectTypeDescription> <PrimaryAddress> <StreetAddressLine> <LineText>Address Check</LineText> </StreetAddressLine> <PrimaryTownName>Bucks</PrimaryTownName> <CountryISOAlpha2Code>IE</CountryISOAlpha2Code> <CountryOfficialName>Ireland</CountryOfficialName> </PrimaryAddress> <DegreeOfSeparation>2</DegreeOfSeparation> <UndisclosedIndicator>true</UndisclosedIndicator> </BeneficialOwners> <BeneficialOwners> <BeneficiaryIndicator>true</BeneficiaryIndicator> <MemberID>474346742</MemberID> <PrimaryName>John John Company</PrimaryName> <SubjectTypeDescription DNBCodeValue="119">Individuals</SubjectTypeDescription> <DegreeOfSeparation>2</DegreeOfSeparation> <UndisclosedIndicator>true</UndisclosedIndicator> </BeneficialOwners> <BeneficialOwners> <BeneficiaryIndicator>true</BeneficiaryIndicator> <MemberID>348204824</MemberID> <PrimaryName>Corporate Test</PrimaryName> <PrimaryAddress> <StreetAddressLine> <LineText>Testing</LineText> </StreetAddressLine> <PrimaryTownName>Bucks</PrimaryTownName> <CountryISOAlpha2Code>GB</CountryISOAlpha2Code> <CountryOfficialName>United Kingdom</CountryOfficialName> </PrimaryAddress> <DegreeOfSeparation>2</DegreeOfSeparation> <UndisclosedIndicator>true</UndisclosedIndicator> </BeneficialOwners> <BeneficialOwners> <BeneficiaryIndicator>true</BeneficiaryIndicator> <MemberID>512252887</MemberID> <PrimaryName>Testing Memory Increase</PrimaryName> <SubjectTypeDescription DNBCodeValue="119">Individuals</SubjectTypeDescription> <DegreeOfSeparation>2</DegreeOfSeparation> <ResidenceCountryName>England</ResidenceCountryName> <NatureOfControlDescription DNBCodeValue="30850">Ownership of 75% to 100% of shares</NatureOfControlDescription> <NatureOfControlClassDescription DNBCodeValue="33476">Ownership or voting rights of 75% to 100%</NatureOfControlClassDescription> <NatureOfControlStartDate>2016-07-11</NatureOfControlStartDate> <PSCIndicator>true</PSCIndicator> </BeneficialOwners> </BeneficialOwnership> </Linkage> </Organization> <ArchiveDetail> <PortfolioAssetID>79016063</PortfolioAssetID> </ArchiveDetail> </Product> </OrderProductResponseDetail> </com:OrderProductResponse> </soap-env:Body> </soapenv:Envelope> lope>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"> <soap-env:Body xmlns:soap-env="http://schemas.xmlsoap.org/soap/envelope/"> <com:OrderProductResponse xmlns:com="http://services.dnb.com/ComplianceVerificationServiceV1.0"> <TransactionDetail> <ApplicationTransactionID>ubotesting</ApplicationTransactionID> <ServiceTransactionID>Id-6186275bd5814c738bb41550-2</ServiceTransactionID> <TransactionTimestamp>2018-06-18T06:16:03.717-04:00</TransactionTimestamp> </TransactionDetail> <TransactionResult> <SeverityText>Information</SeverityText> <ResultID>CM000</ResultID> <ResultText>Success</ResultText> </TransactionResult> <OrderProductResponseDetail> <InquiryDetail> <DUNSNumber>214567885</DUNSNumber> <CountryISOAlpha2Code>GB</CountryISOAlpha2Code> </InquiryDetail> <Product> <DNBProductID>CMP_BOS</DNBProductID> <LanguageCode>39</LanguageCode> <Organization> <SubjectHeader> <DUNSNumber>214567885</DUNSNumber> </SubjectHeader> <Location> <PrimaryAddress> <StreetAddressLine> <LineText>Marlow International Parkway</LineText> </StreetAddressLine> <PrimaryTownName>MARLOW</PrimaryTownName> <CountryISOAlpha2Code>GB</CountryISOAlpha2Code> <PostalCode>SL7 1AJ</PostalCode> </PrimaryAddress> </Location> <OrganizationName> <OrganizationPrimaryName> <OrganizationName>D & B SAMPLE CO LTD</OrganizationName> </OrganizationPrimaryName> </OrganizationName> <OrganizationDetail> <ControlOwnershipTypeText DNBCodeValue="9058">Privately owned</ControlOwnershipTypeText> <OutofBusinessIndicator>false</OutofBusinessIndicator> <ControlOwnershipTypeConfidenceLevel DNBCodeValue="13693">Low</ControlOwnershipTypeConfidenceLevel> </OrganizationDetail> <RegisteredDetail> <LegalFormDetails> <LegalFormText DNBCodeValue="2547">Private Limited Liability Company</LegalFormText> </LegalFormDetails> </RegisteredDetail> <IndustryCode> <PrimaryIndustryCode DNBCodeValue="399" TypeText="US SIC (1987)"> <IndustryCode>7379</IndustryCode> <IndustryCodeDescription LanguageCode="39" IndustryCodeDescriptionLengthCode="1441">Computer related services</IndustryCodeDescription> </PrimaryIndustryCode> </IndustryCode> <Linkage> <GlobalUltimateOrganization> <DUNSNumber>214567885</DUNSNumber> <OrganizationPrimaryName> <OrganizationName>D & B SAMPLE CO LTD</OrganizationName> </OrganizationPrimaryName> </GlobalUltimateOrganization> <DomesticUltimateOrganization> <DUNSNumber>214567885</DUNSNumber> <OrganizationPrimaryName> <OrganizationName>D & B SAMPLE CO LTD</OrganizationName> </OrganizationPrimaryName> </DomesticUltimateOrganization> <BeneficialOwnership> <Summary> <BeneficialOwnersCount>8</BeneficialOwnersCount> <RelationshipsCount>8</RelationshipsCount> <OrganizationsCount>1</OrganizationsCount> <IndividualsCount>6</IndividualsCount> <UnclassifedOwnerCount>1</UnclassifedOwnerCount> <CorporateBeneficiariesCount>0</CorporateBeneficiariesCount> <MaximumDegreeOfSeparation>2</MaximumDegreeOfSeparation> <TotalAllocatedOwnershipPercentage>20.0</TotalAllocatedOwnershipPercentage> <CountrywiseSummary> <CountryISOAlpha2Code>GB</CountryISOAlpha2Code> <BeneficialOwnersCount>2</BeneficialOwnersCount> </CountrywiseSummary> <CountrywiseSummary> <CountryISOAlpha2Code>IE</CountryISOAlpha2Code> <BeneficialOwnersCount>1</BeneficialOwnersCount> </CountrywiseSummary> <UnknownCountryBeneficiariesCount>5</UnknownCountryBeneficiariesCount> <StateOwnedOrganizationsCount>0</StateOwnedOrganizationsCount> <GovernmentOrganizationsCount>0</GovernmentOrganizationsCount> <PubliclyTradingOrganizationsCount>0</PubliclyTradingOrganizationsCount> <PrivatelyHeldOrganizationsCount>1</PrivatelyHeldOrganizationsCount> <PSCCount>1</PSCCount> <PSCUniqueTypeCount>1</PSCUniqueTypeCount> <TypewisePSCSummary> <PSCTypeText DNBCodeValue="119">Individuals</PSCTypeText> <PSCCount>1</PSCCount> </TypewisePSCSummary> <NationalitywisePSCSummary> <Nationality>British</Nationality> <PSCCount>1</PSCCount> </NationalitywisePSCSummary> <CountryUnknownPSCCount>1</CountryUnknownPSCCount> </Summary> <BeneficialOwners> <BeneficiaryIndicator>false</BeneficiaryIndicator> <MemberID>170660440</MemberID> <PrimaryName>D & B SAMPLE CO LTD</PrimaryName> <DUNSNumber>214567885</DUNSNumber> <SubjectTypeDescription DNBCodeValue="118">Businesses</SubjectTypeDescription> <LegalFormText DNBCodeValue="2547">Private Limited Liability Company</LegalFormText> <PrimaryAddress> <StreetAddressLine> <LineText>Marlow International Parkway</LineText> </StreetAddressLine> <PrimaryTownName>MARLOW</PrimaryTownName> <CountryISOAlpha2Code>GB</CountryISOAlpha2Code> <PostalCode>SL7 1AJ</PostalCode> </PrimaryAddress> <OutofBusinessIndicator>false</OutofBusinessIndicator> <DegreeOfSeparation>0</DegreeOfSeparation> <ControlOwnershipTypeText DNBCodeValue="9058">Privately owned</ControlOwnershipTypeText> </BeneficialOwners> <BeneficialOwners> <BeneficiaryIndicator>true</BeneficiaryIndicator> <MemberID>491911575</MemberID> <PrimaryName>Lauren Franklyns</PrimaryName> <SubjectTypeDescription DNBCodeValue="119">Individuals</SubjectTypeDescription> <DegreeOfSeparation>1</DegreeOfSeparation> </BeneficialOwners> <BeneficialOwners> <BeneficiaryIndicator>true</BeneficiaryIndicator> <MemberID>256649461</MemberID> <SubjectTypeDescription DNBCodeValue="119">Individuals</SubjectTypeDescription> <DirectOwnershipPercentage>20.0</DirectOwnershipPercentage> <BeneficialOwnershipPercentage>20.0</BeneficialOwnershipPercentage> <DegreeOfSeparation>1</DegreeOfSeparation> </BeneficialOwners> <BeneficialOwners> <BeneficiaryIndicator>false</BeneficiaryIndicator> <MemberID>185500720</MemberID> <PrimaryName>D & B SAMPLE HOLDING CO LTD</PrimaryName> <DUNSNumber>233083567</DUNSNumber> <SubjectTypeDescription DNBCodeValue="118">Businesses</SubjectTypeDescription> <LegalFormText DNBCodeValue="2547">Private Limited Liability Company</LegalFormText> <PrimaryAddress> <StreetAddressLine> <LineText>7 Hill Street</LineText> </StreetAddressLine> <PrimaryTownName>BIRMINGHAM</PrimaryTownName> <CountryISOAlpha2Code>GB</CountryISOAlpha2Code> <PostalCode>B5 4UU</PostalCode> </PrimaryAddress> <OutofBusinessIndicator>false</OutofBusinessIndicator> <DegreeOfSeparation>1</DegreeOfSeparation> <ControlOwnershipTypeText DNBCodeValue="9058">Privately owned</ControlOwnershipTypeText> <ControlOwnershipTypeConfidenceLevel DNBCodeValue="13693">Low</ControlOwnershipTypeConfidenceLevel> </BeneficialOwners> <BeneficialOwners> <BeneficiaryIndicator>true</BeneficiaryIndicator> <MemberID>460015575</MemberID> <PrimaryName>Prefe rencee</PrimaryName> <SubjectTypeDescription DNBCodeValue="119">Individuals</SubjectTypeDescription> <DegreeOfSeparation>1</DegreeOfSeparation> </BeneficialOwners> <BeneficialOwners> <BeneficiaryIndicator>true</BeneficiaryIndicator> <MemberID>483759250</MemberID> <PrimaryName>Testing VMAX SAN</PrimaryName> <SubjectTypeDescription DNBCodeValue="119">Individuals</SubjectTypeDescription> <PrimaryAddress> <StreetAddressLine> <LineText>Address Check</LineText> </StreetAddressLine> <PrimaryTownName>Bucks</PrimaryTownName> <CountryISOAlpha2Code>IE</CountryISOAlpha2Code> </PrimaryAddress> <DegreeOfSeparation>2</DegreeOfSeparation> </BeneficialOwners> <BeneficialOwners> <BeneficiaryIndicator>true</BeneficiaryIndicator> <MemberID>474346742</MemberID> <PrimaryName>John John Company</PrimaryName> <SubjectTypeDescription DNBCodeValue="119">Individuals</SubjectTypeDescription> <DegreeOfSeparation>2</DegreeOfSeparation> </BeneficialOwners> <BeneficialOwners> <BeneficiaryIndicator>true</BeneficiaryIndicator> <MemberID>348204824</MemberID> <PrimaryName>Corporate Test</PrimaryName> <PrimaryAddress> <StreetAddressLine> <LineText>Testing</LineText> </StreetAddressLine> <PrimaryTownName>Bucks</PrimaryTownName> <CountryISOAlpha2Code>GB</CountryISOAlpha2Code> </PrimaryAddress> <DegreeOfSeparation>2</DegreeOfSeparation> </BeneficialOwners> <BeneficialOwners> <BeneficiaryIndicator>true</BeneficiaryIndicator> <MemberID>512252887</MemberID> <PrimaryName>Testing Memory Increase</PrimaryName> <SubjectTypeDescription DNBCodeValue="119">Individuals</SubjectTypeDescription> <DegreeOfSeparation>2</DegreeOfSeparation> </BeneficialOwners> <Relationships> <RelationshipID>142050574</RelationshipID> <SourceMemberID>170660440</SourceMemberID> <TargetMemberID>491911575</TargetMemberID> <RelationshipTypeDescription DNBCodeValue="137">Share Ownership</RelationshipTypeDescription> <ShareHoldingPercentage>0.0</ShareHoldingPercentage> </Relationships> <Relationships> <RelationshipID>140496231</RelationshipID> <SourceMemberID>170660440</SourceMemberID> <TargetMemberID>256649461</TargetMemberID> <RelationshipTypeDescription DNBCodeValue="137">Share Ownership</RelationshipTypeDescription> <ShareHoldingPercentage>20.0</ShareHoldingPercentage> </Relationships> <Relationships> <RelationshipID>139269233</RelationshipID> <SourceMemberID>170660440</SourceMemberID> <TargetMemberID>185500720</TargetMemberID> <RelationshipTypeDescription DNBCodeValue="137">Share Ownership</RelationshipTypeDescription> <ShareHoldingPercentage>0.0</ShareHoldingPercentage> </Relationships> <Relationships> <RelationshipID>128032335</RelationshipID> <SourceMemberID>170660440</SourceMemberID> <TargetMemberID>460015575</TargetMemberID> <RelationshipTypeDescription DNBCodeValue="137">Share Ownership</RelationshipTypeDescription> <ShareHoldingPercentage>0.0</ShareHoldingPercentage> </Relationships> <Relationships> <RelationshipID>297410952</RelationshipID> <SourceMemberID>185500720</SourceMemberID> <TargetMemberID>483759250</TargetMemberID> <RelationshipTypeDescription DNBCodeValue="137">Share Ownership</RelationshipTypeDescription> <ShareHoldingPercentage>9.59</ShareHoldingPercentage> </Relationships> <Relationships> <RelationshipID>150603007</RelationshipID> <SourceMemberID>185500720</SourceMemberID> <TargetMemberID>474346742</TargetMemberID> <RelationshipTypeDescription DNBCodeValue="137">Share Ownership</RelationshipTypeDescription> <ShareHoldingPercentage>0.09</ShareHoldingPercentage> </Relationships> <Relationships> <RelationshipID>250353126</RelationshipID> <SourceMemberID>185500720</SourceMemberID> <TargetMemberID>348204824</TargetMemberID> <RelationshipTypeDescription DNBCodeValue="137">Share Ownership</RelationshipTypeDescription> <ShareHoldingPercentage>0.01</ShareHoldingPercentage> </Relationships> <Relationships> <RelationshipID>300605302</RelationshipID> <SourceMemberID>185500720</SourceMemberID> <TargetMemberID>512252887</TargetMemberID> <RelationshipTypeDescription DNBCodeValue="33700">Persons of Significant Control</RelationshipTypeDescription> <NatureOfControlDescription DNBCodeValue="30850">Ownership of 75% to 100% of shares</NatureOfControlDescription> <NatureOfControlClassDescription DNBCodeValue="33476">Ownership or voting rights of 75% to 100%</NatureOfControlClassDescription> <NatureOfControlStartDate>2016-07-11</NatureOfControlStartDate> </Relationships> </BeneficialOwnership> </Linkage> </Organization> </Product> <InquiryReferenceDetail> <CustomerReferenceText>UBO_Billing_Ref</CustomerReferenceText> <CustomerBillingEndorsementText>UBO_Billing</CustomerBillingEndorsementText> </InquiryReferenceDetail> </OrderProductResponseDetail> </com:OrderProductResponse> </soap-env:Body> </soapenv:Envelope>
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&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 |
NOTE: There may be additional request and/or response elements specified in the WSDL that are not applicable for D&B Direct customers. Data elements that are not listed on this page are currently unused by this operation.
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:
CM000 | Success | Complete Data (or) Standalone cases where only Members/Beneficiaries aggregate is present without any relationships from UBO Graph API (Customer will be charged for the transaction) |
CM004 | Internal D&B system error. Please try again or contact your local Customer Service Center. | Error from UBO Graph API (Customer will not be charged for the transaction) |
CM005 | D&B System temporarily unavailable. Please try again or contact your local Customer Service Center. | UBO Graph API Service is Unavailable (Customer will not be charged for the transaction) |
CM005 | D&B System temporarily unavailable. Please try again or contact your local Customer Service Center. | UBO Graph API Service is Unavailable (Customer will not be charged for the transaction) |
CM007 | Your request cannot be fulfilled for the given criteria. | Error for invalid combination of Filters for Full Ownership Structure |
CM008 | No match found for the requested Duns number. | Failure Response when Target DUNS is not found E.g. DUNS number does not exist within the UBO Graph DB (Customer will not be charged for the transaction) |
CM018 | No candidates resulted for the given input criteria. | Target DUNS Number is found to have no ownership data in the UBO Graph DB based on filters applied in the request. If the filters are changed, the user might receive difference outcomes. (Customer will be charged for the transaction) |
PD001 | Requested product not available due to insufficient data. | Target DUNS Number is found to have no ownership data available in the UBO Graph DB. Hence, irrespective of the type of request, the user will never receive a different outcome. (Customer will not be charged for the transaction) |
PD008 | Success. Returned truncated list of candidates, as candidates count exceeds maximum limit for the given input criteria. | Partial data is returned from UBO Graph API (Customer will be charged for the transaction) |
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.