Ownership Verification
Also known as Simple Ownership and Global Beneficial Ownership.
Product | D&B Direct 2.0, D&B Direct Onboard |
Product Code(s) | SMPL_OWNSHP, GBO, OWNSHP_VRF |
Level(s) | Standard |
Monitoring Available | Yes (GBO only) |
Interface | REST |
Method | GET |
Format(s) | JSON |
Service | ComplianceVerification |
{version} | 6.0 |
6.0 Released On | December 7, 2018 |
Dun & Bradstreet’s Global Beneficial Ownership Database uniquely brings together global corporate linkage and individual share ownership. It enables you to establish direct and indirect Ultimate Beneficial Ownership at the level that is required in your AML/KYC policy.
Update History
- March 01, 2024 (ALL SOAP & REST): Mapping update to change the priority order of Business Registration Number for Hong Kong market.
- February 09, 2024 (ALL SOAP & REST): Mapping update of Financial Statement Overview for Greece, Romania, Bulgaria, Turkey and Turkish Republic of Northern Cyprus markets.
- October 13, 2023 (ALL SOAP & REST): Financial statements data improvements in overview elements for Brazil, Thailand, Australia, Newzeland, Paraguay, Portugal, Luxembourg, Belgium, Spain, Andorra, Netherlands, Argentina, Uruguay markets.
- August 11, 2023 (ALL SOAP & REST): Replace existing Hoovers Industry Code 25838 with 35912 (new version).
- July 21, 2023 (ALL SOAP & REST): Mapping update to populate Registered Business Name for Spain and Andorra markets.
- July 21, 2023 (ALL SOAP & REST): Mapping update to populate Street Address details in Registered Address for Spain and Andorra markets.
- March 10, 2023 (ALL SOAP & REST): Financial Data Remapping in Overview Section for Hungary market.
- March 10, 2023 (ALL SOAP & REST): Financial Data Remapping in Overview Section for Canada market.
- Decemeber 09, 2022 (ALL SOAP & REST): Addition of NICE Industry Type Code : Korea Standard Industry Code (KSIC).
- Decemeber 09, 2022 (ALL SOAP & REST): Additional Postal Office Addressing Information for Serbia market.
- Decemeber 09, 2022 (ALL SOAP & REST): Street Address Mapping Correction (Street Name & Street Number will be populated in Street Address Line) for Southern Markets (Albania, Bosnia & Herzegovina, Croatia, Montenegro, Serbia, Slovenia, Macedonia, Kosovo).
- Decemeber 09, 2022 (ALL SOAP & REST): ICAP- Local Legal Forms for Greece market.
- October 07, 2022 (ALL SOAP & REST): Registered Business Address changes of companies from Jersey, Guernsey and Isle of Man (currently populated in text line, will be changed to structured format) - United Kingdom markets.
- October 07, 2022 (ALL SOAP & REST): Addition of new registration numbers and removal of Company House UK registration numbers for companies from Jersey, Guernsey and Isle of Man - United Kingdom markets.
- October 07, 2022 (ALL SOAP & REST): Addition of new Legal Form codes for companies from Jersey, Guernsey and Isle of Man- United markets.
- October 07, 2022 (ALL SOAP & REST): Addition of new Legal Events for companies from Jersey, Guernsey and Isle of Man- United Kingdom markets.
- July 15, 2022 (ALL SOAP & REST): Addition of Russia OKVED Local Activity code.
- July 15, 2022 (ALL SOAP & REST): Addition of Mexico SCIAN Local activity code.
- July 15, 2022 (ALL SOAP & REST): Addition of SIC Code 6 & TSR Industry code 4,5,6 for Japan.
- July 15, 2022 (ALL SOAP & REST): Addition of companies start year, month and day in Subject Details for Spain, Andorra market.
- July 15, 2022 (ALL SOAP & REST): Addition of new Principal position codes Executive Officer, Representative Director, Non-Executive Director (Only Director were coming earlier) for Japan
- May 13, 2022 (ALL SOAP & REST): Mapping update of Legal Event Indicators to use updated Scots Code for UK market.
- April 01, 2022 (ALL SOAP & REST): Adding new VAT number and cancellation of VAT identification for Slovenia market
- April 01, 2022 (ALL SOAP & REST): Additional Information on Banking(For Individual accounts), Legal Event(All accounts Frozen) for four countries.
- April 01, 2022 (ALL SOAP & REST): Addition details of GST signal Data like active/inactive/cancelled status of GST number for India market.
- April 01, 2022 (ALL SOAP & REST): Addition of Local business identifier for San Marino market
- February 18, 2022 (ALL SOAP & REST): Adding Consolidated financial statement item and new elements like Financial Statement Item, Consolidation Method Code, Display Sequence for France market.
- February 18, 2022 (ALL SOAP & REST): Adding Minority Interest financial data in Shareholder Equity and P&L into European Standard Format template (20597) of Consolidated statements only for Italy market.
- February 18, 2022 (ALL SOAP & REST): Adding Registered Business Address for Hong Kong SAR , Macao SAR markets.
- February 18, 2022 (ALL SOAP & REST): Adding new Business Identification Number-“MSME UDYAM Registration Number” (Organization ID) for India market.
- January 07, 2022 (ALL SOAP & REST): Defect fix to resolve failure response for Congo countries.
- 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 a Custom Product (that excludes small businesses or company principals), a valid D-U-N-S Number for a company, its country code, and the appropriate product code will be required. 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 SMPL_OWNSHP, GBO data layers are available for businesses domiciled in the following countries:
SMPL_OWNSHP | GBO | 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 | Australia | AU | |
Y | New Zealand | NZ | |
Y | Y | Andorra | AD |
Y | Anguilla | AI | |
Y | Antigua & Barbuda | AG | |
Y | Aruba | AW | |
Y | Bahamas | BS | |
Y | Barbados | BB | |
Y | Belize | BZ | |
Y | Bermuda | BM | |
Y | Bolivia | BO | |
Y | British Virgin Islands | VG | |
Y | Canada | CA | |
Y | Cayman Islands | KY | |
Y | Colombia | CO | |
Y | Costa Rica | CR | |
Y | Y | Denmark | DK |
Y | Dominica | DM | |
Y | Dominican Republic | DO | |
Y | Ecuador | EC | |
Y | El Salvador | SV | |
Y | Y | Faero Islands | FO |
Y | Y | Finland | FI |
Y | Greenland | GL | |
Y | Grenada | GD | |
Y | Guatemala | GT | |
Y | Guyana | GY | |
Y | Haiti | HT | |
Y | Honduras | HN | |
Y | Y | Ireland | IE |
Y | Jamaica | JM | |
Y | Japan | JP | |
Y | Y | Luxembourg | LU |
Y | Mexico | MX | |
Y | Y | Monaco | MC |
Y | Montserrat | MS | |
Y | Netherlands Antilles | AN | |
Y | Bonaire, Sint Eustatius And Saba | BQ | |
Y | Curaçao | CW | |
Y | Sint Maarten (dutch) | SX | |
Y | Nicaragua | NI | |
Y | Y | Norway | NO |
Y | Panama | PA | |
Y | Saint Kitts & Nevis | KN | |
Y | Saint Lucia | LC | |
Y | Saint Vincent | VC | |
Y | Y | San Marino | SM |
Y | Suriname | SR | |
Y | Sweden | SE | |
Y | Taiwan | TW | |
Y | Trinidad And Tobago | TT | |
Y | Turks And Caicos | TC | |
Y | Venezuela | VE | |
Y | Y | Albania | AL |
Y | Argentina | AR | |
Y | Y | Armenia | AM |
Y | Y | Austria | AT |
Y | Y | Azerbaijan | AZ |
Y | Y | Bosnia And Herzegovina | BA |
Y | Brazil | BR | |
Y | Y | Bulgaria | BG |
Y | Y | Belarus | BY |
Y | Y | China, Peoples Republic of | CN |
Y | Y | Croatia | HR |
Y | Y | Cyprus | CY |
Y | Y | Turkish Republic of Northern Cyprus | XT |
Y | Y | Czech Republic | CZ |
Y | Y | Estonia | EE |
Y | French Guiana | GF | |
Y | Y | Georgia | GE |
Y | Y | Gibraltar | GI |
Y | Guadaloupe | GP | |
Y | Hungary | HU | |
Y | Y | Greece | GR |
Y | Hong Kong SAR | HK | |
Y | Hungary | HU | |
Y | Y | Iceland | IS |
Y | Indonesia | ID | |
Y | Y | Kazakhstan | KZ |
Y | Korea, Republic of | KR | |
Y | Y | Kyrgyzstan | KG |
Y | Y | Latvia | LV |
Y | Y | Liechtenstein | LI |
Y | Y | Lithuania | LT |
Y | Y | North Macedonia | MK |
Y | Y | Malta | MT |
Y | Martinique | MQ | |
Y | Y | Moldova | MD |
Y | Montenegro | ME | |
Y | Paraguay | PY | |
Y | Philippines | PH | |
Y | Y | Poland | PL |
Y | Reunion Island | RE | |
Y | Y | Romania | RO |
Y | Y | Russian Federation | RU |
Y | Serbia | RS | |
Y | Y | Slovakia | SK |
Y | Y | Slovenia | SI |
Y | Y | Switzerland | CH |
Y | Y | Tajhikstan | TJ |
Y | Thailand | TH | |
Y | Turkiye | TR | |
Y | Y | Turkmenistan | TM |
Y | Y | Ukraine | UA |
Y | Uruguay | UY | |
Y | Y | Uzbekistan | UZ |
Y | Y | Serbia & Montenegro | CS |
Y | Kosovo | XK | |
Y | Timor-Leste | TL |
NOTE: GBO monitoring is now available for the following countries: Austria, Belgium, Germany, Italy, Ireland, Luxembourg, Netherlands, Portugal, Spain, Switzerland, and United Kingdom.
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 product is entitled as "Corporate Linkage" 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
GET https://direct.dnb.com/V6.0/organizations/214567885/products/SMPL_OWNSHP Authorization: <Token>
GET https://direct.dnb.com/V6.0/organizations/214567885/products/GBO Authorization: <Token>
Name | Characteristics |
---|---|
{version} | Element |
ApplicationTransactionID | string, up to 64 chars, Optional A number assigned by the calling application to uniquely identify this request. |
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. |
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. |
{DUNS} | string, up to 15 chars Pattern: {([0-9a-zA-Z]*)}, Optional The D-U-N-S Number is D&B's identification number, which provides unique identification of this organization, in accordance with the Data Universal Numbering System (D-U-N-S). |
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. |
{productID} | string, Required An alphanumeric string that uniquely identifies the product being requested. |
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. |
TradeUpIndicator | boolean, Optional When 'true' indicates that the customer has requested that D&B return the data for the Headquarters when the requested organization is a Branch. When 'false' indicates that the customer has not requested that D&B return the data for the Headquarters when the requested organization is a Branch; however as this is the assumed condition there is no requirement to create this tag to represent this fact. Note: There are D&B WorldWide Network operations where the Headquarters information will be returned automatically, regardless of the customer request. |
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] |
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. |
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. |
CustomerReferenceText-n | string, up to 240 chars, Optional (up to 5x) A freeform reference string provided by the customer to be linked to the product in order to support subsequent order reconciliation. |
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. |
PrincipalReferenceText | Element, Optional (Array) A freeform reference string provided by the customer to be linked to the principal information provided in the request for the product in order to support subsequent order reconciliation. |
Endpoint
Use the following endpoint for requesting this product. The {version} is dependent on the underlying service delivering the product.
NOTE: While "organizations" is part of this endpoint, there is no service by this name. Many D&B Direct calls have a similar structure; however, the {version} component is based on the SERVICE to which a given product is associated.
Endpoint (CustomProduct) |
---|
GET https://direct.dnb.com/V{version}/organizations/{DUNS}/products/{productID} |
Testing
This operation is currently unavailable in the D&B Direct sandbox (test) environment.
Trials
When conducting testing in the production environment during a trial period, product requests will be limited to the local market of the customer.
Production
A set of D-U-N-S Numbers is available to D&B Direct 2.0 customers for performing non-billable transactions in the production environment.
Product Response
While data for a particular company may not contain values for each of the business elements, there may be items that are considered by D&B to be "essential" to yield the maximum benefit of a data layer. If any of these essential elements do not contain a value for a particular company, a PD005 response code will be returned, and your organization will not incur a usage credit for the request.
For all codified data delivered by D&B Direct, the response package will include the decoded text value as a data element with the code value attached as an attribute. Refer to the Reference Data Service for access to the D&B standard code tables.
NOTE: The D&B Direct REST implementation uses the BadgerFish approach for JSON with some minor variations.
Specification
The following is a list of the possible data fields returned by this operation in the JSON response. Samples are provided for testing successful and failed retrieval, and to demonstrate the basic layout of a response. The data returned in samples may not represent actual values that this feature will deliver.
The Ownership Verification product (OWNSHP_VRF) provides relevant ownership information from one or another independent sources based on the availability. For example, Global Beneficial Ownership data will be returned if available, if not, Simple Ownership Data will be returned.
NOTE: The D-U-N-S Number returned in the response will be a nine-digit zero-padded, numeric value.
{ "OrderProductResponse": { "TransactionDetail": { "ServiceTransactionID": "Id-bbb00c59602902007b300d0040931ef2-2", "TransactionTimestamp": "2017-05-05T13:05:00.372-04:00" }, "TransactionResult": { "SeverityText": "Information", "ResultID": "CM000", "ResultText": "Success" }, "OrderProductResponseDetail": { "InquiryDetail": { "DUNSNumber": "214567885", "CountryISOAlpha2Code": "GB" }, "Product": { "DNBProductID": "SMPL_OWNSHP", "Organization": { "SubjectHeader": { "DUNSNumber": "214567885", "CountryISOAlpha2Code": "GB", "StopDistributionIndicator": false }, "Telecommunication": { "TelephoneNumber": [ { "TelecommunicationNumber": "01628 492000", "InternationalDialingCode": "44" } ] }, "Location": { "PrimaryAddress": [ { "StreetAddressLine": [ { "LineText": "MARLOW INTERNATIONAL PARKWAY", "DisplaySequence": 1 } ], "PrimaryTownName": "MARLOW", "CountryISOAlpha2Code": "GB", "PostalCode": "SL7 1AJ", "TerritoryOfficialName": "BUCKINGHAMSHIRE" } ] }, "OrganizationName": { "OrganizationPrimaryName": [ { "OrganizationName": { "$": "D & B SAMPLE CO LTD" } } ] }, "OrganizationDetail": { "OutofBusinessIndicator": false }, "RegisteredDetail": { "OrganizationIdentificationNumberDetail": [ { "@DNBCodeValue": 2541, "@TypeText": "CRO Number", "OrganizationIdentificationNumber": "434567" } ] }, "Linkage": { "LinkageSummary": { "ChildrenSummary": [ { "ChildrenTypeText": { "@DNBCodeValue": 12769, "$": "Branch" }, "ChildrenQuantity": 1 } ] }, "GlobalUltimateOrganization": { "CountryISOAlpha2Code": "GB", "DUNSNumber": "214567885", "OrganizationPrimaryName": [ { "OrganizationName": { "$": "D & B SAMPLE CO LTD" } } ] }, "DomesticUltimateOrganization": { "DUNSNumber": "214567885", "OrganizationPrimaryName": [ { "OrganizationName": { "$": "D & B SAMPLE CO LTD" } } ] }, "ParentOrganization": { "CountryISOAlpha2Code": "GB", "DUNSNumber": "214567885", "OrganizationPrimaryName": [ { "OrganizationName": { "$": "D & B SAMPLE CO LTD" } } ] } } }, "ArchiveDetail": { "PortfolioAssetID": 76828030 } } } } }
{ "OrderProductResponse": { "TransactionDetail": { "ServiceTransactionID": "Id-84b00c59572902007b300d00d0f934cf-2", "TransactionTimestamp": "2017-05-05T13:04:06.485-04:00" }, "TransactionResult": { "SeverityText": "Information", "ResultID": "CM000", "ResultText": "Success" }, "OrderProductResponseDetail": { "InquiryDetail": { "DUNSNumber": "214567885", "CountryISOAlpha2Code": "GB" }, "Product": { "DNBProductID": "GBO", "Organization": { "SubjectHeader": { "DUNSNumber": "214567885", "CountryISOAlpha2Code": "GB", "StopDistributionIndicator": false }, "Telecommunication": { "TelephoneNumber": [ { "TelecommunicationNumber": "01628 492000", "InternationalDialingCode": "44" } ] }, "Location": { "PrimaryAddress": [ { "StreetAddressLine": [ { "LineText": "MARLOW INTERNATIONAL PARKWAY" } ], "PrimaryTownName": "MARLOW", "CountryISOAlpha2Code": "GB", "TerritoryAbbreviatedName": "BUCKS", "PostalCode": "SL7 1AJ", "TerritoryOfficialName": "BUCKINGHAMSHIRE" } ] }, "OrganizationName": { "OrganizationPrimaryName": [ { "OrganizationName": { "$": "D & B SAMPLE CO LTD" } } ] }, "OrganizationDetail": { "OutofBusinessIndicator": false }, "RegisteredDetail": { "OrganizationIdentificationNumberDetail": [ { "@DNBCodeValue": 2541, "@TypeText": "CRO Number", "OrganizationIdentificationNumber": "434567" } ] }, "Linkage": { "LinkageSummary": { "ChildrenSummary": [ { "ChildrenTypeText": { "@DNBCodeValue": 12769, "$": "Branch" }, "ChildrenQuantity": 1 } ], "ShareOwnerCount": 3 }, "GlobalUltimateOrganization": { "CountryISOAlpha2Code": "GB", "DUNSNumber": "214567885", "OrganizationPrimaryName": [ { "OrganizationName": { "$": "D & B SAMPLE CO LTD" } } ] }, "DomesticUltimateOrganization": { "DUNSNumber": "214567885", "OrganizationPrimaryName": [ { "OrganizationName": { "$": "D & B SAMPLE CO LTD" } } ] }, "ShareOwner": [ { "IndividualName": { "FirstName": "Julie", "MiddleName": "anmol", "LastName": "Whittaker" }, "ShareHoldingPercentage": 20, "MinorShareHolderIndicator": false, "ShareOwnershipStockDetail": [ { "@DNBCodeValue": 3761, "@TypeText": "Ordinary", "CapitalStockQuantity": 1000000, "VotingRightsIndicator": true, "CapitalStockAmount": { "@CurrencyISOAlpha3Code": "GBP", "$": 2500000 }, "ShareHoldingPercentage": 2 } ], "TrusteeIndicator": true }, { "IndividualName": { "FirstName": "Lauren", "LastName": "Franklyn" }, "ShareHoldingPercentage": 20, "MinorShareHolderIndicator": false, "ShareOwnershipStockDetail": [ { "@DNBCodeValue": 3761, "@TypeText": "Ordinary", "CapitalStockQuantity": 1000000, "VotingRightsIndicator": true, "CapitalStockAmount": { "@CurrencyISOAlpha3Code": "GBP", "$": 2500000 }, "ShareHoldingPercentage": 2 } ], "TrusteeIndicator": true }, { "AddressTypeUnknownAddress": [ { "StreetAddressLine": [ { "LineText": "SERFF" }, { "LineText": "THIUJ" }, { "LineText": "TYHVD" } ], "PrimaryTownName": "RTYH", "CountyName": "UK", "PostalCode": "2345" } ], "IndividualName": { "FirstName": "RRTT", "MiddleName": "Zccrt", "LastName": "WERD" }, "ShareHoldingPercentage": 0, "MinorShareHolderIndicator": false, "ShareOwnershipStockDetail": [ { "@DNBCodeValue": 3759, "@TypeText": "Preference", "CapitalStockQuantity": 1, "VotingRightsIndicator": false, "CapitalStockAmount": { "@CurrencyISOAlpha3Code": "GBP", "$": 1 }, "ShareHoldingPercentage": 0 } ], "TrusteeIndicator": false } ] } }, "ShareholdersMatchedQuantity": 3, "ArchiveDetail": { "PortfolioAssetID": 76828041 } } } } }
SO | GBO | 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 & timeRequired 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 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, CountryISOAlpha2Type 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: 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 { DUNSNumber | Element, 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 | OrderProductResponse { OrderProductResponseDetail { Product { Organization { SubjectHeader { CountryISOAlpha2Code | , CountryISOAlpha2Type 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 where the subject is located |
Y | Y | OrderProductResponse { OrderProductResponseDetail { Product { Organization { SubjectHeader { StopDistributionIndicator | , booleanOptional [M] When turned ON (set to TRUE) this indicates that D&B should not fabricate or supply the data recorded in the D&B Database on this subject. When turned OFF (set to FALSE) this indicates that D&B can fabricate or supply the data recorded in the D&B Database on this subject; however, as this is the assumed condition there is no requirement to create this tag to represent this fact. Monitor Path: //Organization /SubjectHeader /StopDistributionIndicator |
Y | Y | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Telecommunication { TelephoneNumber { TelecommunicationNumber | Element, string up to 50 chars.Required A sequence of digits used by the subject for voice communication in a public switched telephone network. This sequence of digits includes the area code or city code. NOTE: This number does not include the International Dialing Code and Domestic Dialing Code. NOTE: Data provided is formatted as per national conventions for each country |
Y | Y | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Telecommunication { TelephoneNumber { InternationalDialingCode | Element, string up to 7 chars.Optional The country calling code assigned by the International Telecommunication Union (ITU) required to connect to this Telecommunication Number of the subject country when dialing from outside the subject country; e.g., '1' for the US, '44' for the UK, '91' for India. |
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 | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { PrimaryAddress { StreetAddressLine { DisplaySequence | , int up to 3 digits.Optional A number which may be used to define the order in which this street address line should be presented relative to other street address lines where the lower the number the earlier the data is presented. |
Y | Y | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { PrimaryAddress { PrimaryTownName | Element, string up to 64 chars.Optional 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, CountryISOAlpha2Type 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 for this address. |
Y | Y | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { PrimaryAddress { TerritoryAbbreviatedName | , string up to 64 chars.Optional The shortened name of the locally governed area which forms part of a centrally governed nation. For example 'NJ' for the US State New Jersey within Country United States of America. |
Y | Y | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { PrimaryAddress { PostalCode | Element, string up to 16 chars.Optional 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 { TerritoryOfficialName | Element, string up to 64 chars.Optional The legal name of the locally governed area which forms part of a centrally governed nation. 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 { OrganizationName { OrganizationPrimaryName { OrganizationName | Element, string up to 256 chars.Required Text recording a name of this organization in the specified language and/or writing script. |
Y | Y | OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationDetail { OutofBusinessIndicator | , booleanOptional 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 { RegisteredDetail { OrganizationIdentificationNumberDetail { OrganizationIdentificationNumber | Element, string up to 40 chars.Required A number assigned by an external body or by D&B which either uniquely identifies or helps to identify an organization. |
Y | Y | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { LinkageSummary { ChildrenSummary { ChildrenTypeText | , string up to 256 chars.Optional Text describing the relationship of the children to the linked Family Tree Subject, e.g., Subsidiary. |
Y | Y | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { LinkageSummary { ChildrenSummary { ChildrenQuantity | , int up to 8 digits.Optional The total number of children of the linked Family Tree Subject of the type specified by Children Type Text. |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { LinkageSummary { ShareOwnerCount | , intOptional The number of organizations/individuals/unclassified entities owning shares of the subject. |
Y | Y | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { GlobalUltimateOrganization { CountryISOAlpha2Code | , CountryISOAlpha2Type at least 2 chars. up to 2 chars.Optional [M] 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. Monitor Path: //Organization /Linkage /GlobalUltimateOrganization /CountryISOAlpha2Code |
Y | Y | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { GlobalUltimateOrganization { DUNSNumber | Element, string up to 15 chars. Pattern: {([0-9a-zA-Z]*)}.Optional [M] 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). Monitor Path: //Organization /Linkage /GlobalUltimateOrganization /DUNSNumber |
Y | Y | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { GlobalUltimateOrganization { OrganizationPrimaryName { OrganizationName | Element, string up to 256 chars.Required [M] Text recording a name of this organization in the specified language and/or writing script. Monitor Path: //Organization /Linkage /GlobalUltimateOrganization /OrganizationPrimaryName /OrganizationName |
Y | Y | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { DomesticUltimateOrganization { CountryISOAlpha2Code | , CountryISOAlpha2Type 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 | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { DomesticUltimateOrganization { DUNSNumber | Element, 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 | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { DomesticUltimateOrganization { OrganizationPrimaryName { OrganizationName | Element, string up to 256 chars.Required Text recording a name of this organization in the specified language and/or writing script. |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { StartDate | , dateOptional The date when the subject's relationship commenced with the Family Tree member. |
Y | Y | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { CountryISOAlpha2Code | , CountryISOAlpha2Type 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 | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { DUNSNumber | Element, string up to 15 chars. Pattern: {([0-9a-zA-Z]*)}.Optional [M] 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). Monitor Path: //Organization /Linkage /ParentOrganization /DUNSNumber |
Y | Y | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { OrganizationPrimaryName { OrganizationName | Element, string up to 256 chars.Required [M] Text recording a name of this organization in the specified language and/or writing script. Monitor Path: //Organization /Linkage /ParentOrganization /OrganizationPrimaryName /OrganizationName |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { OrganizationRegisteredName { OrganizationName | , string up to 256 chars.Required [M] Text recording a name of this organization in the specified language and/or writing script. Monitor Path: //Organization /Linkage /ParentOrganization /OrganizationRegisteredName /OrganizationName |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { TradeStyleName { OrganizationName | , string up to 256 chars.Required Text recording a name of this organization in the specified language and/or writing script. |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { OrganizationNameUnknownTypeName { OrganizationName | , string up to 256 chars.Required [M] Text recording a name of this organization in the specified language and/or writing script. Monitor Path: //Organization /Linkage /ParentOrganization /OrganizationNameUnknownTypeName /OrganizationName |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { 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 | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { PrimaryAddress { StreetAddressLine { DisplaySequence | , int up to 3 digits.Optional A number which may be used to define the order in which this street address line should be presented relative to other street address lines where the lower the number the earlier the data is presented. |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { PrimaryAddress { PrimaryTownName | Element, string up to 64 chars.Optional The name of the town or city recognized by the Postal Authority for delivering mail. |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { PrimaryAddress { CountryISOAlpha2Code | Element, CountryISOAlpha2Type 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 for this address. |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { PrimaryAddress { BuildingName | , string up to 64 chars.Optional Text recording the name of the building in which the subject is located. |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { PrimaryAddress { StreetNumberText | , string up to 6 chars.Optional Text that denotes the number of the address on the street where this subject is located. This may also include the appendix on a street number, the higher number in a range of street numbers which identify more than one building within a street, and / or the appendix to the higher number in a range of street numbers. For example, the '51 - 59C' in the address 51 - 59C Wall Street. |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { PrimaryAddress { StreetName | , string up to 64 chars.Optional Text recording the name of the street where the subject is located. For example, 'Wall Street’ in the address 51 - 59C Wall Street. |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { PrimaryAddress { CountyName | , string up to 128 chars.Optional The name of the primary administrative division within the Territory or Country as received by D&B. Clarification Note: As a guiding principle this is a geographic area which would be classified as a Province (except Canada) or a County. In the U.S. this would be a county within a State. In the UK this would be a county in one of the Home Nations. In Republic Of Ireland, this would be a county and there would be no Territory. |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { PrimaryAddress { TerritoryName | , string up to 128 chars.Optional 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 | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { PrimaryAddress { PostalCode | Element, string up to 16 chars.Optional 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 | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { PrimaryAddress { PostalCodeExtensionCode | , string up to 16 chars.Optional |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { PrimaryAddress { CountryOfficialName | , string up to 64 chars.Optional |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { PrimaryAddress { RegisteredAddressIndicator | , booleanOptional When turned ON (set to TRUE)it indicates that the Primary Address which has been presented is also the Registered Address. When turned OFF (set to FALSE)it indicates that the Primary Address which has been presented is not a Registered Address. |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { MailingAddress { StreetAddressLine { LineText | , 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 | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { MailingAddress { StreetAddressLine { DisplaySequence | , int up to 3 digits.Optional A number which may be used to define the order in which this street address line should be presented relative to other street address lines where the lower the number the earlier the data is presented. |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { MailingAddress { PrimaryTownName | , string up to 64 chars.Optional The name of the town or city recognized by the Postal Authority for delivering mail. |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { MailingAddress { BuildingName | , string up to 64 chars.Optional Text recording the name of the building in which the subject is located. |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { MailingAddress { StreetNumberText | , string up to 6 chars.Optional Text that denotes the number of the address on the street where this subject is located. This may also include the appendix on a street number, the higher number in a range of street numbers which identify more than one building within a street, and / or the appendix to the higher number in a range of street numbers. For example, the '51 - 59C' in the address 51 - 59C Wall Street. |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { MailingAddress { StreetName | , string up to 64 chars.Optional Text recording the name of the street where the subject is located. For example, 'Wall Street’ in the address 51 - 59C Wall Street. |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { MailingAddress { CountyName | , string up to 128 chars.Optional The name of the primary administrative division within the Territory or Country as received by D&B. Clarification Note: As a guiding principle this is a geographic area which would be classified as a Province (except Canada) or a County. In the U.S. this would be a county within a State. In the UK this would be a county in one of the Home Nations. In Republic Of Ireland, this would be a county and there would be no Territory. |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { MailingAddress { TerritoryName | , string up to 128 chars.Optional 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 | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { MailingAddress { PostalCode | , string up to 16 chars.Optional 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 | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { MailingAddress { PostalCodeExtensionCode | , string up to 16 chars.Optional |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { MailingAddress { CountryOfficialName | , string up to 64 chars.Optional |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { MailingAddress { PostOfficeBoxTypeText | , string up to 256 chars.Optional Text that decribes the type of the Post Office Box, e.g., PO Box, PMB. |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { MailingAddress { PostOfficeBoxNumber | , string up to 16 chars.Optional An identifier issued to a subject by a private or public Postal Office for the purposes of collecting mail for that subject for subsequent pickup or delivery. Clarification Note: Though this attribute is referred to as a number, it is not necessarily numeric or entirely numeric. This does not include the textual description of the PO Box type. For example the contents would be just the number 12 from PO Box 12" |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { AddressTypeUnknownAddress { StreetAddressLine { LineText | , 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 | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { AddressTypeUnknownAddress { StreetAddressLine { DisplaySequence | , int up to 3 digits.Optional A number which may be used to define the order in which this street address line should be presented relative to other street address lines where the lower the number the earlier the data is presented. |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { AddressTypeUnknownAddress { PrimaryTownName | , string up to 64 chars.Optional The name of the town or city recognized by the Postal Authority for delivering mail. |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { AddressTypeUnknownAddress { BuildingName | , string up to 64 chars.Optional Text recording the name of the building in which the subject is located. |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { AddressTypeUnknownAddress { StreetNumberText | , string up to 6 chars.Optional Text that denotes the number of the address on the street where this subject is located. This may also include the appendix on a street number, the higher number in a range of street numbers which identify more than one building within a street, and / or the appendix to the higher number in a range of street numbers. For example, the '51 - 59C' in the address 51 - 59C Wall Street. |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { AddressTypeUnknownAddress { StreetName | , string up to 64 chars.Optional Text recording the name of the street where the subject is located. For example, 'Wall Street’ in the address 51 - 59C Wall Street. |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { AddressTypeUnknownAddress { CountyName | , string up to 128 chars.Optional The name of the primary administrative division within the Territory or Country as received by D&B. Clarification Note: As a guiding principle this is a geographic area which would be classified as a Province (except Canada) or a County. In the U.S. this would be a county within a State. In the UK this would be a county in one of the Home Nations. In Republic Of Ireland, this would be a county and there would be no Territory. |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { AddressTypeUnknownAddress { TerritoryName | , string up to 128 chars.Optional 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 | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { AddressTypeUnknownAddress { PostalCode | , string up to 16 chars.Optional 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 | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { AddressTypeUnknownAddress { PostalCodeExtensionCode | , string up to 16 chars.Optional |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { AddressTypeUnknownAddress { CountryOfficialName | , string up to 64 chars.Optional |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { AddressTypeUnknownAddress { PostOfficeBoxTypeText | , string up to 256 chars.Optional Text that decribes the type of the Post Office Box, e.g., PO Box, PMB. |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { AddressTypeUnknownAddress { PostOfficeBoxNumber | , string up to 16 chars.Optional An identifier issued to a subject by a private or public Postal Office for the purposes of collecting mail for that subject for subsequent pickup or delivery. Clarification Note: Though this attribute is referred to as a number, it is not necessarily numeric or entirely numeric. This does not include the textual description of the PO Box type. For example the contents would be just the number 12 from PO Box 12" |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { ShareHoldingPercentage | , decimal up to 5 digits. Maximum of 3 decimal places.Optional [M] The total percentage of the shares (or other instrument of ownership) of the subject directly held/owned by the Shareholder. Monitor Path: //Organization /Linkage /ParentOrganization /ShareHoldingPercentage |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { IndirectShareHoldingPercentage | , decimal up to 5 digits. Maximum of 3 decimal places.Optional [M+] The total percentage of the shares (or other instrument of ownership) of the subject which are directly owned by all the other linked businesses (in which the linked business holds shares), expressed as indirect ownership by the Shareholder. Monitor Path: //Organization /Linkage /ParentOrganization /IndirectShareHoldingPercentage |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { ShareOwnershipStockDetail { CapitalStockSubTypeText | , stringOptional [M+] A text string that identifies a sub category of share classification which has been specifically defined by the subject. For example the ordinary shares of a subject may be broken down into Ordinary A, Ordinary B etc; where the A and B categories have different rights or characteristics. In this example 2 Capital Stock Detail aggregates will be created. In both aggregates the Capital Stock Type Code will be set to 3761 [Ordinary] but the Capital Stock Sub Type Text will be set to A" in the first occurrence and "B" in the second." Monitor Path: //Organization /Linkage /ParentOrganization /ShareOwnershipStockDetail |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { ShareOwnershipStockDetail { CapitalStockQuantity | , longOptional [M+] Records the total number of shares within each Capital Stock Type, e.g., if there are 100 Preference shares with a par value of 5 euros per share the recorded amount is 100. (I.e. The number of shares regardless of value) Monitor Path: //Organization /Linkage /ParentOrganization /ShareOwnershipStockDetail |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { ShareOwnershipStockDetail { VotingRightsIndicator | , booleanOptional [M+] When turned ON (set to TRUE) it means that the shares of the type specified by the combination of the Stock Type Code carry voting rights. When turned OFF (set to FALSE) it means that the shares of the type specified by the combination of the Stock Type Code do not carry voting rights. When set to NULL, it means that DnB does not know if the shares of the type specified by the combination of the Stock Type Code carry voting rights Monitor Path: //Organization /Linkage /ParentOrganization /ShareOwnershipStockDetail |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { ShareOwnershipStockDetail { CapitalStockAmount | , decimalOptional [M+] The total monetary value of these shares, as defined by the combination of the capital stock type This reflects the face value of the shares and not the current stock exchange prices. For example, when a company issues 1000 Preference A shares with a par value of 5 USD (United States Dollar), then the amount recorded is 5000 (i.e. 1000multiplied by 5). Monitor Path: //Organization /Linkage /ParentOrganization /ShareOwnershipStockDetail |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { ShareOwnershipStockDetail { ShareHoldingPercentage | , decimal up to 5 digits. Maximum of 2 decimal places.Optional [M+] The total percentage of the shares (or other instrument of ownership) of the subject directly held/owned by the Shareholder. Monitor Path: //Organization /Linkage /ParentOrganization /ShareOwnershipStockDetail |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { ShareOwnershipStockDetail { IndirectShareHoldingPercentage | , decimal up to 5 digits. Maximum of 2 decimal places.Optional [M+] The total percentage of the shares (or other instrument of ownership) of the subject which are directly owned by all the other linked businesses (in which the linked business holds shares), expressed as indirect ownership by the Shareholder. Monitor Path: //Organization /Linkage /ParentOrganization /ShareOwnershipStockDetail |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { ShareOwnershipStockDetail { ShareHoldingAmount | , decimalOptional [M+] The monetary value of the total shares of the subject possessed by the shareholder. Monitor Path: //Organization /Linkage /ParentOrganization /ShareOwnershipStockDetail |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { ShareOwnershipStockDetail { ConfirmedDate | , dateOptional [M] The date on which the Share Ownership Stock Detail data was confirmed. Monitor Path: //Organization /Linkage /ParentOrganization /ShareOwnershipStockDetail |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { ShareholdingAmount | , decimalOptional The monetary value of the total shares of the subject possessed by the shareholder. |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { DataProviderName | , string up to 256 chars.Optional Text that identifying the source from which this data was originally obtained by DnB. |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { OrganizationIdentificationNumberDetail { OrganizationIdentificationNumber | , string at least 1 chars. up to 40 chars.Required A number assigned by an external body or by D&B which either uniquely identifies or helps to identify an organization. |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { TrusteeIndicator | , booleanOptional When turned ON (set to TRUE) indicates that a shareholder is a trustee or a nominee, I.e. the shareholder is acting on behalf of someone else to hold the shares. When turned OFF (set to FALSE) this indicates that the shareholder is acting in their own right and is not a trustee or nominee; however as this is the assumed condition there is no requirement to create this tag to represent this fact. |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { PrincipalIndicator | , booleanOptional When turned ON (Set to TRUE) this denotes that this shareholder is a person or organization that currently has a relationship with the subject where the relationship is a management relationship, employee relationship or service provider relationship. When turned OFF (Set to FALSE) this denotes that this shareholder is a person or organization that currently does not have a relationship with the subject where the relationship is a management relationship, employee relationship or service provider relationship; however as this is the assumed condition there is no requirement to create this tag to represent this fact. |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { ConfirmedDate | , dateOptional The date on which the Share Ownership was confirmed. |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { IndustryCode { IndustryCode | , string up to 16 chars.Required 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 | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { OrganizationStartYear | , integerOptional The year when operations undertaken by the organization commenced. |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ShareOwner { StartDate | , dateOptional The date when the subject's relationship commenced with the Family Tree member. |
N | Y | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ShareOwner { CountryISOAlpha2Code | , CountryISOAlpha2Type 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 | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ShareOwner { DUNSNumber | , string up to 15 chars. Pattern: {([0-9a-zA-Z]*)}.Optional [M] 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). Monitor Path: //Organization /Linkage /ShareOwner /DUNSNumber |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ShareOwner { OrganizationPrimaryName | , 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 { OrganizationPrimaryName { OrganizationName | , string up to 256 chars.Required Text recording a name of this organization in the specified language and/or writing script. |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ShareOwner { OrganizationRegisteredName { OrganizationName | , string up to 256 chars.Required Text recording a name of this organization in the specified language and/or writing script. |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ShareOwner { TradeStyleName { OrganizationName | , string up to 256 chars.Required Text recording a name of this organization in the specified language and/or writing script. |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ShareOwner { OrganizationNameUnknownTypeName { OrganizationName | , string up to 256 chars.Required Text recording a name of this organization in the specified language and/or writing script. |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ShareOwner { PrimaryAddress { StreetAddressLine { LineText | , 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 | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ShareOwner { PrimaryAddress { StreetAddressLine { DisplaySequence | , int up to 3 digits.Optional A number which may be used to define the order in which this street address line should be presented relative to other street address lines where the lower the number the earlier the data is presented. |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ShareOwner { PrimaryAddress { PrimaryTownName | , string up to 64 chars.Optional The name of the town or city recognized by the Postal Authority for delivering mail. |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ShareOwner { PrimaryAddress { CountryISOAlpha2Code | , CountryISOAlpha2Type 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 for this address. |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ShareOwner { PrimaryAddress { BuildingName | , string up to 64 chars.Optional Text recording the name of the building in which the subject is located. |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ShareOwner { PrimaryAddress { StreetNumberText | , string up to 6 chars.Optional Text that denotes the number of the address on the street where this subject is located. This may also include the appendix on a street number, the higher number in a range of street numbers which identify more than one building within a street, and / or the appendix to the higher number in a range of street numbers. For example, the '51 - 59C' in the address 51 - 59C Wall Street. |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ShareOwner { PrimaryAddress { StreetName | , string up to 64 chars.Optional Text recording the name of the street where the subject is located. For example, 'Wall Street’ in the address 51 - 59C Wall Street. |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ShareOwner { PrimaryAddress { CountyName | , string up to 128 chars.Optional The name of the primary administrative division within the Territory or Country as received by D&B. Clarification Note: As a guiding principle this is a geographic area which would be classified as a Province (except Canada) or a County. In the U.S. this would be a county within a State. In the UK this would be a county in one of the Home Nations. In Republic Of Ireland, this would be a county and there would be no Territory. |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ShareOwner { PrimaryAddress { TerritoryName | , string up to 128 chars.Optional 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 | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ShareOwner { PrimaryAddress { PostalCode | , string up to 16 chars.Optional 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 | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ShareOwner { PrimaryAddress { PostalCodeExtensionCode | , string up to 16 chars.Optional |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ShareOwner { PrimaryAddress { CountryOfficialName | , string up to 64 chars.Optional |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ShareOwner { PrimaryAddress { RegisteredAddressIndicator | , booleanOptional When turned ON (set to TRUE)it indicates that the Primary Address which has been presented is also the Registered Address. When turned OFF (set to FALSE)it indicates that the Primary Address which has been presented is not a Registered Address. |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ShareOwner { MailingAddress { StreetAddressLine { LineText | , 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 | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ShareOwner { MailingAddress { StreetAddressLine { DisplaySequence | , int up to 3 digits.Optional A number which may be used to define the order in which this street address line should be presented relative to other street address lines where the lower the number the earlier the data is presented. |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ShareOwner { MailingAddress { PrimaryTownName | , string up to 64 chars.Optional The name of the town or city recognized by the Postal Authority for delivering mail. |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ShareOwner { MailingAddress { BuildingName | , string up to 64 chars.Optional Text recording the name of the building in which the subject is located. |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ShareOwner { MailingAddress { StreetNumberText | , string up to 6 chars.Optional Text that denotes the number of the address on the street where this subject is located. This may also include the appendix on a street number, the higher number in a range of street numbers which identify more than one building within a street, and / or the appendix to the higher number in a range of street numbers. For example, the '51 - 59C' in the address 51 - 59C Wall Street. |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ShareOwner { MailingAddress { StreetName | , string up to 64 chars.Optional Text recording the name of the street where the subject is located. For example, 'Wall Street’ in the address 51 - 59C Wall Street. |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ShareOwner { MailingAddress { CountyName | , string up to 128 chars.Optional The name of the primary administrative division within the Territory or Country as received by D&B. Clarification Note: As a guiding principle this is a geographic area which would be classified as a Province (except Canada) or a County. In the U.S. this would be a county within a State. In the UK this would be a county in one of the Home Nations. In Republic Of Ireland, this would be a county and there would be no Territory. |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ShareOwner { MailingAddress { TerritoryName | , string up to 128 chars.Optional 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 | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ShareOwner { MailingAddress { PostalCode | , string up to 16 chars.Optional 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 | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ShareOwner { MailingAddress { PostalCodeExtensionCode | , string up to 16 chars.Optional |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ShareOwner { MailingAddress { CountryOfficialName | , string up to 64 chars.Optional |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ShareOwner { MailingAddress { PostOfficeBoxTypeText | , string up to 256 chars.Optional Text that decribes the type of the Post Office Box, e.g., PO Box, PMB. |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ShareOwner { MailingAddress { PostOfficeBoxNumber | , string up to 16 chars.Optional An identifier issued to a subject by a private or public Postal Office for the purposes of collecting mail for that subject for subsequent pickup or delivery. Clarification Note: Though this attribute is referred to as a number, it is not necessarily numeric or entirely numeric. This does not include the textual description of the PO Box type. For example the contents would be just the number 12 from PO Box 12" |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ShareOwner { AddressTypeUnknownAddress { StreetAddressLine { LineText | , 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 | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ShareOwner { AddressTypeUnknownAddress { StreetAddressLine { DisplaySequence | , int up to 3 digits.Optional A number which may be used to define the order in which this street address line should be presented relative to other street address lines where the lower the number the earlier the data is presented. |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ShareOwner { AddressTypeUnknownAddress { PrimaryTownName | , string up to 64 chars.Optional The name of the town or city recognized by the Postal Authority for delivering mail. |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ShareOwner { AddressTypeUnknownAddress { BuildingName | , string up to 64 chars.Optional Text recording the name of the building in which the subject is located. |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ShareOwner { AddressTypeUnknownAddress { StreetNumberText | , string up to 6 chars.Optional Text that denotes the number of the address on the street where this subject is located. This may also include the appendix on a street number, the higher number in a range of street numbers which identify more than one building within a street, and / or the appendix to the higher number in a range of street numbers. For example, the '51 - 59C' in the address 51 - 59C Wall Street. |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ShareOwner { AddressTypeUnknownAddress { StreetName | , string up to 64 chars.Optional Text recording the name of the street where the subject is located. For example, 'Wall Street’ in the address 51 - 59C Wall Street. |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ShareOwner { AddressTypeUnknownAddress { CountyName | , string up to 128 chars.Optional The name of the primary administrative division within the Territory or Country as received by D&B. Clarification Note: As a guiding principle this is a geographic area which would be classified as a Province (except Canada) or a County. In the U.S. this would be a county within a State. In the UK this would be a county in one of the Home Nations. In Republic Of Ireland, this would be a county and there would be no Territory. |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ShareOwner { AddressTypeUnknownAddress { TerritoryName | , string up to 128 chars.Optional 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 | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ShareOwner { AddressTypeUnknownAddress { PostalCode | , string up to 16 chars.Optional 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 | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ShareOwner { AddressTypeUnknownAddress { PostalCodeExtensionCode | , string up to 16 chars.Optional |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ShareOwner { AddressTypeUnknownAddress { CountryOfficialName | , string up to 64 chars.Optional |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ShareOwner { AddressTypeUnknownAddress { PostOfficeBoxTypeText | , string up to 256 chars.Optional Text that decribes the type of the Post Office Box, e.g., PO Box, PMB. |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ShareOwner { AddressTypeUnknownAddress { PostOfficeBoxNumber | , string up to 16 chars.Optional An identifier issued to a subject by a private or public Postal Office for the purposes of collecting mail for that subject for subsequent pickup or delivery. Clarification Note: Though this attribute is referred to as a number, it is not necessarily numeric or entirely numeric. This does not include the textual description of the PO Box type. For example the contents would be just the number 12 from PO Box 12" |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ShareOwner { OrganizationIndicator | , booleanOptional [M] When turned ON (set to TRUE) it indicates that the Shareholder is an Organization When turned OFF (set to FALSE) it indicates that the Shareholder is Individual or Unclassifed Monitor Path: //Organization /Linkage /ShareOwner /OrganizationIndicator |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ShareOwner { IndividualName { NamePrefix { NamePrefixText | , string up to 16 chars.Optional [M+] Text defining the correct form of address for this individual. E.g., Dr, Professor, Lord. Monitor Path: //Organization /Linkage /ShareOwner /IndividualName |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ShareOwner { IndividualName { FirstName | , string up to 64 chars.Optional [M+] The given name of the individual. If this is not known then an initial may be supplied. Monitor Path: //Organization /Linkage /ShareOwner /IndividualName |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ShareOwner { IndividualName { MiddleName | , string up to 64 chars.Optional [M+] The portion of the individual's name (typically a personal name) placed after the first name and before the last name. Monitor Path: //Organization /Linkage /ShareOwner /IndividualName |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ShareOwner { IndividualName { LastName | , string up to 64 chars.Optional [M+] The portion of the individual's name usually presented at the end used to identify the members of a family. Monitor Path: //Organization /Linkage /ShareOwner /IndividualName |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ShareOwner { IndividualName { FullName | , string up to 256 chars.Optional [M+] The entire name of the subject where the subject is either an individual or an organization. Monitor Path: //Organization /Linkage /ShareOwner /IndividualName |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ShareOwner { IndividualName { NameSuffix { NameSuffixText | , string up to 16 chars.Optional [M+] Text representing either a familial suffix to the person's name (e.g., Senior, Junior, III. ) or a professional/qualification suffix to the person's name (e.g., MD, FRICS, PhD etc.) or some other suffix to the person's name (e.g., Baronet, Retired.). Monitor Path: //Organization /Linkage /ShareOwner /IndividualName |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ShareOwner { UnClassifiedShareholderNames | , string up to 240 chars.Optional (Array) [M] Name recording of shareholder which is not categorized as individual or organization. Monitor Path: //Organization /Linkage /ShareOwner /UnClassifiedShareholderNames |
Y | Y | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ShareOwner { ShareHoldingPercentage | , decimal up to 5 digits. Maximum of 3 decimal places.Optional [M] The total percentage of the shares (or other instrument of ownership) of the subject directly held/owned by the Shareholder. Monitor Path: //Organization /Linkage /ShareOwner /ShareHoldingPercentage |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ShareOwner { IndirectShareHoldingPercentage | , decimal up to 5 digits. Maximum of 3 decimal places.Optional [M] The total percentage of the shares (or other instrument of ownership) of the subject which are directly owned by all the other linked businesses (in which the linked business holds shares), expressed as indirect ownership by the Shareholder. Monitor Path: //Organization /Linkage /ShareOwner /IndirectShareHoldingPercentage |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ShareOwner { MinorShareHolderIndicator | , booleanOptional [M] When turned ON (set to TRUE) it indicates that the rest of the meager shares are owned by the minority shareholders. When turned OFF (set to FALSE) it indicates that the rest of the meager shares are not owned by the minority shareholders. Monitor Path: //Organization /Linkage /ShareOwner /MinorShareHolderIndicator |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ShareOwner { ShareOwnershipStockDetail { CapitalStockSubTypeText | , stringOptional [M] A text string that identifies a sub category of share classification which has been specifically defined by the subject. For example the ordinary shares of a subject may be broken down into Ordinary A, Ordinary B etc; where the A and B categories have different rights or characteristics. In this example 2 Capital Stock Detail aggregates will be created. In both aggregates the Capital Stock Type Code will be set to 3761 [Ordinary] but the Capital Stock Sub Type Text will be set to A" in the first occurrence and "B" in the second." Monitor Path: //Organization /Linkage /ShareOwner /ShareOwnershipStockDetail |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ShareOwner { ShareOwnershipStockDetail { CapitalStockQuantity | , longOptional [M+] Records the total number of shares within each Capital Stock Type, e.g., if there are 100 Preference shares with a par value of 5 euros per share the recorded amount is 100. (I.e. The number of shares regardless of value) Monitor Path: //Organization /Linkage /ShareOwner /ShareOwnershipStockDetail |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ShareOwner { ShareOwnershipStockDetail { VotingRightsIndicator | , booleanOptional [M+] When turned ON (set to TRUE) it means that the shares of the type specified by the combination of the Stock Type Code carry voting rights. When turned OFF (set to FALSE) it means that the shares of the type specified by the combination of the Stock Type Code do not carry voting rights. When set to NULL, it means that DnB does not know if the shares of the type specified by the combination of the Stock Type Code carry voting rights Monitor Path: //Organization /Linkage /ShareOwner /ShareOwnershipStockDetail |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ShareOwner { ShareOwnershipStockDetail { CapitalStockAmount | , decimalOptional [M+] The total monetary value of these shares, as defined by the combination of the capital stock type This reflects the face value of the shares and not the current stock exchange prices. For example, when a company issues 1000 Preference A shares with a par value of 5 USD (United States Dollar), then the amount recorded is 5000 (i.e. 1000multiplied by 5). Monitor Path: //Organization /Linkage /ShareOwner /ShareOwnershipStockDetail |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ShareOwner { ShareOwnershipStockDetail { ShareHoldingPercentage | , decimal up to 5 digits. Maximum of 2 decimal places.Optional [M+] The total percentage of the shares (or other instrument of ownership) of the subject directly held/owned by the Shareholder. Monitor Path: //Organization /Linkage /ShareOwner /ShareOwnershipStockDetail |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ShareOwner { ShareOwnershipStockDetail { IndirectShareHoldingPercentage | , decimal up to 5 digits. Maximum of 2 decimal places.Optional [M+] The total percentage of the shares (or other instrument of ownership) of the subject which are directly owned by all the other linked businesses (in which the linked business holds shares), expressed as indirect ownership by the Shareholder. Monitor Path: //Organization /Linkage /ShareOwner /ShareOwnershipStockDetail |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ShareOwner { ShareOwnershipStockDetail { ShareHoldingAmount | , decimalOptional [M+] The monetary value of the total shares of the subject possessed by the shareholder. Monitor Path: //Organization /Linkage /ShareOwner /ShareOwnershipStockDetail |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ShareOwner { ShareOwnershipStockDetail { ConfirmedDate | , dateOptional [M+] The date on which the Share Ownership Stock Detail data was confirmed. Monitor Path: //Organization /Linkage /ShareOwner /ShareOwnershipStockDetail |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ShareOwner { ShareholdingAmount | , decimalOptional The monetary value of the total shares of the subject possessed by the shareholder. |
Y | Y | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ShareOwner { Linkage { ParentOrganization { CountryISOAlpha2Code | , CountryISOAlpha2Type 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. |
N | Y | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ShareOwner { Linkage { ParentOrganization { 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). |
N | Y | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ShareOwner { Linkage { ParentOrganization { OrganizationPrimaryName { OrganizationName | , string up to 256 chars.Required Text recording a name of this organization in the specified language and/or writing script. |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ShareOwner { DataProviderName | , string up to 256 chars.Optional Text that identifying the source from which this data was originally obtained by DnB. |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ShareOwner { BirthDate | , dateOptional [M+] The date of birth of the Family Tree Linkage subject where that subject is an individual. Monitor Path: //Organization /Linkage /ShareOwner /BirthDate |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ShareOwner { OrganizationIdentificationNumberDetail { OrganizationIdentificationNumber | , string at least 1 chars. up to 40 chars.Required A number assigned by an external body or by D&B which either uniquely identifies or helps to identify an organization. |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ShareOwner { TrusteeIndicator | , booleanOptional [M] When turned ON (set to TRUE) indicates that a shareholder is a trustee or a nominee, I.e. the shareholder is acting on behalf of someone else to hold the shares. When turned OFF (set to FALSE) this indicates that the shareholder is acting in their own right and is not a trustee or nominee; however as this is the assumed condition there is no requirement to create this tag to represent this fact. Monitor Path: //Organization /Linkage /ShareOwner /TrusteeIndicator |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ShareOwner { PrincipalIndicator | , booleanOptional [M] When turned ON (Set to TRUE) this denotes that this shareholder is a person or organization that currently has a relationship with the subject where the relationship is a management relationship, employee relationship or service provider relationship. When turned OFF (Set to FALSE) this denotes that this shareholder is a person or organization that currently does not have a relationship with the subject where the relationship is a management relationship, employee relationship or service provider relationship; however as this is the assumed condition there is no requirement to create this tag to represent this fact. Monitor Path: //Organization /Linkage /ShareOwner /PrincipalIndicator |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ShareOwner { ConfirmedDate | , dateOptional The date on which the Share Ownership was confirmed. |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ShareOwner { IndustryCode { IndustryCode | , string up to 16 chars.Required 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 | N | OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ShareOwner { OrganizationStartYear | , integerOptional [M] The year when operations undertaken by the organization commenced. Monitor Path: //Organization /Linkage /ShareOwner /OrganizationStartYear |
Y | Y | End: OrderProductResponse { OrderProductResponseDetail { Product { Organization | Aggregate, |
Y | N | OrderProductResponse { OrderProductResponseDetail { Product { ShareholdersMatchedQuantity | , intOptional The count of shareholders that matches the filter criteria of the request. |
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, longRequired A number used to uniquely identify this product in the location where it is stored. |
Y | Y | OrderProductResponse { OrderProductResponseDetail { Product { ArchiveDetail { PortfolioAssetContainerID | Element, longOptional A number used to uniquely identify the location where this product is stored. |
Y | Y | OrderProductResponse { OrderProductResponseDetail { Product { ArchiveDetail { ExtendedArchiveIndicator | Element, booleanOptional 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 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, PrincipalReferenceText up to 256 chars.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, int upto 2 digits |
Y | Y | End: OrderProductResponse { OrderProductResponseDetail { InquiryReferenceDetail | Aggregate, |
Y | Y | End: OrderProductResponse { OrderProductResponseDetail | Aggregate, |
Y | Y | End: OrderProductResponse | Aggregate, |
Legend: [C] = may be included in a Custom Data product; [M] = may be referenced by the Monitoring process; [M+] = Monitored using an aggregate or attribute XPath.
Lists of possible values (when present) are subject to change. Additional values not presented in this documentation may be delivered in the response and should be anticipated in any implementation.
Empty/NULL Values
A NULL returned for an element indicates that the information was not provided to D&B when the related data items were collected. The absence of a value for a particular item should not be considered indicative of any implied value (e.g., NULL for a boolean indicator is NOT the same as a value of 'false').
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]).
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.
Business Elements
While D&B Direct uses a product canonical naming model in the request/response, many customers may be more familiar with the following business element labels.
This product will also return a set of standard elements (e.g. D-U-N-S Number, Organization Name, Trade Styles, Family Tree Role, Primary Address, Mailing Address, Telephone Number, Fax Number, etc.) in addition to the business elements listed.
In this data layer, the Target DUNS refers to the D-U-N-S Number of the business or organization on which a search is being performed to confirm its existence and verify its credentials.
Match elements within this data layer contain details returned from the regulating authorities regarding the Target DUNS. Sanctions Match elements contain details from the sanctions lists against which the Target DUNS has been checked and matched.
Unclassified elements are data elements that cannot be classified into a defined address type, such as a business or mailing address. This indicates that D&B not aware of the address type collected for this company or shareholder. For other business elements such as Primary Address or Mailing Address D&B knows specifically that the address collected is the primary address where the company is located or the mailing address used for mailing purposes.
SO | GBO | Name | Description |
---|---|---|---|
Y | Y | Country/Market Code | The two-letter country/market code, defined by the International Organization for Standardization (ISO) ISO 3166-1 scheme, identifying the country/market of the subject for which the Shareholder Information is provided. [C] PCM XPath: //Organization/ SubjectHeader/ CountryISOAlpha2Code |
Y | Data Source of GBO Data | A code identifying the source from which this data was originally obtained by D&B. PCM XPath: //Organization/ Linkage/ ShareOwner/ DataProviderName | |
Y | Y | Domestic Ultimate Business Name | Text recording the name of the highest business in the family tree that is in the same country as the subject. [C] PCM XPath: //Organization/ Linkage/ DomesticUltimateOrganization/ OrganizationPrimaryName/ OrganizationName |
Y | Y | Domestic Ultimate Country/Market Code | The two-letter country/market code, defined by the International Organization for Standardization (ISO) ISO 3166-1 scheme, identifying the country/market of the Domestic Ultimate of the Target DUNS. [C] PCM XPath: //Organization/ Linkage/ DomesticUltimateOrganization/ CountryISOAlpha2Code |
Y | Y | Domestic Ultimate D-U-N-S Number | DUNS Number of the Domestic Ultimate of the Target DUNS. [C] PCM XPath: //Organization/ Linkage/ DomesticUltimateOrganization/ DUNSNumber |
Y | Y | Global Ultimate Business Name | Text recording the primary name of the global ultimate business. [C] PCM XPath: //Organization/ Linkage/ GlobalUltimateOrganization/ OrganizationPrimaryName/ OrganizationName |
Y | Y | Global Ultimate Country/Market Code | The two-letter country/market code, defined by the International Organization for Standardization (ISO) ISO 3166-1 scheme, identifying the country/market of the Global Ultimate of the Target DUNS. [C] PCM XPath: //Organization/ Linkage/ GlobalUltimateOrganization/ CountryISOAlpha2Code |
Y | Y | Global Ultimate D-U-N-S Number | DUNS Number of the Global Ultimate of the Target DUNS. [C] PCM XPath: //Organization/ Linkage/ GlobalUltimateOrganization/ DUNSNumber |
Y | Linkage Summary | Provides a summary of the corporate linkage of the Target DUNS. [C] PCM XPath: //Organization/ Linkage/ LinkageSummary/ ChildrenSummary/ ChildrenTypeText | |
Y | Local Registration Number | A registration or identification number assigned by local government agencies to identify a business within the local market. Examples include the France Siret Number, European VAT Number, Australian Business Number, Brazilian State Registry Number. [C] PCM XPath: //Organization/ RegisteredDetail/ OrganizationIdentificationNumberDetail/ OrganizationIdentificationNumber | |
Y | Y | Out of Business Indicator (Organization) | Indicates whether the Target DUNS is out of business. [C] PCM XPath: //Organization/ OrganizationDetail/ OutofBusinessIndicator |
Y | Parent Building Name | The name of the building in which the parent company is located. PCM XPath: //Organization/ Linkage/ ParentOrganization/ PrimaryAddress/ BuildingName | |
Y | Y | Parent Business Name | Text recording the company name of the parent of the Target DUNS. [C] PCM XPath: //Organization/ Linkage/ ParentOrganization/ OrganizationPrimaryName/ OrganizationName |
Y | Y | Parent Country/Market Code | The two-letter country/market code, defined by the International Organization for Standardization (ISO) ISO 3166-1 scheme, identifying the country/market of the parent of the Target DUNS. [C] PCM XPath: //Organization/ Linkage/ ParentOrganization/ CountryISOAlpha2Code |
Y | Parent Country/Market Code | The two-letter country/market code, defined by the International Organization for Standardization (ISO) ISO 3166-1 scheme, identifying the country/market where the parent organization resides. This element can only be used when all attempts to derive the Country Identifier have failed. [C] PCM XPath: //Organization/ Linkage/ ParentOrganization/ PrimaryAddress/ CountryISOAlpha2Code | |
Y | Parent Country Name | A name of an administrative division within a Territory or Country. [C] PCM XPath: //Organization/ Linkage/ ParentOrganization/ PrimaryAddress/ CountryOfficialName | |
Y | Parent County Name | The name of a the administrative division within a territory where the parent company is located. PCM XPath: //Organization/ Linkage/ ParentOrganization/ PrimaryAddress/ CountyName | |
Y | Y | Parent D-U-N-S Number | DUNS Number of the Parent of the Target DUNS. [C] PCM XPath: //Organization/ Linkage/ ParentOrganization/ DUNSNumber |
Y | Parent Indirect Shareholding Percentage | The percentage of ownership held by the parent company in other businesses which in turn own shares of the subject company. PCM XPath: //Organization/ Linkage/ ParentOrganization/ IndirectShareHoldingPercentage | |
Y | Parent Mailing Address Building Name | The name of the building where the parent company receives its mail. PCM XPath: //Organization/ Linkage/ ParentOrganization/ MailingAddress/ BuildingName | |
Y | Parent Mailing Address Country Name | The name of the country where the parent company receives its mail. This element can only be used when all attempts to derive the country identifier have failed. PCM XPath: //Organization/ Linkage/ ParentOrganization/ MailingAddress/ CountryOfficialName | |
Y | Parent Mailing Address County Name | The name of the administrative division within a territory or country where the parent company receives its mail. PCM XPath: //Organization/ Linkage/ ParentOrganization/ MailingAddress/ CountyName | |
Y | Parent Mailing Address Postal Code | An identifier used by the local country Postal Authority to identify a particular geographic location where the parent company receives its mail. PCM XPath: //Organization/ Linkage/ ParentOrganization/ MailingAddress/ PostalCode | |
Y | Parent Mailing Address Street Address | Text describing the first line of the mailing address of the parent company (e.g., building, street, estate) when these cannot be parsed or recorded in a more granular format. PCM XPath: //Organization/ Linkage/ ParentOrganization/ MailingAddress/ StreetAddressLine/ LineText | |
Y | Parent Mailing Address Street Name | The name of the street where the parent company is located for mailing purposes. PCM XPath: //Organization/ Linkage/ ParentOrganization/ MailingAddress/ StreetName | |
Y | Parent Mailing Address Street Number | The street number of the mailing address of the parent company, for example, the number 51 in the address 51 Wall Street. PCM XPath: //Organization/ Linkage/ ParentOrganization/ MailingAddress/ StreetNumberText | |
Y | Parent Mailing Address Territory Name | Text recording the name of the locally governed area which forms part of a centrally governed nation, i.e., state, province, territory, which the business uses for mailing purposes. PCM XPath: //Organization/ Linkage/ ParentOrganization/ MailingAddress/ TerritoryName | |
Y | Parent Mailing Address Town Name | Text recording the name of the city, town, village, etc. where the parent company is located for mailing purposes. PCM XPath: //Organization/ Linkage/ ParentOrganization/ MailingAddress/ PrimaryTownName | |
Y | Parent Organization Data Provider | A code identifying the source from which this data was originally obtained by D&B. PCM XPath: //Organization/ Linkage/ ParentOrganization/ DataProviderName | |
Y | Parent Organization Last Update | The date when the parent company information was confirmed as up to date. PCM XPath: //Organization/ Linkage/ ParentOrganization/ ConfirmedDate | |
Y | Parent Organization Start Year | The year when operations undertaken by the parent company commenced. PCM XPath: //Organization/ Linkage/ ParentOrganization/ OrganizationStartYear | |
Y | Parent Organization Stock Quantity | A number recording how many shares, as defined by the combination of the stock type, are owned by the shareholder. PCM XPath: //Organization/ Linkage/ ParentOrganization/ ShareOwnershipStockDetail/ CapitalStockQuantity | |
Y | Parent Organization Stock Subcategory | A text string that identifies a specific sub-category of shares to further differentiate granted rights. For example, if the stock type is 'ordinary', these shares may be, for instance, class 'A' or class 'B', where A has different rights or characteristics than B (e.g., class A may have 1 vote per share, while class B may have 10 votes per share). PCM XPath: //Organization/ Linkage/ ParentOrganization/ ShareOwnershipStockDetail/ CapitalStockSubTypeText | |
Y | Parent Organization Voting Rights Indicator | When 'true' indicates that the shares of the type specified by the combination of the Stock Type Code carry voting rights. PCM XPath: //Organization/ Linkage/ ParentOrganization/ ShareOwnershipStockDetail/ VotingRightsIndicator | |
Y | Parent Organizaton Industry Code | A code used to identify a business activity. PCM XPath: //Organization/ Linkage/ ParentOrganization/ IndustryCode/ IndustryCode | |
Y | Parent Post Office Box Number | An identifier issued to a subject by a private or public post office for the purposes of collecting mail for that subject for subsequent pickup or delivery. PCM XPath: //Organization/ Linkage/ ParentOrganization/ MailingAddress/ PostOfficeBoxNumber | |
Y | Parent Post Office Box Type | A text value that describes the type of the Post Office Box, e.g., Post Office Box, Post Mail Box. PCM XPath: //Organization/ Linkage/ ParentOrganization/ MailingAddress/ PostOfficeBoxTypeText | |
Y | Parent Postal Code | An extension to the postal code which identifies a street or building within the geographic area covered by the Postal Code. [C] PCM XPath: //Organization/ Linkage/ ParentOrganization/ PrimaryAddress/ PostalCode | |
Y | Parent Postal Code Extension | An extension to the postal code which identifies a street or building within the geographic area covered by the postal code where the parent company receives its mail. PCM XPath: //Organization/ Linkage/ ParentOrganization/ MailingAddress/ PostalCodeExtensionCode | |
Y | Parent Postal Extension Code | An extension to the postal code which identifies a street or building within the geographic area covered by the postal code. PCM XPath: //Organization/ Linkage/ ParentOrganization/ PrimaryAddress/ PostalCodeExtensionCode | |
Y | Parent Registered Address Indicator | When 'true' indicates that the primary address which has been presented is also the registered address. PCM XPath: //Organization/ Linkage/ ParentOrganization/ PrimaryAddress/ RegisteredAddressIndicator | |
Y | Parent Registration Business Name | Text recording the registered name of the parent company. PCM XPath: //Organization/ Linkage/ ParentOrganization/ OrganizationRegisteredName/ OrganizationName | |
Y | Parent Registration Number | The parent company's identification number. This number is assigned by local government agencies to identify a business within the local market, e.g., Establishment Number, Company House Registration Number. PCM XPath: //Organization/ Linkage/ ParentOrganization/ OrganizationIdentificationNumberDetail/ OrganizationIdentificationNumber | |
Y | Parent Shareholding Amount | The total par value of shares held by a parent company. This reflects the face value of the shares and not the current stock exchange price. e.g., if there are 100 ordinary shares with a par value of 5 euros per share the recorded amount is 500. PCM XPath: //Organization/ Linkage/ ParentOrganization/ ShareholdingAmount | |
Y | Parent Shareholding Percentage | The percentage of the ownership shares of the parent company directly held by the linked business. PCM XPath: //Organization/ Linkage/ ParentOrganization/ ShareHoldingPercentage | |
Y | Parent Start Date | The date when the parent company first acquired an interest in the business. PCM XPath: //Organization/ Linkage/ ParentOrganization/ StartDate | |
Y | Parent Stock Detail Shareholding Amount | The total par value of shares held by a shareholder in the parent company. This reflects the face value of the shares and not the current stock exchange price. e.g., if there are 100 ordinary shares with a par value of 5 euros per share the recorded amount is 500. PCM XPath: //Organization/ Linkage/ ParentOrganization/ ShareOwnershipStockDetail/ ShareholdingAmount | |
Y | Parent Stock Detail Shareholding Percentage | The percentage of the voting (ownership)shares of the parent company directly held or owned by the linked business. PCM XPath: //Organization/ Linkage/ ParentOrganization/ ShareOwnershipStockDetail/ ShareHoldingPercentage | |
Y | Parent Stock Indirect Shareholding Percentage | The percentage of ownership held by the shareholder in the parent company in other businesses which in turn own shares of the subject company. PCM XPath: //Organization/ Linkage/ ParentOrganization/ ShareOwnershipStockDetail/ IndirectShareHoldingPercentage | |
Y | Parent Stock Info Last Update | The date when the stock detail information was confirmed as up to date. PCM XPath: //Organization/ Linkage/ ParentOrganization/ ShareOwnershipStockDetail/ ConfirmedDate | |
Y | Parent Street Address | Text describing the first line of the address (e.g., building, street, estate) when these cannot be parsed or recorded in a more granular format. [C] PCM XPath: //Organization/ Linkage/ ParentOrganization/ PrimaryAddress/ StreetAddressLine/ LineText | |
Y | Parent Street Name | The name of the street where the parent company is located. PCM XPath: //Organization/ Linkage/ ParentOrganization/ PrimaryAddress/ StreetName | |
Y | Parent Street Number | The number of the address on the street where the parent company is located, e.g., the 51 in the address 51 Wall Street. PCM XPath: //Organization/ Linkage/ ParentOrganization/ PrimaryAddress/ StreetNumberText | |
Y | Parent Territory Name | The name of a locally governed area which forms part of a centrally governed nation, i.e., state, province or territory, where the parent company is located. [C] PCM XPath: //Organization/ Linkage/ ParentOrganization/ PrimaryAddress/ TerritoryName | |
Y | Parent Town Name | The name of the town or city where the parent company is located. [C] PCM XPath: //Organization/ Linkage/ ParentOrganization/ PrimaryAddress/ PrimaryTownName | |
Y | Parent Trade Style Name | Text recording trade style name of the parent company. Trade styles are additional business names used by a company, also referred to as a DBA (doing business as) or AKA (also known as) name. PCM XPath: //Organization/ Linkage/ ParentOrganization/ TradeStyleName/ OrganizationName | |
Y | Parent Trustee Indicator | When 'true' indicates that a shareholder is a trustee or a nominee, i.e., the shareholder is acting on behalf of someone else to hold the shares. PCM XPath: //Organization/ Linkage/ ParentOrganization/ TrusteeIndicator | |
Y | Parent Unclassified Address Building Name | The name of the building in which the parent company is located. PCM XPath: //Organization/ Linkage/ ParentOrganization/ AddressTypeUnknownAddress/ BuildingName | |
Y | Parent Unclassified Address Country Name | The name of the country where the parent company resides. This element can only be used when all attempts to derive the Country Identifier have failed. PCM XPath: //Organization/ Linkage/ ParentOrganization/ AddressTypeUnknownAddress/ CountryOfficialName | |
Y | Parent Unclassified Address County Name | The name of a the administrative division within a Territory where the parent company is located. PCM XPath: //Organization/ Linkage/ ParentOrganization/ AddressTypeUnknownAddress/ CountyName | |
Y | Parent Unclassified Address Post Office Box Number | An identifier issued to a subject by a private or public Postal Office for the purposes of collecting mail for that subject for subsequent pickup or delivery. PCM XPath: //Organization/ Linkage/ ParentOrganization/ AddressTypeUnknownAddress/ PostOfficeBoxNumber | |
Y | Parent Unclassified Address Post Office Box Type | A text value that describes the type of the Post Office Box, e.g., Post Office Box, Post Mail Box. PCM XPath: //Organization/ Linkage/ ParentOrganization/ AddressTypeUnknownAddress/ PostOfficeBoxTypeText | |
Y | Parent Unclassified Address Postal Code | An identifier used by the local country Postal Authority to identify a particular geographic location. PCM XPath: //Organization/ Linkage/ ParentOrganization/ AddressTypeUnknownAddress/ PostalCode | |
Y | Parent Unclassified Address Postal Code Extension | An extension to the postal code which identifies a street or building within the geographic area covered by the postal code. PCM XPath: //Organization/ Linkage/ ParentOrganization/ AddressTypeUnknownAddress/ PostalCodeExtensionCode | |
Y | Parent Unclassified Address Street Name | The name of the street where the parent company is located. PCM XPath: //Organization/ Linkage/ ParentOrganization/ AddressTypeUnknownAddress/ StreetName | |
Y | Parent Unclassified Address Street Number | The number of the address on the street where the parent company is located, e.g., the 51 in the address 51 Wall Street. PCM XPath: //Organization/ Linkage/ ParentOrganization/ AddressTypeUnknownAddress/ StreetNumberText | |
Y | Parent Unclassified Address Territory Name | Text recording the name of locally governed area which forms part of a centrally governed nation, i.e., state, province or territory, where the parent company is located. PCM XPath: //Organization/ Linkage/ ParentOrganization/ AddressTypeUnknownAddress/ TerritoryName | |
Y | Parent Unclassified Address Town Name | Text recording the name of the city, town, village, etc. where the parent company is located. PCM XPath: //Organization/ Linkage/ ParentOrganization/ AddressTypeUnknownAddress/ PrimaryTownName | |
Y | Parent Unclassified Name | Text recording the unclassified name of the parent company. PCM XPath: //Organization/ Linkage/ ParentOrganization/ OrganizationNameUnknownTypeName/ OrganizationName | |
Y | Parent Unclassified Street Address | Text describing the first line of the address (e.g., building, street, estate) when these cannot be parsed or recorded in a more granular format. PCM XPath: //Organization/ Linkage/ ParentOrganization/ AddressTypeUnknownAddress/ StreetAddressLine/ LineText | |
Y | Share Ownership Amount | The total par value of shares held by a shareholder in the subject. This reflects the face value of the shares and not the current stock exchange price. e.g., if there are 100 ordinary shares with a par value of 5 euros per share the recorded amount is 500. PCM XPath: //Organization/ Linkage/ ShareOwner/ ShareholdingAmount | |
Y | Share Ownership Last Update Date | The date when the shareholder information was confirmed as up to date. PCM XPath: //Organization/ Linkage/ ShareOwner/ ConfirmedDate | |
Y | Y | Share Ownership Percentage | The percentage of the voting (ownership) shares of the subject directly held or owned by the linked business. [C] PCM XPath: //Organization/ Linkage/ ShareOwner/ ShareHoldingPercentage |
Y | Share Ownership Percentage (Indirect) | The percentage of ownership held by the shareholder in other businesses which in turn own shares of the subject company. PCM XPath: //Organization/ Linkage/ ShareOwner/ IndirectShareHoldingPercentage | |
Y | Shareholder | An individual or institution (including a corporation) that owns one or more shares of stock in a corporation. PCM XPath: //Organization/ Linkage/ ShareOwner | |
Y | Shareholder Building Name | The name of the building in which the shareholder organization is located. PCM XPath: //Organization/ Linkage/ ShareOwner/ PrimaryAddress/ BuildingName | |
Y | Shareholder Country/Market Code | The two-letter country/market code, defined by the International Organization for Standardization (ISO) ISO 3166-1 scheme, identifying the country/market of the shareholder. PCM XPath: //Organization/ Linkage/ ShareOwner/ CountryISOAlpha2Code | |
Y | Shareholder Country/Market Code | The two-letter country/market code, defined by the International Organization for Standardization (ISO) standard ISO 3166-1, identifying the country/market where the shareholder organization is located. This element can only be used when all attempts to derive the country identifier have failed. PCM XPath: //Organization/ Linkage/ ShareOwner/ PrimaryAddress/ CountryISOAlpha2Code | |
Y | Shareholder Country Name | The name of the country where the shareholder organization is located. PCM XPath: //Organization/ Linkage/ ShareOwner/ PrimaryAddress/ CountryOfficialName | |
Y | Shareholder County Name | The name of the administrative division within a territory or country where the shareholder is located. PCM XPath: //Organization/ Linkage/ ShareOwner/ PrimaryAddress/ CountyName | |
Y | Shareholder Date of Birth | The date of birth of the Individual. PCM XPath: //Organization/ Linkage/ ShareOwner/ BirthDate | |
Y | Shareholder Direct Ownership Percentage | The percentage of the voting (ownership) shares of the subject directly held or owned by the linked business. PCM XPath: //Organization/ Linkage/ ShareOwner/ ShareOwnershipStockDetail/ ShareHoldingPercentage | |
Y | Y | Shareholder D-U-N-S Number | The D-U-N-S number of the shareholder. PCM XPath: //Organization/ Linkage/ ShareOwner/ DUNSNumber |
Y | Shareholder First Name | Text recording the first name or first initial of the shareholder PCM XPath: //Organization/ Linkage/ ShareOwner/ IndividualName/ FirstName | |
Y | Shareholder Full Name | The name by which the shareholder is known. PCM XPath: //Organization/ Linkage/ ShareOwner/ IndividualName/ FullName | |
Y | Shareholder Indirect Ownership Percentage | The percentage of ownership held by the shareholder in other businesses which in turn own shares of the subject company. PCM XPath: //Organization/ Linkage/ ShareOwner/ ShareOwnershipStockDetail/ IndirectShareHoldingPercentage | |
Y | Shareholder Industry Code | A number that identifies the industry coding system of the Industry Code, e.g., US SIC 1972, SIC 8, NACE, BL VAT. PCM XPath: //Organization/ Linkage/ ShareOwner/ IndustryCode/ IndustryCode | |
Y | Shareholder Last Name | The name which is considered to be the shareholder's last name. This is also referred to as a surname or family name. PCM XPath: //Organization/ Linkage/ ShareOwner/ IndividualName/ LastName | |
Y | Shareholder Mailing Address | Text describing the first line of the address (e.g., building, street, estate) when these cannot be parsed or recorded in a more granular format. PCM XPath: //Organization/ Linkage/ ShareOwner/ MailingAddress/ StreetAddressLine/ LineText | |
Y | Shareholder Mailing Address Building Name | The name of the building where the shareholder receives mail. PCM XPath: //Organization/ Linkage/ ShareOwner/ MailingAddress/ BuildingName | |
Y | Shareholder Mailing Address Country Name | The country name of the shareholder mailing address. This element can only be used when all attempts to derive the Country Identifier have failed. PCM XPath: //Organization/ Linkage/ ShareOwner/ MailingAddress/ CountryOfficialName | |
Y | Shareholder Mailing Address County Name | The name of the administrative division within a territory or country where the shareholder is located for mailing purposes. PCM XPath: //Organization/ Linkage/ ShareOwner/ MailingAddress/ CountyName | |
Y | Shareholder Mailing Address Postal Code | An identifier used by the local country Postal Authority to identify a particular geographic location where the shareholder receives its mail. PCM XPath: //Organization/ Linkage/ ShareOwner/ MailingAddress/ PostalCode | |
Y | Shareholder Mailing Address Postal Code Extension | An extension to the postal code which identifies a street or building within the geographic area covered by the postal code. PCM XPath: //Organization/ Linkage/ ShareOwner/ MailingAddress/ PostalCodeExtensionCode | |
Y | Shareholder Mailing Address Street Name | The street name of the shareholder mailing address. PCM XPath: //Organization/ Linkage/ ShareOwner/ MailingAddress/ StreetName | |
Y | Shareholder Mailing Address Street Number | The number of the shareholder mailing address, e.g., the 51 in the address 51 Wall Street. PCM XPath: //Organization/ Linkage/ ShareOwner/ MailingAddress/ StreetNumberText | |
Y | Shareholder Mailing Address Territory Name | Text recording the name of a locally governed area which forms part of a centrally governed nation, i.e., state, province or territory, where mail is delivered to the shareholder. PCM XPath: //Organization/ Linkage/ ShareOwner/ MailingAddress/ TerritoryName | |
Y | Shareholder Mailing Address Town Name | Text recording the name of the city, town, village, etc. where the shareholder is located for mailing purposes. PCM XPath: //Organization/ Linkage/ ShareOwner/ MailingAddress/ PrimaryTownName | |
Y | Shareholder Middle Name | Text recording the middle name or first name of the shareholder. PCM XPath: //Organization/ Linkage/ ShareOwner/ IndividualName/ MiddleName | |
Y | Shareholder Minor Share Indicator | A code which describes the scope of the shareholder's interest in the subject, e.g., majority holding, minority holding, holds the balance of the shares. PCM XPath: //Organization/ Linkage/ ShareOwner/ MinorShareHolderIndicator | |
Y | Shareholder Name Prefix | The title of the share owner when the share owner is an individual, e.g., Mr, Mrs, Miss, Ms Dr. PCM XPath: //Organization/ Linkage/ ShareOwner/ IndividualName/ NamePrefix/ NamePrefixText | |
Y | Shareholder Name Suffix | Text recording a familial suffix to the shareholder's name (e.g., Senior, Junior, III. ) or a professional/qualification suffix to the shareholder's name (e.g., MD, PhD) or some other suffix to the principals name (e.g., Retired). PCM XPath: //Organization/ Linkage/ ShareOwner/ IndividualName/ NameSuffix/ NameSuffixText | |
Y | Y | Shareholder Organization Name | Text recording the name by which the shareholder business is primarily identified. PCM XPath: //Organization/ Linkage/ ShareOwner/ OrganizationPrimaryName/ OrganizationName |
Y | Shareholder Ownership Amount | The total par value of shares held by a shareholder in the subject. This reflects the face value of the shares and not the current stock exchange price. e.g., if there are 100 ordinary shares with a par value of 5 euros per share the recorded amount is 500. PCM XPath: //Organization/ Linkage/ ShareOwner/ ShareOwnershipStockDetail/ ShareholdingAmount | |
Y | Shareholder Ownership Last Update Date | The date when the shareholder information was confirmed as up to date. PCM XPath: //Organization/ Linkage/ ShareOwner/ ShareOwnershipStockDetail/ ConfirmedDate | |
Y | Shareholder Parent Country/Market Code | The two-letter country/market code, defined by the International Organization for Standardization (ISO) standard ISO 3166-1, identifying the country/market of the parent company of the shareholder. PCM XPath: //Organization/ Linkage/ ShareOwner/ Linkage/ ParentOrganization/ CountryISOAlpha2Code | |
Y | Shareholder Parent D-U-N-S Number | The D-U-N-S number of the parent company of the shareholder. PCM XPath: //Organization/ Linkage/ ShareOwner/ Linkage/ ParentOrganization/ DUNSNumber | |
Y | Shareholder Parent Name | Text recording the company name of the Shareholder's parent company. PCM XPath: //Organization/ Linkage/ ShareOwner/ Linkage/ ParentOrganization/ OrganizationPrimaryName/ OrganizationName | |
Y | Shareholder Post Office Box Number | An identifier issued to a subject by a private or public Postal Office for the purposes of collecting mail for that subject for subsequent pickup or delivery. PCM XPath: //Organization/ Linkage/ ShareOwner/ MailingAddress/ PostOfficeBoxNumber | |
Y | Shareholder Post Office Box Type | A code value that describes the type of the Post Office Box, e.g., Post Office Box, Post Mail Box. PCM XPath: //Organization/ Linkage/ ShareOwner/ MailingAddress/ PostOfficeBoxTypeText | |
Y | Shareholder Postal Code | An extension to the postal code which identifies a street or building within the geographic area covered by the Postal Code. PCM XPath: //Organization/ Linkage/ ShareOwner/ PrimaryAddress/ PostalCode | |
Y | Shareholder Postal Extension Code | An identifier issued to a subject by a private or public Postal Office for the purposes of collecting mail for that subject for subsequent pickup or delivery. PCM XPath: //Organization/ Linkage/ ShareOwner/ PrimaryAddress/ PostalCodeExtensionCode | |
Y | Shareholder Principal Indicator | When 'true' indicates that this shareholder is a principal for the organization that has issued the shares. PCM XPath: //Organization/ Linkage/ ShareOwner/ PrincipalIndicator | |
Y | Shareholder Registered Address Indicator | When 'true' indicates that the primary address which has been presented is also the registered address. PCM XPath: //Organization/ Linkage/ ShareOwner/ PrimaryAddress/ RegisteredAddressIndicator | |
Y | Shareholder Registration Business Name | Text recording the registered name of the shareholder company. PCM XPath: //Organization/ Linkage/ ShareOwner/ OrganizationRegisteredName/ OrganizationName | |
Y | Shareholder Registration Number | A value that describes the type of registration number of the organization, e.g., France Siret Number, European VAT Number. PCM XPath: //Organization/ Linkage/ ShareOwner/ OrganizationIdentificationNumberDetail/ OrganizationIdentificationNumber | |
Y | Shareholder Start Date | The date when the owner first acquired an interest in the business. PCM XPath: //Organization/ Linkage/ ShareOwner/ StartDate | |
Y | Shareholder Start Year | The year when operations undertaken by the organization commenced. PCM XPath: //Organization/ Linkage/ ShareOwner/ OrganizationStartYear | |
Y | Shareholder Street Address | Text describing the first line of the address (e.g., building, street, estate) when these cannot be parsed or recorded in a more granular format. PCM XPath: //Organization/ Linkage/ ShareOwner/ PrimaryAddress/ StreetAddressLine/ LineText | |
Y | Shareholder Street Name | The name of the street where the shareholder organization is located. PCM XPath: //Organization/ Linkage/ ShareOwner/ PrimaryAddress/ StreetName | |
Y | Shareholder Street Number | The number of the address on the street where the Shareholder organization is located, e.g., the 51 in the address 51 Wall Street. PCM XPath: //Organization/ Linkage/ ShareOwner/ PrimaryAddress/ StreetNumberText | |
Y | Shareholder Territory Name | Text recording the name of a locally governed area which forms part of a centrally governed nation, i.e., state, province or territory, where the shareholder is located. PCM XPath: //Organization/ Linkage/ ShareOwner/ PrimaryAddress/ TerritoryName | |
Y | Shareholder Town Name | Text recording the name of the city, town, village, etc. where the shareholder is located. PCM XPath: //Organization/ Linkage/ ShareOwner/ PrimaryAddress/ PrimaryTownName | |
Y | Shareholder Trade Style Name | Text recording the tradestyle name of the shareholder company. Tradestyles are additional business names used by a company, also referred to as a DBA (doing business as) or AKA (also known as) name. PCM XPath: //Organization/ Linkage/ ShareOwner/ TradeStyleName/ OrganizationName | |
Y | Shareholder Trustee Indicator | When 'true' indicates that a shareholder is a trustee or a nominee, i.e., the shareholder is acting on behalf of someone else to hold the shares. PCM XPath: //Organization/ Linkage/ ShareOwner/ TrusteeIndicator | |
Y | Shareholder Unclassfied Name | The name of the shareholder. PCM XPath: //Organization/ Linkage/ ShareOwner/ UnClassifiedShareholderNames | |
Y | Shareholder Unclassified Address Building Name | The name of the building in which the subject is located. PCM XPath: //Organization/ Linkage/ ShareOwner/ AddressTypeUnknownAddress/ BuildingName | |
Y | Shareholder Unclassified Country Name | The name of the country where the shareholder organization is located. PCM XPath: //Organization/ Linkage/ ShareOwner/ AddressTypeUnknownAddress/ CountryOfficialName | |
Y | Shareholder Unclassified County Name | The name of the administrative division within a territory or country where the shareholder is located. PCM XPath: //Organization/ Linkage/ ShareOwner/ AddressTypeUnknownAddress/ CountyName | |
Y | Shareholder Unclassified Post Office Box Number | Text describing the third line of the address (e.g., building, street, estate) when these cannot be parsed or recorded in a more granular format. PCM XPath: //Organization/ Linkage/ ShareOwner/ AddressTypeUnknownAddress/ PostOfficeBoxNumber | |
Y | Shareholder Unclassified Post Office Box Type | The name of the town or city recognized by the Postal Authority for delivering mail. PCM XPath: //Organization/ Linkage/ ShareOwner/ AddressTypeUnknownAddress/ PostOfficeBoxTypeText | |
Y | Shareholder Unclassified Postal Code | Text describing the first line of the address (e.g.building, street, estate) when these cannot be parsed and.or recorded in a more granular format. PCM XPath: //Organization/ Linkage/ ShareOwner/ AddressTypeUnknownAddress/ PostalCode | |
Y | Shareholder Unclassified Postal Code Extenstion | An extension to the postal code which identifies a street or building within the geographic area covered by the postal code. PCM XPath: //Organization/ Linkage/ ShareOwner/ AddressTypeUnknownAddress/ PostalCodeExtensionCode | |
Y | Shareholder Unclassified Street Address | Text describing the second line of the address (e.g., building, street, estate) when these cannot be parsed or recorded in a more granular format. PCM XPath: //Organization/ Linkage/ ShareOwner/ AddressTypeUnknownAddress/ StreetAddressLine/ LineText | |
Y | Shareholder Unclassified Street Name | The name of the street where the shareholder organization is located. PCM XPath: //Organization/ Linkage/ ShareOwner/ AddressTypeUnknownAddress/ StreetName | |
Y | Shareholder Unclassified Street Number | The number of the address on the street where the shareholder is located, e.g., the 51 in the address 51 Wall Street. PCM XPath: //Organization/ Linkage/ ShareOwner/ AddressTypeUnknownAddress/ StreetNumberText | |
Y | Shareholder Unclassified Territory Name | Text recording the name of the locally governed area which forms part of a centrally governed nation, i.e. state, province, or territory where the shareholder is located. This element can only be used when all attempts to derive this information have failed. PCM XPath: //Organization/ Linkage/ ShareOwner/ AddressTypeUnknownAddress/ TerritoryName | |
Y | Shareholder Unclassified Town Name | Text recording the name of the city, town, village, etc. where the shareholder is located. PCM XPath: //Organization/ Linkage/ ShareOwner/ AddressTypeUnknownAddress/ PrimaryTownName | |
Y | Stock Quantity | A number recording how many shares, as defined by the combination of the stock type, are owned by the shareholder. PCM XPath: //Organization/ Linkage/ ShareOwner/ ShareOwnershipStockDetail/ CapitalStockQuantity | |
Y | Stock Subcategory | A text string that identifies a specific sub-category of shares to further differentiate granted rights. For example, if the stock type is 'ordinary', these shares may be, class 'A' or class 'B', where A has different rights or characteristics than B (e.g., class A may have 1 vote per share, while class B may have 10 votes per share). PCM XPath: //Organization/ Linkage/ ShareOwner/ ShareOwnershipStockDetail/ CapitalStockSubTypeText | |
Y | Y | Stop Distribution Indicator | Indicates whether the Target DUNS is on stop distribution status in the D&B database. [C] PCM XPath: //Organization/ SubjectHeader/ StopDistributionIndicator |
Y | Total Children Quantity | The number of subsidiaries, divisions, and branches plus the total number of affiliated subsidiaries linked to this company (i.e., subsidiaries with the same parent company). [C] PCM XPath: //Organization/ Linkage/ LinkageSummary/ ChildrenSummary/ ChildrenQuantity | |
Y | Total Matched Shareholders | The number of shareholders that match the given criteria. PCM XPath: //ShareholdersMatchedQuantity | |
Y | Total Shareholders | The total number of Shareholders for the given DUNS. PCM XPath: //Organization/ Linkage/ LinkageSummary/ ShareOwnerCount | |
Y | Voting Rights Indicator | When 'true' indicates that the shares of the type specified by the combination of the Stock Type Code carry voting rights. PCM XPath: //Organization/ Linkage/ ShareOwner/ ShareOwnershipStockDetail/ VotingRightsIndicator |
The preceding list is not presented in the order, nor manner, in which the information is packaged and delivered via the D&B Direct API. Legend: [C] = may be included in a Custom Data product; [M] = may be referenced by the Monitoring process; [M+] = Monitored using an aggregate or attribute XPath.
Standard Elements
Whenever a D&B Direct data or report product request returns a single D-U-N-S Number, several business elements pertaining to that company will be included with the results.
These elements include D-U-N-S Number*, Organization Name, Primary Address** (including street, city, state, postal code, country), Mailing Address** (including street, city, state, postal code, county), Telephone Number, Fax Number, Trade Styles (up to five), Family Tree Role (HQ, branch), a Standalone Organization Indicator(true/false) and the PortfolioAssetID***.
All standard elements (with the exception of Family Tree Role and PortfolioAssetID) may be referenced by the Monitoring process.
* The D-U-N-S Number of the organization referenced in the results. In the case of a trade up, this will be the headquarters D-U-N-S Number.
** Addresses are returned as they are recieved by D&B and therefore may not conform to local postal formatting specifications.
*** This is an identification number that can be used to retrieve a given results package at a later date from the Product Request Archive (if/when that feature is enabled in a request).
Name | Description |
---|---|
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). This DUNS Number represents the business entity. |
Country Code | The two-letter country code, defined by the International Organization for Standardization (ISO) ISO 3166-1 scheme identifying the country of the business entity. |
County Name | Text recording the name of the county in which the business is located. |
Family Tree Member Role | Text recording of various parts that the Subject plays as a member of an ownership structured family tree. |
FAX Number | The FAX number of the business. |
FAX Number International Dialing Code | The FAX number international dialing code of the business. |
Mailing Country Code | The two-letter country code, defined by the International Organization for Standardization (ISO) ISO 3166-1 scheme identifying the country which the business uses for mailing purposes. |
Mailing County Name | Text recording the name of the county which the business uses for mailing purposes. |
Mailing Postal Code | An identifier used by the local country Postal Authority which the business uses for mailing purposes. |
Mailing Street | Text recording an address which is mainly utilized for the purpose of mail delivery to the business. This usually includes a Post Office Box number or similar mailing details. |
Mailing Street (2) | Text recording an address which is mainly utilized for the purpose of mail delivery to the business. This usually includes a Post Office Box number or similar mailing details. |
Mailing Territory Abbreviation | Text recording the shortened name of the locally governed area which forms part of a centrally governed nation which the business uses for mailing purposes. |
Mailing Territory Name | Text recording the name of the locally governed area which forms part of a centrally governed nation which the business uses for mailing purposes. |
Mailing Town Name | The address number, or post office box number, and street name which a business uses for mailing purposes. |
Postal Code | An identifier used by the local country Postal Authority to identify where the business is located. |
Primary Business Name | Text recording of a single name by which the organization is primarily known or identified. |
Standalone Organization Indicator | When true indicates that this organization is not a member of a legal family tree. The Subject has no Parent Company, no subsidiaries or no branch/division locations. |
Street Address | Text recording the address number, or post office box number and street name where the business is located. |
Street Address (2) | Text recording the address number, or post office box number and street name where the business is located. |
Telephone Number | The telephone number of the business. |
Telephone Number International Dialing Code | The telephone number international dialing code of the business. |
Territory Abbreviated Name | Text recording the shortened name of the locally governed area which forms part of a centrally governed nation to identify where the business is located. |
Territory Name | Text recording the name of the locally governed area which forms part of a centrally governed nation to identify where the business is located. |
Town Name | Text recording the name of a city, town, township, village, borough, etc. where the business is located. |
Trade Style Name | Text recording the name which an organization trades under for commercial purposes although its registered legal name used for contracts and other formal situations may be another name. |
Product Notes
There are no notes for this data layer.