WB1784 Single Record
Also known as Detailed Company Profile - WB1784
Product Code(s) | DCP_WB1784 |
Level(s) | Standard |
Monitoring Available | Yes |
Interface | REST |
Method | GET |
Format(s) | JSON |
Service | Firmographic |
{version} | 5.2 |
5.2 Released On | December 11, 2015 |
This data layer provides details (one record at a time) comparable to the WorldBase Linked Prospect Record (WB1784) batch file, and is intended for customers familiar with the batch product.
New customers are encouraged to consume the Detailed Company Profile data layer(s).
Update History
- May 07, 2021 (ALL SOAP & REST): Defect fix to remove the duplicate industry code from the product response.
- April 26, 2019 (ALL SOAP & REST): New description has been updated for FullReportDate element.
- March 29, 2019 (ALL SOAP & REST): TransferDUNSNumberRegistration aggregate and its elements have been suppressed from the response.
- March 8, 2019 (v7.0 SOAP & REST): New Service version created for diversity changes to include additional indicator and detail section.
- July 15, 2016 (ALL SOAP & REST): Industry Code Description has been added to DCP_SDMR and DCP_WB1784.
- June 3, 2016 (v6.0 SOAP & REST): Return Transferred To DUNS Indicator has been added as a request parameter.
- June 3, 2016 (v6.0 SOAP & REST): Subject Scope Text has been added and enabled.
- March 11, 2016 (ALL SOAP & REST): NAICS 2012 (24664) industry codes are now delivered in addition to the NAICS 2007 (700) codes.
- December 11, 2015 (v5.2 SOAP & REST): United Nations Standard Products and Services Code, D-U-N-S Transfer data, and Primary Local Activity Code are added. GlobalUltimateOrganization/PrimaryAddress/TerritoryOfficialName is also added and should be used in place of GlobalUltimateOrganization/PrimaryAddress/TerritoryName. The latter may not be included in future versions of this service.
- October 9, 2015 (v5.1 SOAP & REST): Linkage Update Date has been added to Custom Products and DCP_WB1784.
- October 9, 2015 (v5.1 SOAP & REST): Trade-up functionality now available for DCP_PREM, DCP_ENH, DCP_STD, DCP_SDMR and DCP_WB1784.
- March 7, 2014 (v3.2 SOAP & REST): The Detailed Company Profile - WB1784 and Detailed Company Profile - SDMR data layers have been added to this service.
- December 12, 2014 (v3.2 + earlier SOAP & REST): The field PrimaryAddress. TerritoryOfficialName should be used in place of PrimaryAddress. TerritoryName. The latter may not be included in future versions of this service.
- July 15, 2016 (ALL SOAP & REST): Industry Code Description has been added to DCP_SDMR and DCP_WB1784.
- June 3, 2016 (v6.0 SOAP & REST): Return Transferred To DUNS Indicator has been added as a request parameter.
- June 3, 2016 (v6.0 SOAP & REST): Subject Scope Text has been added and enabled.
- March 11, 2016 (ALL SOAP & REST): NAICS 2012 (24664) industry codes are now delivered in addition to the NAICS 2007 (700) codes.
- December 11, 2015 (v5.2 SOAP & REST): United Nations Standard Products and Services Code, D-U-N-S Transfer data, and Primary Local Activity Code are added. GlobalUltimateOrganization/PrimaryAddress/TerritoryOfficialName is also added and should be used in place of GlobalUltimateOrganization/PrimaryAddress/TerritoryName. The latter may not be included in future versions of this service.
- October 9, 2015 (v5.1 SOAP & REST): Linkage Update Date has been added to Custom Products and DCP_WB1784.
- October 9, 2015 (v5.1 SOAP & REST): Trade-up functionality now available for DCP_PREM, DCP_ENH, DCP_STD, DCP_SDMR and DCP_WB1784.
- March 7, 2014 (v3.2 SOAP & REST): The Detailed Company Profile - WB1784 and Detailed Company Profile - SDMR data layers have been added to this service.
- December 12, 2014 (v3.2 + earlier SOAP & REST): The field PrimaryAddress. TerritoryOfficialName should be used in place of PrimaryAddress. TerritoryName. The latter may not be included in future versions of this service.
Product Request
IMPORTANT: Due to a known issue, please do not include request values for SubmittingOfficeID.
IMPORTANT: Please see the new Online Services Security Enhancement Release, effective November 09, 2020.
Overview
When requesting this feature, a valid D&B D-U-N-S Number for a company and the appropriate product code will be required. For improved performance, include its country code.
A trade up option exists to request data for the headquarters when the requested organization is a branch.
NOTE: When ordering information for organizations located in Germany, customers are required to provide a valid order reason code.
Global Availability
The DCP_WB1784 data layer is available for businesses domiciled in the following countries:
Country | ISO Code |
---|---|
United States of America | US |
Belgium | BE |
France | FR |
Germany | DE |
Italy | IT |
Netherlands | NL |
Portugal | PT |
Spain | ES |
United Kingdom | GB |
Australia | AU |
New Zealand | NZ |
Andorra | AD |
Anguilla | AI |
Antigua & Barbuda | AG |
Aruba | AW |
Bahamas | BS |
Barbados | BB |
Belize | BZ |
Bermuda | BM |
Bolivia | BO |
British Virgin Islands | VG |
Canada | CA |
Cayman Islands | KY |
Chile | CL |
Colombia | CO |
Costa Rica | CR |
Denmark | DK |
Dominica | DM |
Dominican Republic | DO |
Ecuador | EC |
El Salvador | SV |
Faero Islands | FO |
Finland | FI |
Greenland | GL |
Grenada | GD |
Guatemala | GT |
Guyana | GY |
Haiti | HT |
Honduras | HN |
Ireland | IE |
Jamaica | JM |
Japan | JP |
Luxembourg | LU |
Mexico | MX |
Monaco | MC |
Montserrat | MS |
Netherlands Antilles | AN |
Bonaire, Sint Eustatius And Saba | BQ |
Curaçao | CW |
Sint Maarten (dutch) | SX |
Nicaragua | NI |
Norway | NO |
Panama | PA |
Saint Kitts & Nevis | KN |
Saint Lucia | LC |
Saint Vincent | VC |
San Marino | SM |
Suriname | SR |
Sweden | SE |
Taiwan | TW |
Trinidad And Tobago | TT |
Turks And Caicos | TC |
Venezuela | VE |
Afghanistan | AF |
Albania | AL |
Algeria | DZ |
American Samoa | AS |
Angola | AO |
Argentina | AR |
Armenia | AM |
Austria | AT |
Azerbaijan | AZ |
Bahrain | BH |
Bangladesh | BD |
Benin, Peoples Republic of | BJ |
Bhutan | BT |
Bosnia And Herzegovina | BA |
Botswana | BW |
Brazil | BR |
Brunei | BN |
Bulgaria | BG |
Burkina Faso | BF |
Burma (myanmar) | MM |
Burundi | BI |
Belarus | BY |
Kampuchea (prev. Cambodia) | KH |
Cameroon | CM |
Cape Verde, Republic of | CV |
Central Africa Republic | CF |
Chad, Republic of | TD |
China, Peoples Republic of | CN |
Christmas Island | CX |
Comoros Republic | KM |
Congo Democratic Republic | CD |
Cook Islands | CK |
Croatia | HR |
Cyprus | CY |
Turkish Republic of Northern Cyprus | XT |
Czech Republic | CZ |
Djibouti | DJ |
Egypt | EG |
Equatorial Guinea | GQ |
Eritrea | ER |
Estonia | EE |
Ethiopia | ET |
Falkland Islands | FK |
Fiji | FJ |
French Guiana | GF |
French Polynesia/tahiti | PF |
Gabon Republic | GA |
Gambia | GM |
Georgia | GE |
Ghana | GH |
Gibraltar | GI |
Greece | GR |
Guadeloupe | GP |
Guam | GU |
Guinea Bissau | GW |
Guinea, Republic of | GN |
Hong Kong SAR | HK |
Hungary | HU |
Iceland | IS |
India | IN |
Indonesia | ID |
Iran | IR |
Iraq | IQ |
Israel | IL |
Ivory Coast/cote D'ivoire | CI |
Jordan | JO |
Kazakhstan | KZ |
Kenya | KE |
Kiribati | KI |
Korea, Republic of | KR |
Kuwait | KW |
Kyrgyzstan | KG |
Laos | LA |
Latvia | LV |
Lebanon | LB |
Lesotho | LS |
Liberia | LR |
Libya | LY |
Liechtenstein | LI |
Lithuania | LT |
Macao SAR | MO |
North Macedonia | MK |
Madagasgar | MG |
Malawi | MW |
Malaysia | MY |
Maldives | MV |
Mali | ML |
Malta | MT |
Marianas Islands | MP |
Marshall Islands | MH |
Martinique | MQ |
Mauritania | MR |
Mauritius | MU |
Moldova | MD |
Montenegro | ME |
Morocco | MA |
Mozambique | MZ |
Namibia | NA |
Nauru | NR |
Nepal | NP |
New Caledonia | NC |
Niger | NE |
Nigeria | NG |
Norfolk Island | NF |
Oman | OM |
Pakistan | PK |
Papua New Guinea | PG |
Paraguay | PY |
Peru | PE |
Philippines | PH |
Poland | PL |
Qatar | QA |
Reunion Island | RE |
Romania | RO |
Russian Federation | RU |
Rwanda | RW |
Saint Helena | SH |
Saint Pierre et Miquelon | PM |
Sao Tome & Principe | ST |
Saudi Arabia | SA |
Senegal | SN |
Serbia | RS |
Seychelles | SC |
Sierra Leone | SL |
Singapore | SG |
Slovakia | SK |
Slovenia | SI |
Solomon Islands | SB |
Somalia | SO |
South Africa | ZA |
Sri Lanka | LK |
Sudan | SD |
South Sudan | SS |
Eswatini | SZ |
Switzerland | CH |
Syria | SY |
Tajhikstan | TJ |
Tanzania | TZ |
Thailand | TH |
Togo | TG |
Tokelau Islands | TK |
Tonga | TO |
Tunisia | TN |
Turkey | TR |
Turkmenistan | TM |
Tuvalu | TV |
Uganda | UG |
Ukraine | UA |
United Arab Emirates | AE |
Uruguay | UY |
Uzbekistan | UZ |
Vanuatu | VU |
Vietnam | VN |
Western Samoa | WS |
Yemen | YE |
Zambia | ZM |
Zimbabwe | ZW |
Congo | CG |
Holy See (Vatican City State) | VA |
Kosovo | XK |
Micronesia, Federated States of | FM |
Timor-Leste | TL |
South Georgia and the South Sandwich Islands | GS |
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 "Detailed Company Profile - WorldBase 1784 Layout" 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 NOT included in the D&B Direct Onboard suite.
Specification
GET https://direct.dnb.com/V5.2/organizations/804735132/products/DCP_WB1784 Authorization: <My 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 | date & time, 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]*)}, 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). |
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. Possible values: 39 [English] |
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] |
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. Possible values: true; false |
ArchiveProductOptOutIndicator | boolean, Optional Possible values: true; false |
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. Possible values: true; false |
PortfolioAssetContainerID | long, Optional |
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 char, 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. |
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.
REST (Firmographic) |
---|
GET https://direct.dnb.com/V{version}/organizations/{DUNS}/products/{productID} |
Testing
Sandbox
The following parameters may be used for D&B Direct 2.0 developer sandbox requests to retrieve successful responses. The data returned from sandbox requests may not represent actual values that this feature will deliver.
D-U-N-S Number (Country Code) |
---|
804735132 (US); 362241452 (US); 214567885 (GB); 754683795 (AU); 481794956 (CH) |
Trials
When conducting testing in the production environment during a trial period, product requests will be limited to the local market of the customer.
Production
A set of D-U-N-S Numbers is available to D&B Direct 2.0 customers for performing non-billable transactions in the production environment.
Product Response
While data for a particular company may not contain values for each of the business elements, there may be items that are considered by D&B to be "essential" to yield the maximum benefit of a data layer. If any of these essential elements do not contain a value for a particular company, a PD005 response code will be returned, and your organization will not incur a usage credit for the request.
For all codified data delivered by D&B Direct, the response package will include the decoded text value as a data element with the code value attached as an attribute. Refer to the Reference Data Service for access to the D&B standard code tables.
NOTE: The D&B Direct REST implementation uses the BadgerFish approach for JSON with some minor variations.
Specification
The following is a list of the possible data fields returned by this operation in the JSON response. Samples are provided for testing successful and failed retrieval, and to demonstrate the basic layout of a response. The data returned in samples may not represent actual values that this feature will deliver.
NOTE: The D-U-N-S Number returned in the response will be a nine-digit zero-padded, numeric value.
{"OrderProductResponse": { "@ServiceVersionNumber": "5.2", "TransactionDetail": { "ServiceTransactionID": "Id-e755dd56c34b040080150800554aad7d-2", "TransactionTimestamp": "2016-03-07T05:20:24.895-05:00" }, "TransactionResult": { "SeverityText": "Information", "ResultID": "CM000", "ResultText": "Success" }, "OrderProductResponseDetail": { "InquiryDetail": { "DUNSNumber": "804735132", "CountryISOAlpha2Code": "US" }, "Product": { "DNBProductID": "DCP_WB1784", "Organization": { "SubjectHeader": { "DUNSNumber": "804735132", "LastUpdateDate": {"$": "2015-02-03"}, "FullReportDate": "2015-02-03" }, "Telecommunication": {"TelephoneNumber": [ { "TelecommunicationNumber": "(650) 555-0000", "InternationalDialingCode": "1" }]}, "Location": { "PrimaryAddress": [ { "StreetAddressLine": [{"LineText": "492 KOLLER ST"}], "PrimaryTownName": "San Francisco", "CountryISOAlpha2Code": "US", "TerritoryName": "California", "TerritoryAbbreviatedName": "CA", "PostalCode": "94110", "CountyOfficialName": "San Francisco County", "TerritoryOfficialName": "California", "CountryOfficialName": "USA", "CountryGroupName": "North America", "PrimaryTownWorldBaseCode": 7139, "CountyWorldBaseCode": 636, "TerritoryWorldBaseCode": 9, "RegisteredAddressIndicator": false, "CountryWorldBaseCode": 805 }], "MailingAddress": [ { "CountryISOAlpha2Code": "US", "CountryOfficialName": "USA", "CountryGroupName": "North America", "UndeliverableIndicator": false, "TerritoryWorldBaseCode": 0, "CountryWorldBaseCode": 0 }] }, "Financial": {"KeyFinancialFiguresOverview": [ { "StatementHeaderDetails": { "FinancialStatementToDate": {"$": "2014-12-31"}, "FinancialPeriodDuration": "P1Y" }, "SalesRevenueAmount": [ { "@CurrencyISOAlpha3Code": "USD", "@ReliabilityText": "Actual", "@UnitOfSize": "SingleUnits", "$": 20839372 }] }]}, "OrganizationName": {"OrganizationPrimaryName": [{"OrganizationName": {"$": "Gorman Manufacturing Company, Inc."}}]}, "OrganizationDetail": { "FamilyTreeMemberRole": [ {"FamilyTreeMemberRoleText": { "@DNBCodeValue": 12775, "$": "Global Ultimate" }}, {"FamilyTreeMemberRoleText": { "@DNBCodeValue": 12774, "$": "Domestic Ultimate" }}, {"FamilyTreeMemberRoleText": { "@DNBCodeValue": 12773, "$": "Parent" }}, {"FamilyTreeMemberRoleText": { "@DNBCodeValue": 12771, "$": "Headquarters" }} ], "StandaloneOrganizationIndicator": false, "ControlOwnershipDate": {"$": "1985"} }, "RegisteredDetail": { "LegalFormDetails": {"LegalFormText": { "@DNBCodeValue": 451, "$": "Corporation" }}, "OrganizationIdentificationNumberDetail": [ { "@DNBCodeValue": 6863, "@TypeText": "Federal Taxpayer Identification Number (US)", "OrganizationIdentificationNumber": "123456789" }] }, "IndustryCode": {"IndustryCode": [ { "@DNBCodeValue": 24658, "@TypeText": "UN Standards Products & Services Code", "IndustryCode": {"$": "82151502"}, "DisplaySequence": 1 }, { "@DNBCodeValue": 25838, "@TypeText": "D&B Hoovers Industry Code", "IndustryCode": {"$": "1068"}, "DisplaySequence": 1 }, { "@DNBCodeValue": 700, "@TypeText": "NAICS", "IndustryCode": {"$": "323111"}, "DisplaySequence": 1 }, { "@DNBCodeValue": 24664, "@TypeText": "North American Industry Classification System 2012", "IndustryCode": {"$": "323111"}, "DisplaySequence": 1 }, { "@DNBCodeValue": 21182, "@TypeText": "UK SIC 2003", "IndustryCode": {"$": "22.220"}, "DisplaySequence": 1 }, { "@DNBCodeValue": 3599, "@TypeText": "D&B Standard Industry Code", "IndustryCode": {"$": "27520000"}, "DisplaySequence": 1 }, { "@DNBCodeValue": 399, "@TypeText": "US Standard Industry Code 1987 - 4 digit", "IndustryCode": {"$": "2752"}, "DisplaySequence": 1 } ]}, "ActivitiesAndOperations": {"LineOfBusinessDetails": [{"LineOfBusinessDescription": {"$": "Commercial printing, lithographic"}}]}, "EmployeeFigures": { "IndividualEntityEmployeeDetails": { "TotalEmployeeQuantity": 110, "ReliabilityText": { "@DNBCodeValue": 9092, "$": "Actual" } }, "ConsolidatedEmployeeDetails": { "TotalEmployeeQuantity": 125, "EmployeeCategoryDetails": [{"EmployeeBasisText": { "@DNBCodeValue": 9064, "$": "Principals" }}], "ReliabilityText": { "@DNBCodeValue": 9092, "$": "Actual" } } }, "Linkage": { "LinkageSummary": {"GlobalUltimateFamilyTreeLinkageCount": 8}, "GlobalUltimateOrganization": { "DUNSNumber": "804735132", "OrganizationPrimaryName": [{"OrganizationName": {"$": "GORMAN MANUFACTURING COMPANY, INC."}}], "PrimaryAddress": [ { "StreetAddressLine": [{"LineText": "492 KOLLER ST"}], "PrimaryTownName": "SAN FRANCISCO", "CountryISOAlpha2Code": "US", "TerritoryName": "California", "TerritoryAbbreviatedName": "CA", "PostalCode": "94110", "TerritoryOfficialName": "California", "CountryOfficialName": "UNITED STATES", "CountryGroupName": "North America", "PrimaryTownWorldBaseCode": 7139, "CountyWorldBaseCode": 636, "CountryWorldBaseCode": 805 }] }, "DomesticUltimateOrganization": { "DUNSNumber": "804735132", "OrganizationPrimaryName": [{"OrganizationName": {"$": "GORMAN MANUFACTURING COMPANY, INC."}}], "PrimaryAddress": [ { "StreetAddressLine": [{"LineText": "492 KOLLER ST"}], "PrimaryTownName": "SAN FRANCISCO", "CountryISOAlpha2Code": "US", "TerritoryAbbreviatedName": "CA", "PostalCode": "94110", "TerritoryOfficialName": "California", "PrimaryTownWorldBaseCode": 7139, "CountyWorldBaseCode": 636, "CountryWorldBaseCode": 805 }] }, "FamilyTreeHierarchyLevel": 1, "LinkageUpdateDate": {"$": "2015-09-14"} } }, "ArchiveDetail": {"PortfolioAssetID": 70481232} } } }}
Name | Characteristics |
---|---|
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. |
OrderProductResponse { OrderProductResponseDetail { Product { DNBProductID | string, up to 64 chars, Optional An alphanumeric string that uniquely identifies this product. |
OrderProductResponse { OrderProductResponseDetail { Product { LanguageCode | integer, up to 7 digits, Optional A D&B code value that defines the language in which the requested product is fulfilled. |
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. |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SubjectHeader | Aggregate, Required Records high level information about the subject such as the primary language of the subject and the primary currency in which this subject trades. When the subject is an organizantion, this may also include details such as DUNS Number. |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SubjectHeader { DUNSNumber | string, up to 15 chars Pattern: {([0-9a-zA-Z]*)}, Optional [C] [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). |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SubjectHeader { TransferDUNSNumberRegistration { TransferredFromDUNSNumber | string, up to 15 chars Pattern: {([0-9a-zA-Z]*)}, Optional [C] [M+] This is the D-U-N-S number of the subject that is deleted from the host database. Monitor Path: //Organization /SubjectHeader /TransferDUNSNumberRegistration |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SubjectHeader { LastUpdateDate | date, Optional [C] [M] The date when the subject's record was last updated on D&B's system. |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SubjectHeader { FullReportDate | date | year | year & month, Optional [C] [M] The date when the data recorded in the D&B Database on this subject was fully updated. |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { PrimaryAddress | Aggregate, Optional (Infinite) An entry loop to allow the recording of a single primary or physical address of the subject in multiple languages and/or writing scripts. For an organization this is the principal address at which the organization is located. For an individual, this is the home address. |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { PrimaryAddress { StreetAddressLine | Aggregate, Optional (Infinite) An entry loop which can repeat multiple times to allow the recording of several lines where each address line contains one or more named address elements. Examples of named address elements are Street Name, Street Number, Building Name, Estate Name. They are called “lines” because an addres can be divided into multiple lines. When there are multiple lines the sequence of the lines must be preserved. |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { PrimaryAddress { PrimaryTownName | string, up to 64 chars, Optional [C] [M+] The name of the town or city recognized by the Postal Authority for delivering mail. Monitor Path: //Organization /Location /PrimaryAddress |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { PrimaryAddress { CountyOfficialName | string, up to 64 chars, Optional [C] [M+] The legal name of the primary administrative division within a Territory or Country. 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. Monitor Path: //Organization /Location /PrimaryAddress |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { PrimaryAddress { PostalCode | string, up to 16 chars, Optional [C] [M+] 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. Monitor Path: //Organization /Location /PrimaryAddress |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { PrimaryAddress { TerritoryOfficialName | string, up to 64 chars, Optional [C] [M+] 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. Monitor Path: //Organization /Location /PrimaryAddress |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { PrimaryAddress { TerritoryAbbreviatedName | string, up to 64 chars, Optional [C] [M+] 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. Monitor Path: //Organization /Location /PrimaryAddress |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { PrimaryAddress { RegisteredAddressIndicator | boolean, Optional [C] [M+] When TRUE (set to 1)it indicates that the Primary Address which has been presented is also the Registered Address. When FALSE (set to 0)it indicates that the Primary Address which has been presented is not a Registered Address. Monitor Path: //Organization /Location /PrimaryAddress |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { PrimaryAddress { CountryGroupName | string, up to 64 chars, Optional [C] [M+] The name of the region as defined by Damp;B for this address, i.e., North America, Latin America, Europe, Asia Pacific, Middle East, Africa. Monitor Path: //Organization /Location /PrimaryAddress |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { PrimaryAddress { CountryOfficialName | string, up to 64 chars, Optional [C] [M+] The legal name of the country for this address. Monitor Path: //Organization /Location /PrimaryAddress |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { PrimaryAddress { PrimaryTownWorldBaseCode | integer, up to 32 digits, Optional [C] [M+] The D&B WorldBase code value that identifies the town or the city recognized by the Postal Authority for delivering mail. Monitor Path: //Organization /Location /PrimaryAddress |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { PrimaryAddress { TerritoryWorldBaseCode | integer, up to 32 digits, Optional [C] [M+] The D&B WorldBase code value that identifies 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. Monitor Path: //Organization /Location /PrimaryAddress |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { PrimaryAddress { CountryWorldBaseCode | integer, up to 3 digits, Optional [C] The D&B three digit WorldBase code value that identifies country where the business is located. |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { PrimaryAddress { CountyWorldBaseCode | integer, up to 32 digits, Optional [C] [M+] The D&B WorldBase code value that identifies the primary administrative division within a Territory or Country. Monitor Path: //Organization /Location /PrimaryAddress |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { MailingAddress { PrimaryTownName | string, up to 64 chars, Optional [C] [M+] The name of the town or city recognized by the Postal Authority for delivering mail. Monitor Path: //Organization /Location /MailingAddress |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { MailingAddress { CountyOfficialName | string, up to 64 chars, Optional [C] [M+] The legal name of the primary administrative division within a Territory or Country. 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. Monitor Path: //Organization /Location /MailingAddress |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { MailingAddress { PostalCode | string, up to 16 chars, Optional [C] [M+] 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. Monitor Path: //Organization /Location /MailingAddress |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { MailingAddress { TerritoryOfficialName | string, up to 64 chars, Optional [C] [M+] 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. Monitor Path: //Organization /Location /MailingAddress |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { MailingAddress { TerritoryAbbreviatedName | string, up to 64 chars, Optional [C] [M+] 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. Monitor Path: //Organization /Location /MailingAddress |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { MailingAddress { CountryOfficialName | string, up to 64 chars, Optional [C] [M+] The legal name of the country for this address. Monitor Path: //Organization /Location /MailingAddress |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { MailingAddress { PrimaryTownWorldBaseCode | integer, up to 32 digits, Optional [C] [M+] The D&B WorldBase code value that identifies the town or the city recognized by the Postal Authority for delivering mail. Monitor Path: //Organization /Location /MailingAddress |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { MailingAddress { TerritoryWorldBaseCode | integer, up to 32 digits, Optional [C] [M+] The D&B WorldBase code value that identifies 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. Monitor Path: //Organization /Location /MailingAddress |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { MailingAddress { CountryWorldBaseCode | integer, up to 3 digits, Optional [C] [M+] The D&B three digit WorldBase code value that identifies country where the business is located. Monitor Path: //Organization /Location /MailingAddress |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { MailingAddress { CountryGroupName | string, up to 64 chars, Optional [C] [M+] The name of the region as defined by Damp;B for this address, i.e., North America, Latin America, Europe, Asia Pacific, Middle East, Africa. Monitor Path: //Organization /Location /MailingAddress |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { MailingAddress { CountyWorldBaseCode | integer, up to 32 digits, Optional [C] [M] The D&B WorldBase code value that identifies the primary administrative division within a Territory or Country. |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Telecommunication { TelephoneNumber { TelecommunicationNumber | string, at least 1 char, up to 50 chars, Required [C] [M+] 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 Monitor Path: //Organization /Telecommunication |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Telecommunication { TelephoneNumber { InternationalDialingCode | string, up to 7 chars, Optional [C] [M+] 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. Monitor Path: //Organization /Telecommunication |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Telecommunication { FacsimileNumber { TelecommunicationNumber | string, at least 1 char, up to 50 chars, Required [C] [M+] 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 Monitor Path: //Organization /Telecommunication |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Financial { KeyFinancialFiguresOverview { SalesRevenueAmount | decimal, Optional (Infinite) [C] [M] The monetary value of income received from customers from the sale of the business' goods and/or services. This means it is the gross sales minus any returns, rebates/discounts, allowances for damages or shortages, shipping expenses passed on to the customer, and amounts due where there is not a reasonable expectation of collection. |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Financial { KeyFinancialFiguresOverview { SalesRevenueAmount @CurrencyISOAlpha3Code | Attribute |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Financial { KeyFinancialFiguresOverview { SalesRevenueAmount @ReliabilityText | Attribute |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationName | Aggregate, Optional Records the different names of the organization by which it is known as well as names of other organizations that have a similar name to this organization. |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationName { OrganizationPrimaryName | Aggregate, Optional (Infinite) 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. |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationName { OrganizationPrimaryName { OrganizationName | string, up to 256 chars, Required [C] [M] Text recording a name of this organization in the specified language and/or writing script. |
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization } OrganizationName } OrganizationPrimaryName | /Aggregate |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationName { TradeStyleName | Aggregate, Optional (Infinite) An entry loop which can repeat multiple times to allow the recording of a name which an organization trades under for commercial purposes, although its registered, legal name, used for contracts and other formal situations, may be another. |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationName { TradeStyleName { OrganizationName | string, up to 256 chars, Required [C] [M+] Text recording a name of this organization in the specified language and/or writing script. Monitor Path: //Organization /OrganizationName /TradeStyleName |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationName { TradeStyleName { DisplaySequence | integer, up to 3 digits, Optional [C] A numeric value used to identify the relative importance of this Organization Name compared to the other Organization Names for this organization that are of the same type (e.g., Trading Style). The lower the importance level number, the more important (preferred) is an Organization Name. |
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization } OrganizationName } TradeStyleName | /Aggregate |
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization } OrganizationName | /Aggregate |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationDetail { FamilyTreeMemberRole { FamilyTreeMemberRoleText | string, up to 256 chars, Optional [C] [M+] Text describing the part that the Subject plays as a member of an ownership structured family tree, e.g., a branch, division, a parent, headquarters, subsidiary, global ultimate, domestic ultimate. Possible values: Subsidiary; Branch; Division; Headquarters; Parent; Domestic Ultimate; Global Ultimate Monitor Path: //Organization /OrganizationDetail /FamilyTreeMemberRole |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationDetail { FamilyTreeMemberRole { FamilyTreeMemberRoleText @DNBCodeValue | integer, up to 7 digits, Attribute (1x) Possible values: 9159 (Subsidiary); 12769 (Branch); 12770 (Division); 12771 (Headquarters); 12773 (Parent); 12774 (Domestic Ultimate); 12775 (Global Ultimate) |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationDetail { StandaloneOrganizationIndicator | boolean, Optional [C] [M] When 'true' indicates that this organization is not a member of a legal family tree. This means it cannot play the role of a subsidiary, parent, headquarters or branch; i.e., FamilyTreeMemberRoleText cannot be present. When 'false' indicates that this organization is a member of a legal family tree. In this condition the FamilyTreeMemberRoleText must be present. |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationDetail { ControlOwnershipDate | date, Optional [C] [M] The date when the current owners took over this business. |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { RegisteredDetail { OrganizationIdentificationNumberDetail | Aggregate, Optional (Infinite) An entry loop which can repeat multiple times to allow recording of the identifiers issued by organizations to uniquely identify subjects. The issuing organization may be a Registration Authority, Government Department or Commercial Enterprise E.g. Chamber of Commerce numbers, VAT numbers, etc. |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { RegisteredDetail { OrganizationIdentificationNumberDetail @DNBCodeTableNumber | integer, up to 7 digits, Attribute (1x) |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { RegisteredDetail { OrganizationIdentificationNumberDetail { OrganizationIdentificationNumber | string, at least 1 char, up to 40 chars, Required [C] [M+] A number assigned by an external body or by D&B which either uniquely identifies or helps to identify an organization. Monitor Path: //Organization /RegisteredDetail /OrganizationIdentificationNumberDetail@DNBCodeValue /OrganizationIdentificationNumber |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { RegisteredDetail { LegalFormDetails { LegalFormText | string, up to 256 chars, Required [C] [M+] Text that describes the legal form or structure of a business, as registered with government authorities, e.g., partnership, corporation, private limited company, government department, proprietorship. Possible values: Code Table 197; Code Table 0 (with a selection of 0 Unknown) Monitor Path: //Organization /RegisteredDetail /LegalFormDetails /LegalFormText@DNBCodeValue |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { IndustryCode { IndustryCode | Aggregate, Optional (Infinite) An entry loop which can repeat multiple times to allow the recording of several business activities in which an organization is actively engaged using standardized coding schemes such as European NACE and U.S. Standard Industry Classifications (SIC). |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { IndustryCode { IndustryCode { IndustryCode | string, up to 16 chars, Required [C] [M+] 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). Monitor Path: //Organization /IndustryCode /IndustryCode@DNBCodeValue |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { IndustryCode { IndustryCode { IndustryCodeDescription | string, Required |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { IndustryCode { IndustryCode { IndustryCodeDescription @LanguageCode | attribute, Required |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { IndustryCode { IndustryCode { IndustryCodeDescription @WritingScriptISOAlpha4Code | attribute, Required |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { ActivitiesAndOperations { LineOfBusinessDetails { LineOfBusinessDescription | string, up to 3000 chars, Optional [C] [M+] Records the textual description of operations continued by a business. Monitor Path: //Organization /ActivitiesAndOperations /LineOfBusinessDetails |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { ActivitiesAndOperations { ImportDetails { ImportIndicator | boolean, Optional [C] [M] When 'true' indicates that the subject company imports a quantity of goods from other countries. |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { ActivitiesAndOperations { ExportDetails { ExportIndicator | boolean, Optional [C] [M] When 'true' indicates that the subject company exports a quantity of goods to other countries. |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { ActivitiesAndOperations { SubjectIsAgentDetails { AgentIndicator | boolean, Optional [C] [M] When 'true' indicates that the subject acts as an agent promoting the goods or services of another organization, e.g., Sales Agent, Purchasing Agent. When 'false' indicates that the subject does not act as an agent of another organization. |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { EmployeeFigures { IndividualEntityEmployeeDetails { TotalEmployeeQuantity | long, Optional [C] [M] A number that defines how many people are directly engaged and paid by the organization to perform or support its business operations. |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { EmployeeFigures { IndividualEntityEmployeeDetails { ReliabilityText | string, up to 256 chars, Optional [C] [M+] Text that describes the integrity of the employee figures, e.g. actual, estimated, modeled. Monitor Path: //Organization /EmployeeFigures /IndividualEntityEmployeeDetails /ReliabilityText@DNBCodeValue |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { EmployeeFigures { ConsolidatedEmployeeDetails { TotalEmployeeQuantity | long, Optional [C] [M] A number that defines how many people are directly engaged and paid by the organization to perform or support its business operations. |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { EmployeeFigures { ConsolidatedEmployeeDetails { ReliabilityText | string, up to 256 chars, Optional [C] [M+] Text that describes the integrity of the employee figures, e.g. actual, estimated, modeled. Monitor Path: //Organization /EmployeeFigures /ConsolidatedEmployeeDetails /ReliabilityText@DNBCodeValue |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { EmployeeFigures { ConsolidatedEmployeeDetails { EmployeeCategoryDetails { EmployeeBasisText | string, up to 256 chars, Optional [C] [M+] Text that describes what type of employees has been included in the calculation of the Employee Quantity on the basis of their employment contract, e.g. Principals, Part Time Workers. Monitor Path: //Organization /EmployeeFigures /ConsolidatedEmployeeDetails /EmployeeCategoryDetails /EmployeeBasisText@DNBCodeValue |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { LinkageSummary { GlobalUltimateFamilyTreeLinkageCount | integer, up to 8 digits, Optional [C] [M] This is the number of linkages in the upward and downward directions of the entire Family tree where the subject belongs to. Starting from global ultimate company. |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { GlobalUltimateOrganization { DUNSNumber | string, up to 15 chars Pattern: {([0-9a-zA-Z]*)}, Optional [C] [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). |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { GlobalUltimateOrganization { OrganizationPrimaryName { OrganizationName | string, up to 256 chars, Required [C] [M] Text recording a name of this organization in the specified language and/or writing script. |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { GlobalUltimateOrganization { CountryISOAlpha2Code | string, at least 2 chars, up to 2 chars, Optional [C] [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. |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { GlobalUltimateOrganization { PrimaryAddress { StreetAddressLine { LineText | string, up to 240 chars, Required [C] [M+] 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. Monitor Path: //Organization /Linkage /GlobalUltimateOrganization /PrimaryAddress |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { GlobalUltimateOrganization { PrimaryAddress { PrimaryTownName | string, up to 64 chars, Optional [C] [M+] The name of the town or city recognized by the Postal Authority for delivering mail. Monitor Path: //Organization /Linkage /GlobalUltimateOrganization /PrimaryAddress |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { GlobalUltimateOrganization { PrimaryAddress { TerritoryName | string, up to 128 chars, Optional [C] [M+] 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. Note: This element will deliver the same result as Organization { Linkage { GlobalUltimateOrganization { PrimaryAddress { TerritoryOfficialName. Monitor Path: //Organization /Linkage /GlobalUltimateOrganization /PrimaryAddress |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { GlobalUltimateOrganization { PrimaryAddress { TerritoryOfficialName | string, up to 128 chars, Optional [C] [M+] 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. Monitor Path: //Organization /Linkage /GlobalUltimateOrganization /PrimaryAddress |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { GlobalUltimateOrganization { PrimaryAddress { TerritoryAbbreviatedName | string, up to 64 chars, Optional [C] [M+] 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. Monitor Path: //Organization /Linkage /GlobalUltimateOrganization /PrimaryAddress |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { GlobalUltimateOrganization { PrimaryAddress { PostalCode | string, up to 16 chars, Optional [C] [M+] 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. Monitor Path: //Organization /Linkage /GlobalUltimateOrganization /PrimaryAddress |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { GlobalUltimateOrganization { PrimaryAddress { CountryOfficialName | string, up to 64 chars, Optional [C] [M+] Monitor Path: //Organization /Linkage /GlobalUltimateOrganization /PrimaryAddress |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { GlobalUltimateOrganization { PrimaryAddress { PrimaryTownWorldBaseCode | integer, up to 32 digits, Optional [C] [M+] Monitor Path: //Organization /Linkage /GlobalUltimateOrganization /PrimaryAddress |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { GlobalUltimateOrganization { PrimaryAddress { CountryWorldBaseCode | integer, up to 3 digits, Optional [C] [M+] The D&B three digit WorldBase code value that identifies country where the business is located. Monitor Path: //Organization /Linkage /GlobalUltimateOrganization /PrimaryAddress |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { GlobalUltimateOrganization { PrimaryAddress { CountryGroupName | string, up to 64 chars, Optional [C] [M+] Monitor Path: //Organization /Linkage /GlobalUltimateOrganization /PrimaryAddress |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { GlobalUltimateOrganization { PrimaryAddress { CountyWorldBaseCode | integer, up to 32 digits, Optional [C] [M+] Monitor Path: //Organization /Linkage /ParentOrganization /PrimaryAddress |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { DomesticUltimateOrganization { DUNSNumber | string, up to 15 chars Pattern: {([0-9a-zA-Z]*)}, Optional [C] [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). |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { DomesticUltimateOrganization { OrganizationPrimaryName { OrganizationName | string, up to 256 chars, Required [C] [M] Text recording a name of this organization in the specified language and/or writing script. |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { DomesticUltimateOrganization { PrimaryAddress { StreetAddressLine { LineText | string, up to 240 chars, Required [C] [M+] 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. Monitor Path: //Organization /Linkage /DomesticUltimateOrganization /PrimaryAddress |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { DomesticUltimateOrganization { PrimaryAddress { PrimaryTownName | string, up to 64 chars, Optional [C] [M+] The name of the town or city recognized by the Postal Authority for delivering mail. Monitor Path: //Organization /Linkage /DomesticUltimateOrganization /PrimaryAddress |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { DomesticUltimateOrganization { 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. |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { DomesticUltimateOrganization { PrimaryAddress { TerritoryAbbreviatedName | string, up to 64 chars, Optional [C] [M+] 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. Monitor Path: //Organization /Linkage /DomesticUltimateOrganization /PrimaryAddress |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { DomesticUltimateOrganization { PrimaryAddress { PostalCode | string, up to 16 chars, Optional [C] [M+] 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. Monitor Path: //Organization /Linkage /DomesticUltimateOrganization /PrimaryAddress |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { DomesticUltimateOrganization { PrimaryAddress { PrimaryTownWorldBaseCode | integer, up to 32 digits, Optional [C] [M+] Monitor Path: //Organization /Linkage /DomesticUltimateOrganization /PrimaryAddress |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { DomesticUltimateOrganization { PrimaryAddress { CountryWorldBaseCode | integer, up to 3 digits, Optional [C] [M+] The D&B three digit WorldBase code value that identifies country where the business is located. Monitor Path: //Organization /Linkage /DomesticUltimateOrganization /PrimaryAddress |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { HeadquartersOrganization { DUNSNumber | string, up to 15 chars Pattern: {([0-9a-zA-Z]*)}, Optional [C] [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). |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { HeadquartersOrganization { OrganizationPrimaryName { OrganizationName | string, up to 256 chars, Required [C] [M] Text recording a name of this organization in the specified language and/or writing script. |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { HeadquartersOrganization { PrimaryAddress { StreetAddressLine { LineText | string, up to 240 chars, Required [C] [M+] 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. Monitor Path: //Organization /Linkage /HeadquartersOrganization /PrimaryAddress |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { HeadquartersOrganization { PrimaryAddress { PrimaryTownName | string, up to 64 chars, Optional [C] [M+] The name of the town or city recognized by the Postal Authority for delivering mail. Monitor Path: //Organization /Linkage /HeadquartersOrganization /PrimaryAddress |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { HeadquartersOrganization { PrimaryAddress { CountryISOAlpha2Code | string, at least 2 chars, up to 2 chars, Optional [C] [M+] 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. Monitor Path: //Organization /Linkage /HeadquartersOrganization /PrimaryAddress |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { HeadquartersOrganization { PrimaryAddress { TerritoryName | string, up to 128 chars, Optional [C] [M+] 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. Monitor Path: //Organization /Linkage /HeadquartersOrganization /PrimaryAddress |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { HeadquartersOrganization { PrimaryAddress { TerritoryAbbreviatedName | string, up to 64 chars, Optional [C] [M+] 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. Monitor Path: //Organization /Linkage /HeadquartersOrganization /PrimaryAddress |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { HeadquartersOrganization { PrimaryAddress { PostalCode | string, up to 16 chars, Optional [C] [M+] 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. Monitor Path: //Organization /Linkage /HeadquartersOrganization /PrimaryAddress |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { HeadquartersOrganization { PrimaryAddress { CountryOfficialName | string, up to 64 chars, Optional [C] [M+] Monitor Path: //Organization /Linkage /HeadquartersOrganization /PrimaryAddress |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { HeadquartersOrganization { PrimaryAddress { PrimaryTownWorldBaseCode | integer, up to 32 digits, Optional [C] [M+] Monitor Path: //Organization /Linkage /HeadquartersOrganization /PrimaryAddress |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { HeadquartersOrganization { PrimaryAddress { CountryWorldBaseCode | integer, up to 3 digits, Optional [C] [M+] The D&B three digit WorldBase code value that identifies country where the business is located. Monitor Path: //Organization /Linkage /HeadquartersOrganization /PrimaryAddress |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { HeadquartersOrganization { PrimaryAddress { CountryGroupName | string, up to 64 chars, Optional [C] [M+] Monitor Path: //Organization /Linkage /HeadquartersOrganization /PrimaryAddress |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { HeadquartersOrganization { PrimaryAddress { CountyWorldbaseCode | integer, up to 32 digits, Optional [C] [M] |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { DUNSNumber | string, up to 15 chars Pattern: {([0-9a-zA-Z]*)}, Optional [C] [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). |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { OrganizationPrimaryName { OrganizationName | string, up to 256 chars, Required [C] [M] Text recording a name of this organization in the specified language and/or writing script. |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { PrimaryAddress { StreetAddressLine { LineText | string, up to 240 chars, Required [C] [M+] 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. Monitor Path: //Organization /Linkage /ParentOrganization /PrimaryAddress |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { PrimaryAddress { PrimaryTownName | string, up to 64 chars, Optional [C] [M+] The name of the town or city recognized by the Postal Authority for delivering mail. Monitor Path: //Organization /Linkage /ParentOrganization /PrimaryAddress |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { PrimaryAddress { TerritoryName | string, up to 128 chars, Optional [C] [M+] 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. Monitor Path: //Organization /Linkage /ParentOrganization /PrimaryAddress |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { PrimaryAddress { TerritoryAbbreviatedName | string, up to 64 chars, Optional [C] [M+] 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. Monitor Path: //Organization /Linkage /ParentOrganization /PrimaryAddress |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { PrimaryAddress { PostalCode | string, up to 16 chars, Optional [C] [M+] 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. Monitor Path: //Organization /Linkage /ParentOrganization /PrimaryAddress |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { PrimaryAddress { CountryOfficialName | string, up to 64 chars, Optional [C] [M+] Monitor Path: //Organization /Linkage /ParentOrganization /PrimaryAddress |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { PrimaryAddress { PrimaryTownWorldBaseCode | integer, up to 32 digits, Optional [C] [M+] Monitor Path: //Organization /Linkage /ParentOrganization /PrimaryAddress |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { PrimaryAddress { CountryWorldBaseCode | integer, up to 3 digits, Optional [C] [M+] The D&B three digit WorldBase code value that identifies country where the business is located. Monitor Path: //Organization /Linkage /GlobalUltimateOrganization /PrimaryAddress |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { PrimaryAddress { CountryGroupName | string, up to 64 chars, Optional [C] [M+] Monitor Path: //Organization /Linkage /ParentOrganization /PrimaryAddress |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { PrimaryAddress { CountyWorldbaseCode | integer, up to 32 digits, Optional [C] [M] |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { FamilyTreeHierarchyLevel | integer, up to 2 digits, Optional [C] [M] A two-position code, in conjunction with the status and subsidiary indicators that pinpoints the location of an establishment within a corporate hierarchy. |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { LinkageUpdateDate | Element |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { LinkageUpdateDate @DatePrecisionText | Attribute |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { LinkageUpdateDate @DatePrecisionDNBCodeValue | Attribute |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { LinkageUpdateDate @DatePrecisionDNBCodeTableNumber | Attribute |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { MostSeniorPrincipal { PrincipalName { FullName | string, up to 256 chars, Optional [C] [M+] Monitor Path: //Organization /PrincipalsAndManagement /MostSeniorPrincipal |
OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { MostSeniorPrincipal { JobTitle { JobTitleText | string, up to 3000 chars, Optional [C] [M+] Text that denotes a position held by the principal or manager. Monitor Path: //Organization /PrincipalsAndManagement /MostSeniorPrincipal |
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').
Currency Codes/Units
Whenever financial statement data is included in a response, each individual business element (ItemAmount) should be inspected for currency code and unit values (CurrencyISOAlpha3Code and UnitOfSize). If a given element does not include these attributes, the values provided in the statement header should be utilized.
For Customers using Optimizer (optional)
D&B Optimizer provides bulk WB1784 data; however, in a different format. A WB1784 product data reference guide is available to help customers understand how to transform and/or consume the Optimizer data in combination with the API response from this data layer.
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.
Name | Description |
---|---|
Agent Indicator | When 'true' indicates that the subject acts as an agent promoting the goods or services of another organization, e.g., Sales Agent, Purchasing Agent. [M] PCM XPath: //Organization/ ActivitiesAndOperations/ SubjectIsAgentDetails/ AgentIndicator |
Business Legal Structure | Text that describes the legal form or structure of a business, as registered with government authorities, e.g., partnership, corporation, private limited company, government department, proprietorship. [M+] PCM XPath: //Organization/ RegisteredDetail/ LegalFormDetails/ LegalFormText |
Continent Code (World Region ID) | Text recording the name of the region as defined by D&B for this address i.e., Africa, Australia/Asia, Europe, Middle East, South & Central America, North America. [M+] PCM XPath: //Organization/ Location/ PrimaryAddress/ CountryGroupName |
Control Year | The year current control was assumed. [M] PCM XPath: //Organization/ OrganizationDetail/ ControlOwnershipDate |
Country Name | Text recording the name of the country in which the business is located. [M+] PCM XPath: //Organization/ Location/ PrimaryAddress/ CountryOfficialName |
D&B City Code | D&B proprietary geographical code which indicates the city where the business is located. For US records, the code is unique within COUNTY, for non-US records, the code is unique within COUNTRY. [M+] PCM XPath: //Organization/ Location/ PrimaryAddress/ PrimaryTownWorldBaseCode |
D&B Country Code | D&B three-digit code which indicates the country where the business is located. PCM XPath: //Organization/ Location/ PrimaryAddress/ CountryWorldBaseCode |
D&B County Code | D&B geographical code which identifies the county where the business is located. Code is unique within state/province. PCM XPath: //Organization/ Location/ PrimaryAddress/ CountyWorldBaseCode |
D&B Hoovers Industry Code | An alphanumeric industry code identifying a business activity, based on a three-tier taxonomy developed by D&B as a complement to NAICS and SIC codes, that are assigned according to companies’ primary and secondary business activities. PCM XPath: //Organization/ IndustryCode/ IndustryCode/ IndustryCode |
D&B Hoovers Industry Code Description | Text that describes the business activity based on the scheme specified by the attribute type. PCM XPath: //Organization/ IndustryCode/ IndustryCode/ IndustryCodeDescription |
D&B Mailing City Code | D&B geographical code which indicates the city where the business is located for mailing address. For US records, the code is unique within COUNTY, for non-US records, the code is unique within COUNTRY. [M+] PCM XPath: //Organization/ Location/ MailingAddress/ PrimaryTownWorldBaseCode |
D&B Mailing Country Code | D&B three-digit country code which indicates the country where the mailing address of the business is located. PCM XPath: //Organization/ Location/ MailingAddress/ CountryWorldBaseCode |
D&B Mailing County Code | D&B geographical code which indicates the county where the business is located for mailing address. Populated in US and Canada only; unique within state/province. Zeros if not available. PCM XPath: //Organization/ Location/ MailingAddress/ CountyWorldBaseCode |
D&B Mailing Region/Continent Code | D&B code which indicates the region of the mailing address of the business. [M+] PCM XPath: //Organization/ Location/ MailingAddress/ CountryGroupName |
D&B Mailing State/Province Code | D&B geographical code which indicates the state/province where the business is located for mailing address. Only validated state/province names carry a state/province code. [M+] PCM XPath: //Organization/ Location/ MailingAddress/ TerritoryWorldBaseCode |
D&B Standard Industry Code | An alphanumeric value identifying a business activity based on the scheme specified by the Standard Industrial Classification (SIC) Code. The first four digits are external codes created by the U.S. Government. D&B has 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). PCM XPath: //Organization/ IndustryCode/ IndustryCode/ IndustryCode |
D&B Standard Industry Code Description | Text that describes the business activity based on the scheme specified by the attribute type, e.g., 'highway and street construction' is the description of industry code 1611 in the U.S. SIC (Standard Industrial Classification) system. PCM XPath: //Organization/ IndustryCode/ IndustryCode/ IndustryCodeDescription |
D&B State/Province Code | D&B geographical code which indicates the state/province (aka primary subdivision) where the business is located. Only validated state/province names carry a state/province code. [M+] PCM XPath: //Organization/ Location/ PrimaryAddress/ TerritoryWorldBaseCode |
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. [M] PCM XPath: //Organization/ Linkage/ DomesticUltimateOrganization/ OrganizationPrimaryName/ OrganizationName |
Domestic Ultimate D&B City Code | D&B code of the city where the domestic ultimate is located. [M+] PCM XPath: //Organization/ Linkage/ DomesticUltimateOrganization/ PrimaryAddress/ PrimaryTownWorldBaseCode |
Domestic Ultimate D&B Country Code | D&B code of the country where the domestic ultimate is located. [M+] PCM XPath: //Organization/ Linkage/ DomesticUltimateOrganization/ PrimaryAddress/ CountryWorldBaseCode |
Domestic Ultimate D-U-N-S Number | The D-U-N-S Number of the highest level parent within a corporate family tree that is domiciled in the same country as the requested company. A parent is a corporation that owns more than 50% of another corporation's capital stock. A subject may be its own domestic ultimate. [M] PCM XPath: //Organization/ Linkage/ DomesticUltimateOrganization/ DUNSNumber |
Domestic Ultimate Postal Code | An identifier used by the local country postal authority to identify where the domestic ultimate is located. [M+] PCM XPath: //Organization/ Linkage/ DomesticUltimateOrganization/ PrimaryAddress/ PostalCode |
Domestic Ultimate Street Address | Text recording the address number and street name where the domestic ultimate is located. [M+] PCM XPath: //Organization/ Linkage/ DomesticUltimateOrganization/ PrimaryAddress/ StreetAddressLine/ LineText |
Domestic Ultimate 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 domestic ultimate is located. [M+] PCM XPath: //Organization/ Linkage/ DomesticUltimateOrganization/ PrimaryAddress/ TerritoryAbbreviatedName |
Domestic Ultimate 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 domestic ultimate is located. PCM XPath: //Organization/ Linkage/ DomesticUltimateOrganization/ PrimaryAddress/ TerritoryName |
Domestic Ultimate Town Name | Text recording the name of the city, town, village, etc. where the domestic ultimate is located. [M+] PCM XPath: //Organization/ Linkage/ DomesticUltimateOrganization/ PrimaryAddress/ PrimaryTownName |
D-U-N-S Number Transfer Date | The date associated with the most recent retirement of a D-U-N-S Number affecting this subject. When included in a monitoring notice, the Retained D-U-N-S Number should be used for subsequent requests. When included in a product response, the Previous D-U-N-S Number is provided for reference purposes. PCM XPath: //Organization/ SubjectHeader/ TransferDUNSNumberRegistration/ TransferDate |
D-U-N-S Number Transfer Reason Text | Text explaining the most recent retirement of a D-U-N-S Number affecting this subject. When included in a monitoring notice, the Retained D-U-N-S Number should be used for subsequent requests. When included in a product response, the Previous D-U-N-S Number is provided for reference purposes. PCM XPath: //Organization/ SubjectHeader/ TransferDUNSNumberRegistration/ TransferReasonText |
Employee Quantity (All Locations) | A number that defines how many people are directly engaged and paid by the organization to perform or support its business operations. [M] PCM XPath: //Organization/ EmployeeFigures/ ConsolidatedEmployeeDetails/ TotalEmployeeQuantity |
Employee Quantity (Single Location) | A number that defines how many people are directly engaged and paid by the organization to perform or support its business operations at the subject's location. [M] PCM XPath: //Organization/ EmployeeFigures/ IndividualEntityEmployeeDetails/ TotalEmployeeQuantity |
Employee Quantity Basis Text | Text that indicates when it has been reported to D&B that certain types of employees have been included in the calculation of the Employee Quantity. [M+] PCM XPath: //Organization/ EmployeeFigures/ ConsolidatedEmployeeDetails/ EmployeeCategoryDetails/ EmployeeBasisText |
Employee Quantity Reliability Text (All Locations) | Text that describes the integrity of the employee figures, e.g., actual, estimated, or modeled. [M+] PCM XPath: //Organization/ EmployeeFigures/ ConsolidatedEmployeeDetails/ ReliabilityText |
Employee Quantity Reliability Text (Single Location) | Text that describes the integrity of the employee figures, e.g., actual, estimated, or modeled. [M+] PCM XPath: //Organization/ EmployeeFigures/ IndividualEntityEmployeeDetails/ ReliabilityText |
Export Indicator | When 'true' indicates that the subject business exports goods to other countries. [M] PCM XPath: //Organization/ ActivitiesAndOperations/ ExportDetails/ ExportIndicator |
Family Tree Hierarchy Level Code | A two-position counter that indicates the number of family tree levels below the global ultimate business in its corporate hierarchy. The hierarchy level value of the global ultimate will always be 1. Each subsidiary level below the global ultimate is incremented by one. Branch locations in a family tree will have the same hierarchy code as its associated headquarter. [M] PCM XPath: //Organization/ Linkage/ FamilyTreeHierarchyLevel |
FEIN Tax ID Number | A number recording a unique nine-digit FEIN number assigned by the U.S. Internal Revenue Service to business entities (and in some cases individuals) operating in the United States for the purposes of identification. PCM XPath: //Organization/ RegisteredDetail/ OrganizationIdentificationNumberDetail/ OrganizationIdentificationNumber |
Full Report Date | The date when a complete review of all Business Information Report data was updated about the business. PCM XPath: //Organization/ SubjectHeader/ FullReportDate |
Global Ultimate Business Name | Text recording the primary name of the global ultimate business. [M] PCM XPath: //Organization/ Linkage/ GlobalUltimateOrganization/ OrganizationPrimaryName/ OrganizationName |
Global Ultimate Country Name | Name of the country where the global ultimate is located. [M+] PCM XPath: //Organization/ Linkage/ GlobalUltimateOrganization/ PrimaryAddress/ CountryOfficialName |
Global Ultimate D&B City Code | D&B code of the city where the global ultimate is located. [M+] PCM XPath: //Organization/ Linkage/ GlobalUltimateOrganization/ PrimaryAddress/ PrimaryTownWorldBaseCode |
Global Ultimate D&B Country Code | D&B code of the country where the global ultimate is located. [M+] PCM XPath: //Organization/ Linkage/ GlobalUltimateOrganization/ PrimaryAddress/ CountryWorldBaseCode |
Global Ultimate D&B County Code | D&B geographical code which identifies the county where the global ultimate is located. Code is unique within state/province. [M+] PCM XPath: //Organization/ Linkage/ GlobalUltimateOrganization/ PrimaryAddress/ CountyWorldBaseCode |
Global Ultimate D&B Region/Continent Code | D&B code for the region where the global ultimate is located. [M+] PCM XPath: //Organization/ Linkage/ GlobalUltimateOrganization/ PrimaryAddress/ CountryGroupName |
Global Ultimate D-U-N-S Number | The D-U-N-S number of the highest level parent within a corporate family tree. A parent is a corporation that owns more than 50% of another corporation's capital stock. A subject may be its own global ultimate. [M] PCM XPath: //Organization/ Linkage/ GlobalUltimateOrganization/ DUNSNumber |
Global Ultimate Postal Code | An identifier used by the local country postal authority to identify where the global ultimate is located. [M+] PCM XPath: //Organization/ Linkage/ GlobalUltimateOrganization/ PrimaryAddress/ PostalCode |
Global Ultimate Street Address | Text recording the address number, or post office box number and street name where the global ultimate is located. [M+] PCM XPath: //Organization/ Linkage/ GlobalUltimateOrganization/ PrimaryAddress/ StreetAddressLine/ LineText |
Global Ultimate 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 global ultimate is located. [M+] PCM XPath: //Organization/ Linkage/ GlobalUltimateOrganization/ PrimaryAddress/ TerritoryAbbreviatedName |
Global Ultimate 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 global ultimate is located. [M+] PCM XPath: //Organization/ Linkage/ GlobalUltimateOrganization/ PrimaryAddress/ TerritoryOfficialName Note: PCM XPath: //Organization/ Linkage/ GlobalUltimateOrganization/ PrimaryAddress/ TerritoryName will continue to be delivered; however, the XPath including TerritoryOfficialName should be used. |
Global Ultimate Town Name | Text recording the name of the city, town, village, etc. where the global ultimate is located. [M+] PCM XPath: //Organization/ Linkage/ GlobalUltimateOrganization/ PrimaryAddress/ PrimaryTownName |
Headquarters Business Name | The business name of the headquarters company. A headquarters is a business establishment that has branches or divisions reporting to it. [M] PCM XPath: //Organization/ Linkage/ HeadquartersOrganization/ OrganizationPrimaryName/ OrganizationName |
Headquarters Country Code | The two-letter country code, defined by the International Organization for Standardization (ISO) standard ISO 3166-1 identifying the country of the company headquarters. PCM XPath: //Organization/ Linkage/ HeadquartersOrganization/ PrimaryAddress/ CountryISOAlpha2Code |
Headquarters Country Name | Name of the country where the company headquarters is located. [M+] PCM XPath: //Organization/ Linkage/ HeadquartersOrganization/ PrimaryAddress/ CountryOfficialName |
Headquarters D&B City Code | D&B code of the city where the headquarters is located. [M+] PCM XPath: //Organization/ Linkage/ HeadquartersOrganization/ PrimaryAddress/ PrimaryTownWorldBaseCode |
Headquarters D&B Country Code | D&B code of the country where the company headquarters is located. PCM XPath: //Organization/ Linkage/ HeadquartersOrganization/ PrimaryAddress/ CountryWorldBaseCode |
Headquarters D&B County Code | D&B geographical code which identifies the county where the headquarters is located. Code is unique within state/province. PCM XPath: //Organization/ Linkage/ HeadquartersOrganization/ PrimaryAddress/ CountyWorldbaseCode |
Headquarters D&B Region/Continent Code | D&B code for the region where the headquarters is located. [M+] PCM XPath: //Organization/ Linkage/ HeadquartersOrganization/ PrimaryAddress/ CountryGroupName |
Headquarters D-U-N-S Number | The D-U-N-S Number of the headquarters company. A headquarters is a business establishment that has branches or divisions reporting to it. [M] PCM XPath: //Organization/ Linkage/ HeadquartersOrganization/ DUNSNumber |
Headquarters Postal Code | An identifier used by the local country postal authority to identify where the headquarters is located. [M+] PCM XPath: //Organization/ Linkage/ HeadquartersOrganization/ PrimaryAddress/ PostalCode |
Headquarters Street Address | Text recording the address number, or post office box number and street name where the headquarters is located. [M+] PCM XPath: //Organization/ Linkage/ HeadquartersOrganization/ PrimaryAddress/ StreetAddressLine/ LineText |
Headquarters 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 headquarters is located. [M+] PCM XPath: //Organization/ Linkage/ HeadquartersOrganization/ PrimaryAddress/ TerritoryAbbreviatedName |
Headquarters 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 headquarters is located. [M+] PCM XPath: //Organization/ Linkage/ HeadquartersOrganization/ PrimaryAddress/ TerritoryName |
Headquarters Town Name | Text recording the name of the city, town, village, etc. where the headquarters is located. [M+] PCM XPath: //Organization/ Linkage/ HeadquartersOrganization/ PrimaryAddress/ PrimaryTownName |
Import Indicator | When 'true' indicates that the subject business imports a quantity of goods from other countries. [M] PCM XPath: //Organization/ ActivitiesAndOperations/ ImportDetails/ ImportIndicator |
Last Update Date | The date when the record was last updated in D&B's system. PCM XPath: //Organization/ SubjectHeader/ LastUpdateDate |
Line of Business | Text recording the description of the operations conducted by a business. [M+] PCM XPath: //Organization/ ActivitiesAndOperations/ LineOfBusinessDetails/ LineOfBusinessDescription |
Linkage Update Date | The date when a review of the entire family tree was completed to verify linkage relationships within the family was updated. PCM XPath: //Organization/ Linkage/ LinkageUpdateDate |
Local Activity Industry Code | Records the business activities in which an organization is actively engaged using standardized coding schemes such as European NACE and other country-specific Classification of Economic Activities. PCM XPath: //Organization/ IndustryCode/ IndustryCode/ IndustryCode |
Mailing Country Name | Text recording the name of the country which the business uses for mailing purposes. [M+] PCM XPath: //Organization/ Location/ MailingAddress/ CountryOfficialName |
Most Senior Principal Full Name | Text recording the name of the CEO. [M+] PCM XPath: //Organization/ PrincipalsAndManagement/ MostSeniorPrincipal/ PrincipalName/ FullName |
Most Senior Principal Job Title | Text recording the job held by the most senior principal; For example, CEO, President and CEO. [M+] PCM XPath: //Organization/ PrincipalsAndManagement/ MostSeniorPrincipal/ JobTitle/ JobTitleText |
NAICS Code | An alphanumeric value identifying the business activity based on the North American Industry Classification System (NAICS) 2017 Code (Industry Type Code: 700). Can repeat multiple times. [C] PCM XPath: //Organization/ IndustryCode/ IndustryCode/ IndustryCode |
NAICS Code Description | Text that describes the business activity specified by the North American Industry Classification System (NAICS) 2017 Code (Industry Type Code: 700), e.g., "General Freight Trucking, Long-Distance, Less Than Truckload" is the description of NAICS code 484122. [C] PCM XPath: //Organization/ IndustryCode/ IndustryCode/ IndustryCodeDescription |
Number of Family Members Including Subsidiaries | The number of linkages in the upward and downward directions of the entire corporate family tree that the subject belongs to, starting from the global ultimate. [M] PCM XPath: //Organization/ Linkage/ LinkageSummary/ GlobalUltimateFamilyTreeLinkageCount |
Parent Business Name | Text recording the business name of the parent company. A parent is a corporation that owns more than 50% of another corporation's capital stock; these owned companies are subsidiaries to the parent company. [M] PCM XPath: //Organization/ Linkage/ ParentOrganization/ OrganizationPrimaryName/ OrganizationName |
Parent Country Name | Name of the country where the parent organization is located. [M+] PCM XPath: //Organization/ Linkage/ ParentOrganization/ PrimaryAddress/ CountryOfficialName |
Parent D&B City Code | D&B code of the city where the parent organization is located. [M+] PCM XPath: //Organization/ Linkage/ ParentOrganization/ PrimaryAddress/ PrimaryTownWorldBaseCode |
Parent D&B Country Code | D&B code of the country where the parent organization is located. PCM XPath: //Organization/ Linkage/ ParentOrganization/ PrimaryAddress/ CountryWorldBaseCode |
Parent D&B County Code | D&B geographical code which identifies the county where the parent organization is located. Code is unique within state/province. PCM XPath: //Organization/ Linkage/ ParentOrganization/ PrimaryAddress/ CountyWorldbaseCode |
Parent D&B Region/Continent Code | D&B code for the region where the parent organization is located. [M+] PCM XPath: //Organization/ Linkage/ ParentOrganization/ PrimaryAddress/ CountryGroupName |
Parent D-U-N-S Number | The D-U-N-S number of the parent company. A parent is a corporation that owns more than 50% of another corporation's capital stock; these owned companies are subsidiaries to the parent company. [M] PCM XPath: //Organization/ Linkage/ ParentOrganization/ DUNSNumber |
Parent Postal Code | An identifier used by the local country postal authority to identify where the parent company is located. [M+] PCM XPath: //Organization/ Linkage/ ParentOrganization/ PrimaryAddress/ PostalCode |
Parent Street Address | Text recording the address number, or post office box number and street name where the parent company is located. [M+] PCM XPath: //Organization/ Linkage/ ParentOrganization/ PrimaryAddress/ StreetAddressLine/ LineText |
Parent 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 parent company is located. [M+] PCM XPath: //Organization/ Linkage/ ParentOrganization/ PrimaryAddress/ TerritoryAbbreviatedName |
Parent 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 parent company is located. [M+] PCM XPath: //Organization/ Linkage/ ParentOrganization/ PrimaryAddress/ TerritoryName |
Parent Town Name | Text recording the name of the city, town, village, etc. where the parent company is located. [M+] PCM XPath: //Organization/ Linkage/ ParentOrganization/ PrimaryAddress/ PrimaryTownName |
Previous D-U-N-S Number (Transfer) | The most recently retired D-U-N-S Number that is associated with this subject, often as a redundant record. An explanation for this change is provided in the transfer reason. [M+] PCM XPath: //Organization/ SubjectHeader/ TransferDUNSNumberRegistration/ TransferredFromDUNSNumber |
Primary SIC Code | The first listed alphanumeric value identifying the primary business activity based on the scheme specified by the Standard Industrial Classification (SIC) Code. The first four digits are external codes created by the U.S. Government. D&B has 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). PCM XPath: //Organization/ IndustryCode/ IndustryCode/ IndustryCode |
Primary SIC Description | Text that describes the business activity based on the scheme specified by the attribute type, e.g., 'highway and street construction' is the description of industry code 1611 in the U.S. SIC (Standard Industrial Classification) system. PCM XPath: //Organization/ IndustryCode/ IndustryCode/ IndustryCodeDescription |
Registered Address Indicator | When 'true' indicates that the Primary Address which has been presented is also the Registered Address. [M+] PCM XPath: //Organization/ Location/ PrimaryAddress/ RegisteredAddressIndicator |
Registration Identification 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. PCM XPath: //Organization/ RegisteredDetail/ OrganizationIdentificationNumberDetail/ OrganizationIdentificationNumber |
Registration Number - All Countries Except US | 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 Union VAT Number, Australian Business Number, Brazilian State Registry Number. PCM XPath: //Organization/ RegisteredDetail/ OrganizationIdentificationNumberDetail/ OrganizationIdentificationNumber |
Retained D-U-N-S Number (Transfer) | In the event that the D-U-N-S Number of this subject is retired, this field will contain the D-U-N-S Number to reference for future product requests. An explanation for this change is provided in the transfer reason. PCM XPath: //Organization/ SubjectHeader/ TransferDUNSNumberRegistration/ TransferredToDUNSNumber |
Sales Revenue Amount in Local Currency (Key Financials) | The monetary value of income received from customers from the sale of the business' goods and/or services. This is the gross sales minus any returns, rebates/discounts, allowances for damages or shortages, shipping expenses passed on to the customer. [M] PCM XPath: //Organization/ Financial/ KeyFinancialFiguresOverview/ SalesRevenueAmount |
Sales Revenue Amount in US Dollars (Key Financials) | The revenue claimed in the income statement data in millions (USD). [M] PCM XPath: //Organization/ Financial/ KeyFinancialFiguresOverview/ SalesRevenueAmount |
Secondary SIC Code | An alphanumeric value identifying a business activity based on the scheme specified by the Standard Industrial Classification (SIC) Code. Clarification Note: These are generally external codes created by an external authoritative body like the U.S. Office of Management and Budget 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). Can repeat up to five times. PCM XPath: //Organization/ IndustryCode/ IndustryCode/ IndustryCode |
Secondary SIC Description | Text that describes the business activity based on the scheme specified by the attribute type, e.g., 'highway and street construction' is the description of industry code 1611 in the U.S. SIC (Standard Industrial Classification) system. PCM XPath: //Organization/ IndustryCode/ IndustryCode/ IndustryCodeDescription |
UK SIC Code | The first listed alphanumeric value identifying the primary business activity based on the UK SIC Code. PCM XPath: //Organization/ IndustryCode/ IndustryCode/ IndustryCode |
UNSPSC Code | An alphanumeric value identifying a product or service based on the United Nations Standard Products and Services Code (UNSPSC). UNSPSC is a four-level hierarchical convention that is coded as an eight-digit number, with an optional fifth level adding two more digits. PCM XPath: //Organization/ IndustryCode/ IndustryCode/ IndustryCode |
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
The availability of certain scores delivered by this product may be limited due to a lack of sufficient company or industry specific data to perform the calculations.
Compatibility with Batch File products
The following fields are included in this data layer for existing D&B customers who may have internal systems and/or processes that rely upon these codes:
- Location.PrimaryAddress.PrimaryTownWorldBaseCode
- Location.PrimaryAddress.TerritoryWorldBaseCode
- Location.PrimaryAddress.CountryWorldBaseCode
- Location.PrimaryAddress.CountyWorldBaseCode
- Location.MailingAddress.PrimaryTownWorldBaseCode
- Location.MailingAddress.TerritoryWorldBaseCode
- Location.MailingAddress.CountryWorldBaseCode
- Location.MailingAddress.CountyWorldBaseCode
- Linkage.GlobalUltimateOrganization.PrimaryAddress.PrimaryTownWorldBaseCode
- Linkage.GlobalUltimateOrganization.PrimaryAddress.CountryWorldBaseCode
- Linkage.GlobalUltimateOrganization.PrimaryAddress.CountyWorldBaseCode
- Linkage.DomesticUltimateOrganization.PrimaryAddress.PrimaryTownWorldBaseCode
- Linkage.DomesticUltimateOrganization.PrimaryAddress.CountryWorldBaseCode
- Linkage.HeadquartersOrganization.PrimaryAddress.PrimaryTownWorldBaseCode
- Linkage.HeadquartersOrganization.PrimaryAddress.CountryWorldBaseCode
- Linkage.HeadquartersOrganization.PrimaryAddress.CountyWorldbaseCode
- Linkage.ParentOrganization.PrimaryAddress.PrimaryTownWorldBaseCode
- Linkage.ParentOrganization.PrimaryAddress.CountryWorldBaseCode
- Linkage.ParentOrganization.PrimaryAddress.CountyWorldbaseCode
New implementations should be developed using the corresponding fields that are based on coding standards for geographic locations. For example, instead of CountryWorldBaseCode, please use CountryISOAlpha2Code.
A conversion table for WorldBase to ISO codes is available on the Country Chart tab (far right column contains the WorldBase codes) of the downloadable Data Primer.