d&b direct 2.0 firmographic service...diversityindicators-enhanced...
TRANSCRIPT
D&B DirectAPI Documentation for
Firmographic Product Service
Version 2.0 (API) / 3.2 (Service)
D&B Direct is a trademark or registered trademark of Dun and Bradstreet, Incorporated. Other trademarks
used herein are the trademarks or registered trademarks of their respective owners.
This document is a work of authorship that belongs to Dun and Bradstreet, Incorporated and is protected
by United States and foreign copyright laws and international copyright treaties. The use of the software
and this Documentation is governed by the Dun and Bradstreet Incorporated software license agreement.
D&B DOES NOT GUARANTEE OR WARRANT SYSTEMS AVAILABILITY OR PERFORMANCE IN ACCORDANCE
WITH THE FIGURES WITHIN THIS DOCUMENT, NOR DOES D&B ACCEPT ANY LIABILITY FOR DAMAGES
WHICH MAY BE SUFFERED AS A RESULT OF PLACING ANY RELIANCE ON THESE FIGURES. D&B RESERVES
THE RIGHT TO AMEND THIS DOCUMENT AT ANY TIME AND WILL ADVISE THE CUSTOMER ACCORDINGLY OF
ANY SUCH AMENDMENTS OR CHANGES.
©Dun & Bradstreet, Inc. 2014. All rights reserved
ContentsThese pages provide business overviews; explaining requirements and the business elements that will bedelivered. For suggested uses of the API components, please refer to the Solutions menu option on thedeveloper.dnb.com home page.
Title / Overview Link
Detailed Company Profile
Alternative Detailed Company Profile
Detailed Company Profile - SDMR
Detailed Company Profile - WB1784
Diversity Indicators
USA PATRIOT Act Plus
These pages provide the technical specifications that a developer will need to obtain information usingD&B Direct.
Service Operation / SOAP Resource / REST
n/a [Authentication Process] POST Authentication
Firmographic Product Service OrderProduct GET organizations/{DUNS}/products/{productID}
RetrieveProduct GET assets/{assetid}/{productid}
Service History
Version Date Interface(s)
Change(s)
3.2 August22, 2014
SOAP/REST Several fields on the Detailed Company Profile - SDMR product have been remapped.See details in the following table.
3.2 March 7,2014
SOAP/REST The Detailed Company Profile - WB1784 and Detailed Company Profile -SDMR data layers have been added to this service.The business elements Management Responsibility (Principal) and Most SeniorPrincipal Management Responsibility are now based on D&B's ManagementResponsibilty Code system, rather than the previously delivered Hoover's JobCode list. A table comparing the two sets of codes is available in the DataPrimer.
3.1 January24, 2014
SOAP/REST XPATH's have been added to resolve an issue implementing this API serviceusing the Microsoft .NET platform.
D&B Direct API Documentation Service History
©Dun & Bradstreet, Inc. 2014 3
Version Date Interface(s)
Change(s)
3.0 December6, 2013
SOAP/REST 1. Business elements were added to the following data layers: Detailed CompanyProfile, USA PATRIOT Act Plus, Alternative Detailed Company Profile. Details...
2. To support upcoming changes to the delivery of PAYDEX data, several XPATH's have
changed/were added to the OrderProduct response. Details...
2.1 October25, 2013
SOAP/REST Five new business elements were added to the data layer response: Global UtimateTotal Organization Employees, Major Industry Category, Number of Family MembersIncluding Subsidiaries, Transfer Date, and Transfer Reason Text. Details...
2.0 October 2,2013
SOAP/REST Initial release.
D&B Direct API Documentation Service History
©Dun & Bradstreet, Inc. 2014 4
About this DocumentationThe D&B Direct 2.0 API Reference materials are organized into product, feature, service and operation pages.Throughout the documentation, certain items are marked as eligible for custom products and/or for inclusionin the monitoring process.
Key Concepts
Business Elements vs. Data Fields
The D&B Direct API has been designed to efficiently deliver information, and as a result, multiple businesselements are often delivered in the same data field (with separate attributes signaling the specific contents ofa data field).
The documentation highlights the business elements (i.e. business-oriented labels) on product pages; and thedata fields (i.e. technical, variable-like names used within the delivery packages) on operation pages -- withthe business elements linked to the corresponding data field for each available implementation.
Data Layers
The D&B Direct API delivers information in data layers, some of which have multiple levels. For the purpose ofthis documentation, the term Product is used to represent a given level for a data layer.
For example, "Detailed Company Profile" is the Data Layer, while "Detailed Company Profile - Enhanced" willbe referred to as a Product.
Custom Products
D&B Direct offers a customization service that allows for up to eight pre-configured products to be deliveredthrough the API web service. Throughout the documentation, business elements and data fields which areeligible for inclusion in a custom product are designated with a [C] marker.
Service Versions
It is important to note that D&B Direct 2.x implements version control at the service level, in addition to theAPI level. For example, the current version of the Assessment Product Service is Version 2.0 (API) / 3.0 (Service).
D&B Direct services will be updated (major and minor version changes) without a API version change.Following the example given, it will be possible for the Assessment Product Service to change to Version 2.0
D&B Direct API Documentation About this Documentation
©Dun & Bradstreet, Inc. 2014 5
(API) / 3.1 (Service) or Version 2.0 (API) / 4.0 (Service) based on the significance of the changes made to theservice.
Product Pages
These are non-technical pages that describe the information (i.e. business elements) returned by the data-oriented operations. In addition, the requirements and options for requesting data are mentioned.
Feature Pages
These are also non-technical pages, but explain the use of operations that provide a function (e.g. search) andoften return the items (i.e. D-U-N-S Number) required to request data products.
Service Pages
These are technical pages that explain what operations a given API web service provides, the correct versionand endpoints, WSDL location (for SOAP), and how to download samples and data dictionaries specific to theservice. While services are not applicable for REST implementations, the documentation is organized aroundthem for consistency.
Operation Pages
These are also technical pages, but describe (for each available implementation method) the individualfunctions provided by a service, listing the input field names and requirements, and the output with datafields (including data type, size, description and possible values).
Release Histories
Whenever an operation is enhanced (or a minor correction is made), a notation will be added to a section onthe bottom of the affected SOAP/REST operation page. If the change is significant and results in a versionchange, the release history will maintain a link to the documentation for the previous version(s).
Getting Started
While the API Reference documentation provides extensive details on each operation and data layer, for moresummarized explanations of common tasks/uses refer to the collection of How To Guides.
D&B Direct API Documentation Product Pages
©Dun & Bradstreet, Inc. 2014 6
Diversity Indicators - EnhancedMeet your diversity goals with access to the leading source of diversity data collected from over 400 sources.Access our database of more than 5.3 million socio-economic classifications and over 20 million smallbusiness indicators to find qualified suppliers that meet your needs.
Match your supplier file with D&B’s database to append diversity indicators and determine the diversity inyour supply base. Add additional suppliers to meet company goals, comply with corporate, federal, state, andTier 2 requirements such as 294/295 reporting. Avoid suppliers on government control lists, including OFAC, orwho have EPA or OSHA violations. And, document how much you spend with diverse suppliers.
Requirements & Options
When requesting this D&B Direct product, a valid D-U-N-S Number for a company, its country code, and theappropriate product code will be required. If this information is not available, refer to obtaining a company D-U-N-S Number for assistance. A trade up option exists to request data for the headquarters when therequested organization is a branch.
When ordering information for organizations located in Germany, customers are required to provide a validorder reason code. A list of possible values is included on the respective SOAP or REST operation page.
Note: The product code for Diversity Indicators - Enhanced is DVR_ENH. This product may be included inthe Monitoring process.
Data Privacy
This product returns information that, in some jurisdictions, is considered personally identifiable information(PII). D&B customers that are entitled to request this product (and any third-parties that may be assisting withtheir implementation) are bound to the data privacy terms specified in the D&B Direct agreement.
Business Elements
The following table is an alphabetical list of the unique items delivered in this data layer. Legend: [C] = maybe included in a Custom Data product; [M] = may be referenced by the Monitoring process; [M+] = Monitoredusing an aggregate or attribute XPath.
Note: This product will 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, et al.)
D&B Direct API Documentation Diversity Indicators - Enhanced
©Dun & Bradstreet, Inc. 2014 7
along with the business elements listed. In addition, customers who compare the following table to theData Primer should be advised of several intentional differences.
Name Description XML* JSON*
8A Case Number The certification number given by SBA which is usually 6 digits in length. [C] [M+] SOAP REST
8A CertificationCode
A code describing the level to which a source data provider applies due diligence toendorse the subject authoritatively as having met certain requirements to begranted the classification. [C] [M+]
SOAP REST
8A CertificationExpiration Date
The date when the SBA-granted certification expires. Date format is YYYYMMDD. [C][M+]
SOAP REST
8A CertificationIndicator
When 'true' indicates that a business meets the eligibility criteria established by theSmall Business Administration for small companies owned by socially andeconomically disadvantaged persons, so that they may bid and obtain federalgovernment contracts and other assistance to develop their business. The businessowner must be eligible under the same rules and guidelines set down by the federalgovernment. [C] [M]
SOAP REST
8A CertificationStart Date
The date when the certification was granted by the SBA. Date format is YYYYMMDD.[C] [M+]
SOAP REST
8A Data ProviderCode
A code describing the classification level for the source providing the indicator. [C][M+]
SOAP REST
8A Data ProviderName
Text recording the name of the source from which the 8A indicator was obtained. [C][M+]
SOAP REST
8A Date Receivedby D&B
The date when the certification information of the business as an 8A certifiedorganization was processed by D&B. The 8(A) program is a U.S. business developmentprogram to help small disadvantaged businesses compete and access the federalprocurement ma [C] [M+]
SOAP REST
8A VerificationCode
A code describing the level to which a source data provider applies due diligence toendorse the subject authoritatively as having met certain requirements to begranted the classification. [C] [M+]
SOAP REST
AirportConcessionDisadvantagedBusinessEnterpriseIndicator
When 'true' indicates the business is certified as a Federal Airport ConcessionDisadvantaged Business Enterprise in accordance with U.S. Federal ACDBEregulations (49 CFR Part 23). [C] [M]
SOAP REST
AirportConcessionDisadvantagedBusinessEnterprise SourceCountry Code
The two-letter country code, defined in the ISO 3166-1 scheme published byInternational Organization for Standardization (ISO), identifying the country for thisaddress.Can repeat up to five times. [C] [M+]
SOAP REST
D&B Direct API Documentation Business Elements
©Dun & Bradstreet, Inc. 2014 8
Name Description XML* JSON*
AirportConcessionDisadvantagedBusinessEnterprise SourceLevel
A code describing the classification level for the source providing the indicator. [C][M+]
SOAP REST
AirportConcessionDisadvantagedBusinessEnterprise SourceName
The name of the source from which the Airport Concession Disadvantaged BusinessEnterprise indicator was obtained. Can repeat up to five times. [C] [M+]
SOAP REST
AirportConcessionDisadvantagedBusinessEnterprise SourceState/ProvinceAbbreviatedName
Text recording the shortened name of the locally governed area which forms part ofa centrally governed nation. For example 'NJ' for the US State New Jersey withinCountry United States of America. Can repeat up to five times. [C] [M+]
SOAP REST
Alaskan NativeCorporationIndicator
When 'true' indicates that the tribe is an Alaskan Native Corporation. [C] [M] SOAP REST
Certified SmallBusinessCertificationExpiration Date
The date marking the expiration of the Small Business Certification, as issued by thecertifying authority. This element can repeat up to three times. [C] [M+]
SOAP REST
Certified SmallBusinessCertificationNumber
A number that uniquely identifies the Certified Small Business Certification providedby the certifying body. The use of this number varies from entity to entity and may ormay not be present. Can repeat up to three times. [C] [M+]
SOAP REST
Certified SmallBusinessCertification StartDate
The date marking the start of the Small Business Certification, as issued by thecertifying authority. Can repeat up to three times. [C] [M+]
SOAP REST
Certified SmallBusiness Indicator
When 'true' indicates that the business is certified by a federal, state or localgovernment agency or organization to be eligible for certain small businessopportunities, such as government contracts. [C] [M]
SOAP REST
Certified SmallBusiness SourceCode Name
Text recording the name of the source from which the Certified Small Businessindicator was obtained. Can repeat up to three times. [C] [M+]
SOAP REST
Certified SmallBusiness SourceLevel Code
An alpha code indicating the level of the source providing the indicator, for example,federal, state, or city government or association. Can repeat up to three times. [C][M+]
SOAP REST
D&B Direct API Documentation Business Elements
©Dun & Bradstreet, Inc. 2014 9
Name Description XML* JSON*
Disabled VeteranBusinessEnterpriseIndicator
When 'true' indicates whether a business is recognized by the state of California,meaning a veteran of the U.S. military, naval, or air service, with a service-connecteddisability of at least 10% or more and who is a California resident; where at least [C][M]
SOAP REST
Disabled-OwnedBusiness Indicator
When 'true' indicates that a business is a least 51% owned by one or more disabledpersons who control and operate the business. Control in this context meansexercising the power to make policy decisions and operate means to be activelyinvolved [C] [M]
SOAP REST
Disabled-OwnedCertification -VerificationStatus
When 'true' indicates that this status has been verified through a D&B call centercampaign. This element can repeat up to two times. [C] [M+]
SOAP REST
Disabled-OwnedCertification Code
A code describing the level to which a source data provider applies due diligence toendorse the subject authoritatively as having met certain requirements to begranted the classification. Can repeat up to two times. [C] [M+]
SOAP REST
Disabled-OwnedCertificationExpiration Date
The date on which the certification period for this organization as disabled-ownedexpires. Can repeat up to two times. [C] [M+]
SOAP REST
Disabled-OwnedCertificationNumber
The Disabled-Owned Certification Identification number provided by the certifyingbody. The use of this number varies from entity to entity and may or may not bepresent. Can repeat up to two times. [C] [M+]
SOAP REST
Disabled-OwnedCertification StartDate
The date on which the certification period for this organization as disabled-ownedbegins. Can repeat up to two times. [C] [M+]
SOAP REST
Disabled-OwnedDate Received byD&B
The date when the data was received by D&B from the source indicating thebusiness entity is a Disabled-Owned Business. Can repeat up to two times. [C] [M+]
SOAP REST
Disabled-OwnedSource CodeName
Text recording the name of the source from which the Disabled-Owned indicatorwas obtained. Examples include SBA, NJDOT, etc. Can repeat up to two times.[C] [M+]
SOAP REST
Disabled-OwnedSource Level Code
An alpha code value indicating the level of the source providing the indicator, forexample, federal, state, or city government or association. [C] [M+]
SOAP REST
DisadvantagedBusinessEnterpriseCertification Code
A code describing the level to which a source data provider applies due diligence toendorse the subject authoritatively as having met certain requirements to begranted the classificationof Disadvantaged Business. Can repeat up to two times. [C][M+]
SOAP REST
DisadvantagedBusinessEnterpriseCertification Code- VerificationStatus
When 'true' indicates that this status has been verified through a D&B call centercampaign. Can repeat two times. [C] [M+]
SOAP REST
D&B Direct API Documentation Business Elements
©Dun & Bradstreet, Inc. 2014 10
Name Description XML* JSON*
DisadvantagedBusinessEnterpriseCertificationExpiration Date
The date marking the expiration of the certification of this business as aDisadvantaged Business Enterprise. Can repeat up to two times. [C] [M+]
SOAP REST
DisadvantagedBusinessEnterpriseCertificationNumber
The Disadvantaged Business Enterprise Certification Identification number providedby the certifying body. The use of this number varies from entity to entity and may ormay not be present.Can repeat up to two times. [C] [M+]
SOAP REST
DisadvantagedBusinessEnterpriseCertification StartDate
The date my which the business was certified as a Disadvantaged Business. Canrepeat up to two times. [C] [M+]
SOAP REST
DisadvantagedBusinessEnterprise DateReceived by D&B
The date when the disadvantaged enterprise detail data was processed by D&B fromthe source. Can repeat up to two times. [C] [M+]
SOAP REST
DisadvantagedBusinessEnterpriseIndicator
When 'true' indicates a business that is certified by a federal, state or localgovernment agency as having met all of the government standards that awardeligibility, but may include women, minority, disabled and other disadvantaged as aresult of economic disadvantages with respect to education, employment, residenceor business location or social disadvantage and lack of business training. [C] [M]
SOAP REST
DisadvantagedBusinessEnterprise SourceCode Name
Text recording the name of the source from which the Disadvantaged BusinessEnterprise indicator was obtained. Examples are: SBA, NJDOT, etc. Can repeat up totwo times. [C] [M+]
SOAP REST
DisadvantagedBusinessEnterprise SourceLevel Code
An alpha code indicating the level of the source providing the indicator, for example,federal, state, or city government or association. [C] [M+]
SOAP REST
DisadvantagedVeteranEnterpriseIndicator
When 'true' indicates that the business entity is owned and controlled byDisadvantaged Veterans. Can repeat up to two times. [C] [M]
SOAP REST
HUB ZoneCertified BusinessIndicator
When 'true' indicates that this organization is certified by the US Small BusinessAdministration as being a recipient of the Historically Underutilized Business (HUB)Zone program. [C] [M]
SOAP REST
Labor SurplusArea Indicator
When 'true' indicates that this organization is certified as a business that operates ina labor surplus area, which is a geographical area identified by the Department ofLabor as an area of concentrated unemployment or underemployment or an area oflabor [C] [M]
SOAP REST
D&B Direct API Documentation Business Elements
©Dun & Bradstreet, Inc. 2014 11
Name Description XML* JSON*
Minority BusinessEnterpriseIndicator
When 'true' indicates that a business is certified by a federal, state or localgovernment agency through an application and/or premise visit process as havingmet all of the government standards and requirements. Can repeat up to five times.[C] [M]
SOAP REST
MinorityCertification -VerificationStatus
A code describing the level to which a source data provider applies due diligence toendorse the subject authoritatively as having met certain requirements to begranted the classification. This element can repeat up to five times. [C] [M+]
SOAP REST
MinorityCertificationExpiration Date
The date on which the business is no longer certified. Date format is YYYYMMDD.Can repeat up to five times. [C] [M+]
SOAP REST
MinorityCertificationIndicator
A code describing the level to which a source data provider applies due diligence toendorse the subject authoritatively as having met certain requirements to begranted the classification. This element can repeat up to five times. [C] [M+]
SOAP REST
MinorityCertificationNumber
A number that identifies an organization as minority certified and provided by thecertifying body. The use of this number varies from entity to entity and may or maynot be present. It may contain special characters such as hyphens. Can repeat up to fi[C] [M+]
SOAP REST
MinorityCertification StartDate
The date on which the certification period for this organization begins. Can repeat upto five times. [C] [M+]
SOAP REST
MinorityClassificationCode
A code describing the type of minority business. Can repeat up to five times. [C] [M+] SOAP REST
Minority CollegeIndicator
When 'true' indicates that this organization is a college or university where theprofile of the majority of students is of minority ethnicity. [C] [M]
SOAP REST
Minority DataDate Received byD&B
The date when the minority owned details data was processed by D&B from thesource. Date format is YYYYMMDD. Can repeat up to five times. [C] [M+]
SOAP REST
Minority DataProvider
Name identifying the source from which this socio economic data was originallyobtained by D&B. [C] [M+]
SOAP REST
Minority OwnedIndicator
When 'true' indicates that this organization is certified as a business that is greaterthan 50% owned by and whose management and daily business operations arecontrolled by one or more minority group members. [C] [M]
SOAP REST
Minority SourceLevel Code
A code describing the classification level for the source providing the indicator. Canrepeat up to five times. [C] [M+]
SOAP REST
Out of BusinessIndicator
Text that records the operating status of the business. [C] SOAP REST
Political District Text recording a distinct territorial subdivision for holding a separate election for oneor more seats in a legislative body to which this address belongs. In the U.S. this is anumber. In the U.K. this is text that describes the U.K. Constituency. [C] [M+]
SOAP REST
D&B Direct API Documentation Business Elements
©Dun & Bradstreet, Inc. 2014 12
Name Description XML* JSON*
Service DisabledVeteran OwnedIndicator
When 'true' indicates that a business is at least 51% owned by one or more veteranswith a disability that is service connected. The term “service connected” means, withrespect to disability, that such disability was incurred or aggravated, in the line of dutyin the active military, naval or air service. (38 U.S.C. ‘101(16)). Can repeat up to twotimes. [C] [M]
SOAP REST
Small BusinessIndicator
When 'true' indicates that the subject qualifies as small business, eligible forassistance from SBA, with a place of business located in the United States. It mustoperate primarily within the United States or make a significant contribution to theU.S. economy through payment of taxes or use of American products, materials orlabor. Together with its affiliates, it must meet the numerical size standards asdefined in the Small Business Size Regulations 13 CFR 121. [C] [M]
SOAP REST
SmallDisadvantagedBusinessCertificationIndicator
When 'true' indicates the level to which a source data provider applies due diligenceto endorse the subject authoritatively as having met certain requirements to begranted the classification. [C] [M+]
SOAP REST
SmallDisadvantagedBusiness DateReceived by D&B
The date when the certification information of the business as a SmallDisadvantaged Business was obtained by D&B from the source. [C] [M+]
SOAP REST
SmallDisadvantagedBusinessExpiration Date
The date when the certification information of the business as a SmallDisadvantaged Business expires. [C] [M+]
SOAP REST
SmallDisadvantagedBusiness Indicator
When 'true' indicates that this organization is certified as a business that is greaterthan 50% owned by and whose management and daily business operations arecontrolled by socially and economically disadvantaged persons. [C] [M]
SOAP REST
SmallDisadvantagedBusiness SourceLevel Code
A code describing the classification level for the source providing the indicator. [C][M+]
SOAP REST
SmallDisadvantagedBusiness SourceName
Text recording the name of the source from which the Small DisadvantagedBusiness indicator was obtained. [C] [M+]
SOAP REST
SmallDisadvantagedBusiness StartDate
The date when the certification information of the business as a SmallDisadvantaged Business begins. [C] [M+]
SOAP REST
SmallDisadvantagedBusinessVerificationIndicator
When 'true' indicates the level to which a source data provider applies due diligenceto endorse the subject authoritatively as having met certain requirements to begranted the classification. [C] [M+]
SOAP REST
D&B Direct API Documentation Business Elements
©Dun & Bradstreet, Inc. 2014 13
Name Description XML* JSON*
Veteran BusinessEnterpriseIndicator
When 'true' indicates whether Small Business Concerns are owned and controlled byveterans not less than 51% owned by one or more veterans and in the case of apublicly owned business not less than 51% of the stock is owned by one or moreveterans. Can r [C]
SOAP REST
VeteranCertification -VerificationStatus
When 'true' indicates that this status has been verified through a D&B call centercampaign. Can repeat two times. [C] [M+]
SOAP REST
VeteranCertificationExpiration Date
The expiration date marking the certification of the business as Veteran Owned. [C][M+]
SOAP REST
VeteranCertificationIndicator
When 'true' indicates that data provider is certified to endorse the subject as aVeteran owned business authoritatively. When 'false' indicates that this dataprovider is not certified to endorse the subject authoritatively.Can repeat up to twotimes. [C] [M+]
SOAP REST
VeteranCertificationNumber
A number recording the Veteran Certification Identification provided by the certifyingbody. The use of this number varies from entity to entity and may or may not bepresent. Can repeat up to two times. [C] [M+]
SOAP REST
VeteranCertification StartDate
The date by which the business was certified as a Veteran Owned Business. Canrepeat up to two times. [C] [M+]
SOAP REST
Veteran OwnedDetail DateReceived by D&B
The date by which the veteran-owned detail data was processed by D&B from thesource. Date format is YYYYMMDD. [C] [M+]
SOAP REST
Veteran OwnedIndicator
When 'true' indicates that the business entity is owned and controlled by a Veteran.[C] [M]
SOAP REST
Veteran SourceCode Name
Text recording the name of the source from which the Veteran indicator wasobtained. Examples are: SBA, DBV - D&B Verified, DBC - D&B Collected, NJDOT, etc.Can repeat up to two times. [C] [M+]
SOAP REST
Veteran SourceLevel Code
An alpha code indicating the level of the source providing the indicator, for example,federal, state, or city government or association. Can repeat up to two times. [C] [M+]
SOAP REST
Vietnam VeteranOwned Indicator
When 'true' indicates whether a business is a least 51% owned by one or moreVietnam Veterans who served between 1/1/59 and 5/7/75 and have control andoperate the business. Can repeat up to two times. [C] [M]
SOAP REST
Woman-OwnedBusinessEnterpriseIndicator
When 'true' indicates whether a business is certified by a federal, state or localgovernment agency as having met all of the government standards andrequirements. Can repeat up to five times. [C] [M]
SOAP REST
Woman-OwnedCertification -VerificationStatus
When 'true' indicates that this status has been verified through a D&B call centercampaign. This element can repeat up to five times. [C] [M+]
SOAP REST
Woman-OwnedCertificationExpiration Date
The expiration date of the certification of the business as Woman-Owned. Canrepeat up to five times. [C] [M+]
SOAP REST
D&B Direct API Documentation Business Elements
©Dun & Bradstreet, Inc. 2014 14
Name Description XML* JSON*
Woman-OwnedCertificationIndicator
A code describing the level to which a source data provider applies due diligence toendorse the subject authoritatively as having met certain requirements to begranted the classification. Choices are yes, no or null. Can repeat up to five times. [C][M+]
SOAP REST
Woman-OwnedCertificationNumber
The number that is assigned by a certifying body to Woman-Owned organizations.The use of this number varies from entity to entity and may or may not be present.Can repeat up to five times. [C] [M+]
SOAP REST
Woman-OwnedCertification StartDate
The date by which the data regarding woman-owned certification was sent to D&B.Date format is YYYYMMDD. Can repeat up to five times. [C] [M+]
SOAP REST
Woman-OwnedDate Received byD&B
The date that the Woman-Owned certification information was received by D&Bfrom the source. Can repeat up to five times. [C] [M+]
SOAP REST
Woman-OwnedIndicator
When 'true' indicates that this organization is certified as a business that is greaterthan 50% owned by and whose management and daily business operations arecontrolled by one or more female persons. The percentage of ownership requirementmay [C] [M]
SOAP REST
Woman-OwnedSource CodeName
Text recording the name of the source from which the Woman-Owned indicator wasobtained. Examples are: SBA, DBV - D&B Verified, DBC - D&B Collected, NJDOT, etc.Can repeat up to five times. [C] [M+]
SOAP REST
Woman-OwnedSource Level Code
An alpha code indicating the level of the source providing the indicator, for example,federal, state, or city government or association. Can repeat up to five times. [C] [M+]
SOAP REST
*The links in this column provide the technical characteristics for the data field of the respective business element in the
XML or JSON response.
The preceding list is not presented in the order, nor manner, in which the information is packaged anddelivered via the D&B Direct API.
While data for a particular company may not contain values for all of the business elements, there may beitems that are considered by D&B to be essential to yield the maximum benefit of a data layer. If any of theseessential elements do not contain a value for a particular company, an error code will be returned, and yourorganization will not incur a usage credit for the request.
The Product Availability Lookup feature may be utilized to determine if this D&B Direct product is availablefor a given D-U-N-S Number.
Additional Details
Access to this information is provided on a metered basis; and will require data layer entitlement prior to usein the production environment. A built-in feature exists to prevent duplicate billing when multiple requestswith the same D-U-N-S Number and product code are submitted on the same calendar day (which is based onEastern Standard Time [GMT-5]).
D&B Direct API Documentation Additional Details
©Dun & Bradstreet, Inc. 2014 15
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.
Related Topics
Diversity Indicators - Standard.
Technical Specification
For details on how to obtain this data layer, please refer to the Firmographic.OrderProduct (SOAP) orFirmographic.OrderProduct (REST) page.
D&B Direct API Documentation Related Topics
©Dun & Bradstreet, Inc. 2014 16
Diversity Indicators - StandardMeet your diversity goals with access to the leading source of diversity data collected from over 400 sources.Access our database of more than 5.3 million socio-economic classifications and over 20 million smallbusiness indicators to find qualified suppliers that meet your needs.
Match your supplier file with D&B’s database to append diversity indicators and determine the diversity inyour supply base. Add additional suppliers to meet company goals, comply with corporate, federal, state, andTier 2 requirements such as 294/295 reporting. Avoid suppliers on government control lists, including OFAC, orwho have EPA or OSHA violations. And, document how much you spend with diverse suppliers.
Requirements & Options
When requesting this D&B Direct product, a valid D-U-N-S Number for a company, its country code, and theappropriate product code will be required. If this information is not available, refer to obtaining a company D-U-N-S Number for assistance. A trade up option exists to request data for the headquarters when therequested organization is a branch.
When ordering information for organizations located in Germany, customers are required to provide a validorder reason code. A list of possible values is included on the respective SOAP or REST operation page.
Note: The product code for Diversity Indicators - Standard is DVR_STD. This product may be included inthe Monitoring process.
Data Privacy
This product returns information that, in some jurisdictions, is considered personally identifiable information(PII). D&B customers that are entitled to request this product (and any third-parties that may be assisting withtheir implementation) are bound to the data privacy terms specified in the D&B Direct agreement.
Business Elements
The following table is an alphabetical list of the unique items delivered in this data layer. Legend: [C] = maybe included in a Custom Data product; [M] = may be referenced by the Monitoring process; [M+] = Monitoredusing an aggregate or attribute XPath.
Note: This product will 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, et al.)
D&B Direct API Documentation Diversity Indicators - Standard
©Dun & Bradstreet, Inc. 2014 17
along with the business elements listed. In addition, customers who compare the following table to theData Primer should be advised of several intentional differences.
Name Description XML* JSON*
8ACertificationIndicator
When 'true' indicates that a business meets the eligibility criteria established by theSmall Business Administration for small companies owned by socially and economicallydisadvantaged persons, so that they may bid and obtain federal government contractsand other assistance to develop their business. The business owner must be eligibleunder the same rules and guidelines set down by the federal government. [C] [M]
SOAP REST
AirportConcessionDisadvantagedBusinessEnterpriseIndicator
When 'true' indicates the business is certified as a Federal Airport ConcessionDisadvantaged Business Enterprise in accordance with U.S. Federal ACDBE regulations(49 CFR Part 23). [C] [M]
SOAP REST
Alaskan NativeCorporationIndicator
When 'true' indicates that the tribe is an Alaskan Native Corporation. [C] [M] SOAP REST
Certified SmallBusinessIndicator
When 'true' indicates that the business is certified by a federal, state or localgovernment agency or organization to be eligible for certain small businessopportunities, such as government contracts. [C] [M]
SOAP REST
DisabledVeteranBusinessEnterpriseIndicator
When 'true' indicates whether a business is recognized by the state of California,meaning a veteran of the U.S. military, naval, or air service, with a service-connecteddisability of at least 10% or more and who is a California resident; where at least [C] [M]
SOAP REST
Disabled-OwnedBusinessIndicator
When 'true' indicates that a business is a least 51% owned by one or more disabledpersons who control and operate the business. Control in this context means exercisingthe power to make policy decisions and operate means to be actively involved [C] [M]
SOAP REST
DisadvantagedBusinessEnterpriseIndicator
When 'true' indicates a business that is certified by a federal, state or local governmentagency as having met all of the government standards that award eligibility, but mayinclude women, minority, disabled and other disadvantaged as a result of economicdisadvantages with respect to education, employment, residence or business location orsocial disadvantage and lack of business training. [C] [M]
SOAP REST
DisadvantagedVeteranEnterpriseIndicator
When 'true' indicates that the business entity is owned and controlled by DisadvantagedVeterans. Can repeat up to two times. [C] [M]
SOAP REST
HUB ZoneCertifiedBusinessIndicator
When 'true' indicates that this organization is certified by the US Small BusinessAdministration as being a recipient of the Historically Underutilized Business (HUB) Zoneprogram. [C] [M]
SOAP REST
Labor SurplusArea Indicator
When 'true' indicates that this organization is certified as a business that operates in alabor surplus area, which is a geographical area identified by the Department of Labor asan area of concentrated unemployment or underemployment or an area of labor [C] [M]
SOAP REST
D&B Direct API Documentation Business Elements
©Dun & Bradstreet, Inc. 2014 18
Name Description XML* JSON*
MinorityBusinessEnterpriseIndicator
When 'true' indicates that a business is certified by a federal, state or local governmentagency through an application and/or premise visit process as having met all of thegovernment standards and requirements. Can repeat up to five times. [C] [M]
SOAP REST
MinorityCollegeIndicator
When 'true' indicates that this organization is a college or university where the profile ofthe majority of students is of minority ethnicity. [C] [M]
SOAP REST
MinorityOwnedIndicator
When 'true' indicates that this organization is certified as a business that is greater than50% owned by and whose management and daily business operations are controlled byone or more minority group members. [C] [M]
SOAP REST
Out ofBusinessIndicator
Text that records the operating status of the business. [C] SOAP REST
PoliticalDistrict
Text recording a distinct territorial subdivision for holding a separate election for one ormore seats in a legislative body to which this address belongs. In the U.S. this is anumber. In the U.K. this is text that describes the U.K. Constituency. [C] [M+]
SOAP REST
ServiceDisabledVeteranOwnedIndicator
When 'true' indicates that a business is at least 51% owned by one or more veteranswith a disability that is service connected. The term “service connected” means, withrespect to disability, that such disability was incurred or aggravated, in the line of duty inthe active military, naval or air service. (38 U.S.C. ‘101(16)). Can repeat up to two times.[C] [M]
SOAP REST
SmallBusinessIndicator
When 'true' indicates that the subject qualifies as small business, eligible for assistancefrom SBA, with a place of business located in the United States. It must operate primarilywithin the United States or make a significant contribution to the U.S. economy throughpayment of taxes or use of American products, materials or labor. Together with itsaffiliates, it must meet the numerical size standards as defined in the Small BusinessSize Regulations 13 CFR 121. [C] [M]
SOAP REST
SmallDisadvantagedBusinessIndicator
When 'true' indicates that this organization is certified as a business that is greater than50% owned by and whose management and daily business operations are controlled bysocially and economically disadvantaged persons. [C] [M]
SOAP REST
VeteranBusinessEnterpriseIndicator
When 'true' indicates whether Small Business Concerns are owned and controlled byveterans not less than 51% owned by one or more veterans and in the case of a publiclyowned business not less than 51% of the stock is owned by one or more veterans. Can r[C]
SOAP REST
VeteranOwnedIndicator
When 'true' indicates that the business entity is owned and controlled by a Veteran. [C][M]
SOAP REST
VietnamVeteranOwnedIndicator
When 'true' indicates whether a business is a least 51% owned by one or more VietnamVeterans who served between 1/1/59 and 5/7/75 and have control and operate thebusiness. Can repeat up to two times. [C] [M]
SOAP REST
D&B Direct API Documentation Business Elements
©Dun & Bradstreet, Inc. 2014 19
Name Description XML* JSON*
Woman-OwnedBusinessEnterpriseIndicator
When 'true' indicates whether a business is certified by a federal, state or localgovernment agency as having met all of the government standards and requirements.Can repeat up to five times. [C] [M]
SOAP REST
Woman-OwnedIndicator
When 'true' indicates that this organization is certified as a business that is greater than50% owned by and whose management and daily business operations are controlled byone or more female persons. The percentage of ownership requirement may [C] [M]
SOAP REST
*The links in this column provide the technical characteristics for the data field of the respective business element in the
XML or JSON response.
The preceding list is not presented in the order, nor manner, in which the information is packaged anddelivered via the D&B Direct API.
While data for a particular company may not contain values for all of the business elements, there may beitems that are considered by D&B to be essential to yield the maximum benefit of a data layer. If any of theseessential elements do not contain a value for a particular company, an error code will be returned, and yourorganization will not incur a usage credit for the request.
The Product Availability Lookup feature may be utilized to determine if this D&B Direct product is availablefor a given D-U-N-S Number.
Additional Details
Access to this information is provided on a metered basis; and will require data layer entitlement prior to usein the production environment. A built-in feature exists to prevent duplicate billing when multiple requestswith the same D-U-N-S Number and product code are submitted on the same calendar day (which is based onEastern Standard Time [GMT-5]).
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.
Related Topics
Diversity Indicators - Enhanced.
Technical Specification
For details on how to obtain this data layer, please refer to the Firmographic.OrderProduct (SOAP) orFirmographic.OrderProduct (REST) page.
D&B Direct API Documentation Additional Details
©Dun & Bradstreet, Inc. 2014 20
Detailed Company Profile - PremiumThe most efficient way to gain basic marketing information about a potential prospect such as businessname, address, D&B® D-U-N-S® Number, fax, phone and trade style. Includes business intelligence such asexecutive names and titles, financials, number of employees, import or export code, branch indicator, andmore.
Requirements & Options
When requesting this D&B Direct product, a valid D-U-N-S Number for a company, its country code, and theappropriate product code will be required. If this information is not available, refer to obtaining a company D-U-N-S Number for assistance. A trade up option exists to request data for the headquarters when therequested organization is a branch.
When ordering information for organizations located in Germany, customers are required to provide a validorder reason code. A list of possible values is included on the respective SOAP or REST operation page.
Note: The product code for Detailed Company Profile - Premium is DCP_PREM. This product may beincluded in the Monitoring process.
Data Privacy
This product returns information that, in some jurisdictions, is considered personally identifiable information(PII). D&B customers that are entitled to request this product (and any third-parties that may be assisting withtheir implementation) are bound to the data privacy terms specified in the D&B Direct agreement.
Business Elements
The following table is an alphabetical list of the unique items delivered in this data layer. Legend: [C] = maybe included in a Custom Data product; [M] = may be referenced by the Monitoring process; [M+] = Monitoredusing an aggregate or attribute XPath.
Note: This product will 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, et al.)along with the business elements listed. In addition, customers who compare the following table to theData Primer should be advised of several intentional differences.
D&B Direct API Documentation Detailed Company Profile - Premium
©Dun & Bradstreet, Inc. 2014 21
Name Description XML* JSON*
AccountantName
Text recording the name of either an individual or the name of an accounting firm. [M+] SOAP REST
AgentIndicator
When 'true' indicates that the subject acts as an agent promoting the goods or servicesof another organization, e.g., Sales Agent, Purchasing Agent. When 'false' indicates thatthe subject does not act as an agent of another organization. [M]
SOAP REST
Asset ArticleQuantity
A number specifying how many of this particular asset type are held, owned, or managedby the subject. [M]
SOAP REST
Bank Name Text recording the name of the banking organization with whom the business subjectmaintains an account. [M]
SOAP REST
Best FEINIndicator
For companies that may be associated with multiple FEIN numbers, this field (when setto 1) identifies the FEIN records that are considered by D&B to be the most relevant forthis subject.
SOAP REST
BoneyardOrganizationIndicator
When 'true' indicates that data on the company is no longer collected and was coveredby Hoover's Editorial staff before being acquired or going out of business. [M]
SOAP REST
Business LegalStructure
Text that describes the legal form or structure of a business, as registered withgovernment authorities, e.g., partnership, corporation, private limited company,government department, proprietorship. [M+]
SOAP REST
CompanyPrincipalBonusAmount
Bonus for the year, in requested currency. [M+] SOAP REST
CompanyPrincipalCompensationYear
Year of the current compensation details. [M+] SOAP REST
CompanyPrincipal FirstName
Text recording the first name of the principal. [M+] SOAP REST
CompanyPrincipal FullName
Text recording the complete name of an individual who is primarily responsible for thedecisions that drive the business. [M]
SOAP REST
CompanyPrincipalIdentificationNumber
A number assigned by an external body or by D&B which either uniquely identifies orhelps to identify the principal.
SOAP REST
CompanyPrincipal JobTitle
Text recording the job held by the principal or manager. E.g. e.g., Leader GlobalCommunication, Manager National Technical Support Center. [M]
SOAP REST
CompanyPrincipal LastName
Text recording the last name of the principal. [M+] SOAP REST
D&B Direct API Documentation Business Elements
©Dun & Bradstreet, Inc. 2014 22
Name Description XML* JSON*
CompanyPrincipalMiddle Name
Text recording the middle name of the principal. [M+] SOAP REST
CompanyPrincipalName Prefix
Text that describes the correct form of address for this principal. For example, Dr.,Professor, Lord, etc. [M+]
SOAP REST
CompanyPrincipalName Suffix
Text recording a familial suffix to the principal's name (e.g. Senior, Junior, III. ) or aprofessional/qualification suffix to the principal's name (e.g. MD, PhD etc.) or some othersuffix to the principals name (e.g. Retired). [M+]
SOAP REST
CompanyPrincipalSalaryAmount
Salary for the year, excluding bonus, in requested currency [M+] SOAP REST
CompanyPrincipal TotalSalary
Total compensation for the year, including any bonus or other compensation, inrequested currency [M+]
SOAP REST
CompetitorOrganizationCompanyName
Text recording the Primary Company Name of the Competitor. SOAP REST
CompetitorOrganizationEmployeeQuantity
The number of people that are employed the competitor. [M+] SOAP REST
CompetitorOrganizationMarket ShareCapital
A monetary figure specifying the total value of issued shares of a publicly tradedcompany, it is equal to the share price times the number of shares outstanding. [M+]
SOAP REST
CompetitorOrganizationSales Revenue
A monetary figure that is the competitor's amount of revenue or sales claimed in theincome statement data in millions (USD). [M]
SOAP REST
ContinentCode (WorldRegion 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+]
SOAP REST
Control Year The year current control was assumed. [M] SOAP REST
D&B HooversIndustry Code
An alphanumeric industry code identifying a business activity, based on a three-tiertaxonomy developed by D&B as a complement to NAICS and SIC codes, that are assignedaccording to companies’ primary and secondary business activities.
SOAP REST
D&B HooversIndustry CodeDescription
Text that describes the business activity based on the scheme specified by the attributetype.
SOAP REST
D&B IndustryCode
An alphanumeric value identifying a business activity based on the scheme specified bythe Standard Industrial Classification (SIC) Code. The first four digits are external codescreated by the U.S. Government. D&B has created extensions to more precisely define anactivity as in the case of the SIC 2+2 (the last 4 digits of an 8-digit SIC).
SOAP REST
D&B Direct API Documentation Business Elements
©Dun & Bradstreet, Inc. 2014 23
Name Description XML* JSON*
D&B IndustryCodeDescription
Text that describes the business activity based on the scheme specified by the attributetype, e.g., 'highway and street construction' is the description of industry code 1611 inthe U.S. SIC (Standard Industrial Classification) system.
SOAP REST
DomesticUltimateBusinessName
Text recording the name of the highest business in the family tree that is in the samecountry as the subject.
SOAP REST
DomesticUltimateCountry Code
The two-letter country code, defined by the International Organization forStandardization (ISO) ISO 3166-1 scheme identifying the country of the domesticultimate. [M+]
SOAP REST
DomesticUltimate D-U-N-S Number
The D-U-N-S Number of the highest level parent within a corporate family tree that isdomiciled in the same country as the requested company. A parent is a corporation thatowns more than 50% of another corporation's capital stock. A subject may be its owndomestic ultimate.
SOAP REST
DomesticUltimatePostal Code
An identifier used by the local country postal authority to identify where the domesticultimate is located. [M+]
SOAP REST
DomesticUltimateStreet Address
Text recording the address number, or post office box number and street name wherethe domestic ultimate is located. [M+]
SOAP REST
DomesticUltimateTerritoryAbbreviatedName
Text recording the shortened name of the locally governed area which forms part of acentrally governed nation to identify where the domestic ultimate is located. [M+]
SOAP REST
DomesticUltimateTerritoryName
Text recording the name of the locally governed area which forms part of a centrallygoverned nation to identify where the domestic ultimate is located.
SOAP REST
DomesticUltimateTown Name
Text recording the name of a city, town, township, village, borough, etc. where thedomestic ultimate is located. [M+]
SOAP REST
D-U-N-SNumberTransfer Date
The date associated with the most recent retirement of a D-U-N-S Number affecting thissubject. When included in a monitoring notice, the Retained D-U-N-S Number should beused for subsequent requests. When included in a product response, the Previous D-U-N-S Number is provided for reference purposes.
SOAP REST
D-U-N-SNumberTransferReason 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 forsubsequent requests. When included in a product response, the Previous D-U-N-SNumber is provided for reference purposes.
SOAP REST
D-U-N-S SelfRequest Date
The date on which the DUNS was created as a result of a Self Request. (Data onlyavailable from 1997).
SOAP REST
D&B Direct API Documentation Business Elements
©Dun & Bradstreet, Inc. 2014 24
Name Description XML* JSON*
D-U-N-S SelfRequestIndicator
When 'true' indicates that the D-U-N-S Number for this subject was created at therequest of the subject. When 'false' indicates that the D-U-N-S Number for this subjectwas not created at the request of the subject; however, as this is the assumed conditionthere is no requirement to create this tag to represent this fact.
SOAP REST
EmployeeQuantity (AllLocations)
A number that defines how many people are directly engaged and paid by theorganization to perform or support its business operations. [M]
SOAP REST
EmployeeQuantity BasisText
Text that indicates when it has been reported to D&B that certain types of employeeshave been included in the calculation of the Employee Quantity. [M+]
SOAP REST
EmployeeQuantityGrowth Rate
The annual rate at which total number of employees in a firm's has been or is expectedto grow. [M]
SOAP REST
EmployeeQuantityReliability Text(All Locations)
Text that describes the integrity of the employee figures, e.g. audited, actual, estimated,or modeled. [M+]
SOAP REST
EmployeeQuantityReliability Text(SingleLocation)
Text that describes the integrity of the employee figures, e.g. audited, actual, estimated,or modeled. [M+]
SOAP REST
ExportIndicator
When 'true' indicates that the subject company exports goods to other countries. [M] SOAP REST
FEINAssignmentMethod
Text that identifies how the inquiry DUNS was assigned based on a direct source such asan Agency or if assigned based on the branch process which utilizes the HQ linkage toassign the HQ FEIN to each Branch.
SOAP REST
FEIN CollectionDate
The date the FEIN information was received. SOAP REST
FEIN Issuer D-U-N-S Number
The DUNS Number assigned to the entity that provided the FEIN number to D&B. SOAP REST
FEIN IssuerOrganizationName
Text recording the name of the entity that provided the FEIN Number to D&B. SOAP REST
FEINRegistrationBusinessName
Text recording the filing name for the unique nine-digit number assigned by the U.S.Internal Revenue Service to business entities (and in some cases individuals) operating inthe United States for the purposes of conducting business.
SOAP REST
FEINRegistrationPostal Code
An identifier used by the local country postal authority to identify where theidentification number provider is located.
SOAP REST
FEINRegistrationStreet Address
Text that records the street address components as it would be presented on an addresslabel. This includes, but is not limited to, details such as street name, street number,building name, estate name.
SOAP REST
D&B Direct API Documentation Business Elements
©Dun & Bradstreet, Inc. 2014 25
Name Description XML* JSON*
FEINRegistrationTerritoryName
Text recording the name of the territory or state where the entity which provided theFEIN Number to D&B is located
SOAP REST
FEINRegistrationTown Name
Text recording the mailing address town or city name that is recorded in the FEINregistration.
SOAP REST
FEIN Tax IDNumber
A number recording a unique nine-digit FEIN number assigned by the U.S. InternalRevenue Service to business entities (and in some cases individuals) operating in theUnited States for the purposes of identification.
SOAP REST
FinancialStatementCurrency
The three-letter code, published by International Organization for Standardization (ISO),identifying the type of money that corresponds to the values in the financial statement.
SOAP REST
FinancialStatementDate
The date when the accounting period ended. If the accounting figures are projected(future), then this is the date when the accounting period will end. [M+]
SOAP REST
FinancialStatementDate (KeyFinancialFigures)
The date or partial date (i.e. period showing year/month) when the accounting periodended. If the Reliability Code denotes the figures are projected (future) then this whenthe accounting period will end. [M]
SOAP REST
FinancialStatementPeriod
The period of the financial statement expressed as a number of years, months or days.(e.g. P3M is 3 months or quarterly, P1Y is 1 year or annual) [M+]
SOAP REST
FinancialStatementPeriod (KeyFinancialFigures)
The period of the financial statement expressed as a number of years, months or days.(e.g. P3M is 3 months or quarterly, P1Y is 1 year or annual) [M]
SOAP REST
FinancialStatementUnit of Size
Text which identifies the unit of size that corresponds to the values in the financialstatement.
SOAP REST
FormerBusinessName
Text recording the former business name. SOAP REST
FranchiseOperationType
Text that denotes whether the franchise rights are operated by a company or directly bythe franchisee; i.e. franchisee, franchisor. [M+]
SOAP REST
GeographicalPrecision Text
Text that identifies the accuracy of the match used for an address. [M+] SOAP REST
GlobalUltimateBusinessName
Text recording the primary name of the global ultimate business. SOAP REST
D&B Direct API Documentation Business Elements
©Dun & Bradstreet, Inc. 2014 26
Name Description XML* JSON*
GlobalUltimateCountry Code
The two-letter country code, defined by the International Organization forStandardization (ISO) ISO 3166-1 scheme identifying the country of the global ultimatebusiness entity. [M+]
SOAP REST
GlobalUltimate D-U-N-S Number
The D-U-N-S number of the highest level parent within a corporate family tree. A parentis a corporation that owns more than 50% of another corporation's capital stock. Asubject may be its own global ultimate. [M]
SOAP REST
GlobalUltimatePostal Code
An identifier used by the local country postal authority to identify where the globalultimate is located. [M+]
SOAP REST
GlobalUltimateStreet Address
Text recording the address number, or post office box number and street name wherethe global ultimate is located. [M+]
SOAP REST
GlobalUltimateTerritoryAbbreviatedName
Text recording the shortened name of the locally governed area which forms part of acentrally governed nation to identify where the global ultimate is located. [M+]
SOAP REST
GlobalUltimateTerritoryName
Text recording the name of the locally governed area which forms part of a centrallygoverned nation to identify where the global ultimate is located.
SOAP REST
GlobalUltimate TotalEmployeeQuantity
A number that defines how many people are directly engaged and paid by theorganization to perform or support its business operations. Includes employees in theentire global family tree, including all direct and indirect subsidiaries of the globalultimate parent company, and all branch and division locations.
SOAP REST
GlobalUltimateTown Name
Text recording the name of a city, town, township, village, borough, etc. where the globalultimate is located. [M+]
SOAP REST
HeadquarterCountry Code
The two-letter country code, defined by the International Organization forStandardization (ISO) ISO 3166-1 scheme identifying the country of the companyheadquarters. [M+]
SOAP REST
HeadquarterD-U-N-SNumber
The D-U-N-S Number of the headquarters company. A headquarters is a businessestablishment that has branches or divisions reporting to it. [M]
SOAP REST
HeadquarterPostal Code
An identifier used by the local country postal authority to identify where theheadquarters is located. [M+]
SOAP REST
HeadquarterStreet Address
Text recording the address number, or post office box number and street name wherethe headquarters is located. [M+]
SOAP REST
HeadquarterTerritoryAbbreviatedName
Text recording the shortened name of the locally governed area which forms part of acentrally governed nation to identify where the headquarters is located. [M+]
SOAP REST
HeadquarterTerritoryName
Text recording the name of the locally governed area which forms part of a centrallygoverned nation to identify where the headquarters is located.
SOAP REST
D&B Direct API Documentation Business Elements
©Dun & Bradstreet, Inc. 2014 27
Name Description XML* JSON*
HeadquarterTown Name
Text recording the name of a city, town, township, village, borough, etc. where theheadquarters is located. [M+]
SOAP REST
ImportIndicator
When 'true' indicates that the subject company imports a quantity of goods from othercountries. [M]
SOAP REST
IncorporationYear
The year the business incorporated - The year the business entity incorporated orregistered as the current legal structure. The Incorporation Year may or may not be thesame as the year the business started. [M]
SOAP REST
Industry CodePercentage ofSales
The value of annual sales which are attributable to the operations defined by IndustryCode Number as a percentage of total annual sales. Can repeat up to six times.
SOAP REST
Labor SurplusArea Indicator
When 'true' indicates that this organization is certified as a business that operates in alabor surplus area, which is a geographical area identified by the Department of Labor asan area of concentrated unemployment or underemployment or an area of labor [M]
SOAP REST
Last UpdateDate
The date when the record was last updated in D&B's system. [M] SOAP REST
Line ofBusiness
Text recording the description of the operations conducted by a business. [M+] SOAP REST
Local ActivityIndustry Code
Records the business activities in which an organization is actively engaged usingstandardized coding schemes such as European NACE and other country-specificClassification of Economic Activities.
SOAP REST
LocationOwnershipText
Text specifying the terms under which this subject occupies the premises (i.e., one ormore facilities) at the primary address, e.g., owned, rented or leased. [M+]
SOAP REST
MailUndeliverable(NIXIE)Indicator
When 'true' indicates that it is it is not possible to deliver mail to this address. When'false' indicates that mail to this address can be delivered; however, as this is theassumed condition there is no requirement to create this tag to represent this fact. [M+]
SOAP REST
MajorIndustryCategory
A narrative description of the operations or activities of the business. Relates to theprimary four-digit 1987 US SIC. In English.
SOAP REST
ManagementResponsibilityStart Year
The date when the principal or manager was appointed to this position. This is notnecessarily the date when the principal or manager was first employed by the subject;this is simply the date when they moved to this position, e.g. due to a promotion. [M+]
SOAP REST
MarketSegmentationClusters
The assigned Market Segmentation Cluster (MSC) values for this organization. MSCvalues represent 22 distinct mutually exclusive profiles resulting from a cluster analysisof U.S. D&B data. [M]
SOAP REST
Market ValueDate
The date on which the Capital Amount was first registered. SOAP REST
MarketabilityIndicator
When 'true' indicates that the record satisfies D&B marketability rules. When 'false'indicates that the record does not satisfy D&B marketability rules; however, there is norequirement to create this tag to represent this fact. [M]
SOAP REST
D&B Direct API Documentation Business Elements
©Dun & Bradstreet, Inc. 2014 28
Name Description XML* JSON*
MarketingPrescreenScore
Prescreen score is a D&B marketing tool that predicts the likelihood of a company’s abilityto pay all its bills on time over the next 12 months. Updated monthly, it shows thelikelihood that a company may become a collection problem. Scores are calculated usingstatistical models and the most recent payment information in D&B’s commercialdatabase. It is intended to be a marketing tool and should not be used for credit decisionson individual organizations. [M+]
SOAP REST
MetropolitanStatisticalArea Code
A code describing a geographical region with a relatively high population density at itscore and close economic ties throughout the area. [M+]
SOAP REST
MinorityOwnedIndicator
When 'true' indicates that this organization is certified as a business that is greater than50% owned by and whose management and daily business operations are controlled byone or more minority group members. [M]
SOAP REST
Most SeniorPrincipal Age
A number recording the age of the most senior principal in years. [M+] SOAP REST
Most SeniorPrincipalBonus
Bonus of the most senior principal for the year, in requested currency. [M+] SOAP REST
Most SeniorPrincipalCompensationYear
Year of the current compensation details. [M+] SOAP REST
Most SeniorPrincipal FirstName
Text recording the first name of the most senior principal. [M+] SOAP REST
Most SeniorPrincipal FullName
Text recording the name of the CEO. [M+] SOAP REST
Most SeniorPrincipalIdentificationNumber
A number assigned by an external body or by D&B which either uniquely identifies orhelps to identify the individual who is the most senior principal at this organization.
SOAP REST
Most SeniorPrincipal JobTitle
Text recording the job held by the most senior principal; For example, CEO, President andCEO. [M+]
SOAP REST
Most SeniorPrincipal LastName
Text recording the last name of the most senior principal. [M+] SOAP REST
Most SeniorPrincipalManagementResponsibility
Text identifying the business function of the principal derived from a standardManagement Responsibility Code (MRC). [M+]
SOAP REST
D&B Direct API Documentation Business Elements
©Dun & Bradstreet, Inc. 2014 29
Name Description XML* JSON*
Most SeniorPrincipalManagementResponsibilityStart Date
The date when the principal or manager was appointed to this position. This is notnecessarily the date when the principal or manager was first employed by the subject;this is simply the date when they moved to this position, e.g. due to a promotion. [M+]
SOAP REST
Most SeniorPrincipalMiddle Name
Text recording the middle name of the most senior principal. [M+] SOAP REST
Most SeniorPrincipalSalary
Salary of the most senior principal the year, excluding bonus, in requested currency. [M+] SOAP REST
Most SeniorPrincipal TotalSalary
Total compensation of the most senior principal for the year, including any bonus orother compensation, in requested currency [M+]
SOAP REST
NAICS Code An alphanumeric value identifying the business activity based on the NAICS Code. Canrepeat multiple times.
SOAP REST
NAICS CodeDescription
Text that describes the business activity based on the scheme specified by the attributetype, e.g., 'highway and street construction' is the description of industry code 1611 inthe U.S. SIC (Standard Industrial Classification) system.
SOAP REST
NonMarketableReason Text
Text specifying the reason why the subject's data is not considered marketable by D&B.[M+]
SOAP REST
Non-PostalTown
Text recording the name of a village, town or suburb where this is not a PrimaryTown/City. For example, 'Booker' in Booker, High Wycombe. [M+]
SOAP REST
Number ofFamilyMembersIncludingSubsidiaries
This is the number of linkages in the upward and downward directions of the entirefamily tree that the subject belongs to, starting from the global ultimate.
SOAP REST
OperatingStatusComment
Free form text which records the summary of the company's trading status. [M] SOAP REST
OperationsText
Text that describes detailed information regarding a business operation. [M] SOAP REST
OrganizationHistory Text
Text that indicates if D&B has any information that may reflect unfavorably on thisorganization, e.g. clear, incomplete, management and business.
SOAP REST
OrganizationIdentificationNumber
A number assigned by an external body or by D&B which either uniquely identifies orhelps to identify an organization.
SOAP REST
OrganizationStart Year
The year when operations undertaken by the organization commenced. [M] SOAP REST
OrganizationSummaryText
Text that records a brief statement or account of this organization. [M] SOAP REST
D&B Direct API Documentation Business Elements
©Dun & Bradstreet, Inc. 2014 30
Name Description XML* JSON*
OtherPrincipal Age
A number recording the age of the principal in years. [M+] SOAP REST
OtherPrincipalManagementResponsibility
Text identifying the business function of the principal derived from a standardManagement Responsibility Code (MRC). [M+]
SOAP REST
Out ofBusinessIndicator
Text that records the operating status of the business. [M+] SOAP REST
OwnershipControl Type
Text that describes the type of controlling ownership e.g. publicly owned, privatelyowned, state owned. [M+]
SOAP REST
OwnershipEthnicity Type
Text that records the racial, national, tribal, or cultural classifications that are applied toan organization based on the ethnicity of a majority of its ownership. [M+]
SOAP REST
ParentBusinessName
Text recording the business name of the parent company. A parent is a corporation thatowns more than 50% of another corporation's capital stock; these owned companies aresubsidiaries to the parent company.
SOAP REST
ParentCountry Code
The two-letter country code, defined in the ISO 3166-1 scheme published by InternationalOrganization for Standardization (ISO) identifying the country of the parent organization.[M+]
SOAP REST
Parent D-U-N-S Number
The D-U-N-S number of the parent company. A parent is a corporation that owns morethan 50% of another corporation's capital stock; these owned companies are subsidiariesto the parent company.
SOAP REST
Parent PostalCode
An identifier used by the local country postal authority to identify where the parentcompany is located. [M+]
SOAP REST
Parent StreetAddress
Text recording the address number, or post office box number and street name wherethe parent company is located. [M+]
SOAP REST
ParentTerritoryAbbreviatedName
Text recording the shortened name of the locally governed area which forms part of acentrally governed nation to identify where the parent company is located. [M+]
SOAP REST
ParentTerritoryName
Text recording the name of the locally governed area which forms part of a centrallygoverned nation to identify where the parent company is located.
SOAP REST
Parent TownName
Text recording the name of a city, town, township, village, borough, etc. where theparent company is located. [M+]
SOAP REST
Premises AreaMeasurement
Text that records the measurement of the premises. [M+] SOAP REST
Premises AreaMeasurementReliability Text
Text that describes the accuracy of the measurement found in Premises AreaMeasurement; e.g., actual, estimated, modeled. [M+]
SOAP REST
Premises AreaUnit ofMeasurement
Text that records the measurement unit used to express the Premises AreaMeasurement; e.g. acre, square meters, square feet. [M+]
SOAP REST
D&B Direct API Documentation Business Elements
©Dun & Bradstreet, Inc. 2014 31
Name Description XML* JSON*
PremisesFunction Text
Text specifying an activity that is performed or is not performed at this facility by thesubject, e.g., manufacturing, warehousing, printing, packaging, office work. [M+]
SOAP REST
Previous D-U-N-S Number(Transfer)
The most recently retired D-U-N-S Number that is associated with this subject, often as aredundant record. An explanation for this change is provided in the transfer reason. [M+]
SOAP REST
PreviousEmployeeQuantity (AllLocations)
A number that defines how many people are directly engaged and paid by theorganization to perform or support its business operations as reported to D&B inaprevious period. [M]
SOAP REST
PreviousEmployeeQuantity(SingleLocation)
A number that defines how many people are directly engaged and paid by theorganization to perform or support its business operations at the subject's location asreported to D&B in a previous period. [M]
SOAP REST
PreviousEmployeeQuantityReliability Text(All Locations)
Text that describes the integrity of the employee figures e.g. audited, actual, estimated,modeled. [M+]
SOAP REST
PreviousEmployeeQuantityReliability Text(SingleLocation)
Text that describes the integrity of the employee figures e.g. audited, actual, estimated,modeled. [M+]
SOAP REST
PrimaryAddressLatitude
The angular distance of the organization's primary physical address north or south fromthe Earth's equator measured through 90 degrees expressed in decimal numbers. [M+]
SOAP REST
PrimaryAddressLongitude
The angular distance of the organization's primary physical address east or west from animaginary line (called the prime meridian) that goes from the North Pole to the SouthPole measured through 90 degrees expressed in decimal numbers. [M+]
SOAP REST
Primary SICCode
The first listed alphanumeric value identifying the primary business activity based on thescheme specified by the Standard Industrial Classification (SIC) Code. The first four digitsare external codes created by the U.S. Government. D&B has created extensions to moreprecisely define an activity as in the case of the SIC 2+2 (the last 4 digits of an 8-digit SIC).
SOAP REST
Primary SICDescription
Text that describes the business activity based on the scheme specified by the attributetype, e.g., 'highway and street construction' is the description of industry code 1611 inthe U.S. SIC (Standard Industrial Classification) system.
SOAP REST
Primary StockExchangeIndicator
When 'true' indicates that this is the most important stock exchange among all the stockexchanges where this subject's shares are traded. When 'false' indicates that this is notthe most important stock exchange among all the stock exchanges where this subject'sshares are traded; however, as this is the assumed condition there is no requirement tocreate this tag to represent this fact. [M+]
SOAP REST
Profit or LossAmount
A monetary figure that shows the difference between sales revenue and cost of salesbefore the deduction of selling, distribution, administration and other costs. [M]
SOAP REST
D&B Direct API Documentation Business Elements
©Dun & Bradstreet, Inc. 2014 32
Name Description XML* JSON*
Profit or LossGrowth Rate
The rate of change in the difference between sales revenue and cost of sales before thededuction of selling, distribution, administration and other costs. [M]
SOAP REST
RegisteredAddressIndicator
When 'true' indicates that the Primary Address which has been presented is also theRegistered Address. When 'false' indicates that the Primary Address which has beenpresented is not a Registered Address. [M+]
SOAP REST
RegistrationNumber - AllCountriesExcept US
A registration/identifier number assigned by local government agencies to identify abusiness within the local market. Examples include the France Siret Number, UK CRONumber, Europe VAT Number, Australia Company Number, and Brazilian State RegistryNumber.
SOAP REST
ResidentialAddressIndicator
When 'true' indicates that the Primary Address which has been presented is also theResidential Address. When 'false' indicates that the Primary Address which has beenpresented is not a Residential Address. [M+]
SOAP REST
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 theD-U-N-S Number to reference for future product requests. An explanation for thischange is provided in the transfer reason.
SOAP REST
Revenue PerShare
A number expressing proportionally what one or more of the business' financial figuresis in relation to one or more of the business' other financial figures. This figure is anindicator used to evaluate the business' financial condition or potential risk. [M+]
SOAP REST
Sales RevenueAmount
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 onto the customer. [M]
SOAP REST
SalesTurnoverGrowth Rate
The amount by which sales turnover increases over a given period of time as apercentage of its previous value. [M]
SOAP REST
Secondary SICCode
An alphanumeric value identifying a business activity based on the scheme specified bythe Standard Industrial Classification (SIC) Code. Clarification Note: These are generallyexternal codes created by an external authoritative body like the U.S. Office ofManagement and Budget but D&B may have created extensions to more preciselydefine an activity as in the case of the SIC 2+2 (the last 4 digits of an 8-digit SIC). Canrepeat up to five times.
SOAP REST
Secondary SICDescription
Text that describes the business activity based on the scheme specified by the attributetype, e.g., 'highway and street construction' is the description of industry code 1611 inthe U.S. SIC (Standard Industrial Classification) system.
SOAP REST
Share CapitalAmount
A monetary value representing the amount of Share Capital. Calculation is Price X TotalShares Outstanding.
SOAP REST
SmallBusinessIndicator
When 'true' indicates that the subject qualifies as small business, eligible for assistancefrom SBA, with a place of business located in the United States. It must operate primarilywithin the United States or make a significant contribution to the U.S. economy throughpayment of taxes or use of American products, materials or labor. Together with itsaffiliates, it must meet the numerical size standards as defined in the Small BusinessSize Regulations 13 CFR 121. [M]
SOAP REST
StockExchangeCountry Code
The two-letter country code, defined by the International Organization forStandardization (ISO) ISO 3166-1 scheme identifying the country for this stock exchange.[M+]
SOAP REST
D&B Direct API Documentation Business Elements
©Dun & Bradstreet, Inc. 2014 33
Name Description XML* JSON*
StockExchangeName
Text recording the name of the Stock Exchange on which the subject's shares aretraded. [M+]
SOAP REST
Stock TickerName
Text that identifies the subject at the Stock Exchange for share trading purposes, e.g.,DNB. [M+]
SOAP REST
SubjectHandling Text
Text specifying the manner in which the subject is to receive special care from D&Bwhen it is being contacted; e.g. do not call or do not send information requests. In manycases this process was specifically requested by the subject. [M+]
SOAP REST
TelephoneDisconnected(TIXIE)Indicator
When 'true' indicates that telecommunication number cannot be connected tosuccessfully. When 'false' indicates that telecommunication number can be connectedto successfully. When set to NULL, it indicates that D&B does not know whether thetelecommunication number can be connected to successfully.
SOAP REST
Third PartyAssessment
An alpha code assigned by a third party to define the kind of appraisal/opinion that wasassigned to this subject by the third party, e.g. Moody's Long Term Obligation Rating, FICOscore, Vantage Score. [M+]
SOAP REST
Third PartyAssessmentRank
Company's rank on a ranking list, such as number 100 on the Fortune 500 [M+] SOAP REST
Total Assets A monetary figure representing the sum of all the business's assets listed on the balancesheet. [M+]
SOAP REST
Total EquityAmount
The total value of share capital/stock originally invested by shareholders/stockholdersplus any reserves which have arisen, such as retained profits, which are ploughed backinto the firm. Also known as Net Worth. [M+]
SOAP REST
UK SIC Code The first listed alphanumeric value identifying the primary business activity based on theUK SIC Code.
SOAP REST
Web SiteAddress
The Internet URL (Uniform Resource Locator) which uniquely identifies the proprietarywebsite of the subject or the website preferred by the subject which gives moreinformation on the subject. [M]
SOAP REST
Woman-OwnedIndicator
When 'true' indicates that this organization is certified as a business that is greater than50% owned by and whose management and daily business operations are controlled byone or more female persons. The percentage of ownership requirement may
SOAP REST
*The links in this column provide the technical characteristics for the data field of the respective business element in the
XML or JSON response.
The preceding list is not presented in the order, nor manner, in which the information is packaged anddelivered via the D&B Direct API.
While data for a particular company may not contain values for all of the business elements, there may beitems that are considered by D&B to be essential to yield the maximum benefit of a data layer. If any of theseessential elements do not contain a value for a particular company, an error code will be returned, and yourorganization will not incur a usage credit for the request.
D&B Direct API Documentation Business Elements
©Dun & Bradstreet, Inc. 2014 34
The Product Availability Lookup feature may be utilized to determine if this D&B Direct product is availablefor a given D-U-N-S Number.
SIC Codes
SIC stands for Standard Industrial Classification. The idea of coding and classifying industries to help analyzeindustrial structure was first developed by the U.S. Government in the 1930’s. The Standard IndustrialClassification (SIC) System has been widely adopted as the standard coding system used to define and analyzeindustry structure.
D&B assigns SIC’s at the eight-digit level and can include up to six base (four-digit, which are defined by theGovernment) SIC’s with up to four, four-digit extensions for each, for a maximum total of twenty-fourseparate lines of business per record to identify what a business does.
Market Segmentation Clusters
The following are high level descriptions of the market segmentation cluster values delivered in this datalayer:
l 1 = High Tension Branches of Insurance/Utility Industriesl 2 = Bustling Manufacturers & Business Servicesl 3 = The Withering Branch Companyl 4 = Rapid Growth Large Businessesl 5 = Sunny Branches of Insurance/Utility Industriesl 6 = Labor Intensive Giantsl 7 = Entrepreneur & Co.l 8 = Frugal & Associatesl 9 = Spartansl 10 = Struggling Start Upsl 11 = The Hectic Venture Companyl 12 = The Established Shingle Companyl 13 = Industry Inc.l 14 = Landmark Business Servicesl 15 = The Test Of Time Companyl 16 = Powerhouse 6000l 17 = In Good Handsl 18 = Sudden Growth Giantsl 19 = Active Tradersl 20 = Old Core Proprietorsl 21 = Solid & Sonsl 22 = Main Street USA
D&B Direct API Documentation Business Elements
©Dun & Bradstreet, Inc. 2014 35
Third Party Assessment Rank
The following is a list of possible assessment types:
l Amsterdam Exchange 25l ASX 50 (September 2013)l BEL20l CAC 40l CAC Mid 60l DAX 30l Dow Jones Global Titansl Dow Jones Industrialsl Dow Jones Transportsl Dow Jones Utilitiesl Euronext 100l Forbes Largest Private Companies (November 2012)l FORTUNE 1000 (May 2013)l FORTUNE 500 (May 2013)l FORTUNE's Fastest-Growing Companies (September 2013)l FT Global 500 (July 2013)l FTSE 100l FTSE 250l Hang Sengl IBEX 35l LuxXl Madrid Generall MDAXl Mexican Bolsal MIBl Nikkei 225l Russell 2000 (June 2013)l S&P 500 (September 30, 2013)l S&P 600 (September 30, 2013)l SBF 120l SENSEXl STOXX Europe 50l Straits Timesl Swiss Marketl TecDAXl TSX 60l TSX Completionl TSX Smallcap
D&B Direct API Documentation Business Elements
©Dun & Bradstreet, Inc. 2014 36
Additional Details
There are two varieties of this product: Marketing and Risk (referred to as Alternative). They both offer similarbusiness elements; however, there may be differences in the availability of data for certain countries. The dataprovided in the Risk version may also be updated more frequently, making it the preferred source when it isavailable for a given country.
The results from this product will include principal identification numbers (Principal ID) that may be passed tothe People feature to obtain additional information about individuals.
Access to this information is provided on a metered basis; and will require data layer entitlement prior to usein the production environment. A built-in feature exists to prevent duplicate billing when multiple requestswith the same D-U-N-S Number and product code are submitted on the same calendar day (which is based onEastern Standard Time [GMT-5]).
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.
Related Topics
Detailed Company Profile- Enhanced, Detailed Company Profile - Standard, Alternative Detailed CompanyProfile.
Technical Specification
For details on how to obtain this data layer, please refer to the Firmographic.OrderProduct (SOAP) orFirmographic.OrderProduct (REST) page.
D&B Direct API Documentation Additional Details
©Dun & Bradstreet, Inc. 2014 37
Detailed Company Profile - EnhancedThe most efficient way to gain basic marketing information about a potential prospect such as businessname, address, D&B® D-U-N-S® Number, fax, phone and trade style. Includes business intelligence such asexecutive names and titles, financials, number of employees, import or export code, branch indicator, andmore.
Requirements & Options
When requesting this D&B Direct product, a valid D-U-N-S Number for a company, its country code, and theappropriate product code will be required. If this information is not available, refer to obtaining a company D-U-N-S Number for assistance. A trade up option exists to request data for the headquarters when therequested organization is a branch.
When ordering information for organizations located in Germany, customers are required to provide a validorder reason code. A list of possible values is included on the respective SOAP or REST operation page.
Note: The product code for Detailed Company Profile - Enhanced is DCP_ENH. This product may beincluded in the Monitoring process.
Data Privacy
This product returns information that, in some jurisdictions, is considered personally identifiable information(PII). D&B customers that are entitled to request this product (and any third-parties that may be assisting withtheir implementation) are bound to the data privacy terms specified in the D&B Direct agreement.
Business Elements
The following table is an alphabetical list of the unique items delivered in this data layer. Legend: [C] = maybe included in a Custom Data product; [M] = may be referenced by the Monitoring process; [M+] = Monitoredusing an aggregate or attribute XPath.
Note: This product will 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, et al.)along with the business elements listed. In addition, customers who compare the following table to theData Primer should be advised of several intentional differences.
D&B Direct API Documentation Detailed Company Profile - Enhanced
©Dun & Bradstreet, Inc. 2014 38
Name Description XML* JSON*
AccountantName
Text recording the name of either an individual or the name of an accounting firm. [M+] SOAP REST
AgentIndicator
When 'true' indicates that the subject acts as an agent promoting the goods or servicesof another organization, e.g., Sales Agent, Purchasing Agent. When 'false' indicates thatthe subject does not act as an agent of another organization. [M]
SOAP REST
Asset ArticleQuantity
A number specifying how many of this particular asset type are held, owned, or managedby the subject. [M]
SOAP REST
Best FEINIndicator
For companies that may be associated with multiple FEIN numbers, this field (when setto 1) identifies the FEIN records that are considered by D&B to be the most relevant forthis subject.
SOAP REST
BoneyardOrganizationIndicator
When 'true' indicates that data on the company is no longer collected and was coveredby Hoover's Editorial staff before being acquired or going out of business. [M]
SOAP REST
BusinessLegalStructure
Text that describes the legal form or structure of a business, as registered withgovernment authorities, e.g., partnership, corporation, private limited company,government department, proprietorship. [M+]
SOAP REST
CompanyPrincipal FullName
Text recording the complete name of an individual who is primarily responsible for thedecisions that drive the business. [M]
SOAP REST
CompanyPrincipalIdentificationNumber
A number assigned by an external body or by D&B which either uniquely identifies orhelps to identify the principal.
SOAP REST
CompanyPrincipal JobTitle
Text recording the job held by the principal or manager. E.g. e.g., Leader GlobalCommunication, Manager National Technical Support Center. [M]
SOAP REST
ContinentCode (WorldRegion 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+]
SOAP REST
Control Year The year current control was assumed. [M] SOAP REST
D&B HooversIndustry Code
An alphanumeric industry code identifying a business activity, based on a three-tiertaxonomy developed by D&B as a complement to NAICS and SIC codes, that are assignedaccording to companies’ primary and secondary business activities.
SOAP REST
D&B HooversIndustry CodeDescription
Text that describes the business activity based on the scheme specified by the attributetype.
SOAP REST
D&B IndustryCode
An alphanumeric value identifying a business activity based on the scheme specified bythe Standard Industrial Classification (SIC) Code. The first four digits are external codescreated by the U.S. Government. D&B has created extensions to more precisely define anactivity as in the case of the SIC 2+2 (the last 4 digits of an 8-digit SIC).
SOAP REST
D&B IndustryCodeDescription
Text that describes the business activity based on the scheme specified by the attributetype, e.g., 'highway and street construction' is the description of industry code 1611 inthe U.S. SIC (Standard Industrial Classification) system.
SOAP REST
D&B Direct API Documentation Business Elements
©Dun & Bradstreet, Inc. 2014 39
Name Description XML* JSON*
D-U-N-SNumberTransfer Date
The date associated with the most recent retirement of a D-U-N-S Number affecting thissubject. When included in a monitoring notice, the Retained D-U-N-S Number should beused for subsequent requests. When included in a product response, the Previous D-U-N-S Number is provided for reference purposes.
SOAP REST
D-U-N-SNumberTransferReason 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 forsubsequent requests. When included in a product response, the Previous D-U-N-SNumber is provided for reference purposes.
SOAP REST
D-U-N-S SelfRequest Date
The date on which the DUNS was created as a result of a Self Request. (Data onlyavailable from 1997).
SOAP REST
D-U-N-S SelfRequestIndicator
When 'true' indicates that the D-U-N-S Number for this subject was created at therequest of the subject. When 'false' indicates that the D-U-N-S Number for this subjectwas not created at the request of the subject; however, as this is the assumed conditionthere is no requirement to create this tag to represent this fact.
SOAP REST
EmployeeQuantity (AllLocations)
A number that defines how many people are directly engaged and paid by theorganization to perform or support its business operations. [M]
SOAP REST
EmployeeQuantity(SingleLocation)
A number that defines how many people are directly engaged and paid by theorganization to perform or support its business operations at the subject's location. [M]
SOAP REST
EmployeeQuantity BasisText
Text that indicates when it has been reported to D&B that certain types of employeeshave been included in the calculation of the Employee Quantity. [M+]
SOAP REST
EmployeeQuantityGrowth Rate
The annual rate at which total number of employees in a firm's has been or is expectedto grow. [M]
SOAP REST
EmployeeQuantityReliability Text(All Locations)
Text that describes the integrity of the employee figures, e.g. audited, actual, estimated,or modeled. [M+]
SOAP REST
EmployeeQuantityReliability Text(SingleLocation)
Text that describes the integrity of the employee figures, e.g. audited, actual, estimated,or modeled. [M+]
SOAP REST
ExportIndicator
When 'true' indicates that the subject company exports goods to other countries. [M] SOAP REST
FEINAssignmentMethod
Text that identifies how the inquiry DUNS was assigned based on a direct source such asan Agency or if assigned based on the branch process which utilizes the HQ linkage toassign the HQ FEIN to each Branch.
SOAP REST
FEINCollectionDate
The date the FEIN information was received. SOAP REST
D&B Direct API Documentation Business Elements
©Dun & Bradstreet, Inc. 2014 40
Name Description XML* JSON*
FEIN Issuer D-U-N-S Number
The DUNS Number assigned to the entity that provided the FEIN number to D&B. SOAP REST
FEIN IssuerOrganizationName
Text recording the name of the entity that provided the FEIN Number to D&B. SOAP REST
FEINRegistrationBusinessName
Text recording the filing name for the unique nine-digit number assigned by the U.S.Internal Revenue Service to business entities (and in some cases individuals) operating inthe United States for the purposes of conducting business.
SOAP REST
FEINRegistrationPostal Code
An identifier used by the local country postal authority to identify where theidentification number provider is located.
SOAP REST
FEINRegistrationStreetAddress
Text that records the street address components as it would be presented on an addresslabel. This includes, but is not limited to, details such as street name, street number,building name, estate name.
SOAP REST
FEINRegistrationTerritoryName
Text recording the name of the territory or state where the entity which provided theFEIN Number to D&B is located
SOAP REST
FEINRegistrationTown Name
Text recording the mailing address town or city name that is recorded in the FEINregistration.
SOAP REST
FEIN Tax IDNumber
A number recording a unique nine-digit FEIN number assigned by the U.S. InternalRevenue Service to business entities (and in some cases individuals) operating in theUnited States for the purposes of identification.
SOAP REST
FinancialStatementCurrency
The three-letter code, published by International Organization for Standardization (ISO),identifying the type of money that corresponds to the values in the financial statement.
SOAP REST
FinancialStatementDate
The date when the accounting period ended. If the accounting figures are projected(future), then this is the date when the accounting period will end. [M+]
SOAP REST
FinancialStatementDate (KeyFinancialFigures)
The date or partial date (i.e. period showing year/month) when the accounting periodended. If the Reliability Code denotes the figures are projected (future) then this whenthe accounting period will end. [M]
SOAP REST
FinancialStatementPeriod
The period of the financial statement expressed as a number of years, months or days.(e.g. P3M is 3 months or quarterly, P1Y is 1 year or annual) [M+]
SOAP REST
FinancialStatementUnit of Size
Text which identifies the unit of size that corresponds to the values in the financialstatement.
SOAP REST
D&B Direct API Documentation Business Elements
©Dun & Bradstreet, Inc. 2014 41
Name Description XML* JSON*
FormerBusinessName
Text recording the former business name. SOAP REST
FranchiseOperationType
Text that denotes whether the franchise rights are operated by a company or directly bythe franchisee; i.e. franchisee, franchisor. [M+]
SOAP REST
GeographicalPrecision Text
Text that identifies the accuracy of the match used for an address. [M+] SOAP REST
GlobalUltimate TotalEmployeeQuantity
A number that defines how many people are directly engaged and paid by theorganization to perform or support its business operations. Includes employees in theentire global family tree, including all direct and indirect subsidiaries of the globalultimate parent company, and all branch and division locations.
SOAP REST
HeadquarterD-U-N-SNumber
The D-U-N-S Number of the headquarters company. A headquarters is a businessestablishment that has branches or divisions reporting to it. [M]
SOAP REST
ImportIndicator
When 'true' indicates that the subject company imports a quantity of goods from othercountries. [M]
SOAP REST
IncorporationYear
The year the business incorporated - The year the business entity incorporated orregistered as the current legal structure. The Incorporation Year may or may not be thesame as the year the business started. [M]
SOAP REST
Industry CodePercentage ofSales
The value of annual sales which are attributable to the operations defined by IndustryCode Number as a percentage of total annual sales. Can repeat up to six times.
SOAP REST
Labor SurplusArea Indicator
When 'true' indicates that this organization is certified as a business that operates in alabor surplus area, which is a geographical area identified by the Department of Labor asan area of concentrated unemployment or underemployment or an area of labor [M]
SOAP REST
Last UpdateDate
The date when the record was last updated in D&B's system. [M] SOAP REST
Line ofBusiness
Text recording the description of the operations conducted by a business. [M+] SOAP REST
Local ActivityIndustry Code
Records the business activities in which an organization is actively engaged usingstandardized coding schemes such as European NACE and other country-specificClassification of Economic Activities.
SOAP REST
LocationOwnershipText
Text specifying the terms under which this subject occupies the premises (i.e., one ormore facilities) at the primary address, e.g., owned, rented or leased. [M+]
SOAP REST
MailUndeliverable(NIXIE)Indicator
When 'true' indicates that it is it is not possible to deliver mail to this address. When'false' indicates that mail to this address can be delivered; however, as this is theassumed condition there is no requirement to create this tag to represent this fact. [M+]
SOAP REST
MajorIndustryCategory
A narrative description of the operations or activities of the business. Relates to theprimary four-digit 1987 US SIC. In English.
SOAP REST
D&B Direct API Documentation Business Elements
©Dun & Bradstreet, Inc. 2014 42
Name Description XML* JSON*
MarketabilityIndicator
When 'true' indicates that the record satisfies D&B marketability rules. When 'false'indicates that the record does not satisfy D&B marketability rules; however, there is norequirement to create this tag to represent this fact. [M]
SOAP REST
MarketingPrescreenScore
Prescreen score is a D&B marketing tool that predicts the likelihood of a company’s abilityto pay all its bills on time over the next 12 months. Updated monthly, it shows thelikelihood that a company may become a collection problem. Scores are calculated usingstatistical models and the most recent payment information in D&B’s commercialdatabase. It is intended to be a marketing tool and should not be used for credit decisionson individual organizations. [M+]
SOAP REST
MetropolitanStatisticalArea Code
A code describing a geographical region with a relatively high population density at itscore and close economic ties throughout the area. [M+]
SOAP REST
MinorityOwnedIndicator
When 'true' indicates that this organization is certified as a business that is greater than50% owned by and whose management and daily business operations are controlled byone or more minority group members. [M]
SOAP REST
Most SeniorPrincipal FullName
Text recording the name of the CEO. [M+] SOAP REST
Most SeniorPrincipalIdentificationNumber
A number assigned by an external body or by D&B which either uniquely identifies orhelps to identify the individual who is the most senior principal at this organization.
SOAP REST
Most SeniorPrincipal JobTitle
Text recording the job held by the most senior principal; For example, CEO, President andCEO. [M+]
SOAP REST
NAICS Code An alphanumeric value identifying the business activity based on the NAICS Code. Canrepeat multiple times.
SOAP REST
NAICS CodeDescription
Text that describes the business activity based on the scheme specified by the attributetype, e.g., 'highway and street construction' is the description of industry code 1611 inthe U.S. SIC (Standard Industrial Classification) system.
SOAP REST
NonMarketableReason Text
Text specifying the reason why the subject's data is not considered marketable by D&B.[M+]
SOAP REST
Non-PostalTown
Text recording the name of a village, town or suburb where this is not a PrimaryTown/City. For example, 'Booker' in Booker, High Wycombe. [M+]
SOAP REST
Number ofFamilyMembersIncludingSubsidiaries
This is the number of linkages in the upward and downward directions of the entirefamily tree that the subject belongs to, starting from the global ultimate.
SOAP REST
OperatingStatusComment
Free form text which records the summary of the company's trading status. [M] SOAP REST
OperationsText
Text that describes detailed information regarding a business operation. [M] SOAP REST
D&B Direct API Documentation Business Elements
©Dun & Bradstreet, Inc. 2014 43
Name Description XML* JSON*
OrganizationHistory Text
Text that indicates if D&B has any information that may reflect unfavorably on thisorganization, e.g. clear, incomplete, management and business.
SOAP REST
OrganizationIdentificationNumber
A number assigned by an external body or by D&B which either uniquely identifies orhelps to identify an organization.
SOAP REST
OrganizationStart Year
The year when operations undertaken by the organization commenced. [M] SOAP REST
OrganizationSummaryText
Text that records a brief statement or account of this organization. [M] SOAP REST
Out ofBusinessIndicator
Text that records the operating status of the business. [M+] SOAP REST
OwnershipControl Type
Text that describes the type of controlling ownership e.g. publicly owned, privatelyowned, state owned. [M+]
SOAP REST
OwnershipEthnicity Type
Text that records the racial, national, tribal, or cultural classifications that are applied toan organization based on the ethnicity of a majority of its ownership. [M+]
SOAP REST
Premises AreaMeasurement
Text that records the measurement of the premises. [M+] SOAP REST
Premises AreaMeasurementReliability Text
Text that describes the accuracy of the measurement found in Premises AreaMeasurement; e.g., actual, estimated, modeled. [M+]
SOAP REST
Premises AreaUnit ofMeasurement
Text that records the measurement unit used to express the Premises AreaMeasurement; e.g. acre, square meters, square feet. [M+]
SOAP REST
PremisesFunction Text
Text specifying an activity that is performed or is not performed at this facility by thesubject, e.g., manufacturing, warehousing, printing, packaging, office work. [M+]
SOAP REST
Previous D-U-N-S Number(Transfer)
The most recently retired D-U-N-S Number that is associated with this subject, often as aredundant record. An explanation for this change is provided in the transfer reason. [M+]
SOAP REST
PrimaryAddressLatitude
The angular distance of the organization's primary physical address north or south fromthe Earth's equator measured through 90 degrees expressed in decimal numbers. [M+]
SOAP REST
PrimaryAddressLongitude
The angular distance of the organization's primary physical address east or west from animaginary line (called the prime meridian) that goes from the North Pole to the SouthPole measured through 90 degrees expressed in decimal numbers. [M+]
SOAP REST
Primary SICCode
The first listed alphanumeric value identifying the primary business activity based on thescheme specified by the Standard Industrial Classification (SIC) Code. The first four digitsare external codes created by the U.S. Government. D&B has created extensions to moreprecisely define an activity as in the case of the SIC 2+2 (the last 4 digits of an 8-digit SIC).
SOAP REST
Primary SICDescription
Text that describes the business activity based on the scheme specified by the attributetype, e.g., 'highway and street construction' is the description of industry code 1611 inthe U.S. SIC (Standard Industrial Classification) system.
SOAP REST
D&B Direct API Documentation Business Elements
©Dun & Bradstreet, Inc. 2014 44
Name Description XML* JSON*
RegisteredAddressIndicator
When 'true' indicates that the Primary Address which has been presented is also theRegistered Address. When 'false' indicates that the Primary Address which has beenpresented is not a Registered Address. [M+]
SOAP REST
RegistrationNumber - AllCountriesExcept US
A registration/identifier number assigned by local government agencies to identify abusiness within the local market. Examples include the France Siret Number, UK CRONumber, Europe VAT Number, Australia Company Number, and Brazilian State RegistryNumber.
SOAP REST
ResidentialAddressIndicator
When 'true' indicates that the Primary Address which has been presented is also theResidential Address. When 'false' indicates that the Primary Address which has beenpresented is not a Residential Address. [M+]
SOAP REST
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 theD-U-N-S Number to reference for future product requests. An explanation for thischange is provided in the transfer reason.
SOAP REST
Revenue PerShare
A number expressing proportionally what one or more of the business' financial figuresis in relation to one or more of the business' other financial figures. This figure is anindicator used to evaluate the business' financial condition or potential risk. [M+]
SOAP REST
Sales RevenueAmount
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 tothe customer. [M]
SOAP REST
Secondary SICCode
An alphanumeric value identifying a business activity based on the scheme specified bythe Standard Industrial Classification (SIC) Code. Clarification Note: These are generallyexternal codes created by an external authoritative body like the U.S. Office ofManagement and Budget but D&B may have created extensions to more preciselydefine an activity as in the case of the SIC 2+2 (the last 4 digits of an 8-digit SIC). Canrepeat up to five times.
SOAP REST
Secondary SICDescription
Text that describes the business activity based on the scheme specified by the attributetype, e.g., 'highway and street construction' is the description of industry code 1611 inthe U.S. SIC (Standard Industrial Classification) system.
SOAP REST
SmallBusinessIndicator
When 'true' indicates that the subject qualifies as small business, eligible for assistancefrom SBA, with a place of business located in the United States. It must operate primarilywithin the United States or make a significant contribution to the U.S. economy throughpayment of taxes or use of American products, materials or labor. Together with itsaffiliates, it must meet the numerical size standards as defined in the Small BusinessSize Regulations 13 CFR 121. [M]
SOAP REST
StockExchangeCountry Code
The two-letter country code, defined by the International Organization forStandardization (ISO) ISO 3166-1 scheme identifying the country for this stock exchange.[M+]
SOAP REST
StockExchangeName
Text recording the name of the Stock Exchange on which the subject's shares aretraded. [M+]
SOAP REST
Stock TickerName
Text that identifies the subject at the Stock Exchange for share trading purposes, e.g.,DNB. [M+]
SOAP REST
D&B Direct API Documentation Business Elements
©Dun & Bradstreet, Inc. 2014 45
Name Description XML* JSON*
TelephoneDisconnected(TIXIE)Indicator
When 'true' indicates that telecommunication number cannot be connected tosuccessfully. When 'false' indicates that telecommunication number can be connectedto successfully. When set to NULL, it indicates that D&B does not know whether thetelecommunication number can be connected to successfully.
SOAP REST
Third PartyAssessment
An alpha code assigned by a third party to define the kind of appraisal/opinion that wasassigned to this subject by the third party, e.g. Moody's Long Term Obligation Rating, FICOscore, Vantage Score. [M+]
SOAP REST
Third PartyAssessmentRank
Company's rank on a ranking list, such as number 100 on the Fortune 500 [M+] SOAP REST
Total EquityAmount
The total value of share capital/stock originally invested by shareholders/stockholdersplus any reserves which have arisen, such as retained profits, which are ploughed backinto the firm. Also known as Net Worth. [M+]
SOAP REST
UK SIC Code The first listed alphanumeric value identifying the primary business activity based on theUK SIC Code.
SOAP REST
Web SiteAddress
The Internet URL (Uniform Resource Locator) which uniquely identifies the proprietarywebsite of the subject or the website preferred by the subject which gives moreinformation on the subject. [M]
SOAP REST
*The links in this column provide the technical characteristics for the data field of the respective business element in the
XML or JSON response.
The preceding list is not presented in the order, nor manner, in which the information is packaged anddelivered via the D&B Direct API.
While data for a particular company may not contain values for all of the business elements, there may beitems that are considered by D&B to be essential to yield the maximum benefit of a data layer. If any of theseessential elements do not contain a value for a particular company, an error code will be returned, and yourorganization will not incur a usage credit for the request.
The Product Availability Lookup feature may be utilized to determine if this D&B Direct product is availablefor a given D-U-N-S Number.
SIC Codes
SIC stands for Standard Industrial Classification. The idea of coding and classifying industries to help analyzeindustrial structure was first developed by the U.S. Government in the 1930’s. The Standard IndustrialClassification (SIC) System has been widely adopted as the standard coding system used to define and analyzeindustry structure.
D&B assigns SIC’s at the eight-digit level and can include up to six base (four-digit, which are defined by theGovernment) SIC’s with up to four, four-digit extensions for each, for a maximum total of twenty-fourseparate lines of business per record to identify what a business does.
D&B Direct API Documentation Business Elements
©Dun & Bradstreet, Inc. 2014 46
Additional Details
There are two varieties of this product: Marketing and Risk (referred to as Alternative). They both offer similarbusiness elements; however, there may be differences in the availability of data for certain countries. The dataprovided in the Risk version may also be updated more frequently, making it the preferred source when it isavailable for a given country.
The results from this product will include principal identification numbers (Principal ID) that may be passed tothe People feature to obtain additional information about individuals.
Access to this information is provided on a metered basis; and will require data layer entitlement prior to usein the production environment. A built-in feature exists to prevent duplicate billing when multiple requestswith the same D-U-N-S Number and product code are submitted on the same calendar day (which is based onEastern Standard Time [GMT-5]).
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.
Related Topics
Detailed Company Profile- Premium, Detailed Company Profile - Standard, Alternative Detailed CompanyProfile.
Technical Specification
For details on how to obtain this data layer, please refer to the Firmographic.OrderProduct (SOAP) orFirmographic.OrderProduct (REST) page.
D&B Direct API Documentation Additional Details
©Dun & Bradstreet, Inc. 2014 47
Detailed Company Profile - StandardThe most efficient way to gain basic marketing information about a potential prospect such as businessname, address, D&B® D-U-N-S® Number, fax, phone and trade style. Includes business intelligence such asexecutive names and titles, financials, number of employees, import or export code, branch indicator, andmore.
Requirements & Options
When requesting this D&B Direct product, a valid D-U-N-S Number for a company, its country code, and theappropriate product code will be required. If this information is not available, refer to obtaining a company D-U-N-S Number for assistance. A trade up option exists to request data for the headquarters when therequested organization is a branch.
When ordering information for organizations located in Germany, customers are required to provide a validorder reason code. A list of possible values is included on the respective SOAP or REST operation page.
Note: The product code for Detailed Company Profile - Standard is DCP_STD. This product may beincluded in the Monitoring process.
Data Privacy
This product returns information that, in some jurisdictions, is considered personally identifiable information(PII). D&B customers that are entitled to request this product (and any third-parties that may be assisting withtheir implementation) are bound to the data privacy terms specified in the D&B Direct agreement.
Business Elements
The following table is an alphabetical list of the unique items delivered in this data layer. Legend: [C] = maybe included in a Custom Data product; [M] = may be referenced by the Monitoring process; [M+] = Monitoredusing an aggregate or attribute XPath.
Note: This product will 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, et al.)along with the business elements listed. In addition, customers who compare the following table to theData Primer should be advised of several intentional differences.
D&B Direct API Documentation Detailed Company Profile - Standard
©Dun & Bradstreet, Inc. 2014 48
Name Description XML* JSON*
AgentIndicator
When 'true' indicates that the subject acts as an agent promoting the goods or servicesof another organization, e.g., Sales Agent, Purchasing Agent. When 'false' indicates thatthe subject does not act as an agent of another organization. [M]
SOAP REST
Asset ArticleQuantity
A number specifying how many of this particular asset type are held, owned, or managedby the subject. [M]
SOAP REST
Best FEINIndicator
For companies that may be associated with multiple FEIN numbers, this field (when setto 1) identifies the FEIN records that are considered by D&B to be the most relevant forthis subject.
SOAP REST
CompanyPrincipal FullName
Text recording the complete name of an individual who is primarily responsible for thedecisions that drive the business. [M]
SOAP REST
CompanyPrincipalIdentificationNumber
A number assigned by an external body or by D&B which either uniquely identifies orhelps to identify the principal.
SOAP REST
CompanyPrincipal JobTitle
Text recording the job held by the principal or manager. E.g. e.g., Leader GlobalCommunication, Manager National Technical Support Center. [M]
SOAP REST
ContinentCode (WorldRegion 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+]
SOAP REST
Control Year The year current control was assumed. [M] SOAP REST
D&B HooversIndustry Code
An alphanumeric industry code identifying a business activity, based on a three-tiertaxonomy developed by D&B as a complement to NAICS and SIC codes, that are assignedaccording to companies’ primary and secondary business activities.
SOAP REST
D&B HooversIndustry CodeDescription
Text that describes the business activity based on the scheme specified by the attributetype.
SOAP REST
D&B IndustryCode
An alphanumeric value identifying a business activity based on the scheme specified bythe Standard Industrial Classification (SIC) Code. The first four digits are external codescreated by the U.S. Government. D&B has created extensions to more precisely define anactivity as in the case of the SIC 2+2 (the last 4 digits of an 8-digit SIC).
SOAP REST
D&B IndustryCodeDescription
Text that describes the business activity based on the scheme specified by the attributetype, e.g., 'highway and street construction' is the description of industry code 1611 inthe U.S. SIC (Standard Industrial Classification) system.
SOAP REST
D-U-N-SNumberTransfer Date
The date associated with the most recent retirement of a D-U-N-S Number affecting thissubject. When included in a monitoring notice, the Retained D-U-N-S Number should beused for subsequent requests. When included in a product response, the Previous D-U-N-S Number is provided for reference purposes.
SOAP REST
D-U-N-SNumberTransferReason 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 forsubsequent requests. When included in a product response, the Previous D-U-N-SNumber is provided for reference purposes.
SOAP REST
D&B Direct API Documentation Business Elements
©Dun & Bradstreet, Inc. 2014 49
Name Description XML* JSON*
D-U-N-S SelfRequest Date
The date on which the DUNS was created as a result of a Self Request. (Data onlyavailable from 1997).
SOAP REST
D-U-N-S SelfRequestIndicator
When 'true' indicates that the D-U-N-S Number for this subject was created at therequest of the subject. When 'false' indicates that the D-U-N-S Number for this subjectwas not created at the request of the subject; however, as this is the assumed conditionthere is no requirement to create this tag to represent this fact.
SOAP REST
EmployeeQuantity (AllLocations)
A number that defines how many people are directly engaged and paid by theorganization to perform or support its business operations. [M]
SOAP REST
EmployeeQuantity(SingleLocation)
A number that defines how many people are directly engaged and paid by theorganization to perform or support its business operations at the subject's location. [M]
SOAP REST
EmployeeQuantity BasisText
Text that indicates when it has been reported to D&B that certain types of employeeshave been included in the calculation of the Employee Quantity. [M+]
SOAP REST
EmployeeQuantityGrowth Rate
The annual rate at which total number of employees in a firm's has been or is expectedto grow. [M]
SOAP REST
EmployeeQuantityReliability Text(All Locations)
Text that describes the integrity of the employee figures, e.g. audited, actual, estimated,or modeled. [M+]
SOAP REST
EmployeeQuantityReliability Text(SingleLocation)
Text that describes the integrity of the employee figures, e.g. audited, actual, estimated,or modeled. [M+]
SOAP REST
ExportIndicator
When 'true' indicates that the subject company exports goods to other countries. [M] SOAP REST
FEINAssignmentMethod
Text that identifies how the inquiry DUNS was assigned based on a direct source such asan Agency or if assigned based on the branch process which utilizes the HQ linkage toassign the HQ FEIN to each Branch.
SOAP REST
FEINCollectionDate
The date the FEIN information was received. SOAP REST
FEIN Issuer D-U-N-S Number
The DUNS Number assigned to the entity that provided the FEIN number to D&B. SOAP REST
FEIN IssuerOrganizationName
Text recording the name of the entity that provided the FEIN Number to D&B. SOAP REST
FEINRegistrationBusinessName
Text recording the filing name for the unique nine-digit number assigned by the U.S.Internal Revenue Service to business entities (and in some cases individuals) operating inthe United States for the purposes of conducting business.
SOAP REST
D&B Direct API Documentation Business Elements
©Dun & Bradstreet, Inc. 2014 50
Name Description XML* JSON*
FEINRegistrationPostal Code
An identifier used by the local country postal authority to identify where theidentification number provider is located.
SOAP REST
FEINRegistrationStreetAddress
Text that records the street address components as it would be presented on an addresslabel. This includes, but is not limited to, details such as street name, street number,building name, estate name.
SOAP REST
FEINRegistrationTerritoryName
Text recording the name of the territory or state where the entity which provided theFEIN Number to D&B is located
SOAP REST
FEINRegistrationTown Name
Text recording the mailing address town or city name that is recorded in the FEINregistration.
SOAP REST
FEIN Tax IDNumber
A number recording a unique nine-digit FEIN number assigned by the U.S. InternalRevenue Service to business entities (and in some cases individuals) operating in theUnited States for the purposes of identification.
SOAP REST
FinancialStatementCurrency
The three-letter code, published by International Organization for Standardization (ISO),identifying the type of money that corresponds to the values in the financial statement.
SOAP REST
FinancialStatementDate
The date when the accounting period ended. If the accounting figures are projected(future), then this is the date when the accounting period will end. [M+]
SOAP REST
FinancialStatementDate (KeyFinancialFigures)
The date or partial date (i.e. period showing year/month) when the accounting periodended. If the Reliability Code denotes the figures are projected (future) then this whenthe accounting period will end. [M]
SOAP REST
FinancialStatementPeriod
The period of the financial statement expressed as a number of years, months or days.(e.g. P3M is 3 months or quarterly, P1Y is 1 year or annual) [M+]
SOAP REST
FinancialStatementUnit of Size
Text which identifies the unit of size that corresponds to the values in the financialstatement.
SOAP REST
FormerBusinessName
Text recording the former business name. SOAP REST
GlobalUltimate TotalEmployeeQuantity
A number that defines how many people are directly engaged and paid by theorganization to perform or support its business operations. Includes employees in theentire global family tree, including all direct and indirect subsidiaries of the globalultimate parent company, and all branch and division locations.
SOAP REST
HeadquarterD-U-N-SNumber
The D-U-N-S Number of the headquarters company. A headquarters is a businessestablishment that has branches or divisions reporting to it. [M]
SOAP REST
D&B Direct API Documentation Business Elements
©Dun & Bradstreet, Inc. 2014 51
Name Description XML* JSON*
ImportIndicator
When 'true' indicates that the subject company imports a quantity of goods from othercountries. [M]
SOAP REST
IncorporationYear
The year the business incorporated - The year the business entity incorporated orregistered as the current legal structure. The Incorporation Year may or may not be thesame as the year the business started. [M]
SOAP REST
Industry CodePercentage ofSales
The value of annual sales which are attributable to the operations defined by IndustryCode Number as a percentage of total annual sales. Can repeat up to six times.
SOAP REST
Labor SurplusArea Indicator
When 'true' indicates that this organization is certified as a business that operates in alabor surplus area, which is a geographical area identified by the Department of Labor asan area of concentrated unemployment or underemployment or an area of labor [M]
SOAP REST
Last UpdateDate
The date when the record was last updated in D&B's system. [M] SOAP REST
Line ofBusiness
Text recording the description of the operations conducted by a business. [M+] SOAP REST
Local ActivityIndustry Code
Records the business activities in which an organization is actively engaged usingstandardized coding schemes such as European NACE and other country-specificClassification of Economic Activities.
SOAP REST
LocationOwnershipText
Text specifying the terms under which this subject occupies the premises (i.e., one ormore facilities) at the primary address, e.g., owned, rented or leased. [M+]
SOAP REST
MailUndeliverable(NIXIE)Indicator
When 'true' indicates that it is it is not possible to deliver mail to this address. When'false' indicates that mail to this address can be delivered; however, as this is theassumed condition there is no requirement to create this tag to represent this fact. [M+]
SOAP REST
MajorIndustryCategory
A narrative description of the operations or activities of the business. Relates to theprimary four-digit 1987 US SIC. In English.
SOAP REST
MarketabilityIndicator
When 'true' indicates that the record satisfies D&B marketability rules. When 'false'indicates that the record does not satisfy D&B marketability rules; however, there is norequirement to create this tag to represent this fact. [M]
SOAP REST
MinorityOwnedIndicator
When 'true' indicates that this organization is certified as a business that is greater than50% owned by and whose management and daily business operations are controlled byone or more minority group members. [M]
SOAP REST
Most SeniorPrincipal FullName
Text recording the name of the CEO. [M+] SOAP REST
Most SeniorPrincipalIdentificationNumber
A number assigned by an external body or by D&B which either uniquely identifies orhelps to identify the individual who is the most senior principal at this organization.
SOAP REST
Most SeniorPrincipal JobTitle
Text recording the job held by the most senior principal; For example, CEO, President andCEO. [M+]
SOAP REST
D&B Direct API Documentation Business Elements
©Dun & Bradstreet, Inc. 2014 52
Name Description XML* JSON*
NAICS Code An alphanumeric value identifying the business activity based on the NAICS Code. Canrepeat multiple times.
SOAP REST
NAICS CodeDescription
Text that describes the business activity based on the scheme specified by the attributetype, e.g., 'highway and street construction' is the description of industry code 1611 inthe U.S. SIC (Standard Industrial Classification) system.
SOAP REST
NonMarketableReason Text
Text specifying the reason why the subject's data is not considered marketable by D&B.[M+]
SOAP REST
Non-PostalTown
Text recording the name of a village, town or suburb where this is not a PrimaryTown/City. For example, 'Booker' in Booker, High Wycombe. [M+]
SOAP REST
OrganizationHistory Text
Text that indicates if D&B has any information that may reflect unfavorably on thisorganization, e.g. clear, incomplete, management and business.
SOAP REST
OrganizationIdentificationNumber
A number assigned by an external body or by D&B which either uniquely identifies orhelps to identify an organization.
SOAP REST
OrganizationStart Year
The year when operations undertaken by the organization commenced. [M] SOAP REST
OrganizationSummaryText
Text that records a brief statement or account of this organization. [M] SOAP REST
Out ofBusinessIndicator
Text that records the operating status of the business. [M+] SOAP REST
OwnershipControl Type
Text that describes the type of controlling ownership e.g. publicly owned, privatelyowned, state owned. [M+]
SOAP REST
OwnershipEthnicity Type
Text that records the racial, national, tribal, or cultural classifications that are applied toan organization based on the ethnicity of a majority of its ownership. [M+]
SOAP REST
Premises AreaMeasurement
Text that records the measurement of the premises. [M+] SOAP REST
Premises AreaMeasurementReliability Text
Text that describes the accuracy of the measurement found in Premises AreaMeasurement; e.g., actual, estimated, modeled. [M+]
SOAP REST
Premises AreaUnit ofMeasurement
Text that records the measurement unit used to express the Premises AreaMeasurement; e.g. acre, square meters, square feet. [M+]
SOAP REST
Previous D-U-N-S Number(Transfer)
The most recently retired D-U-N-S Number that is associated with this subject, often as aredundant record. An explanation for this change is provided in the transfer reason. [M+]
SOAP REST
PrimaryAddressLatitude
The angular distance of the organization's primary physical address north or south fromthe Earth's equator measured through 90 degrees expressed in decimal numbers. [M+]
SOAP REST
PrimaryAddressLongitude
The angular distance of the organization's primary physical address east or west from animaginary line (called the prime meridian) that goes from the North Pole to the SouthPole measured through 90 degrees expressed in decimal numbers. [M+]
SOAP REST
D&B Direct API Documentation Business Elements
©Dun & Bradstreet, Inc. 2014 53
Name Description XML* JSON*
Primary SICCode
The first listed alphanumeric value identifying the primary business activity based on thescheme specified by the Standard Industrial Classification (SIC) Code. The first four digitsare external codes created by the U.S. Government. D&B has created extensions to moreprecisely define an activity as in the case of the SIC 2+2 (the last 4 digits of an 8-digit SIC).
SOAP REST
Primary SICDescription
Text that describes the business activity based on the scheme specified by the attributetype, e.g., 'highway and street construction' is the description of industry code 1611 inthe U.S. SIC (Standard Industrial Classification) system.
SOAP REST
RegisteredAddressIndicator
When 'true' indicates that the Primary Address which has been presented is also theRegistered Address. When 'false' indicates that the Primary Address which has beenpresented is not a Registered Address. [M+]
SOAP REST
RegistrationNumber - AllCountriesExcept US
A registration/identifier number assigned by local government agencies to identify abusiness within the local market. Examples include the France Siret Number, UK CRONumber, Europe VAT Number, Australia Company Number, and Brazilian State RegistryNumber.
SOAP REST
ResidentialAddressIndicator
When 'true' indicates that the Primary Address which has been presented is also theResidential Address. When 'false' indicates that the Primary Address which has beenpresented is not a Residential Address. [M+]
SOAP REST
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 theD-U-N-S Number to reference for future product requests. An explanation for thischange is provided in the transfer reason.
SOAP REST
Revenue PerShare
A number expressing proportionally what one or more of the business' financial figuresis in relation to one or more of the business' other financial figures. This figure is anindicator used to evaluate the business' financial condition or potential risk. [M+]
SOAP REST
Sales RevenueAmount
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 tothe customer. [M]
SOAP REST
Secondary SICCode
An alphanumeric value identifying a business activity based on the scheme specified bythe Standard Industrial Classification (SIC) Code. Clarification Note: These are generallyexternal codes created by an external authoritative body like the U.S. Office ofManagement and Budget but D&B may have created extensions to more preciselydefine an activity as in the case of the SIC 2+2 (the last 4 digits of an 8-digit SIC). Canrepeat up to five times.
SOAP REST
Secondary SICDescription
Text that describes the business activity based on the scheme specified by the attributetype, e.g., 'highway and street construction' is the description of industry code 1611 inthe U.S. SIC (Standard Industrial Classification) system.
SOAP REST
SmallBusinessIndicator
When 'true' indicates that the subject qualifies as small business, eligible for assistancefrom SBA, with a place of business located in the United States. It must operate primarilywithin the United States or make a significant contribution to the U.S. economy throughpayment of taxes or use of American products, materials or labor. Together with itsaffiliates, it must meet the numerical size standards as defined in the Small BusinessSize Regulations 13 CFR 121. [M]
SOAP REST
StockExchangeCountry Code
The two-letter country code, defined by the International Organization forStandardization (ISO) ISO 3166-1 scheme identifying the country for this stock exchange.[M+]
SOAP REST
D&B Direct API Documentation Business Elements
©Dun & Bradstreet, Inc. 2014 54
Name Description XML* JSON*
StockExchangeName
Text recording the name of the Stock Exchange on which the subject's shares aretraded. [M+]
SOAP REST
Stock TickerName
Text that identifies the subject at the Stock Exchange for share trading purposes, e.g.,DNB. [M+]
SOAP REST
TelephoneDisconnected(TIXIE)Indicator
When 'true' indicates that telecommunication number cannot be connected tosuccessfully. When 'false' indicates that telecommunication number can be connectedto successfully. When set to NULL, it indicates that D&B does not know whether thetelecommunication number can be connected to successfully.
SOAP REST
Third PartyAssessment
An alpha code assigned by a third party to define the kind of appraisal/opinion that wasassigned to this subject by the third party, e.g. Moody's Long Term Obligation Rating, FICOscore, Vantage Score. [M+]
SOAP REST
Third PartyAssessmentRank
Company's rank on a ranking list, such as number 100 on the Fortune 500 [M+] SOAP REST
Total EquityAmount
The total value of share capital/stock originally invested by shareholders/stockholdersplus any reserves which have arisen, such as retained profits, which are ploughed backinto the firm. Also known as Net Worth. [M+]
SOAP REST
UK SIC Code The first listed alphanumeric value identifying the primary business activity based on theUK SIC Code.
SOAP REST
Web SiteAddress
The Internet URL (Uniform Resource Locator) which uniquely identifies the proprietarywebsite of the subject or the website preferred by the subject which gives moreinformation on the subject. [M]
SOAP REST
*The links in this column provide the technical characteristics for the data field of the respective business element in the
XML or JSON response.
The preceding list is not presented in the order, nor manner, in which the information is packaged anddelivered via the D&B Direct API.
While data for a particular company may not contain values for all of the business elements, there may beitems that are considered by D&B to be essential to yield the maximum benefit of a data layer. If any of theseessential elements do not contain a value for a particular company, an error code will be returned, and yourorganization will not incur a usage credit for the request.
The Product Availability Lookup feature may be utilized to determine if this D&B Direct product is availablefor a given D-U-N-S Number.
SIC Codes
SIC stands for Standard Industrial Classification. The idea of coding and classifying industries to help analyzeindustrial structure was first developed by the U.S. Government in the 1930’s. The Standard Industrial
D&B Direct API Documentation Business Elements
©Dun & Bradstreet, Inc. 2014 55
Classification (SIC) System has been widely adopted as the standard coding system used to define and analyzeindustry structure.
D&B assigns SIC’s at the eight-digit level and can include up to six base (four-digit, which are defined by theGovernment) SIC’s with up to four, four-digit extensions for each, for a maximum total of twenty-fourseparate lines of business per record to identify what a business does.
Additional Details
There are two varieties of this product: Marketing and Risk (referred to as Alternative). They both offer similarbusiness elements; however, there may be differences in the availability of data for certain countries. The dataprovided in the Risk version may also be updated more frequently, making it the preferred source when it isavailable for a given country.
The results from this product will include principal identification numbers (Principal ID) that may be passed tothe People feature to obtain additional information about individuals.
Access to this information is provided on a metered basis; and will require data layer entitlement prior to usein the production environment. A built-in feature exists to prevent duplicate billing when multiple requestswith the same D-U-N-S Number and product code are submitted on the same calendar day (which is based onEastern Standard Time [GMT-5]).
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.
Related Topics
Detailed Company Profile- Premium, Detailed Company Profile - Enhanced, Alternative Detailed CompanyProfile.
Technical Specification
For details on how to obtain this data layer, please refer to the Firmographic.OrderProduct (SOAP) orFirmographic.OrderProduct (REST) page.
D&B Direct API Documentation Additional Details
©Dun & Bradstreet, Inc. 2014 56
Alternative Detailed Company Profile - PremiumThe most efficient way to gain the most up to date information about a company such as business name,address, D&B D-U-N-S Number, fax, phone, trade style, legal status, industry, sales, and more.
Requirements & Options
When requesting this D&B Direct product, a valid D-U-N-S Number for a company, its country code, and theappropriate product code will be required. If this information is not available, refer to obtaining a company D-U-N-S Number for assistance. A trade up option exists to request data for the headquarters when therequested organization is a branch.
When ordering information for organizations located in Germany, customers are required to provide a validorder reason code. A list of possible values is included on the respective SOAP or REST operation page.
Note: The product code for Alternative Detailed Company Profile - Premium is DCP_ALT_PREM. Thisproduct may be included in the Monitoring process.
Business Elements
The following table is an alphabetical list of the unique items delivered in this data layer. Legend: [C] = maybe included in a Custom Data product; [M] = may be referenced by the Monitoring process; [M+] = Monitoredusing an aggregate or attribute XPath.
Note: This product will 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, et al.)along with the business elements listed. In addition, customers who compare the following table to theData Primer should be advised of several intentional differences.
Name Description XML* JSON*
8ACertificationIndicator
When 'true' indicates that a business meets the eligibility criteria established by theSmall Business Administration for small companies owned by socially and economicallydisadvantaged persons, so that they may bid and obtain federal government contractsand other assistance to develop their business. The business owner must be eligibleunder the same rules and guidelines set down by the federal government. [M]
SOAP REST
AccountantName
Text recording the name of either an individual or the name of an accounting firm. [M+] SOAP REST
AgentIndicator
When 'true' indicates that the subject acts as an agent promoting the goods or servicesof another organization, e.g., Sales Agent, Purchasing Agent. When 'false' indicates thatthe subject does not act as an agent of another organization. [M]
SOAP REST
D&B Direct API Documentation Alternative Detailed Company Profile - Premium
©Dun & Bradstreet, Inc. 2014 57
Name Description XML* JSON*
Asset ArticleQuantity
A number specifying how many of this particular asset type are held, owned, or managedby the subject. [M]
SOAP REST
Best FEINIndicator
For companies that may be associated with multiple FEIN numbers, this field (when setto 1) identifies the FEIN records that are considered by D&B to be the most relevant forthis subject.
SOAP REST
BoneyardOrganizationIndicator
When 'true' indicates that data on the company is no longer collected and was coveredby Hoover's Editorial staff before being acquired or going out of business. [M]
SOAP REST
BusinessLegalStructure
Text that describes the legal form or structure of a business, as registered withgovernment authorities, e.g., partnership, corporation, private limited company,government department, proprietorship. [M+]
SOAP REST
CompanyPrincipal FullName
Text recording the complete name of an individual who is primarily responsible for thedecisions that drive the business. [M]
SOAP REST
CompanyPrincipalIdentificationNumber
A number assigned by an external body or by D&B which either uniquely identifies orhelps to identify the principal.
SOAP REST
CompanyPrincipal JobTitle
Text recording the job held by the principal or manager. E.g. e.g., Leader GlobalCommunication, Manager National Technical Support Center. [M]
SOAP REST
CompetitorOrganizationCompanyName
Text recording the Primary Company Name of the Competitor. SOAP REST
CompetitorOrganizationEmployeeQuantity
The number of people that are employed the competitor. [M+] SOAP REST
CompetitorOrganizationMarket ShareCapital
A monetary figure specifying the total value of issued shares of a publicly tradedcompany, it is equal to the share price times the number of shares outstanding. [M+]
SOAP REST
CompetitorOrganizationSales Revenue
A monetary figure that is the competitor's amount of revenue or sales claimed in theincome statement data in millions (USD). [M]
SOAP REST
ContinentCode (WorldRegion 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+]
SOAP REST
Control Year The year current control was assumed. [M] SOAP REST
D&B HooversIndustry Code
An alphanumeric industry code identifying a business activity, based on a three-tiertaxonomy developed by D&B as a complement to NAICS and SIC codes, that are assignedaccording to companies’ primary and secondary business activities.
SOAP REST
D&B Direct API Documentation Business Elements
©Dun & Bradstreet, Inc. 2014 58
Name Description XML* JSON*
D&B HooversIndustry CodeDescription
Text that describes the business activity based on the scheme specified by the attributetype.
SOAP REST
D&B IndustryCode
An alphanumeric value identifying a business activity based on the scheme specified bythe Standard Industrial Classification (SIC) Code. The first four digits are external codescreated by the U.S. Government. D&B has created extensions to more precisely define anactivity as in the case of the SIC 2+2 (the last 4 digits of an 8-digit SIC).
SOAP REST
D&B IndustryCodeDescription
Text that describes the business activity based on the scheme specified by the attributetype, e.g., 'highway and street construction' is the description of industry code 1611 inthe U.S. SIC (Standard Industrial Classification) system.
SOAP REST
D-U-N-SNumberTransfer Date
The date associated with the most recent retirement of a D-U-N-S Number affecting thissubject. When included in a monitoring notice, the Retained D-U-N-S Number should beused for subsequent requests. When included in a product response, the Previous D-U-N-S Number is provided for reference purposes.
SOAP REST
D-U-N-SNumberTransferReason 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 forsubsequent requests. When included in a product response, the Previous D-U-N-SNumber is provided for reference purposes.
SOAP REST
D-U-N-S SelfRequest Date
The date on which the DUNS was created as a result of a Self Request. (Data onlyavailable from 1997).
SOAP REST
D-U-N-S SelfRequestIndicator
When 'true' indicates that the D-U-N-S Number for this subject was created at therequest of the subject. When 'false' indicates that the D-U-N-S Number for this subjectwas not created at the request of the subject; however, as this is the assumed conditionthere is no requirement to create this tag to represent this fact.
SOAP REST
EmployeeQuantity (AllLocations)
A number that defines how many people are directly engaged and paid by theorganization to perform or support its business operations. [M]
SOAP REST
EmployeeQuantity(SingleLocation)
A number that defines how many people are directly engaged and paid by theorganization to perform or support its business operations at the subject's location. [M]
SOAP REST
EmployeeQuantity BasisText
Text that indicates when it has been reported to D&B that certain types of employeeshave been included in the calculation of the Employee Quantity. [M+]
SOAP REST
EmployeeQuantityGrowth Rate
The annual rate at which total number of employees in a firm's has been or is expectedto grow.
SOAP REST
EmployeeQuantityReliability Text(All Locations)
Text that describes the integrity of the employee figures, e.g. audited, actual, estimated,or modeled. [M+]
SOAP REST
D&B Direct API Documentation Business Elements
©Dun & Bradstreet, Inc. 2014 59
Name Description XML* JSON*
EmployeeQuantityReliability Text(SingleLocation)
Text that describes the integrity of the employee figures, e.g. audited, actual, estimated,or modeled. [M+]
SOAP REST
ExportIndicator
When 'true' indicates that the subject company exports goods to other countries. [M] SOAP REST
FEINAssignmentMethod
Text that identifies how the inquiry DUNS was assigned based on a direct source such asan Agency or if assigned based on the branch process which utilizes the HQ linkage toassign the HQ FEIN to each Branch.
SOAP REST
FEINCollectionDate
The date the FEIN information was received. SOAP REST
FEIN Issuer D-U-N-S Number
The DUNS Number assigned to the entity that provided the FEIN number to D&B. SOAP REST
FEIN IssuerOrganizationName
Text recording the name of the entity that provided the FEIN Number to D&B. SOAP REST
FEINRegistrationBusinessName
Text recording the filing name for the unique nine-digit number assigned by the U.S.Internal Revenue Service to business entities (and in some cases individuals) operating inthe United States for the purposes of conducting business.
SOAP REST
FEINRegistrationPostal Code
An identifier used by the local country postal authority to identify where theidentification number provider is located.
SOAP REST
FEINRegistrationStreetAddress
Text that records the street address components as it would be presented on an addresslabel. This includes, but is not limited to, details such as street name, street number,building name, estate name.
SOAP REST
FEINRegistrationTerritoryName
Text recording the name of the territory or state where the entity which provided theFEIN Number to D&B is located
SOAP REST
FEINRegistrationTown Name
Text recording the mailing address town or city name that is recorded in the FEINregistration.
SOAP REST
FEIN Tax IDNumber
A number recording a unique nine-digit FEIN number assigned by the U.S. InternalRevenue Service to business entities (and in some cases individuals) operating in theUnited States for the purposes of identification.
SOAP REST
FinancialStatementCurrency
The three-letter code, published by International Organization for Standardization (ISO),identifying the type of money that corresponds to the values in the financial statement.[M+]
SOAP REST
FinancialStatementDate
The date when the accounting period ended. If the accounting figures are projected(future), then this is the date when the accounting period will end. [M+]
SOAP REST
D&B Direct API Documentation Business Elements
©Dun & Bradstreet, Inc. 2014 60
Name Description XML* JSON*
FinancialStatementDate (KeyFinancialFigures)
The date or partial date (i.e. period showing year/month) when the accounting periodended. If the Reliability Code denotes the figures are projected (future) then this whenthe accounting period will end. [M]
SOAP REST
FinancialStatementPeriod
The period of the financial statement expressed as a number of years, months or days.(e.g. P3M is 3 months or quarterly, P1Y is 1 year or annual)
SOAP REST
FinancialStatementUnit of Size
Text which identifies the unit of size that corresponds to the values in the financialstatement. [M+]
SOAP REST
FormerBusinessName
Text recording the former business name. SOAP REST
FranchiseOperationType
Text that denotes whether the franchise rights are operated by a company or directly bythe franchisee; i.e. franchisee, franchisor. [M+]
SOAP REST
GeographicalPrecision Text
Text that identifies the accuracy of the match used for an address. [M+] SOAP REST
GlobalUltimateBusinessName
Text recording the primary name of the global ultimate business. SOAP REST
GlobalUltimate D-U-N-S Number
The D-U-N-S number of the highest level parent within a corporate family tree. A parentis a corporation that owns more than 50% of another corporation's capital stock. Asubject may be its own global ultimate. [M]
SOAP REST
GlobalUltimate TotalEmployeeQuantity
A number that defines how many people are directly engaged and paid by theorganization to perform or support its business operations. Includes employees in theentire global family tree, including all direct and indirect subsidiaries of the globalultimate parent company, and all branch and division locations.
SOAP REST
HeadquarterD-U-N-SNumber
The D-U-N-S Number of the headquarters company. A headquarters is a businessestablishment that has branches or divisions reporting to it. [M]
SOAP REST
ImportIndicator
When 'true' indicates that the subject company imports a quantity of goods from othercountries. [M]
SOAP REST
In Date Status An text element that indicates "in date" status, i.e. whether D&B has recently collecteddata on this business.
SOAP REST
IncorporationYear
The year the business incorporated - The year the business entity incorporated orregistered as the current legal structure. The Incorporation Year may or may not be thesame as the year the business started. [M]
SOAP REST
Industry CodePercentage ofSales
The value of annual sales which are attributable to the operations defined by IndustryCode Number as a percentage of total annual sales. Can repeat up to six times.
SOAP REST
D&B Direct API Documentation Business Elements
©Dun & Bradstreet, Inc. 2014 61
Name Description XML* JSON*
Labor SurplusArea Indicator
When 'true' indicates that this organization is certified as a business that operates in alabor surplus area, which is a geographical area identified by the Department of Labor asan area of concentrated unemployment or underemployment or an area of labor [M]
SOAP REST
Last UpdateDate
The date when the record was last updated in D&B's system. [M] SOAP REST
Line ofBusiness
Text recording the description of the operations conducted by a business. [M+] SOAP REST
Local ActivityIndustry Code
Records the business activities in which an organization is actively engaged usingstandardized coding schemes such as European NACE and other country-specificClassification of Economic Activities.
SOAP REST
LocationOwnershipText
Text specifying the terms under which this subject occupies the premises (i.e., one ormore facilities) at the primary address, e.g., owned, rented or leased. [M+]
SOAP REST
MailUndeliverable(NIXIE)Indicator
When 'true' indicates that it is it is not possible to deliver mail to this address. When'false' indicates that mail to this address can be delivered; however, as this is theassumed condition there is no requirement to create this tag to represent this fact. [M+]
SOAP REST
MajorIndustryCategory
A narrative description of the operations or activities of the business. Relates to theprimary four-digit 1987 US SIC. In English.
SOAP REST
MarketSegmentationClusters
The assigned Market Segmentation Cluster (MSC) values for this organization. MSCvalues represent 22 distinct mutually exclusive profiles resulting from a cluster analysisof U.S. D&B data. [M]
SOAP REST
MarketabilityIndicator
When 'true' indicates that the record satisfies D&B marketability rules. When 'false'indicates that the record does not satisfy D&B marketability rules; however, there is norequirement to create this tag to represent this fact. [M]
SOAP REST
MarketingPrescreenScore
Prescreen score is a D&B marketing tool that predicts the likelihood of a company’s abilityto pay all its bills on time over the next 12 months. Updated monthly, it shows thelikelihood that a company may become a collection problem. Scores are calculated usingstatistical models and the most recent payment information in D&B’s commercialdatabase. It is intended to be a marketing tool and should not be used for credit decisionson individual organizations. [M+]
SOAP REST
MetropolitanStatisticalArea Code
A code describing a geographical region with a relatively high population density at itscore and close economic ties throughout the area. [M+]
SOAP REST
MinorityOwnedIndicator
When 'true' indicates that this organization is certified as a business that is greater than50% owned by and whose management and daily business operations are controlled byone or more minority group members. [M]
SOAP REST
Most SeniorPrincipal FullName
Text recording the name of the CEO. [M] SOAP REST
Most SeniorPrincipalIdentificationNumber
A number assigned by an external body or by D&B which either uniquely identifies orhelps to identify the individual who is the most senior principal at this organization.
SOAP REST
D&B Direct API Documentation Business Elements
©Dun & Bradstreet, Inc. 2014 62
Name Description XML* JSON*
Most SeniorPrincipal JobTitle
Text recording the job held by the most senior principal; For example, CEO, President andCEO. [M+]
SOAP REST
NAICS Code An alphanumeric value identifying the business activity based on the NAICS Code. Canrepeat multiple times.
SOAP REST
NAICS CodeDescription
Text that describes the business activity based on the scheme specified by the attributetype, e.g., 'highway and street construction' is the description of industry code 1611 inthe U.S. SIC (Standard Industrial Classification) system.
SOAP REST
NonMarketableReason Text
Text specifying the reason why the subject's data is not considered marketable by D&B.[M+]
SOAP REST
Non-PostalTown
Text recording the name of a village, town or suburb where this is not a PrimaryTown/City. For example, 'Booker' in Booker, High Wycombe. [M+]
SOAP REST
Number ofFamilyMembersIncludingSubsidiaries
This is the number of linkages in the upward and downward directions of the entirefamily tree that the subject belongs to, starting from the global ultimate.
SOAP REST
OperatingStatusComment
Free form text which records the summary of the company's trading status. [M] SOAP REST
OperationsText
Text that describes detailed information regarding a business operation. [M] SOAP REST
OrganizationHistory Text
Text that indicates if D&B has any information that may reflect unfavorably on thisorganization, e.g. clear, incomplete, management and business.
SOAP REST
OrganizationIdentificationNumber
A number assigned by an external body or by D&B which either uniquely identifies orhelps to identify an organization.
SOAP REST
OrganizationStart Year
The year when operations undertaken by the organization commenced. [M] SOAP REST
OrganizationSummaryText
Text that records a brief statement or account of this organization. [M] SOAP REST
Out ofBusinessIndicator
Text that records the operating status of the business. [M+] SOAP REST
OwnershipControl Type
Text that describes the type of controlling ownership e.g. publicly owned, privatelyowned, state owned. [M+]
SOAP REST
OwnershipEthnicity Type
Text that records the racial, national, tribal, or cultural classifications that are applied toan organization based on the ethnicity of a majority of its ownership.
SOAP REST
PoliticalDistrict
Text recording a distinct territorial subdivision for holding a separate election for one ormore seats in a legislative body to which this address belongs. In the U.S. this is anumber. In the U.K. this is text that describes the U.K. Constituency. [M+]
SOAP REST
D&B Direct API Documentation Business Elements
©Dun & Bradstreet, Inc. 2014 63
Name Description XML* JSON*
Premises AreaMeasurement
Text that records the measurement of the premises. [M+] SOAP REST
Premises AreaMeasurementReliability Text
Text that describes the accuracy of the measurement found in Premises AreaMeasurement; e.g., actual, estimated, modeled. [M+]
SOAP REST
Premises AreaUnit ofMeasurement
Text that records the measurement unit used to express the Premises AreaMeasurement; e.g. acre, square meters, square feet. [M+]
SOAP REST
PremisesFunction Text
Text specifying an activity that is performed or is not performed at this facility by thesubject, e.g., manufacturing, warehousing, printing, packaging, office work. [M+]
SOAP REST
Previous D-U-N-S Number(Transfer)
The most recently retired D-U-N-S Number that is associated with this subject, often as aredundant record. An explanation for this change is provided in the transfer reason. [M+]
SOAP REST
PrimaryAddressLatitude
The angular distance of the organization's primary physical address north or south fromthe Earth's equator measured through 90 degrees expressed in decimal numbers. [M+]
SOAP REST
PrimaryAddressLongitude
The angular distance of the organization's primary physical address east or west from animaginary line (called the prime meridian) that goes from the North Pole to the SouthPole measured through 90 degrees expressed in decimal numbers. [M+]
SOAP REST
Primary SICCode
The first listed alphanumeric value identifying the primary business activity based on thescheme specified by the Standard Industrial Classification (SIC) Code. The first four digitsare external codes created by the U.S. Government. D&B has created extensions to moreprecisely define an activity as in the case of the SIC 2+2 (the last 4 digits of an 8-digit SIC).
SOAP REST
Primary SICDescription
Text that describes the business activity based on the scheme specified by the attributetype, e.g., 'highway and street construction' is the description of industry code 1611 inthe U.S. SIC (Standard Industrial Classification) system.
SOAP REST
RegisteredAddressIndicator
When 'true' indicates that the Primary Address which has been presented is also theRegistered Address. When 'false' indicates that the Primary Address which has beenpresented is not a Registered Address. [M+]
SOAP REST
RegistrationNumber - AllCountriesExcept US
A registration/identifier number assigned by local government agencies to identify abusiness within the local market. Examples include the France Siret Number, UK CRONumber, Europe VAT Number, Australia Company Number, and Brazilian State RegistryNumber.
SOAP REST
ResidentialAddressIndicator
When 'true' indicates that the Primary Address which has been presented is also theResidential Address. When 'false' indicates that the Primary Address which has beenpresented is not a Residential Address.
SOAP REST
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 theD-U-N-S Number to reference for future product requests. An explanation for thischange is provided in the transfer reason.
SOAP REST
Revenue PerShare
A number expressing proportionally what one or more of the business' financial figuresis in relation to one or more of the business' other financial figures. This figure is anindicator used to evaluate the business' financial condition or potential risk. [M+]
SOAP REST
D&B Direct API Documentation Business Elements
©Dun & Bradstreet, Inc. 2014 64
Name Description XML* JSON*
Sales RevenueAmount
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 tothe customer. [M]
SOAP REST
Secondary SICCode
An alphanumeric value identifying a business activity based on the scheme specified bythe Standard Industrial Classification (SIC) Code. Clarification Note: These are generallyexternal codes created by an external authoritative body like the U.S. Office ofManagement and Budget but D&B may have created extensions to more preciselydefine an activity as in the case of the SIC 2+2 (the last 4 digits of an 8-digit SIC). Canrepeat up to five times.
SOAP REST
Secondary SICDescription
Text that describes the business activity based on the scheme specified by the attributetype, e.g., 'highway and street construction' is the description of industry code 1611 inthe U.S. SIC (Standard Industrial Classification) system.
SOAP REST
SmallBusinessIndicator
When 'true' indicates that the subject qualifies as small business, eligible for assistancefrom SBA, with a place of business located in the United States. It must operate primarilywithin the United States or make a significant contribution to the U.S. economy throughpayment of taxes or use of American products, materials or labor. Together with itsaffiliates, it must meet the numerical size standards as defined in the Small BusinessSize Regulations 13 CFR 121. [M]
SOAP REST
StockExchangeCountry Code
The two-letter country code, defined by the International Organization forStandardization (ISO) ISO 3166-1 scheme identifying the country for this stock exchange.[M+]
SOAP REST
StockExchangeName
Text recording the name of the Stock Exchange on which the subject's shares aretraded. [M+]
SOAP REST
Stock TickerName
Text that identifies the subject at the Stock Exchange for share trading purposes, e.g.,DNB. [M+]
SOAP REST
TelephoneDisconnected(TIXIE)Indicator
When 'true' indicates that telecommunication number cannot be connected tosuccessfully. When 'false' indicates that telecommunication number can be connectedto successfully. When set to NULL, it indicates that D&B does not know whether thetelecommunication number can be connected to successfully.
SOAP REST
Third PartyAssessment
An alpha code assigned by a third party to define the kind of appraisal/opinion that wasassigned to this subject by the third party, e.g. Moody's Long Term Obligation Rating, FICOscore, Vantage Score. [M+]
SOAP REST
Third PartyAssessmentRank
Company's rank on a ranking list, such as number 100 on the Fortune 500 [M+] SOAP REST
Total EquityAmount
The total value of share capital/stock originally invested by shareholders/stockholdersplus any reserves which have arisen, such as retained profits, which are ploughed backinto the firm. Also known as Net Worth. [M+]
SOAP REST
UK SIC Code The first listed alphanumeric value identifying the primary business activity based on theUK SIC Code.
SOAP REST
Web SiteAddress
The Internet URL (Uniform Resource Locator) which uniquely identifies the proprietarywebsite of the subject or the website preferred by the subject which gives moreinformation on the subject. [M]
SOAP REST
D&B Direct API Documentation Business Elements
©Dun & Bradstreet, Inc. 2014 65
*The links in this column provide the technical characteristics for the data field of the respective business element in the
XML or JSON response.
The preceding list is not presented in the order, nor manner, in which the information is packaged anddelivered via the D&B Direct API.
While data for a particular company may not contain values for all of the business elements, there may beitems that are considered by D&B to be essential to yield the maximum benefit of a data layer. If any of theseessential elements do not contain a value for a particular company, an error code will be returned, and yourorganization will not incur a usage credit for the request.
The Product Availability Lookup feature may be utilized to determine if this D&B Direct product is availablefor a given D-U-N-S Number.
SIC Codes
SIC stands for Standard Industrial Classification. The idea of coding and classifying industries to help analyzeindustrial structure was first developed by the U.S. Government in the 1930’s. The Standard IndustrialClassification (SIC) System has been widely adopted as the standard coding system used to define and analyzeindustry structure.
D&B assigns SIC’s at the eight-digit level and can include up to six base (four-digit, which are defined by theGovernment) SIC’s with up to four, four-digit extensions for each, for a maximum total of twenty-fourseparate lines of business per record to identify what a business does.
Market Segmentation Clusters
The following are high level descriptions of the market segmentation cluster values delivered in this datalayer:
l 1 = High Tension Branches of Insurance/Utility Industriesl 2 = Bustling Manufacturers & Business Servicesl 3 = The Withering Branch Companyl 4 = Rapid Growth Large Businessesl 5 = Sunny Branches of Insurance/Utility Industriesl 6 = Labor Intensive Giantsl 7 = Entrepreneur & Co.l 8 = Frugal & Associatesl 9 = Spartansl 10 = Struggling Start Upsl 11 = The Hectic Venture Companyl 12 = The Established Shingle Companyl 13 = Industry Inc.l 14 = Landmark Business Services
D&B Direct API Documentation Business Elements
©Dun & Bradstreet, Inc. 2014 66
l 15 = The Test Of Time Companyl 16 = Powerhouse 6000l 17 = In Good Handsl 18 = Sudden Growth Giantsl 19 = Active Tradersl 20 = Old Core Proprietorsl 21 = Solid & Sonsl 22 = Main Street USA
Third Party Assessment Rank
The following is a list of possible assessment types:
l Amsterdam Exchange 25l ASX 50 (September 2013)l BEL20l CAC 40l CAC Mid 60l DAX 30l Dow Jones Global Titansl Dow Jones Industrialsl Dow Jones Transportsl Dow Jones Utilitiesl Euronext 100l Forbes Largest Private Companies (November 2012)l FORTUNE 1000 (May 2013)l FORTUNE 500 (May 2013)l FORTUNE's Fastest-Growing Companies (September 2013)l FT Global 500 (July 2013)l FTSE 100l FTSE 250l Hang Sengl IBEX 35l LuxXl Madrid Generall MDAXl Mexican Bolsal MIBl Nikkei 225l Russell 2000 (June 2013)l S&P 500 (September 30, 2013)l S&P 600 (September 30, 2013)l SBF 120l SENSEX
D&B Direct API Documentation Business Elements
©Dun & Bradstreet, Inc. 2014 67
l STOXX Europe 50l Straits Timesl Swiss Marketl TecDAXl TSX 60l TSX Completionl TSX Smallcap
Additional Details
There are two varieties of this product: Marketing and Risk (referred to as Alternative). They both offer similarbusiness elements; however, there may be differences in the availability of data for certain countries. The dataprovided in the Risk version may also be updated more frequently, making it the preferred source when it isavailable for a given country.
The results from this product will include principal identification numbers (Principal ID) that may be passed tothe People feature to obtain additional information about individuals.
Access to this information is provided on a metered basis; and will require data layer entitlement prior to usein the production environment. A built-in feature exists to prevent duplicate billing when multiple requestswith the same D-U-N-S Number and product code are submitted on the same calendar day (which is based onEastern Standard Time [GMT-5]).
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.
Related Topics
Alternative Detailed Company Profile - Enhanced, Alternative Detailed Company Profile - Standard, DetailedCompany Profile, D&B Business Information Report.
Technical Specification
For details on how to obtain this data layer, please refer to the Firmographic.OrderProduct (SOAP) orFirmographic.OrderProduct (REST) page.
D&B Direct API Documentation Additional Details
©Dun & Bradstreet, Inc. 2014 68
Alternative Detailed Company Profile - EnhancedThe most efficient way to gain the most up to date information about a company such as business name,address, D&B D-U-N-S Number, fax, phone, trade style, legal status, industry, sales, and more.
Requirements & Options
When requesting this D&B Direct product, a valid D-U-N-S Number for a company, its country code, and theappropriate product code will be required. If this information is not available, refer to obtaining a company D-U-N-S Number for assistance. A trade up option exists to request data for the headquarters when therequested organization is a branch.
When ordering information for organizations located in Germany, customers are required to provide a validorder reason code. A list of possible values is included on the respective SOAP or REST operation page.
Note: The product code for Alternative Detailed Company Profile - Enhanced is DCP_ALT_ENH. Thisproduct may be included in the Monitoring process.
Business Elements
The following table is an alphabetical list of the unique items delivered in this data layer. Legend: [C] = maybe included in a Custom Data product; [M] = may be referenced by the Monitoring process; [M+] = Monitoredusing an aggregate or attribute XPath.
Note: This product will 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, et al.)along with the business elements listed. In addition, customers who compare the following table to theData Primer should be advised of several intentional differences.
Name Description XML* JSON*
8ACertificationIndicator
When 'true' indicates that a business meets the eligibility criteria established by theSmall Business Administration for small companies owned by socially and economicallydisadvantaged persons, so that they may bid and obtain federal government contractsand other assistance to develop their business. The business owner must be eligibleunder the same rules and guidelines set down by the federal government. [M]
SOAP REST
AccountantName
Text recording the name of either an individual or the name of an accounting firm. [M+] SOAP REST
AgentIndicator
When 'true' indicates that the subject acts as an agent promoting the goods or servicesof another organization, e.g., Sales Agent, Purchasing Agent. When 'false' indicates thatthe subject does not act as an agent of another organization. [M]
SOAP REST
D&B Direct API Documentation Alternative Detailed Company Profile - Enhanced
©Dun & Bradstreet, Inc. 2014 69
Name Description XML* JSON*
Asset ArticleQuantity
A number specifying how many of this particular asset type are held, owned, or managedby the subject. [M]
SOAP REST
Best FEINIndicator
For companies that may be associated with multiple FEIN numbers, this field (when setto 1) identifies the FEIN records that are considered by D&B to be the most relevant forthis subject.
SOAP REST
BoneyardOrganizationIndicator
When 'true' indicates that data on the company is no longer collected and was coveredby Hoover's Editorial staff before being acquired or going out of business. [M]
SOAP REST
BusinessLegalStructure
Text that describes the legal form or structure of a business, as registered withgovernment authorities, e.g., partnership, corporation, private limited company,government department, proprietorship. [M+]
SOAP REST
CompanyPrincipal FullName
Text recording the complete name of an individual who is primarily responsible for thedecisions that drive the business. [M]
SOAP REST
CompanyPrincipalIdentificationNumber
A number assigned by an external body or by D&B which either uniquely identifies orhelps to identify the principal.
SOAP REST
CompanyPrincipal JobTitle
Text recording the job held by the principal or manager. E.g. e.g., Leader GlobalCommunication, Manager National Technical Support Center. [M]
SOAP REST
ContinentCode (WorldRegion 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+]
SOAP REST
Control Year The year current control was assumed. [M] SOAP REST
D&B HooversIndustry Code
An alphanumeric industry code identifying a business activity, based on a three-tiertaxonomy developed by D&B as a complement to NAICS and SIC codes, that are assignedaccording to companies’ primary and secondary business activities.
SOAP REST
D&B HooversIndustry CodeDescription
Text that describes the business activity based on the scheme specified by the attributetype.
SOAP REST
D&B IndustryCode
An alphanumeric value identifying a business activity based on the scheme specified bythe Standard Industrial Classification (SIC) Code. The first four digits are external codescreated by the U.S. Government. D&B has created extensions to more precisely define anactivity as in the case of the SIC 2+2 (the last 4 digits of an 8-digit SIC).
SOAP REST
D&B IndustryCodeDescription
Text that describes the business activity based on the scheme specified by the attributetype, e.g., 'highway and street construction' is the description of industry code 1611 inthe U.S. SIC (Standard Industrial Classification) system.
SOAP REST
D-U-N-SNumberTransfer Date
The date associated with the most recent retirement of a D-U-N-S Number affecting thissubject. When included in a monitoring notice, the Retained D-U-N-S Number should beused for subsequent requests. When included in a product response, the Previous D-U-N-S Number is provided for reference purposes.
SOAP REST
D&B Direct API Documentation Business Elements
©Dun & Bradstreet, Inc. 2014 70
Name Description XML* JSON*
D-U-N-SNumberTransferReason 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 forsubsequent requests. When included in a product response, the Previous D-U-N-SNumber is provided for reference purposes.
SOAP REST
D-U-N-S SelfRequest Date
The date on which the DUNS was created as a result of a Self Request. (Data onlyavailable from 1997).
SOAP REST
D-U-N-S SelfRequestIndicator
When 'true' indicates that the D-U-N-S Number for this subject was created at therequest of the subject. When 'false' indicates that the D-U-N-S Number for this subjectwas not created at the request of the subject; however, as this is the assumed conditionthere is no requirement to create this tag to represent this fact.
SOAP REST
EmployeeQuantity (AllLocations)
A number that defines how many people are directly engaged and paid by theorganization to perform or support its business operations. [M]
SOAP REST
EmployeeQuantity(SingleLocation)
A number that defines how many people are directly engaged and paid by theorganization to perform or support its business operations at the subject's location. [M]
SOAP REST
EmployeeQuantity BasisText
Text that indicates when it has been reported to D&B that certain types of employeeshave been included in the calculation of the Employee Quantity. [M+]
SOAP REST
EmployeeQuantityGrowth Rate
The annual rate at which total number of employees in a firm's has been or is expectedto grow.
SOAP REST
EmployeeQuantityReliability Text(All Locations)
Text that describes the integrity of the employee figures, e.g. audited, actual, estimated,or modeled. [M+]
SOAP REST
EmployeeQuantityReliability Text(SingleLocation)
Text that describes the integrity of the employee figures, e.g. audited, actual, estimated,or modeled. [M+]
SOAP REST
ExportIndicator
When 'true' indicates that the subject company exports goods to other countries. [M] SOAP REST
FEINAssignmentMethod
Text that identifies how the inquiry DUNS was assigned based on a direct source such asan Agency or if assigned based on the branch process which utilizes the HQ linkage toassign the HQ FEIN to each Branch.
SOAP REST
FEINCollectionDate
The date the FEIN information was received. SOAP REST
FEIN Issuer D-U-N-S Number
The DUNS Number assigned to the entity that provided the FEIN number to D&B. SOAP REST
FEIN IssuerOrganizationName
Text recording the name of the entity that provided the FEIN Number to D&B. SOAP REST
D&B Direct API Documentation Business Elements
©Dun & Bradstreet, Inc. 2014 71
Name Description XML* JSON*
FEINRegistrationBusinessName
Text recording the filing name for the unique nine-digit number assigned by the U.S.Internal Revenue Service to business entities (and in some cases individuals) operating inthe United States for the purposes of conducting business.
SOAP REST
FEINRegistrationPostal Code
An identifier used by the local country postal authority to identify where theidentification number provider is located.
SOAP REST
FEINRegistrationStreetAddress
Text that records the street address components as it would be presented on an addresslabel. This includes, but is not limited to, details such as street name, street number,building name, estate name.
SOAP REST
FEINRegistrationTerritoryName
Text recording the name of the territory or state where the entity which provided theFEIN Number to D&B is located
SOAP REST
FEINRegistrationTown Name
Text recording the mailing address town or city name that is recorded in the FEINregistration.
SOAP REST
FEIN Tax IDNumber
A number recording a unique nine-digit FEIN number assigned by the U.S. InternalRevenue Service to business entities (and in some cases individuals) operating in theUnited States for the purposes of identification.
SOAP REST
FinancialStatementCurrency
The three-letter code, published by International Organization for Standardization (ISO),identifying the type of money that corresponds to the values in the financial statement.[M+]
SOAP REST
FinancialStatementDate
The date when the accounting period ended. If the accounting figures are projected(future), then this is the date when the accounting period will end. [M+]
SOAP REST
FinancialStatementDate (KeyFinancialFigures)
The date or partial date (i.e. period showing year/month) when the accounting periodended. If the Reliability Code denotes the figures are projected (future) then this whenthe accounting period will end. [M]
SOAP REST
FinancialStatementPeriod
The period of the financial statement expressed as a number of years, months or days.(e.g. P3M is 3 months or quarterly, P1Y is 1 year or annual)
SOAP REST
FinancialStatementUnit of Size
Text which identifies the unit of size that corresponds to the values in the financialstatement. [M+]
SOAP REST
FormerBusinessName
Text recording the former business name. SOAP REST
FranchiseOperationType
Text that denotes whether the franchise rights are operated by a company or directly bythe franchisee; i.e. franchisee, franchisor. [M+]
SOAP REST
D&B Direct API Documentation Business Elements
©Dun & Bradstreet, Inc. 2014 72
Name Description XML* JSON*
GeographicalPrecision Text
Text that identifies the accuracy of the match used for an address. [M+] SOAP REST
GlobalUltimate TotalEmployeeQuantity
A number that defines how many people are directly engaged and paid by theorganization to perform or support its business operations. Includes employees in theentire global family tree, including all direct and indirect subsidiaries of the globalultimate parent company, and all branch and division locations.
SOAP REST
HeadquarterD-U-N-SNumber
The D-U-N-S Number of the headquarters company. A headquarters is a businessestablishment that has branches or divisions reporting to it. [M]
SOAP REST
ImportIndicator
When 'true' indicates that the subject company imports a quantity of goods from othercountries. [M]
SOAP REST
In Date Status An text element that indicates "in date" status, i.e. whether D&B has recently collecteddata on this business.
SOAP REST
IncorporationYear
The year the business incorporated - The year the business entity incorporated orregistered as the current legal structure. The Incorporation Year may or may not be thesame as the year the business started. [M]
SOAP REST
Industry CodePercentage ofSales
The value of annual sales which are attributable to the operations defined by IndustryCode Number as a percentage of total annual sales. Can repeat up to six times.
SOAP REST
Labor SurplusArea Indicator
When 'true' indicates that this organization is certified as a business that operates in alabor surplus area, which is a geographical area identified by the Department of Labor asan area of concentrated unemployment or underemployment or an area of labor [M]
SOAP REST
Last UpdateDate
The date when the record was last updated in D&B's system. [M] SOAP REST
Line ofBusiness
Text recording the description of the operations conducted by a business. [M+] SOAP REST
Local ActivityIndustry Code
Records the business activities in which an organization is actively engaged usingstandardized coding schemes such as European NACE and other country-specificClassification of Economic Activities.
SOAP REST
LocationOwnershipText
Text specifying the terms under which this subject occupies the premises (i.e., one ormore facilities) at the primary address, e.g., owned, rented or leased. [M+]
SOAP REST
MailUndeliverable(NIXIE)Indicator
When 'true' indicates that it is it is not possible to deliver mail to this address. When'false' indicates that mail to this address can be delivered; however, as this is theassumed condition there is no requirement to create this tag to represent this fact. [M+]
SOAP REST
MajorIndustryCategory
A narrative description of the operations or activities of the business. Relates to theprimary four-digit 1987 US SIC. In English.
SOAP REST
MarketabilityIndicator
When 'true' indicates that the record satisfies D&B marketability rules. When 'false'indicates that the record does not satisfy D&B marketability rules; however, there is norequirement to create this tag to represent this fact. [M]
SOAP REST
D&B Direct API Documentation Business Elements
©Dun & Bradstreet, Inc. 2014 73
Name Description XML* JSON*
MarketingPrescreenScore
Prescreen score is a D&B marketing tool that predicts the likelihood of a company’s abilityto pay all its bills on time over the next 12 months. Updated monthly, it shows thelikelihood that a company may become a collection problem. Scores are calculated usingstatistical models and the most recent payment information in D&B’s commercialdatabase. It is intended to be a marketing tool and should not be used for credit decisionson individual organizations. [M+]
SOAP REST
MetropolitanStatisticalArea Code
A code describing a geographical region with a relatively high population density at itscore and close economic ties throughout the area. [M+]
SOAP REST
MinorityOwnedIndicator
When 'true' indicates that this organization is certified as a business that is greater than50% owned by and whose management and daily business operations are controlled byone or more minority group members. [M]
SOAP REST
Most SeniorPrincipal FullName
Text recording the name of the CEO. [M] SOAP REST
Most SeniorPrincipalIdentificationNumber
A number assigned by an external body or by D&B which either uniquely identifies orhelps to identify the individual who is the most senior principal at this organization.
SOAP REST
Most SeniorPrincipal JobTitle
Text recording the job held by the most senior principal; For example, CEO, President andCEO. [M+]
SOAP REST
NAICS Code An alphanumeric value identifying the business activity based on the NAICS Code. Canrepeat multiple times.
SOAP REST
NAICS CodeDescription
Text that describes the business activity based on the scheme specified by the attributetype, e.g., 'highway and street construction' is the description of industry code 1611 inthe U.S. SIC (Standard Industrial Classification) system.
SOAP REST
NonMarketableReason Text
Text specifying the reason why the subject's data is not considered marketable by D&B.[M+]
SOAP REST
Non-PostalTown
Text recording the name of a village, town or suburb where this is not a PrimaryTown/City. For example, 'Booker' in Booker, High Wycombe. [M+]
SOAP REST
Number ofFamilyMembersIncludingSubsidiaries
This is the number of linkages in the upward and downward directions of the entirefamily tree that the subject belongs to, starting from the global ultimate.
SOAP REST
OperatingStatusComment
Free form text which records the summary of the company's trading status. [M] SOAP REST
OperationsText
Text that describes detailed information regarding a business operation. [M] SOAP REST
OrganizationHistory Text
Text that indicates if D&B has any information that may reflect unfavorably on thisorganization, e.g. clear, incomplete, management and business.
SOAP REST
D&B Direct API Documentation Business Elements
©Dun & Bradstreet, Inc. 2014 74
Name Description XML* JSON*
OrganizationIdentificationNumber
A number assigned by an external body or by D&B which either uniquely identifies orhelps to identify an organization.
SOAP REST
OrganizationStart Year
The year when operations undertaken by the organization commenced. [M] SOAP REST
OrganizationSummaryText
Text that records a brief statement or account of this organization. [M] SOAP REST
Out ofBusinessIndicator
Text that records the operating status of the business. [M+] SOAP REST
OwnershipControl Type
Text that describes the type of controlling ownership e.g. publicly owned, privatelyowned, state owned. [M+]
SOAP REST
OwnershipEthnicity Type
Text that records the racial, national, tribal, or cultural classifications that are applied toan organization based on the ethnicity of a majority of its ownership.
SOAP REST
PoliticalDistrict
Text recording a distinct territorial subdivision for holding a separate election for one ormore seats in a legislative body to which this address belongs. In the U.S. this is anumber. In the U.K. this is text that describes the U.K. Constituency. [M+]
SOAP REST
Premises AreaMeasurement
Text that records the measurement of the premises. [M+] SOAP REST
Premises AreaMeasurementReliability Text
Text that describes the accuracy of the measurement found in Premises AreaMeasurement; e.g., actual, estimated, modeled. [M+]
SOAP REST
Premises AreaUnit ofMeasurement
Text that records the measurement unit used to express the Premises AreaMeasurement; e.g. acre, square meters, square feet. [M+]
SOAP REST
PremisesFunction Text
Text specifying an activity that is performed or is not performed at this facility by thesubject, e.g., manufacturing, warehousing, printing, packaging, office work. [M+]
SOAP REST
Previous D-U-N-S Number(Transfer)
The most recently retired D-U-N-S Number that is associated with this subject, often as aredundant record. An explanation for this change is provided in the transfer reason. [M+]
SOAP REST
PrimaryAddressLatitude
The angular distance of the organization's primary physical address north or south fromthe Earth's equator measured through 90 degrees expressed in decimal numbers. [M+]
SOAP REST
PrimaryAddressLongitude
The angular distance of the organization's primary physical address east or west from animaginary line (called the prime meridian) that goes from the North Pole to the SouthPole measured through 90 degrees expressed in decimal numbers. [M+]
SOAP REST
Primary SICCode
The first listed alphanumeric value identifying the primary business activity based on thescheme specified by the Standard Industrial Classification (SIC) Code. The first four digitsare external codes created by the U.S. Government. D&B has created extensions to moreprecisely define an activity as in the case of the SIC 2+2 (the last 4 digits of an 8-digit SIC).
SOAP REST
Primary SICDescription
Text that describes the business activity based on the scheme specified by the attributetype, e.g., 'highway and street construction' is the description of industry code 1611 inthe U.S. SIC (Standard Industrial Classification) system.
SOAP REST
D&B Direct API Documentation Business Elements
©Dun & Bradstreet, Inc. 2014 75
Name Description XML* JSON*
RegisteredAddressIndicator
When 'true' indicates that the Primary Address which has been presented is also theRegistered Address. When 'false' indicates that the Primary Address which has beenpresented is not a Registered Address. [M+]
SOAP REST
RegistrationNumber - AllCountriesExcept US
A registration/identifier number assigned by local government agencies to identify abusiness within the local market. Examples include the France Siret Number, UK CRONumber, Europe VAT Number, Australia Company Number, and Brazilian State RegistryNumber.
SOAP REST
ResidentialAddressIndicator
When 'true' indicates that the Primary Address which has been presented is also theResidential Address. When 'false' indicates that the Primary Address which has beenpresented is not a Residential Address.
SOAP REST
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 theD-U-N-S Number to reference for future product requests. An explanation for thischange is provided in the transfer reason.
SOAP REST
Revenue PerShare
A number expressing proportionally what one or more of the business' financial figuresis in relation to one or more of the business' other financial figures. This figure is anindicator used to evaluate the business' financial condition or potential risk. [M+]
SOAP REST
Sales RevenueAmount
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 tothe customer. [M]
SOAP REST
Secondary SICCode
An alphanumeric value identifying a business activity based on the scheme specified bythe Standard Industrial Classification (SIC) Code. Clarification Note: These are generallyexternal codes created by an external authoritative body like the U.S. Office ofManagement and Budget but D&B may have created extensions to more preciselydefine an activity as in the case of the SIC 2+2 (the last 4 digits of an 8-digit SIC). Canrepeat up to five times.
SOAP REST
Secondary SICDescription
Text that describes the business activity based on the scheme specified by the attributetype, e.g., 'highway and street construction' is the description of industry code 1611 inthe U.S. SIC (Standard Industrial Classification) system.
SOAP REST
SmallBusinessIndicator
When 'true' indicates that the subject qualifies as small business, eligible for assistancefrom SBA, with a place of business located in the United States. It must operate primarilywithin the United States or make a significant contribution to the U.S. economy throughpayment of taxes or use of American products, materials or labor. Together with itsaffiliates, it must meet the numerical size standards as defined in the Small BusinessSize Regulations 13 CFR 121. [M]
SOAP REST
StockExchangeCountry Code
The two-letter country code, defined by the International Organization forStandardization (ISO) ISO 3166-1 scheme identifying the country for this stock exchange.[M+]
SOAP REST
StockExchangeName
Text recording the name of the Stock Exchange on which the subject's shares aretraded. [M+]
SOAP REST
Stock TickerName
Text that identifies the subject at the Stock Exchange for share trading purposes, e.g.,DNB. [M+]
SOAP REST
D&B Direct API Documentation Business Elements
©Dun & Bradstreet, Inc. 2014 76
Name Description XML* JSON*
TelephoneDisconnected(TIXIE)Indicator
When 'true' indicates that telecommunication number cannot be connected tosuccessfully. When 'false' indicates that telecommunication number can be connectedto successfully. When set to NULL, it indicates that D&B does not know whether thetelecommunication number can be connected to successfully.
SOAP REST
Third PartyAssessment
An alpha code assigned by a third party to define the kind of appraisal/opinion that wasassigned to this subject by the third party, e.g. Moody's Long Term Obligation Rating, FICOscore, Vantage Score. [M+]
SOAP REST
Third PartyAssessmentRank
Company's rank on a ranking list, such as number 100 on the Fortune 500 [M+] SOAP REST
Total EquityAmount
The total value of share capital/stock originally invested by shareholders/stockholdersplus any reserves which have arisen, such as retained profits, which are ploughed backinto the firm. Also known as Net Worth. [M+]
SOAP REST
UK SIC Code The first listed alphanumeric value identifying the primary business activity based on theUK SIC Code.
SOAP REST
Web SiteAddress
The Internet URL (Uniform Resource Locator) which uniquely identifies the proprietarywebsite of the subject or the website preferred by the subject which gives moreinformation on the subject. [M]
SOAP REST
*The links in this column provide the technical characteristics for the data field of the respective business element in the
XML or JSON response.
The preceding list is not presented in the order, nor manner, in which the information is packaged anddelivered via the D&B Direct API.
While data for a particular company may not contain values for all of the business elements, there may beitems that are considered by D&B to be essential to yield the maximum benefit of a data layer. If any of theseessential elements do not contain a value for a particular company, an error code will be returned, and yourorganization will not incur a usage credit for the request.
The Product Availability Lookup feature may be utilized to determine if this D&B Direct product is availablefor a given D-U-N-S Number.
SIC Codes
SIC stands for Standard Industrial Classification. The idea of coding and classifying industries to help analyzeindustrial structure was first developed by the U.S. Government in the 1930’s. The Standard IndustrialClassification (SIC) System has been widely adopted as the standard coding system used to define and analyzeindustry structure.
D&B assigns SIC’s at the eight-digit level and can include up to six base (four-digit, which are defined by theGovernment) SIC’s with up to four, four-digit extensions for each, for a maximum total of twenty-fourseparate lines of business per record to identify what a business does.
D&B Direct API Documentation Business Elements
©Dun & Bradstreet, Inc. 2014 77
Additional Details
There are two varieties of this product: Marketing and Risk (referred to as Alternative). They both offer similarbusiness elements; however, there may be differences in the availability of data for certain countries. The dataprovided in the Risk version may also be updated more frequently, making it the preferred source when it isavailable for a given country.
The results from this product will include principal identification numbers (Principal ID) that may be passed tothe People feature to obtain additional information about individuals.
Access to this information is provided on a metered basis; and will require data layer entitlement prior to usein the production environment. A built-in feature exists to prevent duplicate billing when multiple requestswith the same D-U-N-S Number and product code are submitted on the same calendar day (which is based onEastern Standard Time [GMT-5]).
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.
Related Topics
Alternative Detailed Company Profile - Premium, Alternative Detailed Company Profile - Standard, DetailedCompany Profile, D&B Business Information Report.
Technical Specification
For details on how to obtain this data layer, please refer to the Firmographic.OrderProduct (SOAP) orFirmographic.OrderProduct (REST) page.
D&B Direct API Documentation Additional Details
©Dun & Bradstreet, Inc. 2014 78
Alternative Detailed Company Profile - StandardThe most efficient way to gain the most up to date information about a company such as business name,address, D&B D-U-N-S Number, fax, phone, trade style, legal status, industry, sales, and more.
Requirements & Options
When requesting this D&B Direct product, a valid D-U-N-S Number for a company, its country code, and theappropriate product code will be required. If this information is not available, refer to obtaining a company D-U-N-S Number for assistance. A trade up option exists to request data for the headquarters when therequested organization is a branch.
When ordering information for organizations located in Germany, customers are required to provide a validorder reason code. A list of possible values is included on the respective SOAP or REST operation page.
Note: The product code for Alternative Detailed Company Profile - Standard is DCP_ALT_STD. Thisproduct may be included in the Monitoring process.
Business Elements
The following table is an alphabetical list of the unique items delivered in this data layer. Legend: [C] = maybe included in a Custom Data product; [M] = may be referenced by the Monitoring process; [M+] = Monitoredusing an aggregate or attribute XPath.
Note: This product will 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, et al.)along with the business elements listed. In addition, customers who compare the following table to theData Primer should be advised of several intentional differences.
Name Description XML* JSON*
8ACertificationIndicator
When 'true' indicates that a business meets the eligibility criteria established by theSmall Business Administration for small companies owned by socially and economicallydisadvantaged persons, so that they may bid and obtain federal government contractsand other assistance to develop their business. The business owner must be eligibleunder the same rules and guidelines set down by the federal government. [M]
SOAP REST
AgentIndicator
When 'true' indicates that the subject acts as an agent promoting the goods or servicesof another organization, e.g., Sales Agent, Purchasing Agent. When 'false' indicates thatthe subject does not act as an agent of another organization. [M]
SOAP REST
Asset ArticleQuantity
A number specifying how many of this particular asset type are held, owned, or managedby the subject. [M]
SOAP REST
D&B Direct API Documentation Alternative Detailed Company Profile - Standard
©Dun & Bradstreet, Inc. 2014 79
Name Description XML* JSON*
Best FEINIndicator
For companies that may be associated with multiple FEIN numbers, this field (when setto 1) identifies the FEIN records that are considered by D&B to be the most relevant forthis subject.
SOAP REST
CompanyPrincipal FullName
Text recording the complete name of an individual who is primarily responsible for thedecisions that drive the business. [M]
SOAP REST
CompanyPrincipalIdentificationNumber
A number assigned by an external body or by D&B which either uniquely identifies orhelps to identify the principal.
SOAP REST
CompanyPrincipal JobTitle
Text recording the job held by the principal or manager. E.g. e.g., Leader GlobalCommunication, Manager National Technical Support Center. [M]
SOAP REST
ContinentCode (WorldRegion 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+]
SOAP REST
Control Year The year current control was assumed. [M] SOAP REST
D&B HooversIndustry Code
An alphanumeric industry code identifying a business activity, based on a three-tiertaxonomy developed by D&B as a complement to NAICS and SIC codes, that are assignedaccording to companies’ primary and secondary business activities.
SOAP REST
D&B HooversIndustry CodeDescription
Text that describes the business activity based on the scheme specified by the attributetype.
SOAP REST
D&B IndustryCode
An alphanumeric value identifying a business activity based on the scheme specified bythe Standard Industrial Classification (SIC) Code. The first four digits are external codescreated by the U.S. Government. D&B has created extensions to more precisely define anactivity as in the case of the SIC 2+2 (the last 4 digits of an 8-digit SIC).
SOAP REST
D&B IndustryCodeDescription
Text that describes the business activity based on the scheme specified by the attributetype, e.g., 'highway and street construction' is the description of industry code 1611 inthe U.S. SIC (Standard Industrial Classification) system.
SOAP REST
D-U-N-SNumberTransfer Date
The date associated with the most recent retirement of a D-U-N-S Number affecting thissubject. When included in a monitoring notice, the Retained D-U-N-S Number should beused for subsequent requests. When included in a product response, the Previous D-U-N-S Number is provided for reference purposes.
SOAP REST
D-U-N-SNumberTransferReason 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 forsubsequent requests. When included in a product response, the Previous D-U-N-SNumber is provided for reference purposes.
SOAP REST
D-U-N-S SelfRequest Date
The date on which the DUNS was created as a result of a Self Request. (Data onlyavailable from 1997).
SOAP REST
D-U-N-S SelfRequestIndicator
When 'true' indicates that the D-U-N-S Number for this subject was created at therequest of the subject. When 'false' indicates that the D-U-N-S Number for this subjectwas not created at the request of the subject; however, as this is the assumed conditionthere is no requirement to create this tag to represent this fact.
SOAP REST
D&B Direct API Documentation Business Elements
©Dun & Bradstreet, Inc. 2014 80
Name Description XML* JSON*
EmployeeQuantity (AllLocations)
A number that defines how many people are directly engaged and paid by theorganization to perform or support its business operations. [M]
SOAP REST
EmployeeQuantity(SingleLocation)
A number that defines how many people are directly engaged and paid by theorganization to perform or support its business operations at the subject's location. [M]
SOAP REST
EmployeeQuantity BasisText
Text that indicates when it has been reported to D&B that certain types of employeeshave been included in the calculation of the Employee Quantity. [M+]
SOAP REST
EmployeeQuantityGrowth Rate
The annual rate at which total number of employees in a firm's has been or is expectedto grow.
SOAP REST
EmployeeQuantityReliability Text(All Locations)
Text that describes the integrity of the employee figures, e.g. audited, actual, estimated,or modeled. [M+]
SOAP REST
EmployeeQuantityReliability Text(SingleLocation)
Text that describes the integrity of the employee figures, e.g. audited, actual, estimated,or modeled. [M+]
SOAP REST
ExportIndicator
When 'true' indicates that the subject company exports goods to other countries. [M] SOAP REST
FEINAssignmentMethod
Text that identifies how the inquiry DUNS was assigned based on a direct source such asan Agency or if assigned based on the branch process which utilizes the HQ linkage toassign the HQ FEIN to each Branch.
SOAP REST
FEINCollectionDate
The date the FEIN information was received. SOAP REST
FEIN Issuer D-U-N-S Number
The DUNS Number assigned to the entity that provided the FEIN number to D&B. SOAP REST
FEIN IssuerOrganizationName
Text recording the name of the entity that provided the FEIN Number to D&B. SOAP REST
FEINRegistrationBusinessName
Text recording the filing name for the unique nine-digit number assigned by the U.S.Internal Revenue Service to business entities (and in some cases individuals) operating inthe United States for the purposes of conducting business.
SOAP REST
FEINRegistrationPostal Code
An identifier used by the local country postal authority to identify where theidentification number provider is located.
SOAP REST
D&B Direct API Documentation Business Elements
©Dun & Bradstreet, Inc. 2014 81
Name Description XML* JSON*
FEINRegistrationStreetAddress
Text that records the street address components as it would be presented on an addresslabel. This includes, but is not limited to, details such as street name, street number,building name, estate name.
SOAP REST
FEINRegistrationTerritoryName
Text recording the name of the territory or state where the entity which provided theFEIN Number to D&B is located
SOAP REST
FEINRegistrationTown Name
Text recording the mailing address town or city name that is recorded in the FEINregistration.
SOAP REST
FEIN Tax IDNumber
A number recording a unique nine-digit FEIN number assigned by the U.S. InternalRevenue Service to business entities (and in some cases individuals) operating in theUnited States for the purposes of identification.
SOAP REST
FinancialStatementCurrency
The three-letter code, published by International Organization for Standardization (ISO),identifying the type of money that corresponds to the values in the financial statement.[M+]
SOAP REST
FinancialStatementDate
The date when the accounting period ended. If the accounting figures are projected(future), then this is the date when the accounting period will end. [M+]
SOAP REST
FinancialStatementDate (KeyFinancialFigures)
The date or partial date (i.e. period showing year/month) when the accounting periodended. If the Reliability Code denotes the figures are projected (future) then this whenthe accounting period will end. [M]
SOAP REST
FinancialStatementPeriod
The period of the financial statement expressed as a number of years, months or days.(e.g. P3M is 3 months or quarterly, P1Y is 1 year or annual)
SOAP REST
FinancialStatementUnit of Size
Text which identifies the unit of size that corresponds to the values in the financialstatement. [M+]
SOAP REST
FormerBusinessName
Text recording the former business name. SOAP REST
GlobalUltimate TotalEmployeeQuantity
A number that defines how many people are directly engaged and paid by theorganization to perform or support its business operations. Includes employees in theentire global family tree, including all direct and indirect subsidiaries of the globalultimate parent company, and all branch and division locations.
SOAP REST
HeadquarterD-U-N-SNumber
The D-U-N-S Number of the headquarters company. A headquarters is a businessestablishment that has branches or divisions reporting to it. [M]
SOAP REST
ImportIndicator
When 'true' indicates that the subject company imports a quantity of goods from othercountries. [M]
SOAP REST
In Date Status An text element that indicates "in date" status, i.e. whether D&B has recently collecteddata on this business.
SOAP REST
D&B Direct API Documentation Business Elements
©Dun & Bradstreet, Inc. 2014 82
Name Description XML* JSON*
IncorporationYear
The year the business incorporated - The year the business entity incorporated orregistered as the current legal structure. The Incorporation Year may or may not be thesame as the year the business started. [M]
SOAP REST
Industry CodePercentage ofSales
The value of annual sales which are attributable to the operations defined by IndustryCode Number as a percentage of total annual sales. Can repeat up to six times.
SOAP REST
Labor SurplusArea Indicator
When 'true' indicates that this organization is certified as a business that operates in alabor surplus area, which is a geographical area identified by the Department of Labor asan area of concentrated unemployment or underemployment or an area of labor [M]
SOAP REST
Last UpdateDate
The date when the record was last updated in D&B's system. [M] SOAP REST
Line ofBusiness
Text recording the description of the operations conducted by a business. [M+] SOAP REST
Local ActivityIndustry Code
Records the business activities in which an organization is actively engaged usingstandardized coding schemes such as European NACE and other country-specificClassification of Economic Activities.
SOAP REST
LocationOwnershipText
Text specifying the terms under which this subject occupies the premises (i.e., one ormore facilities) at the primary address, e.g., owned, rented or leased. [M+]
SOAP REST
MailUndeliverable(NIXIE)Indicator
When 'true' indicates that it is it is not possible to deliver mail to this address. When'false' indicates that mail to this address can be delivered; however, as this is theassumed condition there is no requirement to create this tag to represent this fact. [M+]
SOAP REST
MajorIndustryCategory
A narrative description of the operations or activities of the business. Relates to theprimary four-digit 1987 US SIC. In English.
SOAP REST
MarketabilityIndicator
When 'true' indicates that the record satisfies D&B marketability rules. When 'false'indicates that the record does not satisfy D&B marketability rules; however, there is norequirement to create this tag to represent this fact. [M]
SOAP REST
MinorityOwnedIndicator
When 'true' indicates that this organization is certified as a business that is greater than50% owned by and whose management and daily business operations are controlled byone or more minority group members. [M]
SOAP REST
Most SeniorPrincipal FullName
Text recording the name of the CEO. [M] SOAP REST
Most SeniorPrincipalIdentificationNumber
A number assigned by an external body or by D&B which either uniquely identifies orhelps to identify the individual who is the most senior principal at this organization.
SOAP REST
Most SeniorPrincipal JobTitle
Text recording the job held by the most senior principal; For example, CEO, President andCEO. [M+]
SOAP REST
NAICS Code An alphanumeric value identifying the business activity based on the NAICS Code. Canrepeat multiple times.
SOAP REST
D&B Direct API Documentation Business Elements
©Dun & Bradstreet, Inc. 2014 83
Name Description XML* JSON*
NAICS CodeDescription
Text that describes the business activity based on the scheme specified by the attributetype, e.g., 'highway and street construction' is the description of industry code 1611 inthe U.S. SIC (Standard Industrial Classification) system.
SOAP REST
NonMarketableReason Text
Text specifying the reason why the subject's data is not considered marketable by D&B.[M+]
SOAP REST
Non-PostalTown
Text recording the name of a village, town or suburb where this is not a PrimaryTown/City. For example, 'Booker' in Booker, High Wycombe. [M+]
SOAP REST
OrganizationHistory Text
Text that indicates if D&B has any information that may reflect unfavorably on thisorganization, e.g. clear, incomplete, management and business.
SOAP REST
OrganizationIdentificationNumber
A number assigned by an external body or by D&B which either uniquely identifies orhelps to identify an organization.
SOAP REST
OrganizationStart Year
The year when operations undertaken by the organization commenced. [M] SOAP REST
OrganizationSummaryText
Text that records a brief statement or account of this organization. [M] SOAP REST
Out ofBusinessIndicator
Text that records the operating status of the business. [M+] SOAP REST
OwnershipControl Type
Text that describes the type of controlling ownership e.g. publicly owned, privatelyowned, state owned. [M+]
SOAP REST
OwnershipEthnicity Type
Text that records the racial, national, tribal, or cultural classifications that are applied toan organization based on the ethnicity of a majority of its ownership.
SOAP REST
PoliticalDistrict
Text recording a distinct territorial subdivision for holding a separate election for one ormore seats in a legislative body to which this address belongs. In the U.S. this is anumber. In the U.K. this is text that describes the U.K. Constituency. [M+]
SOAP REST
Premises AreaMeasurement
Text that records the measurement of the premises. [M+] SOAP REST
Premises AreaMeasurementReliability Text
Text that describes the accuracy of the measurement found in Premises AreaMeasurement; e.g., actual, estimated, modeled. [M+]
SOAP REST
Premises AreaUnit ofMeasurement
Text that records the measurement unit used to express the Premises AreaMeasurement; e.g. acre, square meters, square feet. [M+]
SOAP REST
Previous D-U-N-S Number(Transfer)
The most recently retired D-U-N-S Number that is associated with this subject, often as aredundant record. An explanation for this change is provided in the transfer reason. [M+]
SOAP REST
PrimaryAddressLatitude
The angular distance of the organization's primary physical address north or south fromthe Earth's equator measured through 90 degrees expressed in decimal numbers. [M+]
SOAP REST
D&B Direct API Documentation Business Elements
©Dun & Bradstreet, Inc. 2014 84
Name Description XML* JSON*
PrimaryAddressLongitude
The angular distance of the organization's primary physical address east or west from animaginary line (called the prime meridian) that goes from the North Pole to the SouthPole measured through 90 degrees expressed in decimal numbers. [M+]
SOAP REST
Primary SICCode
The first listed alphanumeric value identifying the primary business activity based on thescheme specified by the Standard Industrial Classification (SIC) Code. The first four digitsare external codes created by the U.S. Government. D&B has created extensions to moreprecisely define an activity as in the case of the SIC 2+2 (the last 4 digits of an 8-digit SIC).
SOAP REST
Primary SICDescription
Text that describes the business activity based on the scheme specified by the attributetype, e.g., 'highway and street construction' is the description of industry code 1611 inthe U.S. SIC (Standard Industrial Classification) system.
SOAP REST
RegisteredAddressIndicator
When 'true' indicates that the Primary Address which has been presented is also theRegistered Address. When 'false' indicates that the Primary Address which has beenpresented is not a Registered Address. [M+]
SOAP REST
RegistrationNumber - AllCountriesExcept US
A registration/identifier number assigned by local government agencies to identify abusiness within the local market. Examples include the France Siret Number, UK CRONumber, Europe VAT Number, Australia Company Number, and Brazilian State RegistryNumber.
SOAP REST
ResidentialAddressIndicator
When 'true' indicates that the Primary Address which has been presented is also theResidential Address. When 'false' indicates that the Primary Address which has beenpresented is not a Residential Address.
SOAP REST
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 theD-U-N-S Number to reference for future product requests. An explanation for thischange is provided in the transfer reason.
SOAP REST
Revenue PerShare
A number expressing proportionally what one or more of the business' financial figuresis in relation to one or more of the business' other financial figures. This figure is anindicator used to evaluate the business' financial condition or potential risk. [M+]
SOAP REST
Sales RevenueAmount
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 tothe customer. [M]
SOAP REST
Secondary SICCode
An alphanumeric value identifying a business activity based on the scheme specified bythe Standard Industrial Classification (SIC) Code. Clarification Note: These are generallyexternal codes created by an external authoritative body like the U.S. Office ofManagement and Budget but D&B may have created extensions to more preciselydefine an activity as in the case of the SIC 2+2 (the last 4 digits of an 8-digit SIC). Canrepeat up to five times.
SOAP REST
Secondary SICDescription
Text that describes the business activity based on the scheme specified by the attributetype, e.g., 'highway and street construction' is the description of industry code 1611 inthe U.S. SIC (Standard Industrial Classification) system.
SOAP REST
SmallBusinessIndicator
When 'true' indicates that the subject qualifies as small business, eligible for assistancefrom SBA, with a place of business located in the United States. It must operate primarilywithin the United States or make a significant contribution to the U.S. economy throughpayment of taxes or use of American products, materials or labor. Together with itsaffiliates, it must meet the numerical size standards as defined in the Small BusinessSize Regulations 13 CFR 121. [M]
SOAP REST
D&B Direct API Documentation Business Elements
©Dun & Bradstreet, Inc. 2014 85
Name Description XML* JSON*
StockExchangeCountry Code
The two-letter country code, defined by the International Organization forStandardization (ISO) ISO 3166-1 scheme identifying the country for this stock exchange.[M+]
SOAP REST
StockExchangeName
Text recording the name of the Stock Exchange on which the subject's shares aretraded. [M+]
SOAP REST
Stock TickerName
Text that identifies the subject at the Stock Exchange for share trading purposes, e.g.,DNB. [M+]
SOAP REST
TelephoneDisconnected(TIXIE)Indicator
When 'true' indicates that telecommunication number cannot be connected tosuccessfully. When 'false' indicates that telecommunication number can be connectedto successfully. When set to NULL, it indicates that D&B does not know whether thetelecommunication number can be connected to successfully.
SOAP REST
Third PartyAssessment
An alpha code assigned by a third party to define the kind of appraisal/opinion that wasassigned to this subject by the third party, e.g. Moody's Long Term Obligation Rating, FICOscore, Vantage Score. [M+]
SOAP REST
Third PartyAssessmentRank
Company's rank on a ranking list, such as number 100 on the Fortune 500 [M+] SOAP REST
Total EquityAmount
The total value of share capital/stock originally invested by shareholders/stockholdersplus any reserves which have arisen, such as retained profits, which are ploughed backinto the firm. Also known as Net Worth. [M+]
SOAP REST
UK SIC Code The first listed alphanumeric value identifying the primary business activity based on theUK SIC Code.
SOAP REST
Web SiteAddress
The Internet URL (Uniform Resource Locator) which uniquely identifies the proprietarywebsite of the subject or the website preferred by the subject which gives moreinformation on the subject. [M]
SOAP REST
*The links in this column provide the technical characteristics for the data field of the respective business element in the
XML or JSON response.
The preceding list is not presented in the order, nor manner, in which the information is packaged anddelivered via the D&B Direct API.
While data for a particular company may not contain values for all of the business elements, there may beitems that are considered by D&B to be essential to yield the maximum benefit of a data layer. If any of theseessential elements do not contain a value for a particular company, an error code will be returned, and yourorganization will not incur a usage credit for the request.
The Product Availability Lookup feature may be utilized to determine if this D&B Direct product is availablefor a given D-U-N-S Number.
D&B Direct API Documentation Business Elements
©Dun & Bradstreet, Inc. 2014 86
SIC Codes
SIC stands for Standard Industrial Classification. The idea of coding and classifying industries to help analyzeindustrial structure was first developed by the U.S. Government in the 1930’s. The Standard IndustrialClassification (SIC) System has been widely adopted as the standard coding system used to define and analyzeindustry structure.
D&B assigns SIC’s at the eight-digit level and can include up to six base (four-digit, which are defined by theGovernment) SIC’s with up to four, four-digit extensions for each, for a maximum total of twenty-fourseparate lines of business per record to identify what a business does.
Additional Details
There are two varieties of this product: Marketing and Risk (referred to as Alternative). They both offer similarbusiness elements; however, there may be differences in the availability of data for certain countries. The dataprovided in the Risk version may also be updated more frequently, making it the preferred source when it isavailable for a given country.
The results from this product will include principal identification numbers (Principal ID) that may be passed tothe People feature to obtain additional information about individuals.
Access to this information is provided on a metered basis; and will require data layer entitlement prior to usein the production environment. A built-in feature exists to prevent duplicate billing when multiple requestswith the same D-U-N-S Number and product code are submitted on the same calendar day (which is based onEastern Standard Time [GMT-5]).
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.
Related Topics
Alternative Detailed Company Profile - Premium, Alternative Detailed Company Profile - Enhanced, DetailedCompany Profile, D&B Business Information Report.
Technical Specification
For details on how to obtain this data layer, please refer to the Firmographic.OrderProduct (SOAP) orFirmographic.OrderProduct (REST) page.
D&B Direct API Documentation Additional Details
©Dun & Bradstreet, Inc. 2014 87
Detailed Company Profile - SDMRThis data layer provides details comparable to the Strategic Database Marketing Record (SDMR) batch file.
Requirements & Options
When requesting this D&B Direct product, a valid D-U-N-S Number for a company, its country code, and theappropriate product code will be required. If this information is not available, refer to obtaining a company D-U-N-S Number for assistance. A trade up option exists to request data for the headquarters when therequested organization is a branch.
When ordering information for organizations located in Germany, customers are required to provide a validorder reason code. A list of possible values is included on the respective SOAP or REST operation page.
Note: The product code for Detailed Company Profile - SDMR is DCP_SDMR. This product may be includedin the Monitoring process.
Business Elements
The following table is an alphabetical list of the unique items delivered in this data layer. Legend: [C] = maybe included in a Custom Data product; [M] = may be referenced by the Monitoring process; [M+] = Monitoredusing an aggregate or attribute XPath.
Note: This product will 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, et al.)along with the business elements listed. In addition, customers who compare the following table to theData Primer should be advised of several intentional differences.
Name Description XML* JSON*
3 Year BaseEmployeeCount (TrendData)
The total number of employees for the Base Year, which is the first (oldest) year of thethree year trend calculation period. Trend Data fields are calculated once a year, in June,published the following July and used for the subsequent 12 months.
SOAP REST
3 Year BaseEmployeeCountReliability Text
Text that describes the integrity of the employee figures, e.g. audited, actual, estimated,or modeled.
SOAP REST
3 Year BaseSales Amount(Trend Data)
The Sales Amount from the income statement data in millions (USD) for the Base Year,which is the first (oldest) year of this three year trend calculation period. Trend Datafields are calculated once a year, in June, published the following July and used for thesubsequent 12 months. [M]
SOAP REST
D&B Direct API Documentation Detailed Company Profile - SDMR
©Dun & Bradstreet, Inc. 2014 88
Name Description XML* JSON*
3 Year GrowthPercentage onEmployees(Trend Data)
The percentage increase or decrease in the number of employees over a three yearperiod. This field is calculated by dividing the difference between the Trend Year and 3Year Base Employee Count values by the 3 year Base Employee Count and multiplying by100. [M]
SOAP REST
3 Year GrowthPercentage onSales Volume(Trend Data)
The percentage increase or decrease in the Sales Amount over a three year period. Thisfield is calculated by dividing the difference between the Trend Year and 3 Year BaseSales Amount by the 3 Year Base Sales Amount and multiplying by 100. [M]
SOAP REST
5 Year BaseEmployeeCount (TrendData)
The total number of employees for the Base Year, which is the first (oldest) year of thefive year trend calculation period. Trend Data fields are calculated once a year, in June,published the following July and used for the subsequent 12 months.
SOAP REST
5 Year BaseEmployeeCountReliability Text
Text that describes the integrity of the employee figures, e.g. audited, actual, estimated,or modeled.
SOAP REST
5 Year BaseSales Amount(Trend Data)
The Sales Amount from the income statement data in millions (USD) for the Base Year,which is the first (oldest) year of this five year trend calculation period. Trend Data fieldsare calculated once a year, in June, published the following July and used for thesubsequent 12 months. [M]
SOAP REST
5 Year GrowthPercentage onEmployees(Trend Data)
The percentage increase or decrease in the number of employees over a five year period.This field is calculated by dividing the difference between the Trend Year and 5 Year BaseEmployee Count values by the 5 year Base Employee Count and multiplying by 100. [M]
SOAP REST
5 Year GrowthPercentage onSales Volume(Trend Data)
The percentage increase or decrease in the Sales Amount over a five year period. Thisfield is calculated by dividing the difference between the Trend Year and 5 Year BaseSales Amount by the 5 Year Base Sales Amount and multiplying by 100. [M]
SOAP REST
AccountantName
Text recording the name of either an individual or the name of an accounting firm. [M+] SOAP REST
AgentIndicator
When 'true' indicates that the subject acts as an agent promoting the goods or servicesof another organization, e.g., Sales Agent, Purchasing Agent. When 'false' indicates thatthe subject does not act as an agent of another organization. [M]
SOAP REST
Business LegalStructure
Text that describes the legal form or structure of a business, as registered withgovernment authorities, e.g., partnership, corporation, private limited company,government department, proprietorship. [M+]
SOAP REST
Carrier RouteCode
A code assigned by the United States Postal Service (USPS) that sorts mail pieces to theindividual carrier routes within a 5-digit ZIP Code.
SOAP REST
Carrier RouteCode Type
Text describing the value contained in the Carrier Route Code field. SOAP REST
CompanyPrincipal FirstName
Text recording the first name of the principal. [M+] SOAP REST
D&B Direct API Documentation Business Elements
©Dun & Bradstreet, Inc. 2014 89
Name Description XML* JSON*
CompanyPrincipal JobTitle
Text recording the job held by the principal or manager. E.g. e.g., Leader GlobalCommunication, Manager National Technical Support Center. [M+]
SOAP REST
CompanyPrincipal LastName
Text recording the last name of the principal. [M+] SOAP REST
CompanyPrincipalMiddle Name
Text recording the middle name of the principal. [M+] SOAP REST
CompanyPrincipalName Prefix
Text that describes the correct form of address for this principal. For example, Dr.,Professor, Lord, etc.
SOAP REST
CompanyPrincipalName Suffix
Text recording a familial suffix to the principal's name (e.g. Senior, Junior, III. ) or aprofessional/qualification suffix to the principal's name (e.g. MD, PhD etc.) or some othersuffix to the principals name (e.g. Retired).
SOAP REST
ContinentCode (WorldRegion 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+]
SOAP REST
Control Year The year current control was assumed. [M] SOAP REST
Country Name Text recording the name of the country in which the business is located. [M+] SOAP REST
D&B City Code D&B proprietary geographical code which indicates the city where the business islocated. For US records, the code is unique within COUNTY, for non-US records, the codeis unique within COUNTRY. [M+]
SOAP REST
D&B CountryCode
D&B three-digit code which indicates the country where the business is located. SOAP REST
D&B CountyCode
D&B geographical code which identifies the county where the business is located. Codeis unique within state/province. [M+]
SOAP REST
D&B HooversIndustry Code
An alphanumeric industry code identifying a business activity, based on a three-tiertaxonomy developed by D&B as a complement to NAICS and SIC codes, that are assignedaccording to companies’ primary and secondary business activities.
SOAP REST
D&B IndustryCode
An alphanumeric value identifying a business activity based on the scheme specified bythe Standard Industrial Classification (SIC) Code. The first four digits are external codescreated by the U.S. Government. D&B has created extensions to more precisely definean activity as in the case of the SIC 2+2 (the last 4 digits of an 8-digit SIC).
SOAP REST
D&BState/ProvinceCode
D&B geographical code which indicates the state/province (aka primary subdivision)where the business is located. Only validated state/province names carry astate/province code. [M+]
SOAP REST
DomesticUltimateBusinessName
Text recording the name of the highest business in the family tree that is in the samecountry as the subject. [M]
SOAP REST
DomesticUltimate D&BCountry Code
D&B code of the country where the domestic ultimate is located. [M+] SOAP REST
D&B Direct API Documentation Business Elements
©Dun & Bradstreet, Inc. 2014 90
Name Description XML* JSON*
DomesticUltimate D-U-N-S Number
The D-U-N-S Number of the highest level parent within a corporate family tree that isdomiciled in the same country as the requested company. A parent is a corporation thatowns more than 50% of another corporation's capital stock. A subject may be its owndomestic ultimate. [M]
SOAP REST
DomesticUltimateFIPS CountryCode
The Federal Information Processing Standards (FIPS) code value which identifies thecountry where the domestic ultimate is located.
SOAP REST
DomesticUltimateTerritoryAbbreviatedName
Text recording the shortened name of the locally governed area which forms part of acentrally governed nation to identify where the domestic ultimate is located. [M+]
SOAP REST
Economic Areaof InfluenceCode
A code assigned by the U.S Bureau of Economic Analysis to identify the subject's regionalmarket that surrounds a metropolitan or micropolitan statistical area serving as aregional center of economic activity.
SOAP REST
EmployeeQuantity (AllLocations)
A number that defines how many people are directly engaged and paid by theorganization to perform or support its business operations. [M]
SOAP REST
EmployeeQuantity(SingleLocation)
A number that defines how many people are directly engaged and paid by theorganization to perform or support its business operations at the subject's location. [M]
SOAP REST
EmployeeQuantityReliability Text(All Locations)
Text that describes the integrity of the employee figures, e.g. audited, actual, estimated,or modeled. [M+]
SOAP REST
EmployeeQuantityReliability Text(SingleLocation)
Text that describes the integrity of the employee figures, e.g. audited, actual, estimated,or modeled. [M+]
SOAP REST
ExportIndicator
When 'true' indicates that the subject company exports goods to other countries. [M] SOAP REST
Family TreeHierarchyLevel Code
A two-position counter that indicates the number of family tree levels below the globalultimate business in its corporate hierarchy. The hierarchy level value of the globalultimate will always be 1. Each subsidiary level below the global ultimate is incrementedby one. Branch locations in a family tree will have the same hierarchy code as itsassociated headquarter. [M]
SOAP REST
FEIN Tax IDNumber
A number recording a unique nine-digit FEIN number assigned by the U.S. InternalRevenue Service to business entities (and in some cases individuals) operating in theUnited States for the purposes of identification.
SOAP REST
D&B Direct API Documentation Business Elements
©Dun & Bradstreet, Inc. 2014 91
Name Description XML* JSON*
FinancialStatementPeriod (KeyFinancialFigures)
The period of the financial statement expressed as a number of years, months or days.(e.g. P3M is 3 months or quarterly, P1Y is 1 year or annual)
SOAP REST
FIPS CountryCode
The Federal Information Processing Standards (FIPS) code value which identifies thecountry where this subject is located.
SOAP REST
FIPS CountyCode
The Federal Information Processing Standards code value which identifies the countywhere this subject is located.
SOAP REST
FIPS MSA Code The Federal Information Processing Standards (FIPS) code value which identifies theMetropolitan Statistical Area (MSA) where this subject is located.
SOAP REST
FIPS StateCode
The Federal Information Processing Standards (FIPS) territory code for where this subjectis located.
SOAP REST
GeographicalPrecision Text
Text that identifies the accuracy of the match used for an address. [M+] SOAP REST
GlobalUltimateBusinessName
Text recording the primary name of the global ultimate business. [M] SOAP REST
GlobalUltimate D&BCountry Code
D&B code of the country where the global ultimate is located. [M+] SOAP REST
GlobalUltimate D-U-N-S Number
The D-U-N-S number of the highest level parent within a corporate family tree. A parentis a corporation that owns more than 50% of another corporation's capital stock. Asubject may be its own global ultimate. [M]
SOAP REST
GlobalUltimate FIPSCountry Code
The Federal Information Processing Standards (FIPS) code value which identifies thecountry where the global ultimate is located.
SOAP REST
GlobalUltimateTerritoryAbbreviatedName
Text recording the shortened name of the locally governed area which forms part of acentrally governed nation to identify where the global ultimate is located. [M+]
SOAP REST
HeadquarterBusinessName
The business name of the headquarters company. A headquarters is a businessestablishment that has branches or divisions reporting to it. [M]
SOAP REST
HeadquarterD&B CountryCode
D&B code of the country where the company headquarters is located. [M+] SOAP REST
HeadquarterD-U-N-SNumber
The D-U-N-S Number of the headquarters company. A headquarters is a businessestablishment that has branches or divisions reporting to it. [M]
SOAP REST
D&B Direct API Documentation Business Elements
©Dun & Bradstreet, Inc. 2014 92
Name Description XML* JSON*
HeadquarterFIPS CountryCode
The Federal Information Processing Standards (FIPS) code value which identifies thecountry where the company headquarters is located.
SOAP REST
HeadquarterTerritoryAbbreviatedName
Text recording the shortened name of the locally governed area which forms part of acentrally governed nation to identify where the headquarters is located. [M+]
SOAP REST
ImportIndicator
When 'true' indicates that the subject company imports a quantity of goods from othercountries. [M]
SOAP REST
Last UpdateDate
The date when the record was last updated in D&B's system. [M] SOAP REST
Line ofBusiness
Text recording the description of the operations conducted by a business. [M+] SOAP REST
Local ActivityIndustry Code
Records the business activities in which an organization is actively engaged usingstandardized coding schemes such as European NACE and other country-specificClassification of Economic Activities.
SOAP REST
LocationOwnershipText
Text specifying the terms under which this subject occupies the premises (i.e., one ormore facilities) at the primary address, e.g., owned, rented or leased. [M+]
SOAP REST
Major IndustryCategory
A narrative description of the operations or activities of the business. Relates to theprimary four-digit 1987 US SIC. In English. [M]
SOAP REST
MetropolitanStatisticalArea Code
A code describing a geographical region with a relatively high population density at itscore and close economic ties throughout the area. [M+]
SOAP REST
MinorityOwnedIndicator
When 'true' indicates that this organization is certified as a business that is greater than50% owned by and whose management and daily business operations are controlled byone or more minority group members. [M]
SOAP REST
Most SeniorPrincipal FirstName
Text recording the first name of the most senior principal. [M+] SOAP REST
Most SeniorPrincipal FullName
Text recording the name of the CEO. [M+] SOAP REST
Most SeniorPrincipalGender
Text identifying the gender of the individual who has the highest ranking authority forthe business at this location.
SOAP REST
Most SeniorPrincipal JobTitle
Text recording the job held by the most senior principal; For example, CEO, President andCEO. [M+]
SOAP REST
Most SeniorPrincipal LastName
Text recording the last name of the most senior principal. [M+] SOAP REST
D&B Direct API Documentation Business Elements
©Dun & Bradstreet, Inc. 2014 93
Name Description XML* JSON*
Most SeniorPrincipalManagementResponsibility
Text identifying the business function of the principal derived from a standardManagement Responsibility Code (MRC). [M+]
SOAP REST
Most SeniorPrincipalMiddle Name
Text recording the middle name of the most senior principal. [M+] SOAP REST
Most SeniorPrincipalName Prefix
Text that describes the correct form of address for this principal. For example, Dr.,Professor, Lord, etc.
SOAP REST
Most SeniorPrincipalName Suffix
Text recording a familial suffix to the principal's name (e.g. Senior, Junior, III. ) or aprofessional/qualification suffix to the principal's name (e.g. MD, PhD etc.) or some othersuffix to the principals name (e.g. Retired).
SOAP REST
NAICS Code An alphanumeric value identifying the business activity based on the NAICS Code. Canrepeat multiple times.
SOAP REST
Number ofFamilyMembersIncludingSubsidiaries
This is the number of linkages in the upward and downward directions of the entirefamily tree that the subject belongs to, starting from the global ultimate. [M]
SOAP REST
OrganizationIdentificationNumber
A number assigned by an external body or by D&B which either uniquely identifies orhelps to identify an organization.
SOAP REST
Other PrincipalManagementResponsibility
Text identifying the business function of the principal derived from a standardManagement Responsibility Code (MRC). [M+]
SOAP REST
OwnershipControl Type
Text that describes the type of controlling ownership e.g. publicly owned, privatelyowned, state owned. [M]
SOAP REST
ParentBusinessName
Text recording the business name of the parent company. A parent is a corporation thatowns more than 50% of another corporation's capital stock; these owned companies aresubsidiaries to the parent company. [M]
SOAP REST
Parent D&BCountry Code
D&B code of the country where the parent organization is located. [M+] SOAP REST
Parent D-U-N-S Number
The D-U-N-S number of the parent company. A parent is a corporation that owns morethan 50% of another corporation's capital stock; these owned companies are subsidiariesto the parent company. [M]
SOAP REST
Parent FIPSCountry Code
The Federal Information Processing Standards (FIPS) code value which identifies thecountry where the parent organization is located.
SOAP REST
ParentTerritoryAbbreviatedName
Text recording the shortened name of the locally governed area which forms part of acentrally governed nation to identify where the parent company is located. [M+]
SOAP REST
PopulationCode
A numeric value assigned by D&B that describes thedensity of the residential populationfor the geographical area where the business is located.
SOAP REST
D&B Direct API Documentation Business Elements
©Dun & Bradstreet, Inc. 2014 94
Name Description XML* JSON*
Premises AreaMeasurement
Text that records the measurement of the premises. [M+] SOAP REST
PremisesFunction Text
Text specifying an activity that is performed or is not performed at this facility by thesubject, e.g., manufacturing, warehousing, printing, packaging, office work. [M+]
SOAP REST
PrimaryAddressLatitude
The angular distance of the organization's primary physical address north or south fromthe Earth's equator measured through 90 degrees expressed in decimal numbers. [M+]
SOAP REST
PrimaryAddressLongitude
The angular distance of the organization's primary physical address east or west from animaginary line (called the prime meridian) that goes from the North Pole to the SouthPole measured through 90 degrees expressed in decimal numbers. [M+]
SOAP REST
Primary SICCode
The first listed alphanumeric value identifying the primary business activity based on thescheme specified by the Standard Industrial Classification (SIC) Code. The first four digitsare external codes created by the U.S. Government. D&B has created extensions to moreprecisely define an activity as in the case of the SIC 2+2 (the last 4 digits of an 8-digit SIC).
SOAP REST
RegistrationNumber - AllCountriesExcept US
A registration/identifier number assigned by local government agencies to identify abusiness within the local market. Examples include the France Siret Number, UK CRONumber, Europe VAT Number, Australia Company Number, and Brazilian State RegistryNumber.
SOAP REST
Sales RevenueAmount
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 onto the customer. [M]
SOAP REST
Secondary SICCode
An alphanumeric value identifying a business activity based on the scheme specified bythe Standard Industrial Classification (SIC) Code. Clarification Note: These are generallyexternal codes created by an external authoritative body like the U.S. Office ofManagement and Budget but D&B may have created extensions to more preciselydefine an activity as in the case of the SIC 2+2 (the last 4 digits of an 8-digit SIC). Canrepeat up to five times.
SOAP REST
SmallBusinessIndicator
When 'true' indicates that the subject qualifies as small business, eligible for assistancefrom SBA, with a place of business located in the United States. It must operate primarilywithin the United States or make a significant contribution to the U.S. economy throughpayment of taxes or use of American products, materials or labor. Together with itsaffiliates, it must meet the numerical size standards as defined in the Small BusinessSize Regulations 13 CFR 121. [M]
SOAP REST
Time Period(Trend Data)
Text that describes the time period reflecting the calculation of related Trend Data fields.Values include "Between 0 and 12 months" (trend year), "1-3 years" (3-year base) and "1-5 years" (5-year base).
SOAP REST
Trend YearEmployeeCount (TrendData)
The total number of employees for the Trend Year, which is the last (most current) year.Trend Data fields are calculated once a year, in June, published the following July andused for the subsequent 12 months.
SOAP REST
Trend YearEmployeeCountReliability Text
Text that describes the integrity of the employee figures, e.g. audited, actual, estimated,or modeled.
SOAP REST
D&B Direct API Documentation Business Elements
©Dun & Bradstreet, Inc. 2014 95
Name Description XML* JSON*
Trend YearSales Amount(Trend Data)
The Sales Amount from the income statement data in millions (USD) for the Trend Year,which is the last (most current) year. Trend Data fields are calculated once a year, inJune, published the following July and used for the subsequent 12 months. [M]
SOAP REST
UK SIC Code The first listed alphanumeric value identifying the primary business activity based on theUK SIC Code.
SOAP REST
*The links in this column provide the technical characteristics for the data field of the respective business element in the
XML or JSON response.
The preceding list is not presented in the order, nor manner, in which the information is packaged anddelivered via the D&B Direct API.
While data for a particular company may not contain values for all of the business elements, there may beitems that are considered by D&B to be essential to yield the maximum benefit of a data layer. If any of theseessential elements do not contain a value for a particular company, an error code will be returned, and yourorganization will not incur a usage credit for the request.
The Product Availability Lookup feature may be utilized to determine if this D&B Direct product is availablefor a given D-U-N-S Number.
The availability of certain scores delivered by this product may be limited due to a lack of sufficient companyor industry specific data to perform the calculations.
Major Industry Categories
D&B Direct Description SDMR Batch
A Agriculture, Forestry and Fishing 1
B Mining 2
C Construction 3
D Manufacturing 4
E Transportation, Communications, Electric, Gas and Sanitary Services 5
F Wholesale Trade 6
G Retail Sale 7
H Finance, Insurance and Real Estate 8
I Services 9
J Public Administration 0
D&B Direct API Documentation Major Industry Categories
©Dun & Bradstreet, Inc. 2014 96
WorldBase Compatibility
The following fields are included in this data layer for existing D&B customers who may have internalsystems and/or processes that rely upon these codes:
l Location.PrimaryAddress.PrimaryTownWorldBaseCodel Location.PrimaryAddress.TerritoryWorldBaseCodel Location.PrimaryAddress.CountryWorldBaseCodel Location.PrimaryAddress.CountyWorldBaseCodel Linkage.GlobalUltimateOrganization.PrimaryAddress.CountryWorldBaseCodel Linkage.DomesticUltimateOrganization.PrimaryAddress.CountryWorldBaseCodel Linkage.HeadquartersOrganization.PrimaryAddress.CountryWorldBaseCodel Linkage.ParentOrganization.PrimaryAddress.CountryWorldBaseCode
New implementations should be developed using the corresponding fields that are based on coding standardsfor 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 containsthe WorldBase codes) of the downloadable Data Primer.
Dias Code, in a batch environment, is a sequence number of the monthly linkage file. In a batch environment,the Linkage file is updated on only a monthly basis. The Dias Code has the potential to change on a monthlybasis due to linkage changes – additional linked records or closing of locations. The attempt to use Dias Codesacross different monthly updates may cause issues in a customer’s database. Transactional Linkage processingdoes not access the monthly linkage file but a daily linkage file which does not have a Dias Code because itwould have to change daily. Therefore, the Dias Code is not a field that is populated on a transactionalresponse.
Additional Details
Access to this information is provided on a metered basis; and will require data layer entitlement prior to usein the production environment. A built-in feature exists to prevent duplicate billing when multiple requestswith the same D-U-N-S Number and product code are submitted on the same calendar day (which is based onEastern Standard Time [GMT-5]).
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.
D&B Direct API Documentation WorldBase Compatibility
©Dun & Bradstreet, Inc. 2014 97
Technical Specification
For details on how to obtain this data layer, please refer to the Firmographic.OrderProduct (SOAP) orFirmographic.OrderProduct (REST) page.
D&B Direct API Documentation Technical Specification
©Dun & Bradstreet, Inc. 2014 98
Detailed Company Profile - WB1784This data layer provides details comparable to the WorldBase Linked Prospect Record (WB1784) batch file.
Requirements & Options
When requesting this D&B Direct product, a valid D-U-N-S Number for a company, its country code, and theappropriate product code will be required. If this information is not available, refer to obtaining a company D-U-N-S Number for assistance. A trade up option exists to request data for the headquarters when therequested organization is a branch.
When ordering information for organizations located in Germany, customers are required to provide a validorder reason code. A list of possible values is included on the respective SOAP or REST operation page.
Note: The product code for Detailed Company Profile - WB1784 is DCP_WB1784. This product may beincluded in the Monitoring process.
Business Elements
The following table is an alphabetical list of the unique items delivered in this data layer. Legend: [C] = maybe included in a Custom Data product; [M] = may be referenced by the Monitoring process; [M+] = Monitoredusing an aggregate or attribute XPath.
Note: This product will 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, et al.)along with the business elements listed. In addition, customers who compare the following table to theData Primer should be advised of several intentional differences.
Name Description XML* JSON*
Agent Indicator When 'true' indicates that the subject acts as an agent promoting the goods orservices of another organization, e.g., Sales Agent, Purchasing Agent. When 'false'indicates that the subject does not act as an agent of another organization. [M]
SOAP REST
Business LegalStructure
Text that describes the legal form or structure of a business, as registered withgovernment authorities, e.g., partnership, corporation, private limited company,government department, proprietorship. [M+]
SOAP REST
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+]
SOAP REST
Control Year The year current control was assumed. [M] SOAP REST
Country Name Text recording the name of the country in which the business is located. [M+] SOAP REST
D&B Direct API Documentation Detailed Company Profile - WB1784
©Dun & Bradstreet, Inc. 2014 99
Name Description XML* JSON*
D&B City Code D&B proprietary geographical code which indicates the city where the business islocated. For US records, the code is unique within COUNTY, for non-US records, thecode is unique within COUNTRY. [M+]
SOAP REST
D&B CountryCode
D&B three-digit code which indicates the country where the business is located. SOAP REST
D&B CountyCode
D&B geographical code which identifies the county where the business is located.Code is unique within state/province.
SOAP REST
D&B HooversIndustry Code
An alphanumeric industry code identifying a business activity, based on a three-tiertaxonomy developed by D&B as a complement to NAICS and SIC codes, that areassigned according to companies’ primary and secondary business activities.
SOAP REST
D&B IndustryCode
An alphanumeric value identifying a business activity based on the scheme specifiedby the Standard Industrial Classification (SIC) Code. The first four digits are externalcodes created by the U.S. Government. D&B has created extensions to more preciselydefine an activity as in the case of the SIC 2+2 (the last 4 digits of an 8-digit SIC).
SOAP REST
D&B Mailing CityCode
D&B geographical code which indicates the city where the business is located formailing address. For US records, the code is unique within COUNTY, for non-USrecords, the code is unique within COUNTRY. [M+]
SOAP REST
D&B MailingCountry Code
D&B three-digit country code which indicates the country where the mailing addressof the business is located.
SOAP REST
D&B MailingCounty Code
D&B geographical code which indicates the county where the business is located formailing address. Populated in US and Canada only; unique within state/province.Zeros if not available.
SOAP REST
D&B MailingRegion/ContinentCode
D&B code which indicates the region of the mailing address of the business. [M+] SOAP REST
D&B MailingState/ProvinceCode
D&B geographical code which indicates the state/province where the business islocated for mailing address. Only validated state/province names carry astate/province code. [M+]
SOAP REST
D&BState/ProvinceCode
D&B geographical code which indicates the state/province (aka primary subdivision)where the business is located. Only validated state/province names carry astate/province code. [M+]
SOAP REST
DomesticUltimateBusiness Name
Text recording the name of the highest business in the family tree that is in the samecountry as the subject. [M]
SOAP REST
DomesticUltimate D&BCity Code
D&B code of the city where the domestic ultimate is located. [M+] SOAP REST
DomesticUltimate D&BCountry Code
D&B code of the country where the domestic ultimate is located. [M+] SOAP REST
DomesticUltimate D-U-N-SNumber
The D-U-N-S Number of the highest level parent within a corporate family tree that isdomiciled in the same country as the requested company. A parent is a corporationthat owns more than 50% of another corporation's capital stock. A subject may be itsown domestic ultimate. [M]
SOAP REST
D&B Direct API Documentation Business Elements
©Dun & Bradstreet, Inc. 2014 100
Name Description XML* JSON*
DomesticUltimate PostalCode
An identifier used by the local country postal authority to identify where the domesticultimate is located. [M+]
SOAP REST
DomesticUltimate StreetAddress
Text recording the address number, or post office box number and street namewhere the domestic ultimate is located. [M+]
SOAP REST
DomesticUltimate TerritoryAbbreviatedName
Text recording the shortened name of the locally governed area which forms part of acentrally governed nation to identify where the domestic ultimate is located. [M+]
SOAP REST
DomesticUltimate TerritoryName
Text recording the name of the locally governed area which forms part of a centrallygoverned nation to identify where the domestic ultimate is located.
SOAP REST
DomesticUltimate TownName
Text recording the name of a city, town, township, village, borough, etc. where thedomestic ultimate is located. [M+]
SOAP REST
EmployeeQuantity (AllLocations)
A number that defines how many people are directly engaged and paid by theorganization to perform or support its business operations. [M]
SOAP REST
EmployeeQuantity (SingleLocation)
A number that defines how many people are directly engaged and paid by theorganization to perform or support its business operations at the subject's location.[M]
SOAP REST
EmployeeQuantity BasisText
Text that indicates when it has been reported to D&B that certain types of employeeshave been included in the calculation of the Employee Quantity. [M+]
SOAP REST
EmployeeQuantityReliability Text (AllLocations)
Text that describes the integrity of the employee figures, e.g. audited, actual,estimated, or modeled. [M+]
SOAP REST
EmployeeQuantityReliability Text(Single Location)
Text that describes the integrity of the employee figures, e.g. audited, actual,estimated, or modeled. [M+]
SOAP REST
Export Indicator When 'true' indicates that the subject company exports goods to other countries. [M] SOAP REST
Family TreeHierarchy LevelCode
A two-position counter that indicates the number of family tree levels below theglobal ultimate business in its corporate hierarchy. The hierarchy level value of theglobal ultimate will always be 1. Each subsidiary level below the global ultimate isincremented by one. Branch locations in a family tree will have the same hierarchycode as its associated headquarter. [M]
SOAP REST
FEIN Tax IDNumber
A number recording a unique nine-digit FEIN number assigned by the U.S. InternalRevenue Service to business entities (and in some cases individuals) operating in theUnited States for the purposes of identification.
SOAP REST
Full Report Date The date when a complete review of all Business Information Report data wasupdated about the business.
SOAP REST
D&B Direct API Documentation Business Elements
©Dun & Bradstreet, Inc. 2014 101
Name Description XML* JSON*
Global UltimateBusiness Name
Text recording the primary name of the global ultimate business. [M] SOAP REST
Global UltimateCountry Name
Name of the country where the global ultimate is located. [M+] SOAP REST
Global UltimateD&B City Code
D&B code of the city where the global ultimate is located. [M+] SOAP REST
Global UltimateD&B CountryCode
D&B code of the country where the global ultimate is located. [M+] SOAP REST
Global UltimateD&B CountyCode
D&B geographical code which identifies the county where the global ultimate islocated. Code is unique within state/province. [M+]
SOAP REST
Global UltimateD&BRegion/ContinentCode
D&B code for the region where the global ultimate is located. [M+] SOAP REST
Global UltimateD-U-N-S Number
The D-U-N-S number of the highest level parent within a corporate family tree. Aparent is a corporation that owns more than 50% of another corporation's capitalstock. A subject may be its own global ultimate. [M]
SOAP REST
Global UltimatePostal Code
An identifier used by the local country postal authority to identify where the globalultimate is located. [M+]
SOAP REST
Global UltimateStreet Address
Text recording the address number, or post office box number and street namewhere the global ultimate is located. [M+]
SOAP REST
Global UltimateTerritoryAbbreviatedName
Text recording the shortened name of the locally governed area which forms part of acentrally governed nation to identify where the global ultimate is located. [M+]
SOAP REST
Global UltimateTerritory Name
Text recording the name of the locally governed area which forms part of a centrallygoverned nation to identify where the global ultimate is located. [M+]
SOAP REST
Global UltimateTown Name
Text recording the name of a city, town, township, village, borough, etc. where theglobal ultimate is located. [M+]
SOAP REST
HeadquarterBusiness Name
The business name of the headquarters company. A headquarters is a businessestablishment that has branches or divisions reporting to it. [M]
SOAP REST
HeadquarterCountry Code
The two-letter country code, defined by the International Organization forStandardization (ISO) ISO 3166-1 scheme identifying the country of the companyheadquarters.
SOAP REST
HeadquarterCountry Name
Name of the country where the company headquarters is located. [M+] SOAP REST
HeadquarterD&B City Code
D&B code of the city where the headquarters is located. [M+] SOAP REST
HeadquarterD&B CountryCode
D&B code of the country where the company headquarters is located. SOAP REST
D&B Direct API Documentation Business Elements
©Dun & Bradstreet, Inc. 2014 102
Name Description XML* JSON*
HeadquarterD&B CountyCode
D&B geographical code which identifies the county where the headquarters islocated. Code is unique within state/province.
SOAP REST
HeadquarterD&BRegion/ContinentCode
D&B code for the region where the headquarters is located. [M+] SOAP REST
Headquarter D-U-N-S Number
The D-U-N-S Number of the headquarters company. A headquarters is a businessestablishment that has branches or divisions reporting to it. [M]
SOAP REST
HeadquarterPostal Code
An identifier used by the local country postal authority to identify where theheadquarters is located. [M+]
SOAP REST
HeadquarterStreet Address
Text recording the address number, or post office box number and street namewhere the headquarters is located. [M+]
SOAP REST
HeadquarterTerritoryAbbreviatedName
Text recording the shortened name of the locally governed area which forms part of acentrally governed nation to identify where the headquarters is located. [M+]
SOAP REST
HeadquarterTerritory Name
Text recording the name of the locally governed area which forms part of a centrallygoverned nation to identify where the headquarters is located. [M+]
SOAP REST
HeadquarterTown Name
Text recording the name of a city, town, township, village, borough, etc. where theheadquarters is located. [M+]
SOAP REST
Import Indicator When 'true' indicates that the subject company imports a quantity of goods fromother countries. [M]
SOAP REST
Last Update Date The date when the record was last updated in D&B's system. SOAP REST
Line of Business Text recording the description of the operations conducted by a business. [M+] SOAP REST
Local ActivityIndustry Code
Records the business activities in which an organization is actively engaged usingstandardized coding schemes such as European NACE and other country-specificClassification of Economic Activities.
SOAP REST
Mailing CountryName
Text recording the name of the country which the business uses for mailingpurposes. [M+]
SOAP REST
Most SeniorPrincipal FullName
Text recording the name of the CEO. [M+] SOAP REST
Most SeniorPrincipal Job Title
Text recording the job held by the most senior principal; For example, CEO, Presidentand CEO. [M+]
SOAP REST
NAICS Code An alphanumeric value identifying the business activity based on the NAICS Code. Canrepeat multiple times.
SOAP REST
Number of FamilyMembersIncludingSubsidiaries
This is the number of linkages in the upward and downward directions of the entirefamily tree that the subject belongs to, starting from the global ultimate. [M]
SOAP REST
D&B Direct API Documentation Business Elements
©Dun & Bradstreet, Inc. 2014 103
Name Description XML* JSON*
OrganizationIdentificationNumber
A number assigned by an external body or by D&B which either uniquely identifies orhelps to identify an organization.
SOAP REST
Parent BusinessName
Text recording the business name of the parent company. A parent is a corporationthat owns more than 50% of another corporation's capital stock; these ownedcompanies are subsidiaries to the parent company. [M]
SOAP REST
Parent CountryName
Name of the country where the parent organization is located. [M+] SOAP REST
Parent D&B CityCode
D&B code of the city where the parent organization is located. [M+] SOAP REST
Parent D&BCountry Code
D&B code of the country where the parent organization is located. SOAP REST
Parent D&BCounty Code
D&B geographical code which identifies the county where the parent organization islocated. Code is unique within state/province.
SOAP REST
Parent D&BRegion/ContinentCode
D&B code for the region where the parent organization is located. [M+] SOAP REST
Parent D-U-N-SNumber
The D-U-N-S number of the parent company. A parent is a corporation that ownsmore than 50% of another corporation's capital stock; these owned companies aresubsidiaries to the parent company. [M]
SOAP REST
Parent PostalCode
An identifier used by the local country postal authority to identify where the parentcompany is located. [M+]
SOAP REST
Parent StreetAddress
Text recording the address number, or post office box number and street namewhere the parent company is located. [M+]
SOAP REST
Parent TerritoryAbbreviatedName
Text recording the shortened name of the locally governed area which forms part of acentrally governed nation to identify where the parent company is located. [M+]
SOAP REST
Parent TerritoryName
Text recording the name of the locally governed area which forms part of a centrallygoverned nation to identify where the parent company is located. [M+]
SOAP REST
Parent TownName
Text recording the name of a city, town, township, village, borough, etc. where theparent company is located. [M+]
SOAP REST
Previous D-U-N-SNumber(Transfer)
The most recently retired D-U-N-S Number that is associated with this subject, oftenas a redundant record. An explanation for this change is provided in the transferreason. [M+]
SOAP REST
Primary SIC Code The first listed alphanumeric value identifying the primary business activity based onthe scheme specified by the Standard Industrial Classification (SIC) Code. The firstfour digits are external codes created by the U.S. Government. D&B has createdextensions to more precisely define an activity as in the case of the SIC 2+2 (the last 4digits of an 8-digit SIC).
SOAP REST
RegisteredAddress Indicator
When 'true' indicates that the Primary Address which has been presented is also theRegistered Address. When 'false' indicates that the Primary Address which has beenpresented is not a Registered Address. [M+]
SOAP REST
D&B Direct API Documentation Business Elements
©Dun & Bradstreet, Inc. 2014 104
Name Description XML* JSON*
RegistrationNumber - AllCountries ExceptUS
A registration/identifier number assigned by local government agencies to identify abusiness within the local market. Examples include the France Siret Number, UK CRONumber, Europe VAT Number, Australia Company Number, and Brazilian StateRegistry Number.
SOAP REST
Sales RevenueAmount
The monetary value of income received from customers from the sale of thebusiness' goods and/or services. This means it is the gross sales minus any returns,rebates/discounts, allowances for damages or shortages, shipping expenses passedon to the customer. [M]
SOAP REST
Secondary SICCode
An alphanumeric value identifying a business activity based on the scheme specifiedby the Standard Industrial Classification (SIC) Code. Clarification Note: These aregenerally external codes created by an external authoritative body like the U.S. Officeof Management and Budget but D&B may have created extensions to more preciselydefine an activity as in the case of the SIC 2+2 (the last 4 digits of an 8-digit SIC). Canrepeat up to five times.
SOAP REST
UK SIC Code The first listed alphanumeric value identifying the primary business activity based onthe UK SIC Code.
SOAP REST
*The links in this column provide the technical characteristics for the data field of the respective business element in the
XML or JSON response.
The preceding list is not presented in the order, nor manner, in which the information is packaged anddelivered via the D&B Direct API.
While data for a particular company may not contain values for all of the business elements, there may beitems that are considered by D&B to be essential to yield the maximum benefit of a data layer. If any of theseessential elements do not contain a value for a particular company, an error code will be returned, and yourorganization will not incur a usage credit for the request.
The Product Availability Lookup feature may be utilized to determine if this D&B Direct product is availablefor a given D-U-N-S Number.
The availability of certain scores delivered by this product may be limited due to a lack of sufficient companyor industry specific data to perform the calculations.
WorldBase Compatibility
The following fields are included in this data layer for existing D&B customers who may have internalsystems and/or processes that rely upon these codes:
l Location.PrimaryAddress.PrimaryTownWorldBaseCodel Location.PrimaryAddress.TerritoryWorldBaseCodel Location.PrimaryAddress.CountryWorldBaseCodel Location.PrimaryAddress.CountyWorldBaseCodel Location.MailingAddress.PrimaryTownWorldBaseCode
D&B Direct API Documentation WorldBase Compatibility
©Dun & Bradstreet, Inc. 2014 105
l Location.MailingAddress.TerritoryWorldBaseCodel Location.MailingAddress.CountryWorldBaseCodel Location.MailingAddress.CountyWorldBaseCodel Linkage.GlobalUltimateOrganization.PrimaryAddress.PrimaryTownWorldBaseCodel Linkage.GlobalUltimateOrganization.PrimaryAddress.CountryWorldBaseCodel Linkage.GlobalUltimateOrganization.PrimaryAddress.CountyWorldBaseCodel Linkage.DomesticUltimateOrganization.PrimaryAddress.PrimaryTownWorldBaseCodel Linkage.DomesticUltimateOrganization.PrimaryAddress.CountryWorldBaseCodel Linkage.HeadquartersOrganization.PrimaryAddress.PrimaryTownWorldBaseCodel Linkage.HeadquartersOrganization.PrimaryAddress.CountryWorldBaseCodel Linkage.HeadquartersOrganization.PrimaryAddress.CountyWorldbaseCodel Linkage.ParentOrganization.PrimaryAddress.PrimaryTownWorldBaseCodel Linkage.ParentOrganization.PrimaryAddress.CountryWorldBaseCodel Linkage.ParentOrganization.PrimaryAddress.CountyWorldbaseCode
New implementations should be developed using the corresponding fields that are based on coding standardsfor 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 containsthe WorldBase codes) of the downloadable Data Primer.
Additional Details
Access to this information is provided on a metered basis; and will require data layer entitlement prior to usein the production environment. A built-in feature exists to prevent duplicate billing when multiple requestswith the same D-U-N-S Number and product code are submitted on the same calendar day (which is based onEastern Standard Time [GMT-5]).
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.
Technical Specification
For details on how to obtain this data layer, please refer to the Firmographic.OrderProduct (SOAP) orFirmographic.OrderProduct (REST) page.
D&B Direct API Documentation Additional Details
©Dun & Bradstreet, Inc. 2014 106
USA PATRIOT Act PlusIn addition to helping you satisfy the identity verification aspect of the USA Patriot Act, this D&B Directproduct includes further business intelligence data to access potential Anti-Money Laundering (AML) riskincluding the name of the chief executive, company size, age, line of business, public filings and controllinginterest ownership.
Requirements & Options
When requesting this D&B Direct product, a valid D-U-N-S Number for a company, its country code, and theappropriate product code will be required. If this information is not available, refer to obtaining a company D-U-N-S Number for assistance. A trade up option exists to request data for the headquarters when therequested organization is a branch.
When ordering information for organizations located in Germany, customers are required to provide a validorder reason code. A list of possible values is included on the respective SOAP or REST operation page.
Note: The product code for USA PATRIOT Act Plus is PAC_PLUS. This product may be included in theMonitoring process.
Business Elements
The following table is an alphabetical list of the unique items delivered in this data layer. Legend: [C] = maybe included in a Custom Data product; [M] = may be referenced by the Monitoring process; [M+] = Monitoredusing an aggregate or attribute XPath.
Note: This product will 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, et al.)along with the business elements listed. In addition, customers who compare the following table to theData Primer should be advised of several intentional differences.
Name Description XML* JSON*
Average HighCredit Amount
A monetary figure specifying the average high credit is determined by dividing the totalmonetary amount by the number of experiences in file.
SOAP REST
Average HighCredit Amount24 Months
A monetary figure specifying the average high credit is determined by dividing the totaldollar amount by the number of experiences in file for the last 24 months.
SOAP REST
Business LegalStructure
Text that describes the legal form or structure of a business, as registered withgovernment authorities, e.g., partnership, corporation, private limited company,government department, proprietorship. [M+]
SOAP REST
D&B Direct API Documentation USA PATRIOT Act Plus
©Dun & Bradstreet, Inc. 2014 107
Name Description XML* JSON*
Claims Indicator When 'true' indicates that open claims, liens, protested bills, warrants, Social SecuritiesSummons and/or equivalent exist in the D&B database for this subject. [M]
SOAP REST
Compliance RiskClass Index
The Index is a numeric value assigned through a proprietary algorithm based onweighted risk flags. Entities with higher Index values share a larger percentage of riskattributes and are perceived to represent greater compliance exposure relative to those[M]
SOAP REST
Compliance RiskIndex
The compliance risk index is intended to provide organizations subject to the U.S.Patriot Act with an additional tool in performing compliance risk based assessment oftrading partners. The Index is a numeric value that represents an aggregation of weigh[M]
SOAP REST
Control Year The year current control was assumed. [M] SOAP REST
CriminalProceedingsIndicator
When 'true' indicates that criminal proceedings against the subject exists in the D&Bdatabase. When 'false' indicates that no criminal proceedings against the subject existsin the D&B database. [M]
SOAP REST
D&B HooversIndustry Code
An alphanumeric industry code identifying a business activity, based on a three-tiertaxonomy developed by D&B as a complement to NAICS and SIC codes, that areassigned according to companies’ primary and secondary business activities.
SOAP REST
D&B IndustryCode
An alphanumeric value identifying a business activity based on the scheme specified bythe Standard Industrial Classification (SIC) Code. The first four digits are external codescreated by the U.S. Government. D&B has created extensions to more precisely definean activity as in the case of the SIC 2+2 (the last 4 digits of an 8-digit SIC).
SOAP REST
D&B PaydexDate - AllCountriesExcept US & CA
The month and year that the corresponding PAYDEX score was calculated. SOAP REST
D&B PaydexScore - 24Months ofTradeExperiences
A calculated element summarizing the payment habits of a subject based on tradeexperiences obtained from its suppliers.
SOAP REST
D&B PaydexScore - AllCountriesExcept US andCA
A number recording the score that assesses the payment performance of a business.Based on the trade experiences obtained from its suppliers, the score corresponds to anaverage days beyond terms or within terms. Derived from a monetary-weightedaverage of a company’s combined individual payment experiences, it ranges from 0 –100 with higher scores representing businesses which pay their bills more promptly.
SOAP REST
DebarmentsTotal FilingCount
A count of the debarments present in the D&B file for this subject. [M] SOAP REST
Disaster SpecialEvents Indicator
When 'true' indicates that special events regarded as disasters (e.g. fire, hurricane)exist in the D&B database for this subject. [M]
SOAP REST
DomesticUltimateBusiness Name
Text recording the name of the highest business in the family tree that is in the samecountry as the subject.
SOAP REST
D&B Direct API Documentation Business Elements
©Dun & Bradstreet, Inc. 2014 108
Name Description XML* JSON*
DomesticUltimate D-U-N-S Number
The D-U-N-S Number of the highest level parent within a corporate family tree that isdomiciled in the same country as the requested company. A parent is a corporation thatowns more than 50% of another corporation's capital stock. A subject may be its owndomestic ultimate. [M]
SOAP REST
EmployeeQuantity (AllLocations)
A number that defines how many people are directly engaged and paid by theorganization to perform or support its business operations. [M]
SOAP REST
Export Indicator When 'true' indicates that the subject company exports goods to other countries. [M] SOAP REST
FEIN Tax IDNumber
A number recording a unique nine-digit FEIN number assigned by the U.S. InternalRevenue Service to business entities (and in some cases individuals) operating in theUnited States for the purposes of identification.
SOAP REST
FinancialEmbarrassmentIndicator
When 'true' indicates that open bankruptcy, receivership liquidation or equivalent existin the D&B database for this subject. When 'false' indicates that no open bankruptcy,receivership liquidation or equivalent exist in the D&B database for this subject. [M]
SOAP REST
Financial orLegal SpecialEvents Indicator
When 'true' indicates that there are one or more financial legal or significant eventsrecorded in D&B's databases for this subject. [M]
SOAP REST
FinancialStatementCurrency
The three-letter code, published by International Organization for Standardization (ISO),identifying the type of money that corresponds to the values in the financialstatement. [M+]
SOAP REST
FinancialStatement Date
The date when the accounting period ended. If the accounting figures are projected(future), then this is the date when the accounting period will end. [M+]
SOAP REST
FinancialStatement Date(Key FinancialFigures)
The date or partial date (i.e. period showing year/month) when the accounting periodended. If the Reliability Code denotes the figures are projected (future) then this whenthe accounting period will end. [M]
SOAP REST
FinancialStatementPeriod
The period of the financial statement expressed as a number of years, months or days.(e.g. P3M is 3 months or quarterly, P1Y is 1 year or annual) [M+]
SOAP REST
FinancialStatement Unitof Size
Text which identifies the unit of size that corresponds to the values in the financialstatement. [M+]
SOAP REST
Global UltimateBusiness Name
Text recording the primary name of the global ultimate business. SOAP REST
Global UltimateD-U-N-SNumber
The D-U-N-S number of the highest level parent within a corporate family tree. Aparent is a corporation that owns more than 50% of another corporation's capital stock.A subject may be its own global ultimate. [M]
SOAP REST
HeadquarterBusiness Name
The business name of the headquarters company. A headquarters is a businessestablishment that has branches or divisions reporting to it.
SOAP REST
Headquarter D-U-N-S Number
The D-U-N-S Number of the headquarters company. A headquarters is a businessestablishment that has branches or divisions reporting to it. [M]
SOAP REST
Highest CreditAmount
The greatest monetary figure owed to the supplier by the subject based on the tradepayment experiences in the D&B database matched to this purchaser D-U-N-S.
SOAP REST
D&B Direct API Documentation Business Elements
©Dun & Bradstreet, Inc. 2014 109
Name Description XML* JSON*
Highest CreditAmount 24Months
The greatest monetary figure owed to the supplier by the subject within the last 24months.
SOAP REST
Import Indicator When 'true' indicates that the subject company imports a quantity of goods from othercountries. [M]
SOAP REST
In Date Status An text element that indicates "in date" status, i.e. whether D&B has recently collecteddata on this business.
SOAP REST
IncorporationYear
The year the business incorporated - The year the business entity incorporated orregistered as the current legal structure. The Incorporation Year may or may not be thesame as the year the business started. [M]
SOAP REST
Local ActivityIndustry Code
Records the business activities in which an organization is actively engaged usingstandardized coding schemes such as European NACE and other country-specificClassification of Economic Activities.
SOAP REST
LocationOwnership Text
Text specifying the terms under which this subject occupies the premises (i.e., one ormore facilities) at the primary address, e.g., owned, rented or leased. [M+]
SOAP REST
Most SeniorPrincipal FullName
Text recording the name of the CEO. [M] SOAP REST
Most SeniorPrincipal JobTitle
Text recording the job held by the most senior principal; For example, CEO, Presidentand CEO. [M+]
SOAP REST
NAICS Code An alphanumeric value identifying the business activity based on the NAICS Code. Canrepeat multiple times.
SOAP REST
Non-PostalTown
Text recording the name of a village, town or suburb where this is not a PrimaryTown/City. For example, 'Booker' in Booker, High Wycombe. [M+]
SOAP REST
OperationalSpecial EventsIndicator
When 'true' indicates that there are one or more special events concerning changes tooperational aspects of the organization recorded in D&B's databases for this subject.This may include, but is not limited to, name changes, change in management, changeof control, address change. [M]
SOAP REST
OrganizationHistory Text
Text that indicates if D&B has any information that may reflect unfavorably on thisorganization, e.g. clear, incomplete, management and business. [M+]
SOAP REST
OrganizationIdentificationNumber
A number assigned by an external body or by D&B which either uniquely identifies orhelps to identify an organization.
SOAP REST
OrganizationStart Year
The year when operations undertaken by the organization commenced. [M] SOAP REST
Other SpecialEvents Indicator
When 'true' indicates that special events exist in the D&B database that are nototherwise specified. [M]
SOAP REST
Out of BusinessIndicator
Text that records the operating status of the business. [M+] SOAP REST
Parent BusinessName
Text recording the business name of the parent company. A parent is a corporationthat owns more than 50% of another corporation's capital stock; these ownedcompanies are subsidiaries to the parent company.
SOAP REST
D&B Direct API Documentation Business Elements
©Dun & Bradstreet, Inc. 2014 110
Name Description XML* JSON*
Parent D-U-N-SNumber
The D-U-N-S number of the parent company. A parent is a corporation that owns morethan 50% of another corporation's capital stock; these owned companies aresubsidiaries to the parent company. [M]
SOAP REST
Primary SICCode
The first listed alphanumeric value identifying the primary business activity based onthe scheme specified by the Standard Industrial Classification (SIC) Code. The first fourdigits are external codes created by the U.S. Government. D&B has created extensionsto more precisely define an activity as in the case of the SIC 2+2 (the last 4 digits of an 8-digit SIC).
SOAP REST
Proof of RightCount
The proof of right count is a calculated element designed to indicate the number ofauthenticating source types present that provide outside corroboration of a business’sidentity and existence. [M]
SOAP REST
RegistrationNumber - AllCountriesExcept US
A registration/identifier number assigned by local government agencies to identify abusiness within the local market. Examples include the France Siret Number, UK CRONumber, Europe VAT Number, Australia Company Number, and Brazilian State RegistryNumber.
SOAP REST
Sales RevenueAmount
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 onto the customer. [M]
SOAP REST
Secondary SICCode
An alphanumeric value identifying a business activity based on the scheme specified bythe Standard Industrial Classification (SIC) Code. Clarification Note: These are generallyexternal codes created by an external authoritative body like the U.S. Office ofManagement and Budget but D&B may have created extensions to more preciselydefine an activity as in the case of the SIC 2+2 (the last 4 digits of an 8-digit SIC). Canrepeat up to five times.
SOAP REST
Secured FilingsIndicator
When 'true' indicates that open secured filings such as secured charges, mortgages orequivalent exist in the D&B database. [M]
SOAP REST
Small BusinessIndicator
When 'true' indicates that the subject qualifies as small business, eligible for assistancefrom SBA, with a place of business located in the United States. It must operateprimarily within the United States or make a significant contribution to the U.S.economy through payment of taxes or use of American products, materials or labor.Together with its affiliates, it must meet the numerical size standards as defined in theSmall Business Size Regulations 13 CFR 121. [M]
SOAP REST
Suits and/orJudgmentIndicator
When 'true' indicates that open suits, judgments, petitions, or payment remarks existin the D&B database for this subject. When 'false' indicates that no open suits,judgments, petitions or payment remarks exist in the D&B database for this subject.[M]
SOAP REST
TradeExperienceCount - 24Month Paydex
The number of payment experiences that contributed to this payment index score. Asan example the score may have been derived from 18 payment experiences fromvarious suppliers.
SOAP REST
D&B Direct API Documentation Business Elements
©Dun & Bradstreet, Inc. 2014 111
Name Description XML* JSON*
TradeExperienceCount - AllCountriesExcept US andCA
The total number of trade payment experiences in the D&B database matched to thispurchaser D-U-N-S, representing the total number of experiences used to calculate thePaydex from countries other than US and Canada.
SOAP REST
UK SIC Code The first listed alphanumeric value identifying the primary business activity based onthe UK SIC Code.
SOAP REST
*The links in this column provide the technical characteristics for the data field of the respective business element in the
XML or JSON response.
The preceding list is not presented in the order, nor manner, in which the information is packaged anddelivered via the D&B Direct API.
While data for a particular company may not contain values for all of the business elements, there may beitems that are considered by D&B to be essential to yield the maximum benefit of a data layer. If any of theseessential elements do not contain a value for a particular company, an error code will be returned, and yourorganization will not incur a usage credit for the request.
The Product Availability Lookup feature may be utilized to determine if this D&B Direct product is availablefor a given D-U-N-S Number.
The availability of certain scores delivered by this product may be limited due to a lack of sufficient companyor industry specific data to perform the calculations.
Additional Details
With D&B’s USA Patriot Act data, you can support your Know Your Customer (KYC) efforts to conform to therequirements of the USA Patriot Act Section 326. Automatically ensure that the companies you work with donot appear on terrorist or sanctioned country lists, including the Office of Foreign Assets Control (OFAC).
Access to this information is provided on a metered basis; and will require data layer entitlement prior to usein the production environment. A built-in feature exists to prevent duplicate billing when multiple requestswith the same D-U-N-S Number and product code are submitted on the same calendar day (which is based onEastern Standard Time [GMT-5]).
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.
D&B Direct API Documentation Additional Details
©Dun & Bradstreet, Inc. 2014 112
Related Topics
Technical Specification
For details on how to obtain this data layer, please refer to the Firmographic.OrderProduct (SOAP) orFirmographic.OrderProduct (REST) page.
D&B Direct API Documentation Related Topics
©Dun & Bradstreet, Inc. 2014 113
Firmographic Product ServiceVersion 2.0 (API) / 3.2 (Service)
Functions
This D&B Direct service includes the following functionality. The respective SOAP and/or REST pages providetechnical details including input parameters, responses and sample requests.
Function Operation /SOAP
Resource / REST
Deliver a data layer. (see "Product (Data Layer) Details")
OrderProduct() GET organizations/{DUNS}/products/{productID}
Deliver copies of previously ordered products. RetrieveProduct() GET assets/{assetID}/{productID}
The Order Product function provides data layers for a specific company, and requires a D-U-N-S Number{DUNS}, country code and one of the product codes {productID} listed in the Product (Data Layer) Detailssection.
The Retrieve Product function can be used to fetch previously obtained copies of data layers from the ProductRequest Archive by providing the asset identifier {assetID} returned from an Order Product request. The defaultarchival period is 120 days, unless extended (up to 365 days) when the data layer is requested.
Product (Data Layer) Details
The following D&B products may be obtained by using this service. Some data layers may be available indifferent levels (Standard, Enhanced and/or Premium) -- each offering additional data elements. AllD&B Direct product codes are case sensitive. The Product pages provide an overview along with a list of theBusiness Elements.
Title / Overview Link Product Code{productID}
Monitoring
Detailed Company Profile - Standard DCP_STD Yes
Detailed Company Profile - Enhanced DCP_ENH Yes
Detailed Company Profile - Premium DCP_PREM Yes
Alternative Detailed Company Profile - Standard DCP_ALT_STD Yes
Alternative Detailed Company Profile - Enhanced DCP_ALT_ENH Yes
Alternative Detailed Company Profile - Premium DCP_ALT_PREM Yes
Detailed Company Profile - SDMR DCP_SDMR Yes
Detailed Company Profile - WB1784 DCP_WB1784 Yes
D&B Direct API Documentation Firmographic Product Service
©Dun & Bradstreet, Inc. 2014 114
Title / Overview Link Product Code{productID}
Monitoring
Diversity Indicators - Standard DVR_STD Yes
Diversity Indicators - Enhanced DVR_ENH Yes
USA PATRIOT Act Plus** PAC_PLUS Yes
Note: **Due to variations in the availability and frequency of payment information collected from certaincountries, non-US and non-Canadian payment information is delivered separately in "GlobalPaydex" and"GlobalDataCoveragePayments" data fields.
Interfaces & Endpoints
D&B Direct implements version control at the web service level, in addition to the API level. This D&B Direct2.0 {version} of the Firmographic Product Service is 3.2. When contacting D&B customer support, pleaseprovide both the API and Service version numbers. The following table(s) identify version-specific access pointsfor the available API interfaces.
SOAP
Endpoint https://maxcvservices.dnb.com/FirmographicsProduct/V{version}
WSDL* http://developer.dnb.com/docs/2.0/firmographic/3.2/FirmographicProductService.zip
*There may be operations defined in the WSDL that are not available to D&B Direct customers at this time.
REST
OrderProduct GET https://maxcvservices.dnb.com/V{version}/organizations/{DUNS}/products/{productID}
RetrieveProduct GET https://maxcvservices.dnb.com/V{version}/assets/{assetID}/{productID}
Note: While "organizations" is part of the REST OrderProduct URL, there is no service by this name.D&B Direct product-related calls have a similar structure; however, the {version} component is based onthe service to which a given product is associated.
D&B Direct API calls must be made using Secured Socket Layers (SSL) as reflected in the preceding table(s).
D&B Direct API Documentation Interfaces & Endpoints
©Dun & Bradstreet, Inc. 2014 115
Firmographic:OrderProduct (REST)This operation -- part of the Firmographic Product Service -- provides access to multiple products, controlled byunique product codes.
Authentication & Endpoint
D&B Direct web services require authentication, and the data environment (i.e. production, trial or sandbox) isdetermined by the credentials submitted with each API request. Refer to the service page for the correct versionof the operation.
Endpoint
GET https://maxcvservices.dnb.com/V{version}/organizations/{DUNS}/products/{productID}
Product Request
The following parameters are accepted by this operation; however, the requirements for a specific requestmay differ based the product being requested. Please refer to the downloadable data dictionary (filterable byproduct code) to determine which fields are applicable.
The default value for ArchiveProductOptOutIndicator is 'true', indicating that the request will NOT beautomatically archived.
Name Characteristics
{version} Element
ApplicationTransactionID string, up to 64 chars, Optional
A number assigned by the calling application to uniquely
identify this request.
TransactionTimestamp DateTimestamp, Optional
The date and time when this request was created.
When the request is from an intermediary, such as a
workflow manager or service bus, this is the date and
time when the message was sent to the D&B function,
i.e., the date and time when the xml document was
created by the requesting intermediary.
D&B Direct API Documentation Firmographic:OrderProduct (REST)
©Dun & Bradstreet, Inc. 2014 116
Name Characteristics
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]
D&B Direct API Documentation Product Request
©Dun & Bradstreet, Inc. 2014 117
Name Characteristics
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
When 'true' indicates that the product being ordered is
not to be stored. When 'false' indicates that the product
being ordered is to be stored; however as this is the
assumed condition there is no requirement to create
this tag to represent this fact.
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
A number used to uniquely identify the location where
this product is to be stored.
D&B Direct API Documentation Product Request
©Dun & Bradstreet, Inc. 2014 118
Name Characteristics
CustomerReferenceText string, up to 240 chars, Optional
A freeform reference string provided by the customer to
be linked to the product in order to support subsequent
order reconciliation.
CustomerBillingEndorsementText string, at least 1 chars, up to 240 chars, Optional
Text that is filled in by customer and commonly
contains requesting individual or department name, or
customer's own account/reference number and/or
name for the case on which the product was
provided.This text is a reference used during the billing
process.
Testing / Sandbox
The following suggested parameters may be used for test environment (sandbox) requests to retrievesuccessful responses.
Product Test D-U-N-S Number(s)
Detailed Company Profile 804735132 (US); 362241452 (US); 214567885 (GB); 754683795 (AU); 481794956(CH)
Alternative Detailed CompanyProfile
804735132 (US); 362241452 (US); 214567885 (GB); 754683795 (AU); 481794956(CH)
Diversity Indicators 804735132 (US); 362241452 (US); 214567885 (GB); 754683795 (AU); 481794956(CH)
USA PATRIOT Act Plus 804735132 (US); 362241452 (US); 214567885 (GB); 754683795 (AU); 481794956(CH)
Detailed Company Profile - SDMR
Detailed Company Profile - WB1784
The Product Availability Lookup may also be used to confirm if specific D-U-N-S Numbers are appropriate fortest scenarios required by an implementation.
Testing / Trials
When conducting testing in the production environment during a trial period, product requests will be limitedto the local market of the customer.
D&B Direct API Documentation Testing / Sandbox
©Dun & Bradstreet, Inc. 2014 119
Product Response
The following is a list of the possible data fields returned by this operation in the JSON response. Please referto the downloadable data dictionary (filterable by product code) to determine which fields are applicable.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.
For all codified data delivered by D&B Direct, the response package will include the decoded text value as adata element with the code value attached as an attribute. Refer to the Reference Data Service for access tothe D&B standard code tables.
Note: The D&B Direct REST implementation uses the BadgerFish approach for JSON with some minorvariations.
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,Required
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.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 120
Name Characteristics
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 charsPattern: {([0-9a-zA-Z]*)},Optional [M]
The D-U-N-S Number is
D&B's identification
number, which provides
unique identification of
this organization, in
accordance with the
Data Universal
Numbering System (D-U-
N-S).
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SubjectHeader { TransferDUNSNumberRegistration
Aggregate, Optional(Infinite)
An entry loop that
repeats multiple times
to allow the recording of
changes to the D-U-N-S
number over time. This
section may include
reasons for the change.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 121
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SubjectHeader { TransferDUNSNumberRegistration { TransferReasonText
string, up to 256 chars,Optional (Infinite)
Text identifying the
reason that the D-U-N-S
Number was deleted
and possibly a new D-U-
N-S Number was
assigned to the subject.
Possible values:
Duplicate Record
Transferred; Internal
Structure Change;
Straight Deletion;
Reinstated
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SubjectHeader { TransferDUNSNumberRegistration { TransferReasonText @DNBCodeValue
integer, up to 7 digits,Attribute (1x)
Possible values: 420
[Duplicate Record
Transferred]; 421
[Internal Structure
Change]; 333 [Straight
Deletion]; 4049
[Reinstated]
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SubjectHeader { TransferDUNSNumberRegistration { TransferReasonText@DNBCodeTableNumber
integer, up to 7 digits,Attribute (1x)
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SubjectHeader { TransferDUNSNumberRegistration { TransferDate
date, Optional
The date that the D-U-N-
S number was deleted or
transfer to a new D-U-N-
S number.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 122
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SubjectHeader { TransferDUNSNumberRegistration { TransferredFromDUNSNumber
string, up to 15 charsPattern: {([0-9a-zA-Z]*)},Optional [M+]
This is the D-U-N-S
number of the subject
that is deleted from the
host database.
Monitor Path:
//Organization
/SubjectHeader
/TransferDUNSNumber
Registration
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SubjectHeader { TransferDUNSNumberRegistration { TransferredToDUNSNumber
string, up to 15 charsPattern: {([0-9a-zA-Z]*)},Optional [M+]
This is the D-U-N-S
number of the subject
that is retained on the
host database.
Monitor Path:
//Organization
/SubjectHeader
/TransferDUNSNumber
Registration
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization }SubjectHeader } TransferDUNSNumberRegistration
/Aggregate
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 123
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SubjectHeader { SubjectHandling
Aggregate, Optional(Infinite)
An entry loop records
the type of special
handling a subject is to
receive from D&B (or a
D&B partner, e.g., IBM,
Bonnier) e.g., the subject
is not to be contacted by
us, by calling or any
other means, at the
organization's request.
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SubjectHeader { SubjectHandling { SubjectHandlingText
string, up to 256 chars,Required [M+]
Text specifying the
manner in which the
Subject is to receive
special care from D&B
when it is being
contacted; e.g., do not
call, do not send
information requests. In
many cases this process
was specifically
requested by the
Subject.
Possible values: De-listed
Monitor Path:
//Organization
/SubjectHeader
/SubjectHandling
/SubjectHandlingText@
DNBCodeValue
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SubjectHeader { SubjectHandling { SubjectHandlingText @DNBCodeValue
integer, up to 7 digits,Attribute (1x)
Possible values: 11028
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 124
Name Characteristics
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization }SubjectHeader } SubjectHandling
/Aggregate
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SubjectHeader { TotalContinuousInquiriesCount
integer, Optional
The number of unique
subscriber inquiries with
Continuous Service
registered against this
subject over the last 12
months.
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SubjectHeader { TotalInquiriesCount
integer, Optional
The number of unique
subscriber inquiries
registered against the
subject over the last 12
months.
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SubjectHeader { MarketabilityIndicator
boolean, Optional [M]
When 'true' indicates
that the record satisfies
D&B marketability rules.
When 'false' indicates
that the record does not
satisfy D&B
marketability rules;
however, there is no
requirement to create
this tag to represent this
fact.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 125
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SubjectHeader { NonMarketableReasonText
string, up to 256 chars,Optional (Infinite) [M+]
Text specifying the
reason why the
subject's data is not
considered marketable
by D&B.
Monitor Path:
//Organization
/SubjectHeader
/NonMarketableReason
Text@DNBCodeValue
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SubjectHeader { NonMarketableReasonText @DNBCodeValue
integer, up to 7 digits,Attribute (1x)
Possible values: Code
Table 233; 11024 [Out of
business]; 11025 [No
business name]; 11026
[Invalid SIC code]; 11027
[NIXIE]; 11028 [De-
listed]; 11029 [TIXIE];
11030 [No telephone
number]; 11031 [Update
date over 24 months
old]; 11032 [No postal
code]; 11033 [Record
date over 36 months old]
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SubjectHeader { LastUpdateDate
date, Optional [M]
The date when the
subject's record was last
updated on D&B's
system.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 126
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SubjectHeader { OrganizationSummaryText
string, up to 3000 chars,Optional [M]
Text that records a brief
statement or account of
this organization.
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SubjectHeader { DUNSSelfRequestIndicator
boolean, Optional [M]
When 'true' indicates
that the D-U-N-S
Number for this subject
was created at the
request of the subject.
When 'false' indicates
that the D-U-N-S
Number for this subject
was not created at the
request of the subject.;
however as this is the
assumed condition there
is no requirement to
create this tag to
represent this fact.
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SubjectHeader { DUNSSelfRequestDate
date, Optional [M]
The date when the
subject requested a D-U-
N-S number for itself.
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SubjectHeader { FullReportDate
date | year | year &month, Optional [M]
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization }SubjectHeader
/Aggregate
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 127
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location Aggregate, Optional
Records the address
details for a subject. An
address is the
designation of a place
where a subject can be
located or may be
communicated with,
e.g., primary address,
registered address,
mailing address.
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.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 128
Name Characteristics
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 { StreetAddressLine { LineText
string, up to 240 chars,Required [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 /Location
/PrimaryAddress
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 129
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { PrimaryAddress { StreetAddressLine { DisplaySequence
integer, up to 3 digits,Optional
A number which may be
used to define the order
in which this street
address line should be
presented relative to
other street address
lines where the lower
the number the earlier
the data is presented.
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization }Location } PrimaryAddress } StreetAddressLine
/Aggregate
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { PrimaryAddress { PrimaryTownName
string, up to 64 chars,Optional [M+]
The name of the town
or city recognized by the
Postal Authority for
delivering mail.
Monitor Path:
//Organization /Location
/PrimaryAddress
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 130
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { PrimaryAddress { CountryISOAlpha2Code
string, at least 2 chars,up to 2 chars, Optional[M+]
The two-letter country
code, defined in the ISO
3166-1 scheme
published by
International
Organization for
Standardization (ISO),
identifying the country
for this address.
Monitor Path:
//Organization /Location
/PrimaryAddress
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { PrimaryAddress { MinorTownName
string, up to 64 chars,Optional [M+]
Text recording the name
of a village, town or
suburb where this is not
a Primary Town/City. For
example, 'Booker' in
Booker, High Wycombe.
Monitor Path:
//Organization /Location
/PrimaryAddress
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { PrimaryAddress { CountyOfficialName
string, up to 64 chars,Optional [M+]
Monitor Path:
//Organization /Location
/PrimaryAddress
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 131
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { PrimaryAddress { PostalCode
string, up to 16 chars,Optional [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 [M+]
Monitor Path:
//Organization /Location
/PrimaryAddress
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { PrimaryAddress { TerritoryAbbreviatedName
string, up to 64 chars,Optional [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 { UndeliverableIndicator
boolean, Optional [M+]
Monitor Path:
//Organization /Location
/PrimaryAddress
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 132
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { PrimaryAddress { AddressUsageTenureDetail
Aggregate, Optional(Infinite)
An entry loop records
the basis upon which
the subject inhabits the
premises at the address,
e.g., owns, rents, leases.
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { PrimaryAddress { AddressUsageTenureDetail { TenureTypeText
string, up to 256 chars,Required [M+]
Text specifies the terms
under which this subject
occupies the premises
(i.e., one or more
facilities) at the primary
address, e.g., owned,
rented or leased.
Monitor Path:
//Organization /Location
/PrimaryAddress
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { PrimaryAddress { AddressUsageTenureDetail { TenureTypeText @DNBCodeValue
integer, up to 7 digits,Attribute (1x)
Possible values: 440 Co-
owns; 1128 Owns; 1129
Rents; 1130 Leases; 1131
Shares; 3921 Occupies;
6228 Partly Owns/Partly
Rents; 6723 Rent from
shareholder/parent
company; 6724 Rent
from group company;
6725 Rent from
principal; 6726 GE rental
contract; 11206 Partly
Owns/Partly Leases;
21218 Assigned;
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization }Location } PrimaryAddress } AddressUsageTenureDetail
/Aggregate
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 133
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { PrimaryAddress { PoliticalDistrict
Aggregate, Optional(Infinite)
An entry loop that
repeats multiple times
to record different
distinct territorial
subdivision for holding a
separate election for one
or more seats in a
legislative body to which
this address belong.
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { PrimaryAddress { PoliticalDistrict { PoliticalDistrictText
string, up to 256 chars,Required [M+]
Monitor Path:
//Organization /Location
/PrimaryAddress
End: OrderProductResponse } OrderProductResponseDetail } Product } Organization } Location} PrimaryAddress } PoliticalDistrict
/Aggregate
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { PrimaryAddress { RegisteredAddressIndicator
boolean, Optional [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
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 134
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { PrimaryAddress { ResidentialAddressIndicator
boolean, Optional [M+]
When 'true' indicates
that the Primary Address
which has been
presented is also the
Residential Address.
When 'false' indicates
that the Primary Address
which has been
presented is not a
Residential Address.
Monitor Path:
//Organization /Location
/PrimaryAddress
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { PrimaryAddress { CountryGroupName
string, up to 64 chars,Optional [M+]
Monitor Path:
//Organization /Location
/PrimaryAddress
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { PrimaryAddress { PremisesDetail
Aggregate, Optional(Infinite)
An entry loop which can
repeat multiple times to
allow the recording of
several different types of
premises which the
subject utilizes at the
address.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 135
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { PrimaryAddress { PremisesDetail { PremisesAreaMeasurement
decimal, Optional [M+]
A number specifying the
overall space covered by
the premises described
by the PremisesTypeText
used by the subject at
the address e.g., the
2000 in 2000 square
meters.
Monitor Path:
//Organization /Location
/PrimaryAddress
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { PrimaryAddress { PremisesDetail { PremisesAreaMeasurementReliabilityText
string, up to 256 chars,Optional [M+]
Text that describes the
accuracy of the
measurement found in
PremisesAreaMeasurem
ent; e.g., actual,
estimated, modeled.
Possible values: Actual;
Minimum value from a
range; Estimated
Monitor Path:
//Organization /Location
/PrimaryAddress
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { PrimaryAddress { PremisesDetail { PremisesAreaMeasurementReliabilityText@DNBCodeValue
integer, up to 7 digits,Attribute (1x)
Possible values: 9092
[Actual]; 11078
[Minimum value from a
range]; 9093 [Estimated]
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 136
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { PrimaryAddress { PremisesDetail { PremisesAreaMeasurementUnitText
string, up to 256 chars,Optional [M+]
Text that describes the
measurement unit used
to express the Premises
Usage Area
Measurement; e.g. acre,
square meters, square
feet.
Possible values: square
foot
Monitor Path:
//Organization /Location
/PrimaryAddress
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { PrimaryAddress { PremisesDetail { PremisesAreaMeasurementUnitText @DNBCodeValue
integer, up to 7 digits,Attribute (1x)
Possible values: 3848
[square foot]
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization }Location } PrimaryAddress } PremisesDetail
/Aggregate
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 137
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { PrimaryAddress { PremisesUsageDetail
Aggregate, Optional(Infinite)
An entry loop that
describes the premises
strictly with respect to a
subject and identifies: 1.
the nature of the
facilities or grounds used
by the subject at this
address, e.g., office,
warehouse, factory,
farmland, mine/quarry,
brewery 2. the type of
structures or features in
the facility or on the
grounds, where floor,
seats, room, suite are
examples of internal
structures or features
and where building,
harbour, quay are
examples of external
structures or features 3.
identification of the
specific structures or
features at this place of
business, e.g.,
Conference Center
Building, Block A, 3rd
Floor, 9th - 15th Floors,
Suite 101and how they
relate to each other
using a hierarchy
structure.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 138
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { PrimaryAddress { PremisesUsageDetail { PremisesUsageFunctionDetail
Aggregate, Optional(Infinite)
An entry loop which
specifies how the
premises are explicitly
being used, or not used,
by the subject, e.g., for
cattle ranching, for food
preparation, for
accounting, for catering.
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { PrimaryAddress { PremisesUsageDetail { PremisesUsageFunctionDetail { PremisesFunctionText
string, up to 256 chars,Optional [M+]
Text specifying an
activity that is
performed or is not
performed at this facility
by the subject, e.g.,
manufacturing,
warehousing, printing,
packaging, office work.
Monitor Path:
//Organization /Location
/PrimaryAddress
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { PrimaryAddress { PremisesUsageDetail { PremisesUsageFunctionDetail { PremisesFunctionText @DNBCodeValue
integer, up to 7 digits,Attribute (1x)
Possible values: 12058
[Manufacturing]
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization }Location } PrimaryAddress } PremisesUsageDetail } PremisesUsageFunctionDetail
/Aggregate
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization }Location } PrimaryAddress } PremisesUsageDetail
/Aggregate
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { PrimaryAddress { LongitudeMeasurement
decimal, up to 10digits, maximum of 6decimal places, Optional[M+]
Monitor Path:
//Organization /Location
/PrimaryAddress
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 139
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { PrimaryAddress { LatitudeMeasurement
decimal, up to 9 digits,maximum of 6 decimalplaces, Optional [M+]
Monitor Path:
//Organization /Location
/PrimaryAddress
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { PrimaryAddress { GeographicalPrecisionText
string, up to 256 chars,Optional [M+]
Monitor Path:
//Organization /Location
/PrimaryAddress
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { PrimaryAddress { MetropolitanStatisticalAreaUSCensusCode
string, Optional (Infinite)[M+]
A Geographical Region
with a relatively high
population density at its
core and close economic
ties throughout the
area.
Monitor Path:
//Organization /Location
/PrimaryAddress
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { PrimaryAddress { CountryOfficialName
string, up to 64 chars,Optional [M+]
Monitor Path:
//Organization /Location
/PrimaryAddress
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { PrimaryAddress { PrimaryTownWorldBaseCode
integer, up to 32 digits,Optional [M+]
Monitor Path:
//Organization /Location
/PrimaryAddress
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 140
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { PrimaryAddress { TerritoryWorldBaseCode
integer, up to 32 digits,Optional [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
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 [M+]
Monitor Path:
//Organization /Location
/PrimaryAddress
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 141
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { PrimaryAddress { EconomicAreaOfInfluenceCode
integer, up to 3 digits,Optional
A code assigned by the
U.S Bureau of Economic
Analysis to identify the
subject's regional
market that surrounds a
metropolitan or
micropolitan statistical
area serving as a
regional center of
economic activity.
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { PrimaryAddress { CountryFIPSCode
string, up to 4 chars,Optional [M+]
Text that describes the
Federal Information
Processing Standards
(FIPS) code value
assigned by the U.S
Department of
Commerce which
identifies the country
where this subject is
located.
Monitor Path:
//Organization /Location
/PrimaryAddress
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 142
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { PrimaryAddress { TerritoryFIPSCode
integer, up to 2 digits,Optional [M+]
A Federal Information
Processing Standards
(FIPS) code value
assigned by the U.S
Department of
Commerce which
identifies the territory
where this subject is
located.
Monitor Path:
//Organization /Location
/PrimaryAddress
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { PrimaryAddress { MetropolitanStatisticalAreaFIPSCode
integer, up to 4 digits,Optional [M+]
A Federal Information
Processing Standards
(FIPS) code value
assigned by the U.S
Department of
Commerce which
identifies the
Metropolitan Statistical
Area where this subject
is located.
Monitor Path:
//Organization /Location
/PrimaryAddress
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 143
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { PrimaryAddress { CountyPopulationRankNumber
integer, up to 1 digit,Optional
A number ranging from
0 to 9 assigned by D&B
classifying the county of
the subject based on the
resident population; 0
denoting lowest
population range and 9
denoting highest
population range.
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { PrimaryAddress { CountyFIPSCode
integer, up to 3 digits,Optional [M+]
A Federal Information
Processing Standards
(FIPS) code value
assigned by the U.S
Department of
Commerce which
identifies the county
where this subject is
located.
Monitor Path:
//Organization /Location
/PrimaryAddress
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization }Location } PrimaryAddress
/Aggregate
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 144
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { MailingAddress
Aggregate, Optional(Infinite)
An entry loop which can
repeat multiple times to
allow the recording of
address which is mainly
utilized for the purpose
of mail delivery. This
usually includes a Post
Office Box number or
similar mailing details.
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { MailingAddress { 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.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 145
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { MailingAddress { StreetAddressLine { LineText
string, up to 240 chars,Required [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 /Location
/MailingAddress
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { MailingAddress { StreetAddressLine { DisplaySequence
integer, up to 3 digits,Optional
A number which may be
used to define the order
in which this street
address line should be
presented relative to
other street address
lines where the lower
the number the earlier
the data is presented.
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization }Location } MailingAddress } StreetAddressLine
/Aggregate
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 146
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { MailingAddress { PrimaryTownName
string, up to 64 chars,Optional [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 { CountryISOAlpha2Code
string, at least 2 chars,up to 2 chars, Optional[M+]
The two-letter country
code, defined in the ISO
3166-1 scheme
published by
International
Organization for
Standardization (ISO),
identifying the country
for this address.
Monitor Path:
//Organization /Location
/MailingAddress
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { MailingAddress { CountyOfficialName
string, up to 64 chars,Optional [M+]
Monitor Path:
//Organization /Location
/MailingAddress
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 147
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { MailingAddress { PostalCode
string, up to 16 chars,Optional [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 [M+]
Monitor Path:
//Organization /Location
/MailingAddress
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { MailingAddress { TerritoryAbbreviatedName
string, up to 64 chars,Optional [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
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 148
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { MailingAddress { PostalRouteNumber
string, up to 64 chars,Optional
An identifier of a postal
route such as a rural
route" in the United
States or a "Cedex" in
France. Clarification
Note: Though this
attribute is referred to
as a number
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { MailingAddress { PostalRouteTypeText
string, up to 256 chars,Optional
Text that decribes the
type of of postal route
such as a rural route" in
the United States or a
"Cedex" in France."
Possible values: Rural
Route; Cedex; City; Post
Box; Highway Contract
Route; General Delivery
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { MailingAddress { PostalRouteTypeText @DNBCodeValue Possible values: 139
[Rural Route]; 140
[Cedex]; 27865 [City];
27866 [Post Box]; 27868
[Highway Contract
Route]; 27869 [General
Delivery]
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { MailingAddress { CountryOfficialName
string, up to 64 chars,Optional [M+]
Monitor Path:
//Organization /Location
/MailingAddress
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 149
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { MailingAddress { PrimaryTownWorldBaseCode
integer, up to 32 digits,Optional [M+]
Monitor Path:
//Organization /Location
/MailingAddress
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { MailingAddress { TerritoryWorldBaseCode
integer, up to 32 digits,Optional [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 [M+]
The D&B three digit
WorldBase code value
that identifies country
where the business is
located.
Monitor Path:
//Organization /Location
/MailingAddress
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 150
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { MailingAddress { CountryGroupName
string, up to 64 chars,Optional [M+]
Monitor Path:
//Organization /Location
/MailingAddress
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { MailingAddress { CountyWorldBaseCode
integer, up to 32 digits,Optional
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization }Location } MailingAddress
/Aggregate
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization }Location
/Aggregate
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Telecommunication
Aggregate, Optional
Records information
about the different
modes of
Telecommunication
addresses used by a
subject for external
contact purposes. The
modes of
communication include
telephone, fax, e-mail,
web address.
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Telecommunication { TelephoneNumber
Aggregate, Optional(Infinite)
An entry loop which can
allow multiple
Telephone contact
information used for
voice communication
with the subject.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 151
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Telecommunication { TelephoneNumber { TelecommunicationNumber
string, at least 1 char,up to 50 chars, Required[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.
Monitor Path:
//Organization
/Telecommunication
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Telecommunication { TelephoneNumber { InternationalDialingCode
string, up to 7 chars,Optional [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
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 152
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Telecommunication { TelephoneNumber { UnreachableIndicator
boolean, Optional
When 'true' indicates
that telecommunication
number cannot be
connected to
successfully. When
'false' indicates that
telecommunication
number can be
connected to
successfully. When set
to NULL, it indicates that
D&B does not know
whether the
telecommunication
number can be
connected to
successfully.
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization }Telecommunication } TelephoneNumber
/Aggregate
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Telecommunication { FacsimileNumber
Aggregate, Optional(Infinite)
An entry loop which can
allow multiple Facsimile
contact information
used for data
communication with the
subject.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 153
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Telecommunication { FacsimileNumber { TelecommunicationNumber
string, at least 1 char,up to 50 chars, Required[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.
Monitor Path:
//Organization
/Telecommunication
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Telecommunication { FacsimileNumber { InternationalDialingCode
string, up to 7 chars,Optional [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
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 154
Name Characteristics
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization }Telecommunication } FacsimileNumber
/Aggregate
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Telecommunication { WebPageAddress
Aggregate, Optional(Infinite)
An entry loop which can
allow multiple Internet
URLs used for online
information and
communication with the
subject.
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Telecommunication { WebPageAddress { TelecommunicationAddress
string, up to 240 chars,Required [M+]
The Internet URL
(Uniform Resource
Locator) which uniquely
identifies the propreitary
website of the subject or
the website preferred by
the subject which gives
more information on the
subject. Note: The
communications
protocol followed by a
colon and two slashes
(http://) is not included
in the Web Page
address.
Monitor Path:
//Organization
/Telecommunication
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization }Telecommunication } WebPageAddress
/Aggregate
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Telecommunication { SocialMediaDetail
Aggregate, Optional(Infinite)
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 155
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Telecommunication { SocialMediaDetail { SocialMediaPlatformName
string, up to 256 chars,Required [M+]
Monitor Path:
//Organization
/Telecommunication
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Telecommunication { SocialMediaDetail { SocialMediaPlatformName @DNBCodeValue
integer, up to 7 digits,Attribute (1x)
Possible values: 25868
[Wikipedia ]
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Telecommunication { SocialMediaDetail { WebPageURL
string, Optional [M+]
Text identifying the
internet URL of the
subject's content in the
social media platform.
Monitor Path:
//Organization
/Telecommunication
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization }Telecommunication } SocialMediaDetail
/Aggregate
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization }Telecommunication
/Aggregate
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 156
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Financial Aggregate, Optional
Records a standardized
view the financial
results of a subject
usually extracted from a
set of accounts. This
includes the financial
period to which those
results apply, the terms
of its audited status,
whether is fiscal or
estimated, whether it is
a group/consolidated or
individual statement etc.
The identifying data for
the financial statement
(e.g. The financial period
to which it refers) and
the 70 D&B global
standard financial items
are recorded in the
'Statement' aggregate.
Additionally the full
granular view of the
financial statement may
be recorded in the
'Financial Statement
Schedule' sub-
aggregation.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 157
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Financial { KeyFinancialFiguresOverview
Aggregate, Optional(Infinite)
An entry loop which can
repeat multiple times to
record highlights of the
financial statements
(Balance sheet, Income
statement, cash flow
statement etc.) across
years and gives a
snapshot view of how
the company has been
performing on items in
these financial
statements.
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Financial { KeyFinancialFiguresOverview { StatementHeaderDetails { FinancialStatementToDate
date, Optional [M]
The date when the
accounting period
ended. If the Reliability
Code denotes the
figures are projected
(future), then this is the
date when the
accounting period will
end.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 158
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Financial { KeyFinancialFiguresOverview { StatementHeaderDetails { TimePeriodText
string, up to 256 chars,Optional [M+]
Text denoting the
timeframe in the past
for which this
information is recorded.
Monitor Path:
//Organization
/Financial
/KeyFinancialFiguresOve
rview
/StatementHeaderDetai
ls
/TimePeriodText@DNBC
odeValue
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Financial { KeyFinancialFiguresOverview { StatementHeaderDetails { TimePeriodText @DnbCodeValue
integer, up to 7 digits,Attribute (1x)
Possible values: 11096
[Between 0 and 12
months]; 13711 [1-3
years]; 13721 [1-5 years]
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Financial { KeyFinancialFiguresOverview { StatementHeaderDetails { FinancialPeriodDuration
duration, Optional [M]
Records the period of the
Financial Summary
when this cannot be
expressed using
'Summary Date' and
'Number of Months'
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 159
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Financial { KeyFinancialFiguresOverview { SalesRevenueAmount
decimal, Optional(Infinite) [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 @UnitOfSize
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Financial { KeyFinancialFiguresOverview { SalesRevenueAmount @CurrencyISOAlpha3Code
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Financial { KeyFinancialFiguresOverview { SalesRevenueAmount @ReliabilityText
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Financial { KeyFinancialFiguresOverview { ProfitOrLossAmount
decimal, Optional(Infinite) [M]
A monetory figure that
shows the difference
between Sales Revenue
and Cost of Sales before
the deduction of selling,
distribution,
administration and
other costs.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 160
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Financial { KeyFinancialFiguresOverview { SalesTurnoverGrowthRate
decimal, Optional [M]
The amount by which a
SalesTurnover increases
over a given period of
time as a percentage of
its previous value.
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Financial { KeyFinancialFiguresOverview { ProfitOrLossGrowthRate
decimal, Optional [M]
The rate of change in
the difference between
Sales Revenue and Cost
of Sales before the
deduction of selling,
distribution,
administration and
other costs.
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Financial { KeyFinancialFiguresOverview { EmployeeQuantityGrowthRate
decimal, Optional [M]
The annual rate at
which total number of
employees in a firm's
has been or is expected
to grow.Needs to be
moved to Employee
figures
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 161
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Financial { KeyFinancialFiguresOverview { EmployeeQuantity
integer, Optional [M]
The number of
employees for the
subject as published on
the financial statement.
If figure is stored locally
with 000's omitted then
this must be multiplied
and the full figure
populated to the record.
E.g. If number of
employees is 97 with
000's omitted then the
figure of 97000 should
be populated.
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Financial { KeyFinancialFiguresOverview { EmployeeQuantityReliabilityText
string, up to 256 chars,Optional [M]
Text that describes the
integrity of the
employee figures, e.g.
audited, actual,
estimated, modeled.
Possible values: 9092
[Actual]; 11078 [Low End
Range]; 9093 [Estimated
Value]
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Financial { KeyFinancialFiguresOverview { EmployeeQuantityReliabilityText @DNBCodeValue
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization }Financial } KeyFinancialFiguresOverview
/Aggregate
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 162
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Financial { FinancialStatement
Aggregate, Optional(Infinite)
An entry loop which can
repeat multiple times to
record information
characterizing an
organization's financial
health, such as its
operation results (over a
specified period of time),
the ownership equity in
the business, its money
management (at a point
in time), and derived
ratios that give insight
into its profitability,
solvency, liquidity, and
other characteristics.
The financial figures
may be provided as
actual or estimated
figures by the subject,
an outside source, or
modeled by D&B. It may
cover a single
organization or multiple
related organizations.
The figures may be
qualified based on the
auditor's remarks.
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Financial { FinancialStatement { StatementHeaderDetails
Aggregate, Optional
Records high level
information which
either identifies the
presence of a financial
statement for the
subject or is derived
from multiple financial
statements.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 163
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Financial { FinancialStatement { StatementHeaderDetails { FinancialStatementToDate
date, Optional [M+]
The date when the
accounting period
ended. If the Reliability
Code denotes the
figures are projected
(future), then this is the
date when the
accounting period will
end.
Monitor Path:
//Organization
/Financial
/FinancialStatement
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Financial { FinancialStatement { StatementHeaderDetails { CurrencyISOAlpha3Code
string, up to 3 chars,Optional [M+]
The three-letter code,
published by
International
Organization for
Standardization (ISO),
identifying the type of
money that is primarily
used by this subject
Monitor Path:
//Organization
/Financial
/FinancialStatement
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 164
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Financial { FinancialStatement { StatementHeaderDetails { UnitOfSizeText
string, up to 256 chars,Optional [M+]
Text which identifies the
unit of size in which the
financial summary
figures are provided, e.g.,
in 1,000s; in 1,000,000s.
The financial figures
should be populated to
the record with the
000's or 000,000's
omitted, e.g., If Sales are
54398 with 000's
omitted then the figure
of 54398 (NOT 54398000)
should be populated.
Monitor Path:
//Organization
/Financial
/FinancialStatement
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Financial { FinancialStatement { StatementHeaderDetails { UnitOfSizeText @DNBCodeValue
integer, up to 7 digits,Attribute (1x)
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Financial { FinancialStatement { StatementHeaderDetails { UnitOfSizeText @DNBCodeTableNumber
integer, up to 7 digits,Attribute (1x)
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Financial { FinancialStatement { StatementHeaderDetails { FinancialPeriodDuration
string, up to 20 chars,Optional [M+]
Records the period of the
Financial Summary
when this cannot be
expressed using
'Summary Date' and
'Number of Months'
Monitor Path:
//Organization
/Financial
/FinancialStatement
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 165
Name Characteristics
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization }Financial } FinancialStatement } StatementHeaderDetails
/Aggregate
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Financial { FinancialStatement { BalanceSheet
Aggregate, Optional
Summarizes an
organization or
individual's assets,
equity and liabilities at a
specific point in time.
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Financial { FinancialStatement { BalanceSheet { Liabilities
Aggregate, Optional
Records the legal debts
or obligations of a
company that arise
during the course of
business operations.
Liabilities are settled
over time through the
transfer of economic
benefits including
money, goods or
services.
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Financial { FinancialStatement { BalanceSheet { Liabilities { TotalEquityAmount
decimal, Optional [M+]
The total value of share
capital/stock originally
invested by
shareholders/stockholde
rs plus any reserves
which have arisen, such
as retained profits,
which are ploughed back
into the firm.
Monitor Path:
//Organization
/Financial
/FinancialStatement
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 166
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Financial { FinancialStatement { BalanceSheet { Liabilities { TotalEquityAmount@CurrencyISOAlpha3Code
string, up to 3 chars,Attribute (1x)
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization }Financial } FinancialStatement } BalanceSheet } Liabilities
/Aggregate
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Financial { FinancialStatement { BalanceSheet { TotalAssetsAmount
decimal, Optional [M+]
The combined value of
Total Current Assets and
Total Long Term Assets.
This therefore includes
all of the assets used by
an organization no
matter how they are
financed.
Monitor Path:
//Organization
/Financial
/FinancialStatement
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization }Financial } FinancialStatement } BalanceSheet
/Aggregate
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 167
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Financial { FinancialStatement { FinancialRatios
Aggregate, Optional
Financial Ratio records a
business' financial figure
(s) in terms of another
of the business' financial
figures. These ratios are
indicators used to
evaluate a business'
financial condition and
potential risk. They are
especially meaningful in
comparisons, e.g., a
business' ratio in
comparison to that of its
industry, a business'
ratio over time (trend).
These ratios may give
insight, for example, into
a business' profitability,
liquidity, activity
(operations), or leverage.
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Financial { FinancialStatement { FinancialRatios { FinancialRatioCategory
Aggregate, Optional(Infinite)
An entry loop which can
repeat multiple times to
allow the recording of
financial ratios which
are grouped logically
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Financial { FinancialStatement { FinancialRatios { FinancialRatioCategory { FinancialRatioItem
Aggregate, Optional(Infinite)
An entry loop which can
repeat multiple times to
allow the recording of
financial ratios relating
to the stated financial
period.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 168
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Financial { FinancialStatement { FinancialRatios { FinancialRatioCategory { FinancialRatioItem { ItemDescriptionText
string, up to 256 chars,Optional [M+]
Text describes which
calculated financial
figure is stored in Item
Amount, e.g., quick ratio,
current ratio, total
liabilities over net worth
ratio.
Monitor Path:
//Organization
/Financial
/FinancialStatement
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Financial { FinancialStatement { FinancialRatios { FinancialRatioCategory { FinancialRatioItem { ItemDescriptionText @DNBCodeValue
integer, up to 7 digits,Attribute (1x)
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 169
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Financial { FinancialStatement { FinancialRatios { FinancialRatioCategory { FinancialRatioItem { ItemRatio
decimal, up to 19digits, maximum of 6decimal places, Optional[M+]
A number expressing
proportionally what one
or more of the business'
financial figures is in
relation to one or more
of the business' other
financial figures. This
figure is an indicator
used to evaluate the
business' financial
condition or potential
risk. For example, a Quick
Ratio, which is the sum
of a business' cash and
accounts receivable
amounts divided by its
current liabilities, is a
predictor of how likely
the business is to pay its
bills on time.
Monitor Path:
//Organization
/Financial
/FinancialStatement
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization }Financial } FinancialStatement } FinancialRatios } FinancialRatioCategory } FinancialRatioItem
/Aggregate
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization }Financial } FinancialStatement } FinancialRatios } FinancialRatioCategory
/Aggregate
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization }Financial } FinancialStatement } FinancialRatios
/Aggregate
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 170
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Financial { FinancialStatement { AccountantDetails
Aggregate, Optional(Infinite)
An entry loop which can
repeat multiple times to
allow the recording of
detail regarding the
accountants such as
their name and their
opinion regarding the
statement.
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Financial { FinancialStatement { AccountantDetails { AccountantName
Aggregate, Optional(Infinite)
Text that records the
name of the person who
makes and keeps records
in mutiple languages
and/or writing scripts.
They are the practioners
of accountancy (UK) or
accounting (US), which
is the measurement,
disclosure or provision of
assurance about
financial information
that helps managers,
investors, tax authorities
and others make
decisions about
allocating resources.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 171
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Financial { FinancialStatement { AccountantDetails { AccountantName { FullName
string, up to 256 chars,Optional [M+]
The entire name of the
subject where the
subject is either an
individual or an
organization.
Monitor Path:
//Organization
/Financial
/FinancialStatement
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization }Financial } FinancialStatement } AccountantDetails } AccountantName
/Aggregate
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization }Financial } FinancialStatement } AccountantDetails
/Aggregate
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization }Financial } FinancialStatement
/Aggregate
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Financial { GrowthRates { FinancialStatementHeader
Aggregate, Optional
The Financial Statement
period for which this
growth rate is calculated
for.
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Financial { GrowthRates { FinancialStatementHeader { TimePeriodText
string, up to 256 chars,Optional [M+]
Text denoting the
timeframe in the past
for which this
information is recorded.
Monitor Path:
//Organization
/Financial /GrowthRates
/FinancialStatementHea
der
/TimePeRiodText@DNB
CodeValue
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 172
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Financial { GrowthRates { FinancialStatementHeader { TimePeriodText @DnbCodeValue
integer, up to 7 digits,Attribute (1x)
Possible values: 11096
[Between 0 and 12
months]
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Financial { GrowthRates { FinancialStatementHeader
Aggregate, Optional
The Financial Statement
period for which this
growth rate is calculated
for.
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Financial { GrowthRates { ComparedToFinancialStatementHeader
Aggregate, Optional
The earlier Financial
Statement period used
in comparison to
calculate the growth
rate.
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Financial { GrowthRates { ComparedToFinancialStatementHeader { TimePeriodText
string, up to 256 chars,Optional [M+]
Text denoting the
timeframe in the past
for which this
information is recorded.
Monitor Path:
//Organization
/Financial /GrowthRates
/ComparedToFinancialSt
atementHeader
/TimePeRiodText@DNB
CodeValue
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Financial { GrowthRates { ComparedToFinancialStatementHeader { TimePeriodText @DnbCodeValue
integer, up to 7 digits,Attribute (1x)
Possible values: 13711
[1-3 years]; 13721 [1-5
years]
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 173
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Financial { GrowthRates { ComparedToFinancialStatementHeader
Aggregate, Optional
The earlier Financial
Statement period used
in comparison to
calculate the growth
rate.
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Financial { GrowthRates { GrowthRateItem
Aggregate, Optional(Infinite)
An entry loop which can
repeat multiple times to
record different figures
from the financial
Statement Growth Rate.
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Financial { GrowthRates { GrowthRateItem { ItemDescriptionText
string, up to 256 chars,Optional [M+]
Text that describes the
type of derived result
recorded in 'Item Rate'.
Monitor Path:
//Organization
/Financial /GrowthRates
/GrowthRateItem
/ItemDescriptionText@
DNBCodeValue
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Financial { GrowthRates { GrowthRateItem { ItemDescriptionText @DNBCodeValue
integer, up to 7 digits,Attribute (1x)
Possible values: 7542
[net income]; 3110
[Sales Revenue]; 23714
[Adjusted Diluted
Earnings Or Loss Per
Share (B/S)]; 5927
[Dividends]; 3110 [Sales
Revenue]; 6240 [Total
number of employees]
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 174
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Financial { GrowthRates { GrowthRateItem { ItemRate
decimal, Optional [M]
Percentage of change
compared to prior year.
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization }Financial } GrowthRates } GrowthRateItem
/Aggregate
End: OrderProductResponse } OrderProductResponseDetail } Product } Organization }Financial
/Aggregate
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 [M]
Text recording a name
of this organization in
the specified language
and/or writing script.
OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationName { OrganizationPrimaryName { OrganizationName @LanguageCode
integer, up to 3 digits,Attribute (1x)
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 175
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationName { OrganizationPrimaryName { OrganizationName@WritingScriptISOAlpha4Code
string, Attribute (1x)
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization }OrganizationName } OrganizationPrimaryName
/Aggregate
OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationName { FormerOrganizationPrimaryName
Aggregate, Optional(Infinite)
An entry loop which can
repeat multiple times to
allow the recording of
names by which the
organization was
primarily known /
identified previously in
different languages
and/or writing scripts .
OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationName { FormerOrganizationPrimaryName { OrganizationName
string, up to 256 chars,Required
Text recording a name
of this organization in
the specified language
and/or writing script.
OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationName { FormerOrganizationPrimaryName { OrganizationName@WritingScriptISOAlpha4Code
string, Attribute (1x)
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization }OrganizationName } FormerOrganizationPrimaryName
/Aggregate
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 176
Name Characteristics
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 [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 { OrganizationName @LanguageCode
integer, up to 3 digits,Attribute (1x)
OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationName { TradeStyleName { OrganizationName @WritingScriptISOAlpha4Code
string, Attribute (1x)
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 177
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationName { TradeStyleName { DisplaySequence
integer, up to 3 digits,Optional
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
Aggregate, Optional
Records fundamental
information about a
Subject which may vary
over time.
OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationDetail { FamilyTreeMemberRole
Aggregate, Optional(Infinite)
An entry loop that can
repeat multiple times to
allow the recording of
various parts that the
Subject plays as a
member of an
ownership structured
family tree.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 178
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationDetail { FamilyTreeMemberRole { FamilyTreeMemberRoleText
string, up to 256 chars,Optional [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 { FamilyTreeMemberRole { FamilyTreeMemberRoleText@DNBCodeTableNumber
integer, up to 7 digits,Attribute (1x)
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization }OrganizationDetail } FamilyTreeMemberRole
/Aggregate
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 179
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationDetail { StandaloneOrganizationIndicator
boolean, Optional [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.,
FamilyTreeMemberRoleT
ext cannot be present.
When 'false' indicates
that this organization is
a member of a legal
family tree. In this
condition the
FamilyTreeMemberRoleT
ext must be present.
OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationDetail { ControlOwnershipDate
date, Optional [M]
The date when the
current owners took
over this business.
OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationDetail { ControlOwnershipDate @DatePrecisionText
string, up to 256 chars,Attribute (1x)
OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationDetail { ControlOwnershipDate @DatePrecisionDNBCodeValue
integer, up to 7 digits,Attribute (1x)
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 180
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationDetail { ControlOwnershipTypeText
string, up to 256 chars,Optional [M]
Text that describes the
type of controlling
ownership, e.g., publicly
owned, privately owned,
state owned.
Clarification Note: For
some countries,
controlling ownership
can be derived from the
legal form.
OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationDetail { ControlOwnershipTypeText @DNBCodeValue
integer, up to 7 digits,Attribute (1x)
OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationDetail { OperatingStatusText
string, up to 256 chars,Optional [M+]
Text describing this
organization's functional
state / trading status,
e.g. active, out of
business, dormant.
Possible values: Out of
Business; Active;
Dormant; Out of
business - Unfavourable;
Out of business -
Favourable; Ceased
trading; Assumed Out of
Business - Unable to
Confirm Active
Operations
Monitor Path:
//Organization
/OrganizationDetail
/OperatingStatusText@
DNBCodeValue
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 181
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationDetail { OrganizationStartYear
integer, Optional [M]
The year when
operations undertaken
by the organization
commenced.
OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationDetail { FranchiseOperationTypeText
string, up to 256 chars,Optional [M+]
Text that denotes
whether the franchise
rights are operated by a
company or directly by
the franchisee; i.e.
franchisee, franchisor.
Monitor Path:
//Organization
/OrganizationDetail
/FranchiseOperationTyp
eText@DNBCodeValue
OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationDetail { BoneyardOrganizationIndicator
boolean, Optional [M]
When 'true' indicates
that data on the
company is no longer
collected and was
covered by Hoover's
Editorial staff before
getting acquired or going
out of business. When
'false' indicates that
data on the company is
still collected.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 182
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationDetail { OperatingStatusComment
Aggregate, Optional(Infinite)
An entry loop which can
repeat multiple times to
allow the recording of
several facts regarding
the subject's trading
status.
OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationDetail { OperatingStatusComment { OperatingStatusFreeFormComment
string, Optional [M]
Free form text which
records the summary of
the company's trading
status.
End: OrderProductResponse } OrderProductResponseDetail } Product } Organization }OrganizationDetail } OperatingStatusComment
/Aggregate
End: OrderProductResponse } OrderProductResponseDetail } Product } Organization }OrganizationDetail
/Aggregate
OrderProductResponse { OrderProductResponseDetail { Product { Organization { RegisteredDetail
Aggregate, Optional
Records the
constitutional status of
a subject as defined
under the laws of a
country E.g.; Limited
Company, Partnership,
co-operative Society and
the Stock Equity or share
structure employed by a
business according to
the legal form and rules
of incorporation. The
owners of the stock or
shares are the owners
of the business.
OrderProductResponse { OrderProductResponseDetail { Product { Organization { RegisteredDetail { IncorporationYear
integer, Optional [M]
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 183
Name Characteristics
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 @TypeText
string, up to 256 chars,Attribute (1x)
OrderProductResponse { OrderProductResponseDetail { Product { Organization { RegisteredDetail { OrganizationIdentificationNumberDetail { OrganizationIdentificationNumber
string, at least 1 char,up to 40 chars, Required[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
/OrganizationIdentificati
onNumberDetail@DNBC
odeValue
/OrganizationIdentificati
onNumber
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 184
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { RegisteredDetail { OrganizationIdentificationNumberDetail { RegistrationLocation
Aggregate, Optional
Records the address
details where the
Organization
Identification Number is
registered.
OrderProductResponse { OrderProductResponseDetail { Product { Organization { RegisteredDetail { OrganizationIdentificationNumberDetail { RegistrationLocation { 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.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 185
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { RegisteredDetail { OrganizationIdentificationNumberDetail { RegistrationLocation { 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.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 186
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { RegisteredDetail { OrganizationIdentificationNumberDetail { RegistrationLocation { PrimaryAddress { StreetAddressLine { LineText
string, up to 240 chars,Required [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
/RegisteredDetail
/OrganizationIdentificati
onNumberDetail@DNBC
odeValue
/RegistrationLocation
/PrimaryAddress
OrderProductResponse { OrderProductResponseDetail { Product { Organization { RegisteredDetail { OrganizationIdentificationNumberDetail { RegistrationLocation { PrimaryAddress { StreetAddressLine { DisplaySequence
integer, up to 3 digits,Optional
A number which may be
used to define the order
in which this street
address line should be
presented relative to
other street address
lines where the lower
the number the earlier
the data is presented.
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization }RegisteredDetail } OrganizationIdentificationNumberDetail } RegistrationLocation }PrimaryAddress } StreetAddressLine
/Aggregate
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 187
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { RegisteredDetail { OrganizationIdentificationNumberDetail { RegistrationLocation { PrimaryAddress { PrimaryTownName
string, up to 64 chars,Optional [M+]
The name of the town
or city recognized by the
Postal Authority for
delivering mail.
Monitor Path:
//Organization
/RegisteredDetail
/OrganizationIdentificati
onNumberDetail@DNBC
odeValue
/RegistrationLocation
/PrimaryAddress
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 188
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { RegisteredDetail { OrganizationIdentificationNumberDetail { RegistrationLocation { PrimaryAddress { TerritoryName
string, up to 128 chars,Optional [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
/RegisteredDetail
/OrganizationIdentificati
onNumberDetail@DNBC
odeValue
/RegistrationLocation
/PrimaryAddress
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 189
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { RegisteredDetail { OrganizationIdentificationNumberDetail { RegistrationLocation { PrimaryAddress { PostalCode
string, up to 16 chars,Optional [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
/RegisteredDetail
/OrganizationIdentificati
onNumberDetail@DNBC
odeValue
/RegistrationLocation
/PrimaryAddress
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization }RegisteredDetail } OrganizationIdentificationNumberDetail } RegistrationLocation }PrimaryAddress
/Aggregate
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization }RegisteredDetail } OrganizationIdentificationNumberDetail } RegistrationLocation
/Aggregate
OrderProductResponse { OrderProductResponseDetail { Product { Organization { RegisteredDetail { OrganizationIdentificationNumberDetail { StartDate
date, Optional [M+]
The date when the
Organization Identifier
became current, i.e., was
first used / registered.
Monitor Path:
//Organization
/RegisteredDetail
/OrganizationIdentificati
onNumberDetail@DNBC
odeValue /StartDate
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 190
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { RegisteredDetail { OrganizationIdentificationNumberDetail { FilingOrganizationName
string, up to 256 chars,Optional [M+]
The name of the filing
organization.
Monitor Path:
//Organization
/RegisteredDetail
/OrganizationIdentificati
onNumberDetail@DNBC
odeValue
/FilingOrganizationNam
e
OrderProductResponse { OrderProductResponseDetail { Product { Organization { RegisteredDetail { OrganizationIdentificationNumberDetail { RegistrationIssuerDUNSNumber
string, up to 15 charsPattern: {([0-9a-zA-Z]*)},Optional [M+]
The DUNSNumber of the
authority issuing the
Registration Number.
Monitor Path:
//Organization
/RegisteredDetail
/OrganizationIdentificati
onNumberDetail@DNBC
odeValue
/RegistrationIssuerDUN
SNumber
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 191
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { RegisteredDetail { OrganizationIdentificationNumberDetail { RegistrationIssuerName
string, Optional [M+]
The name recording of
the the authority issuing
the Registration
Number.
Monitor Path:
//Organization
/RegisteredDetail
/OrganizationIdentificati
onNumberDetail@DNBC
odeValue
/RegistrationIssuerNam
e
OrderProductResponse { OrderProductResponseDetail { Product { Organization { RegisteredDetail { OrganizationIdentificationNumberDetail { DisplaySequence
integer, Optional
This indicates the best
FEIN by Hierarchical logic.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 192
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { RegisteredDetail { OrganizationIdentificationNumberDetail { AssignmentMethodText
string, up to 128 chars,Optional [M+]
Text which indicates if
the inquiry DUNS was
assigned based on a
direct source such as an
Agency or if assigned
based on the branch
process which utilizes
the HQ linkage to assign
the HQ FEIN to each
Branch.
Monitor Path:
//Organization
/RegisteredDetail
/OrganizationIdentificati
onNumberDetail@DNBC
odeValue
/AssignmentMethodTex
t
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization }RegisteredDetail } OrganizationIdentificationNumberDetail
/Aggregate
OrderProductResponse { OrderProductResponseDetail { Product { Organization { RegisteredDetail { LegalFormDetails
Aggregate, Optional
Records the details on
the current legal form of
a subject.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 193
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { RegisteredDetail { LegalFormDetails { LegalFormText
string, up to 256 chars,Required [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 4
Monitor Path:
//Organization
/RegisteredDetail
/LegalFormDetails
/LegalFormText@DNBC
odeValue
OrderProductResponse { OrderProductResponseDetail { Product { Organization { RegisteredDetail { LegalFormDetails { LegalFormText @DNBCodeValue
integer, up to 7 digits,Attribute (1x)
Possible values: Code
Table 4
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization }RegisteredDetail } LegalFormDetails
/Aggregate
OrderProductResponse { OrderProductResponseDetail { Product { Organization { RegisteredDetail { StockExchangeDetails
Aggregate, Optional(Infinite)
An entry loop which can
repeat multiple times to
allow the recording of
any Stock Exchanges on
which the subject's
shares are traded.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 194
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { RegisteredDetail { StockExchangeDetails { StockExchangeName
string, up to 256 chars,Optional [M+]
The name of a Stock
Exchange on which the
subject's shares are
traded.
Monitor Path:
//Organization
/RegisteredDetail
/StockExchangeDetails
OrderProductResponse { OrderProductResponseDetail { Product { Organization { RegisteredDetail { StockExchangeDetails { StockExchangeName @DNBCodeValue
integer, up to 7 digits,Attribute (1x)
OrderProductResponse { OrderProductResponseDetail { Product { Organization { RegisteredDetail { StockExchangeDetails { StockExchangeTickerName
string, up to 100 chars,Optional [M+]
Text by which this
subject is identified at
this Stock Exchange for
share trading purposes,
e.g., DNB.
Monitor Path:
//Organization
/RegisteredDetail
/StockExchangeDetails
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 195
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { RegisteredDetail { StockExchangeDetails { PrimaryStockExchangeIndicator
boolean, Optional [M+]
When 'true' indicates
that this is the most
important stock
exchange among all the
stock exchanges where
this subject's shares are
traded. When 'false'
indicates that this is not
the most important
stock exchange among
all the stock exchanges
where this subject's
shares are traded,
however as this is the
assumed condition there
is no requirement to
create this tag to
represent this fact.
Monitor Path:
//Organization
/RegisteredDetail
/StockExchangeDetails
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 196
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { RegisteredDetail { StockExchangeDetails { CountryISOAlpha2Code
string, at least 2 chars,up to 2 chars, Optional[M+]
The two-letter country
code, defined in the ISO
3166-1 scheme
published by
International
Organization for
Standardization (ISO),
identifying the country
for this stock exchange.
Monitor Path:
//Organization
/RegisteredDetail
/StockExchangeDetails
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization }RegisteredDetail } StockExchangeDetails
/Aggregate
OrderProductResponse { OrderProductResponseDetail { Product { Organization { RegisteredDetail { ShareCapitalDetails
Aggregate, Optional(Infinite)
An entry loop which can
repeat multiple times to
allow the recording of
the current Capital
information.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 197
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { RegisteredDetail { ShareCapitalDetails { CapitalAmount
decimal, Optional [M+]
The amount of the
capital of this type. If
figure is stored locally
with 000s omitted then
this must be multiplied
and the full figure
populated to the record,
e.g., If Capital is 543 with
000s omitted then the
figure of 543000 should
be populated.
Monitor Path:
//Organization
/RegisteredDetail
/ShareCapitalDetails@D
NBCodeValue
OrderProductResponse { OrderProductResponseDetail { Product { Organization { RegisteredDetail { ShareCapitalDetails { CapitalAmount @UnitOfSize
string, up to 12 chars,Attribute (1x)
OrderProductResponse { OrderProductResponseDetail { Product { Organization { RegisteredDetail { ShareCapitalDetails { CapitalAmount @CurrencyISOAlpha3Code
string, up to 3 chars,Attribute (1x)
OrderProductResponse { OrderProductResponseDetail { Product { Organization { RegisteredDetail { ShareCapitalDetails { CapitalAmount @ReliabilityText
string, up to 256 chars,Attribute (1x)
OrderProductResponse { OrderProductResponseDetail { Product { Organization { RegisteredDetail { ShareCapitalDetails { StartDate
date, Optional [M+]
The date on which the
Capital Amount was first
registered.
Monitor Path:
//Organization
/RegisteredDetail
/ShareCapitalDetails@D
NBCodeValue
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization }RegisteredDetail } ShareCapitalDetails
/Aggregate
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization }RegisteredDetail
/Aggregate
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 198
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { IndustryCode Aggregate, Optional
Records the business
activities in which an
organization is actively
engaged using
standardized coding
schemes such as
European NACE and U.S.
Standard Industry
Classifications (SIC).
Examples of business
activities are:
commercial printing,
legal services, drug store,
sheet metalwork
fabricator.
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 @DNBCodeValue
integer, up to 7 digits,Attribute (1x)
OrderProductResponse { OrderProductResponseDetail { Product { Organization { IndustryCode{ IndustryCode @TypeText
string, up to 256 chars,Attribute (1x)
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 199
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { IndustryCode{ IndustryCode { IndustryCode
string, up to 16 chars,Required [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@DNBCod
eValue
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 200
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { IndustryCode{ IndustryCode { IndustryCodeDescription
string, up to 256 chars,Optional (Infinite) [M+]
Text that describes the
business activity based
on the scheme specified
by the attribute
typeText. E.g., 'highway
and street construction'
is the description of
industry code 1611 in
the U.S. SIC (Standard
Industrial Classification)
system.
Monitor Path:
//Organization
/IndustryCode
/IndustryCode@DNBCod
eValue
OrderProductResponse { OrderProductResponseDetail { Product { Organization { IndustryCode{ IndustryCode { IndustryCodeDescription @LanguageCode
integer, up to 3 digits,Attribute (1x)
OrderProductResponse { OrderProductResponseDetail { Product { Organization { IndustryCode{ IndustryCode { IndustryCodeDescription @WritingScriptISOAlpha4Code
string, Attribute (1x)
OrderProductResponse { OrderProductResponseDetail { Product { Organization { IndustryCode{ IndustryCode { DisplaySequence
integer, up to 3 digits,Optional
A number which may be
used to define the order
in which this industry
code should be
presented relative to
other industry codes of
the same type where
the lower the number
the earlier the data is
presented.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 201
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { IndustryCode{ IndustryCode { SalesPercentage
decimal, up to 8 digits,maximum of 2 decimalplaces, Optional [M+]
The value of annual
sales which are
attributable to the
operations defined by
Industry Code Number
as a percentage of total
annual sales.
Monitor Path:
//Organization
/IndustryCode
/IndustryCode@DNBCod
eValue
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization }IndustryCode } IndustryCode
/Aggregate
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization }IndustryCode
/Aggregate
OrderProductResponse { OrderProductResponseDetail { Product { Organization { ActivitiesAndOperations
Aggregate, Optional
Records the description
of operations continued
by a business including
market information
such as the number of
customers, agency
details and
import/export details.
OrderProductResponse { OrderProductResponseDetail { Product { Organization { ActivitiesAndOperations { OperationsText
string, Optional (Infinite)[M]
Text that describes
detailed information
regarding a business
operation.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 202
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { ActivitiesAndOperations { LineOfBusinessDetails
Aggregate, Optional(Infinite)
An entry loop which can
repeat multiple times to
allow the recording of
several different
descriptions of
operations continued by
a business in different
languages.
OrderProductResponse { OrderProductResponseDetail { Product { Organization { ActivitiesAndOperations { LineOfBusinessDetails { LineOfBusinessDescription
string, up to 3000 chars,Optional [M+]
Records the textual
description of operations
continued by a business.
Monitor Path:
//Organization
/ActivitiesAndOperations
/LineOfBusinessDetails
OrderProductResponse { OrderProductResponseDetail { Product { Organization { ActivitiesAndOperations { LineOfBusinessDetails { LineOfBusinessDescription@LanguageCode
integer, up to 3 digits,Attribute (1x)
OrderProductResponse { OrderProductResponseDetail { Product { Organization { ActivitiesAndOperations { LineOfBusinessDetails { LineOfBusinessDescription@WritingScriptISOAlpha4Code
string, Attribute (1x)
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization }ActivitiesAndOperations } LineOfBusinessDetails
/Aggregate
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 203
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { ActivitiesAndOperations { ImportDetails
Aggregate, Optional
Records the details of
several different
countries or
international regions
from which the subject
imports, and the
percentage of the
subject’s annual
purchases that are
made in each of those
locations.
OrderProductResponse { OrderProductResponseDetail { Product { Organization { ActivitiesAndOperations { ImportDetails { ImportIndicator
boolean, Optional [M]
When 'true' indicates
that the subject
company imports a
quantity of goods from
other countries.
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization }ActivitiesAndOperations } ImportDetails
/Aggregate
OrderProductResponse { OrderProductResponseDetail { Product { Organization { ActivitiesAndOperations { ExportDetails
Aggregate, Optional
Records the details of
several different
countries or
international regions to
which the subject
exports, and the
percentage of the
subject’s annual sales
that are made in each of
those locations.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 204
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { ActivitiesAndOperations { ExportDetails { ExportIndicator
boolean, Optional [M]
When 'true' indicates
that the subject
company exports a
quantity of goods to
other countries.
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization }ActivitiesAndOperations } ExportDetails
/Aggregate
OrderProductResponse { OrderProductResponseDetail { Product { Organization { ActivitiesAndOperations { SubjectIsAgentDetails
Aggregate, Optional
Record the various
details of the subject
acts as an agent to
promote goods or
services.
OrderProductResponse { OrderProductResponseDetail { Product { Organization { ActivitiesAndOperations { SubjectIsAgentDetails { AgentIndicator
boolean, Optional [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.
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization }ActivitiesAndOperations } SubjectIsAgentDetails
/Aggregate
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 205
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { ActivitiesAndOperations { PrimarySICCategoryValue
string, up to 1 char,Optional [M]
Possible values: A
[Agriculture; Forestry
and Fishing]; B [Mining];
C [Construction]; D
[Manufacturing]; E
[Transportation;
Communications;
Electric; Gas and
Sanitary Services]; F
[Wholesale Trade]; G
[Retail Sale]; H [Finance;
Insurance; and Real
Estate]; I [Services]; J
[Public Administration]
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization }ActivitiesAndOperations
/Aggregate
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 206
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { EmployeeFigures
Aggregate, Optional
Records information
about the number of
people engaged by an
organization to perform
its business
operations.Several
different Employee
Figures for a subject
could be recorded, e.g.,
consolidated, individual
entity, headquarters
only. A further
breakdown of employee
figures is recorded based
on employment basis
(e.g., full time, part time,
contract) and/or
employee category (e.g.,
clerical, management,
marketing, sales, blue
collar).
OrderProductResponse { OrderProductResponseDetail { Product { Organization { EmployeeFigures { IndividualEntityEmployeeDetails
Aggregate, Optional
Records current
employee data to the
individual entity. If the
organization is classified
by D&B as a business"
OrderProductResponse { OrderProductResponseDetail { Product { Organization { EmployeeFigures { IndividualEntityEmployeeDetails { EmployeeFiguresDate
date, Optional [M]
The date for which the
employee figure was
reported by the
organization.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 207
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { EmployeeFigures { IndividualEntityEmployeeDetails { TotalEmployeeQuantity
long, Optional [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 [M+]
Text that describes the
integrity of the
employee figures, e.g.
audited, actual,
estimated, modeled.
Monitor Path:
//Organization
/EmployeeFigures
/IndividualEntityEmploye
eDetails
/ReliabilityText@DNBCo
deValue
OrderProductResponse { OrderProductResponseDetail { Product { Organization { EmployeeFigures { IndividualEntityEmployeeDetails { ReliabilityText @DNBCodeValue
integer, up to 7 digits,Attribute (1x)
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization }EmployeeFigures } IndividualEntityEmployeeDetails
/Aggregate
OrderProductResponse { OrderProductResponseDetail { Product { Organization { EmployeeFigures { IndividualEntityEmployeeDetailsHistory
Aggregate, Optional(Infinite)
Records current
employee data to the
individual entity. If the
organization is classified
by D&B as a business"
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 208
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { EmployeeFigures { IndividualEntityEmployeeDetailsHistory { EmployeeFiguresDate
date, Optional [M]
The date for which the
employee figure was
reported by the
organization.
OrderProductResponse { OrderProductResponseDetail { Product { Organization { EmployeeFigures { IndividualEntityEmployeeDetailsHistory { TotalEmployeeQuantity
long, Optional [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 { IndividualEntityEmployeeDetailsHistory { ReliabilityText
string, up to 256 chars,Optional [M+]
Text that describes the
integrity of the
employee figures, e.g.
audited, actual,
estimated, modeled.
Monitor Path:
//Organization
/EmployeeFigures
/IndividualEntityEmploye
eDetailsHistory
/ReliabilityText@DNBCo
deValue
OrderProductResponse { OrderProductResponseDetail { Product { Organization { EmployeeFigures { IndividualEntityEmployeeDetailsHistory { ReliabilityText @DNBCodeValue
integer, up to 7 digits,Attribute (1x)
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization }EmployeeFigures } IndividualEntityEmployeeDetailsHistory
/Aggregate
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 209
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { EmployeeFigures { ConsolidatedEmployeeDetails
Aggregate, Optional
Records current
employee data which
includes all employees
who are engaged in the
operations of the legal
entity (including
employees located at
branch locations) as well
as all employees who are
engaged in the
operations of every
direct descendant in its
family tree (based on
controlling interest). I.e.
Subsidiaries. Note: An
organization which is
classified by D&B as a
branch" location cannot
have an "Consolidated"
employee figure."
OrderProductResponse { OrderProductResponseDetail { Product { Organization { EmployeeFigures { ConsolidatedEmployeeDetails { EmployeeFiguresDate
date, Optional [M]
The date for which the
employee figure was
reported by the
organization.
OrderProductResponse { OrderProductResponseDetail { Product { Organization { EmployeeFigures { ConsolidatedEmployeeDetails { TotalEmployeeQuantity
long, Optional [M]
A number that defines
how many people are
directly engaged and
paid by the organization
to perform or support its
business operations.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 210
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { EmployeeFigures { ConsolidatedEmployeeDetails { ReliabilityText
string, up to 256 chars,Optional [M+]
Text that describes the
integrity of the
employee figures, e.g.
audited, actual,
estimated, modeled.
Monitor Path:
//Organization
/EmployeeFigures
/ConsolidatedEmployee
Details
/ReliabilityText@DNBCo
deValue
OrderProductResponse { OrderProductResponseDetail { Product { Organization { EmployeeFigures { ConsolidatedEmployeeDetails { ReliabilityText @DNBCodeValue
integer, up to 7 digits,Attribute (1x)
OrderProductResponse { OrderProductResponseDetail { Product { Organization { EmployeeFigures { ConsolidatedEmployeeDetails { EmployeeCategoryDetails
Aggregate, Optional(Infinite)
An entry loop which can
repeat multiple times to
allow the recording of
employee figures for the
different function levels
of an organization.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 211
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { EmployeeFigures { ConsolidatedEmployeeDetails { EmployeeCategoryDetails { EmployeeBasisText
string, up to 256 chars,Optional [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
/ConsolidatedEmployee
Details
/EmployeeCategoryDeta
ils
/EmployeeBasisText@D
NBCodeValue
OrderProductResponse { OrderProductResponseDetail { Product { Organization { EmployeeFigures { ConsolidatedEmployeeDetail { EmployeeCategoryDetails { EmployeeBasisText @DNBCodeValue
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization }EmployeeFigures } ConsolidatedEmployeeDetails } EmployeeCategoryDetails
/Aggregate
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization }EmployeeFigures } ConsolidatedEmployeeDetails
/Aggregate
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 212
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { EmployeeFigures { ConsolidatedEmployeeDetailsHistory
Aggregate, Optional(Infinite)
Records previous
employee data which
includes all employees
who are engaged in the
operations of the legal
entity (including
employees located at
branch locations) as well
as all employees who are
engaged in the
operations of every
direct descendant in its
family tree (based on
controlling interest). I.e.
Subsidiaries. Note: An
organization which is
classified by D&B as a
branch" location cannot
have an "Consolidated"
employee figure."
OrderProductResponse { OrderProductResponseDetail { Product { Organization { EmployeeFigures { ConsolidatedEmployeeDetailsHistory { EmployeeFiguresDate
date, Optional [M]
The date for which the
employee figure was
reported by the
organization.
OrderProductResponse { OrderProductResponseDetail { Product { Organization { EmployeeFigures { ConsolidatedEmployeeDetailsHistory { TotalEmployeeQuantity
long, Optional [M]
A number that defines
how many people are
directly engaged and
paid by the organization
to perform or support its
business operations.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 213
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { EmployeeFigures { ConsolidatedEmployeeDetailsHistory { ReliabilityText
string, up to 256 chars,Optional [M+]
Text that describes the
integrity of the
employee figures, e.g.
audited, actual,
estimated, modeled.
Monitor Path:
//Organization
/EmployeeFigures
/ConsolidatedEmployee
DetailsHistory
/ReliabilityText@DNBCo
deValue
OrderProductResponse { OrderProductResponseDetail { Product { Organization { EmployeeFigures { ConsolidatedEmployeeDetailsHistory { ReliabilityText @DNBCodeValue
integer, up to 7 digits,Attribute (1x)
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization }EmployeeFigures } ConsolidatedEmployeeDetailsHistory
/Aggregate
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 214
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { EmployeeFigures { GroupEmployeeDetails
Aggregate, Optional
Records current
employee data of the
entire family up and
down the family tree.
The employee figures
include all employees
who are engaged in the
operations of all
organizations which
make up the entire
family. An organization
which is classified by
D&B as a 'branch'
location cannot have an
employee figure where
the scope code is set to
'Entire Group'. An
organization which is
the global ultimate of a
family should not have
an employee figure
where the scope is set to
'Entire Group'. This
scope should only be
recorded when the
subject is a subsidiary
organization. Note that
figures received with
this information scope
do not meet D&B's
standard, and this
should only be used
when the 'consolidated'
and 'individual' employee
figures can not be
provided for a subject.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 215
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { EmployeeFigures { GroupEmployeeDetails { TotalEmployeeQuantity
long, Optional
A number that defines
how many people are
directly engaged and
paid by the organization
to perform or support its
business operations.
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization }EmployeeFigures } GroupEmployeeDetails
/Aggregate
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization }EmployeeFigures
/Aggregate
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage Aggregate, Optional
Records the relationship
between the subject
and the next subject UP
in the family tree. E.g. Its
parent, HQ, Joint parent
or shareholder. Also
records names,
addresses and
registration numbers for
the related subject. This
data topic may also be
used to record the
details of the
relationship between
the subject and the
business founder;
however if a simple
textual reference to the
business founder is all
that is required then the
'Started By' element in
'Subject Details' should
be used
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 216
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { LinkageSummary
Aggregate, Optional
Records the indicative or
derived information
about the subject UP
and DOWN in the family
tree.
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { LinkageSummary { GlobalUltimateFamilyTreeLinkageCount
integer, up to 8 digits,Optional [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.
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization } Linkage} LinkageSummary
/Aggregate
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 217
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { GlobalUltimateOrganization
Aggregate, Optional
Records information
about the top most
business in the family
tree, tracing each parent
up to its own parent. For
example, Company A is a
business based in the US
and has company B as
its parent also in the US.
In turn company B is
owned by company C,
also in the US, which is
owned by company D
which is in the UK. Thus
the global ultimate" of
this family tree (and
therefore of each
member of the family
tree) is Company D."
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { GlobalUltimateOrganization { DUNSNumber
string, up to 15 charsPattern: {([0-9a-zA-Z]*)},Optional [M]
The D-U-N-S Number is
D&B's identification
number, which provides
unique identification of
this organization, in
accordance with the
Data Universal
Numbering System (D-U-
N-S).
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 218
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { GlobalUltimateOrganization { 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 { Linkage { GlobalUltimateOrganization { OrganizationPrimaryName { OrganizationName
string, up to 256 chars,Required [M]
Text recording a name
of this organization in
the specified language
and/or writing script.
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization } Linkage} GlobalUltimateOrganization } OrganizationPrimaryName
/Aggregate
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { GlobalUltimateOrganization { CountryISOAlpha2Code
string, at least 2 chars,up to 2 chars, Optional[M]
The two-letter country
code, defined in the ISO
3166-1 scheme
published by
International
Organization for
Standardization (ISO)
identifying the country
of the inquired subject.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 219
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { GlobalUltimateOrganization { 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 { Linkage { GlobalUltimateOrganization { PrimaryAddress @LanguageCode
integer, up to 3 digits,Attribute (1x)
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { GlobalUltimateOrganization { PrimaryAddress @WritingScriptCode
integer, up to 7 digits,Attribute (1x)
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 220
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { GlobalUltimateOrganization { 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 { Linkage { GlobalUltimateOrganization { PrimaryAddress { StreetAddressLine { LineText
string, up to 240 chars,Required [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
/GlobalUltimateOrganiz
ation /PrimaryAddress
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 221
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { GlobalUltimateOrganization { PrimaryAddress { StreetAddressLine { DisplaySequence
integer, up to 3 digits,Optional
A number which may be
used to define the order
in which this street
address line should be
presented relative to
other street address
lines where the lower
the number the earlier
the data is presented.
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization } Linkage} GlobalUltimateOrganization } PrimaryAddress } StreetAddressLine
/Aggregate
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { GlobalUltimateOrganization { PrimaryAddress { PrimaryTownName
string, up to 64 chars,Optional [M+]
The name of the town
or city recognized by the
Postal Authority for
delivering mail.
Monitor Path:
//Organization /Linkage
/GlobalUltimateOrganiz
ation /PrimaryAddress
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 222
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { GlobalUltimateOrganization { PrimaryAddress { CountryISOAlpha2Code
string, at least 2 chars,up to 2 chars, Optional[M+]
The two-letter country
code, defined in the ISO
3166-1 scheme
published by
International
Organization for
Standardization (ISO),
identifying the country
for this address.
Monitor Path:
//Organization /Linkage
/GlobalUltimateOrganiz
ation /PrimaryAddress
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { GlobalUltimateOrganization { PrimaryAddress { TerritoryName
string, up to 128 chars,Optional [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
/GlobalUltimateOrganiz
ation /PrimaryAddress
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 223
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { GlobalUltimateOrganization { PrimaryAddress { TerritoryAbbreviatedName
string, up to 64 chars,Optional [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
/GlobalUltimateOrganiz
ation /PrimaryAddress
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { GlobalUltimateOrganization { PrimaryAddress { PostalCode
string, up to 16 chars,Optional [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
/GlobalUltimateOrganiz
ation /PrimaryAddress
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { GlobalUltimateOrganization { PrimaryAddress { CountryOfficialName
string, up to 64 chars,Optional [M+]
Monitor Path:
//Organization /Linkage
/GlobalUltimateOrganiz
ation /PrimaryAddress
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 224
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { GlobalUltimateOrganization { PrimaryAddress { PrimaryTownWorldBaseCode
integer, up to 32 digits,Optional [M+]
Monitor Path:
//Organization /Linkage
/GlobalUltimateOrganiz
ation /PrimaryAddress
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { GlobalUltimateOrganization { PrimaryAddress { CountryWorldBaseCode
integer, up to 3 digits,Optional [M+]
The D&B three digit
WorldBase code value
that identifies country
where the business is
located.
Monitor Path:
//Organization /Linkage
/GlobalUltimateOrganiz
ation /PrimaryAddress
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { GlobalUltimateOrganization { PrimaryAddress { CountryGroupName
string, up to 64 chars,Optional [M+]
Monitor Path:
//Organization /Linkage
/GlobalUltimateOrganiz
ation /PrimaryAddress
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 225
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { GlobalUltimateOrganization { PrimaryAddress { CountryFIPSCode
string, up to 4 chars,Optional [M+]
Text that describes the
Federal Information
Processing Standards
(FIPS) code value
assigned by the U.S
Department of
Commerce which
identifies the country
where this subject is
located.
Monitor Path:
//Organization /Linkage
/GlobalUltimateOrganiz
ation /PrimaryAddress
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { GlobalUltimateOrganization { PrimaryAddress { CountyWorldBaseCode
integer, up to 32 digits,Optional [M+]
Monitor Path:
//Organization /Linkage
/ParentOrganization
/PrimaryAddress
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization } Linkage} GlobalUltimateOrganization } PrimaryAddress
/Aggregate
End: OrderProductResponse } OrderProductResponseDetail } Product } Organization } Linkage} GlobalUltimateOrganization
/Aggregate
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 226
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { DomesticUltimateOrganization
Aggregate, Optional
Records information
about the last business
in the tree, when
reviewing upwards,
which is in the same
country as the other
subject. For example,
Company A is a business
based in the US and has
company B as its parent
also in the US. In turn
company B is owned by
company C, also in the
US, which is owned by
company D which is in
the UK. Thus the
domestic ultimate" of
Company A is actually
Company C as this is the
last business in the
parent chain which is in
the US"
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { DomesticUltimateOrganization { DUNSNumber
string, up to 15 charsPattern: {([0-9a-zA-Z]*)},Optional [M]
The D-U-N-S Number is
D&B's identification
number, which provides
unique identification of
this organization, in
accordance with the
Data Universal
Numbering System (D-U-
N-S).
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 227
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { DomesticUltimateOrganization { 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 { Linkage { DomesticUltimateOrganization { OrganizationPrimaryName { OrganizationName
string, up to 256 chars,Required [M]
Text recording a name
of this organization in
the specified language
and/or writing script.
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization } Linkage} DomesticUltimateOrganization } OrganizationPrimaryName
/Aggregate
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { DomesticUltimateOrganization { CountryISOAlpha2Code
string, at least 2 chars,up to 2 chars, Optional[M]
The two-letter country
code, defined in the ISO
3166-1 scheme
published by
International
Organization for
Standardization (ISO)
identifying the country
of the inquired subject.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 228
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { DomesticUltimateOrganization { 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 { Linkage { DomesticUltimateOrganization { PrimaryAddress @LanguageCode
integer, up to 3 digits,Attribute (1x)
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { DomesticUltimateOrganization { PrimaryAddress @WritingScriptCode
integer, up to 7 digits,Attribute (1x)
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 229
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { DomesticUltimateOrganization { 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.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 230
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { DomesticUltimateOrganization { PrimaryAddress { StreetAddressLine { LineText
string, up to 240 chars,Required [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
/DomesticUltimateOrga
nization
/PrimaryAddress
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { DomesticUltimateOrganization { PrimaryAddress { StreetAddressLine { DisplaySequence
integer, up to 3 digits,Optional
A number which may be
used to define the order
in which this street
address line should be
presented relative to
other street address
lines where the lower
the number the earlier
the data is presented.
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization } Linkage} DomesticUltimateOrganization } PrimaryAddress } StreetAddressLine
/Aggregate
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 231
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { DomesticUltimateOrganization { PrimaryAddress { PrimaryTownName
string, up to 64 chars,Optional [M+]
The name of the town
or city recognized by the
Postal Authority for
delivering mail.
Monitor Path:
//Organization /Linkage
/DomesticUltimateOrga
nization
/PrimaryAddress
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { DomesticUltimateOrganization { PrimaryAddress { CountryISOAlpha2Code
string, at least 2 chars,up to 2 chars, Optional[M+]
The two-letter country
code, defined in the ISO
3166-1 scheme
published by
International
Organization for
Standardization (ISO),
identifying the country
for this address.
Monitor Path:
//Organization /Linkage
/DomesticUltimateOrga
nization
/PrimaryAddress
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 232
Name Characteristics
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 [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
/DomesticUltimateOrga
nization
/PrimaryAddress
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 233
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { DomesticUltimateOrganization { PrimaryAddress { PostalCode
string, up to 16 chars,Optional [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
/DomesticUltimateOrga
nization
/PrimaryAddress
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { DomesticUltimateOrganization { PrimaryAddress { PrimaryTownWorldBaseCode
integer, up to 32 digits,Optional [M+]
Monitor Path:
//Organization /Linkage
/DomesticUltimateOrga
nization
/PrimaryAddress
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { DomesticUltimateOrganization { PrimaryAddress { CountryWorldBaseCode
integer, up to 3 digits,Optional [M+]
The D&B three digit
WorldBase code value
that identifies country
where the business is
located.
Monitor Path:
//Organization /Linkage
/DomesticUltimateOrga
nization
/PrimaryAddress
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 234
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { DomesticUltimateOrganization { PrimaryAddress { CountryFIPSCode
string, up to 4 chars,Optional [M+]
Text that describes the
Federal Information
Processing Standards
(FIPS) code value
assigned by the U.S
Department of
Commerce which
identifies the country
where this subject is
located.
Monitor Path:
//Organization /Linkage
/DomesticUltimateOrga
nization
/PrimaryAddress
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization } Linkage} DomesticUltimateOrganization } PrimaryAddress
/Aggregate
End: OrderProductResponse } OrderProductResponseDetail } Product } Organization } Linkage} DomesticUltimateOrganization
/Aggregate
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { HeadquartersOrganization
Aggregate, Optional
Records information
about the office that
serves as the
administrative center of
an enterprise.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 235
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { HeadquartersOrganization { DUNSNumber
string, up to 15 charsPattern: {([0-9a-zA-Z]*)},Optional [M]
The D-U-N-S Number is
D&B's identification
number, which provides
unique identification of
this organization, in
accordance with the
Data Universal
Numbering System (D-U-
N-S).
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { HeadquartersOrganization { 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 { Linkage { HeadquartersOrganization { OrganizationPrimaryName { OrganizationName
string, up to 256 chars,Required [M]
Text recording a name
of this organization in
the specified language
and/or writing script.
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization } Linkage} HeadquartersOrganization } OrganizationPrimaryName
/Aggregate
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 236
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { HeadquartersOrganization { CountryISOAlpha2Code
string, at least 2 chars,up to 2 chars, Optional[M]
The two-letter country
code, defined in the ISO
3166-1 scheme
published by
International
Organization for
Standardization (ISO)
identifying the country
of the inquired subject.
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { HeadquartersOrganization { 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 { Linkage { HeadquartersOrganization { PrimaryAddress @LanguageCode
integer, up to 3 digits,Attribute (1x)
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { HeadquartersOrganization { PrimaryAddress @WritingScriptCode
integer, up to 7 digits,Attribute (1x)
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 237
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { HeadquartersOrganization { 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 { Linkage { HeadquartersOrganization { PrimaryAddress { StreetAddressLine { LineText
string, up to 240 chars,Required [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
/HeadquartersOrganizat
ion /PrimaryAddress
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 238
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { HeadquartersOrganization { PrimaryAddress { StreetAddressLine { DisplaySequence
integer, up to 3 digits,Optional
A number which may be
used to define the order
in which this street
address line should be
presented relative to
other street address
lines where the lower
the number the earlier
the data is presented.
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization } Linkage} HeadquartersOrganization } PrimaryAddress } StreetAddressLine
/Aggregate
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { HeadquartersOrganization { PrimaryAddress { PrimaryTownName
string, up to 64 chars,Optional [M+]
The name of the town
or city recognized by the
Postal Authority for
delivering mail.
Monitor Path:
//Organization /Linkage
/HeadquartersOrganizat
ion /PrimaryAddress
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 239
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { HeadquartersOrganization { PrimaryAddress { CountryISOAlpha2Code
string, at least 2 chars,up to 2 chars, Optional[M+]
The two-letter country
code, defined in the ISO
3166-1 scheme
published by
International
Organization for
Standardization (ISO),
identifying the country
for this address.
Monitor Path:
//Organization /Linkage
/HeadquartersOrganizat
ion /PrimaryAddress
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { HeadquartersOrganization { PrimaryAddress { TerritoryName
string, up to 128 chars,Optional [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
/HeadquartersOrganizat
ion /PrimaryAddress
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 240
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { HeadquartersOrganization { PrimaryAddress { TerritoryAbbreviatedName
string, up to 64 chars,Optional [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
/HeadquartersOrganizat
ion /PrimaryAddress
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { HeadquartersOrganization { PrimaryAddress { PostalCode
string, up to 16 chars,Optional [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
/HeadquartersOrganizat
ion /PrimaryAddress
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { HeadquartersOrganization { PrimaryAddress { CountryOfficialName
string, up to 64 chars,Optional [M+]
Monitor Path:
//Organization /Linkage
/HeadquartersOrganizat
ion /PrimaryAddress
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 241
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { HeadquartersOrganization { PrimaryAddress { PrimaryTownWorldBaseCode
integer, up to 32 digits,Optional [M+]
Monitor Path:
//Organization /Linkage
/HeadquartersOrganizat
ion /PrimaryAddress
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { HeadquartersOrganization { PrimaryAddress { CountryWorldBaseCode
integer, up to 3 digits,Optional [M+]
The D&B three digit
WorldBase code value
that identifies country
where the business is
located.
Monitor Path:
//Organization /Linkage
/HeadquartersOrganizat
ion /PrimaryAddress
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { HeadquartersOrganization { PrimaryAddress { CountryGroupName
string, up to 64 chars,Optional [M+]
Monitor Path:
//Organization /Linkage
/HeadquartersOrganizat
ion /PrimaryAddress
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 242
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { HeadquartersOrganization { PrimaryAddress { CountryFIPSCode
string, up to 4 chars,Optional [M+]
Text that describes the
Federal Information
Processing Standards
(FIPS) code value
assigned by the U.S
Department of
Commerce which
identifies the country
where this subject is
located.
Monitor Path:
//Organization /Linkage
/HeadquartersOrganizat
ion /PrimaryAddress
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { HeadquartersOrganization { PrimaryAddress { CountyWorldbaseCode
integer, up to 32 digits,Optional
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization } Linkage} HeadquartersOrganization } PrimaryAddress
/Aggregate
End: OrderProductResponse } OrderProductResponseDetail } Product } Organization } Linkage} HeadquartersOrganization
/Aggregate
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization
Aggregate, Optional
Records information
about the organization
which owns more than
50% of the subject and
the organization at the
very top of the legal
family.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 243
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { DUNSNumber
string, up to 15 charsPattern: {([0-9a-zA-Z]*)},Optional [M]
The D-U-N-S Number is
D&B's identification
number, which provides
unique identification of
this organization, in
accordance with the
Data Universal
Numbering System (D-U-
N-S).
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { 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 { Linkage { ParentOrganization { OrganizationPrimaryName { OrganizationName
string, up to 256 chars,Required [M]
Text recording a name
of this organization in
the specified language
and/or writing script.
End: OrderProductResponse } OrderProductResponseDetail } Product } Organization } Linkage} ParentOrganization } OrganizationPrimaryName
/Aggregate
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 244
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { CountryISOAlpha2Code
string, at least 2 chars,up to 2 chars, Optional[M]
The two-letter country
code, defined in the ISO
3166-1 scheme
published by
International
Organization for
Standardization (ISO)
identifying the country
of the inquired subject.
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { 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 { Linkage { ParentOrganization { PrimaryAddress @LanguageCode
integer, up to 3 digits,Attribute (1x)
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { PrimaryAddress @WritingScriptCode
integer, up to 7 digits,Attribute (1x)
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 245
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { 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 { Linkage { ParentOrganization { PrimaryAddress { StreetAddressLine { LineText
string, up to 240 chars,Required [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
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 246
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { PrimaryAddress { StreetAddressLine { DisplaySequence
integer, up to 3 digits,Optional
A number which may be
used to define the order
in which this street
address line should be
presented relative to
other street address
lines where the lower
the number the earlier
the data is presented.
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization } Linkage} ParentOrganization } PrimaryAddress } StreetAddressLine
/Aggregate
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { PrimaryAddress { PrimaryTownName
string, up to 64 chars,Optional [M+]
The name of the town
or city recognized by the
Postal Authority for
delivering mail.
Monitor Path:
//Organization /Linkage
/ParentOrganization
/PrimaryAddress
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 247
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { PrimaryAddress { CountryISOAlpha2Code
string, at least 2 chars,up to 2 chars, Optional[M+]
The two-letter country
code, defined in the ISO
3166-1 scheme
published by
International
Organization for
Standardization (ISO),
identifying the country
for this address.
Monitor Path:
//Organization /Linkage
/ParentOrganization
/PrimaryAddress
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { PrimaryAddress { TerritoryName
string, up to 128 chars,Optional [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
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 248
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { PrimaryAddress { TerritoryAbbreviatedName
string, up to 64 chars,Optional [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 [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 [M+]
Monitor Path:
//Organization /Linkage
/ParentOrganization
/PrimaryAddress
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 249
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { PrimaryAddress { PrimaryTownWorldBaseCode
integer, up to 32 digits,Optional [M+]
Monitor Path:
//Organization /Linkage
/ParentOrganization
/PrimaryAddress
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { PrimaryAddress { CountryWorldBaseCode
integer, up to 3 digits,Optional [M+]
The D&B three digit
WorldBase code value
that identifies country
where the business is
located.
Monitor Path:
//Organization /Linkage
/GlobalUltimateOrganiz
ation /PrimaryAddress
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { PrimaryAddress { CountryGroupName
string, up to 64 chars,Optional [M+]
Monitor Path:
//Organization /Linkage
/ParentOrganization
/PrimaryAddress
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 250
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { PrimaryAddress { CountryFIPSCode
string, up to 4 chars,Optional [M+]
Text that describes the
Federal Information
Processing Standards
(FIPS) code value
assigned by the U.S
Department of
Commerce which
identifies the country
where this subject is
located.
Monitor Path:
//Organization /Linkage
/ParentOrganization
/PrimaryAddress
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { PrimaryAddress { CountyWorldbaseCode
integer, up to 32 digits,Optional
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization } Linkage} ParentOrganization } PrimaryAddress
/Aggregate
End: OrderProductResponse } OrderProductResponseDetail } Product } Organization } Linkage} ParentOrganization
/Aggregate
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { FamilyTreeHierarchyLevel
integer, up to 2 digits,Optional [M]
End: OrderProductResponse } OrderProductResponseDetail } Product } Organization } Linkage /Aggregate
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 251
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Assessment Aggregate, Optional
Records insightful and
value added information
on organizations, such
as: - recommendations
on how much credit to
extend to them, -
assessments of their
liquidity, - concise
evaluations of their
performance and
behavior, - predictions on
the risk of conducting
business with them. The
predictive scores are
usually calculated and
assigned by D&B, but
such assessments may
also be recorded when
assigned by third parties.
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Assessment{ HistoryRatingText
string, up to 256 chars,Optional [M+]
Text that specifies if
D&B has any
information that may
reflect unfavorably on
this organization, e.g.,
clear, incomplete,
management, business.
Monitor Path:
//Organization
/Assessment
/HistoryRatingText@DN
BCodeValue
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Assessment{ HistoryRatingText @DNBCodeValue
integer, up to 7 digits,Attribute (1x)
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 252
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Assessment{ CommercialCreditScore
Aggregate, Optional(Infinite)
An entry loop that
repeats multiple times
to allow the recording of
the most recent risk
scores that are assigned
to this organization on a
given date/time using a
scoring model that help
predict the likelihood
that the organization
will pay its bills in a
severely delinquent
manner (90+ days past
due) over the next 12
months.
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Assessment{ CommercialCreditScore { MarketingRiskClassText
string, up to 256 chars,Optional [M+]
Possible values: Low;
Moderate; High
Monitor Path:
//Organization
/Assessment
/CommercialCreditScore
/MarketingRiskClassText
@DNBCodeValue
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Assessment{ CommercialCreditScore { MarketingRiskClassText @DNBCodeValue Possible values: 10925
[Low]; 10926
[Moderate]; 10927 [High]
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization }Assessment } CommercialCreditScore
/Aggregate
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Assessment{ MarketingSegmentationClusterValue
integer, up to 2 digits,Optional [M]
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Assessment{ USPatriotActComplianceRiskScore
Aggregate, Optional
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 253
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Assessment{ USPatriotActComplianceRiskScore { ComplianceRiskClassIndex
string, up to 64 chars,Optional [M]
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Assessment{ USPatriotActComplianceRiskScore { ComplianceRiskIndex
integer, up to 3 digits,Optional [M]
The compliance risk
index is intended to
provide organisations
subject to the USA
Patriot Act with an
additional tool in
performing compliance
risk based assessment of
trading partners. The
Index is a numeric value
that represents an
aggregation of weighted
risk flags, assigned
through a proprietary
rules based algorithm.
Values range form 0 to
~255. Higher Index
values represent a
higher perceived level of
risk.
End: OrderProductResponse } OrderProductResponseDetail } Product } Organization }Assessment } USPatriotActComplianceRiskScore
/Aggregate
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Assessment{ ProofOfRightCount
integer, Optional [M]
End: OrderProductResponse } OrderProductResponseDetail } Product } Organization }Assessment
/Aggregate
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 254
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { BusinessTrading
Aggregate, Optional
Records references or
opinions in terms of the
timeliness of payment,
the amounts of the
transactions and the
terms of sale applied to
the transactions and
summarized views of
this data that involves
the subject either as a
buyer or supplier of
goods or services.
OrderProductResponse { OrderProductResponseDetail { Product { Organization { BusinessTrading { Purchaser
Aggregate, Optional
Records trade data
where the subject is a
purchaser of good or
services.
OrderProductResponse { OrderProductResponseDetail { Product { Organization { BusinessTrading { Purchaser { CurrentPaydexScore
Aggregate, Optional
Records subject's
current Paydex Score. A
calculated element
summarizing the
payment habits of a
subject based on trade
experiences obtained
from its suppliers.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 255
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { BusinessTrading { Purchaser { CurrentPaydexScore { TwentyFourMonthsPaydex
Aggregate, Optional (Upto 2x)
An entry loop which can
repeat to allow the
recording of the numeric
value assigned to an
organization by a D&B
algorithm, assessing the
organization's ability to
meet future obligations
of a particular monetary
range based on the
twenty four most recent
months of trade
experiences as of the
current month, from
different sources.
OrderProductResponse { OrderProductResponseDetail { Product { Organization { BusinessTrading { Purchaser { CurrentPaydexScore { TwentyFourMonthsPaydex { PaydexScore
integer, up to 3 digits,Required
A calculated element
summarizing the
payment habits of a
subject based on trade
experiences obtained
from its suppliers over
the last 3 months.
OrderProductResponse { OrderProductResponseDetail { Product { Organization { BusinessTrading { Purchaser { CurrentPaydexScore { TwentyFourMonthsPaydex { TotalPaymentExperiencesUsedCount
long, Optional
The number of payment
experiences that
contributed to this
payment index score. As
an example, the score
may have been derived
from 18 payment
experiences from
various suppliers.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 256
Name Characteristics
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization }BusinessTrading } Purchaser } CurrentPaydexScore } TwentyFourMonthsPaydex
/Aggregate
OrderProductResponse { OrderProductResponseDetail { Product { Organization { BusinessTrading { Purchaser { CurrentPaydexScore { GlobalPaydex
Aggregate, Optional (Upto 2x)
An entry loop which can
repeat to allow the
recording of the numeric
value assigned to an
organization by a D&B
algorithm, assessing the
organization's ability to
meet future obligations
of a particular monetary
range based on the
trade experiences during
a time period that
cannot be specified.
OrderProductResponse { OrderProductResponseDetail { Product { Organization { BusinessTrading { Purchaser { CurrentPaydexScore { GlobalPaydex { PaydexDate
date, Optional
The date marking the
end of the time period
covered by the payment
performance score.
OrderProductResponse { OrderProductResponseDetail { Product { Organization { BusinessTrading { Purchaser { CurrentPaydexScore { GlobalPaydex { PaydexScore
integer, up to 3 digits,Required
A calculated element
summarizing the
payment habits of a
subject based on trade
experiences obtained
from its suppliers over
the last 3 months.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 257
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { BusinessTrading { Purchaser { CurrentPaydexScore { GlobalPaydex { TotalPaymentExperiencesUsedCount
long, Optional
The number of payment
experiences that
contributed to this
payment index score. As
an example, the score
may have been derived
from 18 payment
experiences from
various suppliers.
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization }BusinessTrading } Purchaser } CurrentPaydexScore } GlobalPaydex
/Aggregate
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization }BusinessTrading } Purchaser } CurrentPaydexScore
/Aggregate
OrderProductResponse { OrderProductResponseDetail { Product { Organization { BusinessTrading { Purchaser { PurchaserDerivedData
Aggregate, Optional(Infinite)
An entry loop which can
repeat multiple times to
allow the recording of
the payment-based
derived data that has
been summarized for a
purchaser. Each
occurrence of this
aggregate represents a
single derived data
element and its value.
OrderProductResponse { OrderProductResponseDetail { Product { Organization { BusinessTrading { Purchaser { PurchaserDerivedData { TwentyFourMonthsDataCoveragePayments
Aggregate, Optional
Records the details of
the data required to
calculate the derived
value considering
twenty four months
data.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 258
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { BusinessTrading { Purchaser { PurchaserDerivedData { TwentyFourMonthsDataCoveragePayments { PaymentPeriodSummary
Aggregate, Optional(Infinite)
An entry loop which can
repeat to allow the
recording of the results
of summarizing the
payments made by the
subjects.
OrderProductResponse { OrderProductResponseDetail { Product { Organization { BusinessTrading { Purchaser { PurchaserDerivedData { TwentyFourMonthsDataCoveragePayments { PaymentPeriodSummary { PaymentsWithHighCredit
Aggregate, Optional
Records the details of
the highest amount
from each of a subject’s
accounts that was
extended to it on the
expectation of payment
within the agreed upon
terms.
OrderProductResponse { OrderProductResponseDetail { Product { Organization { BusinessTrading { Purchaser { PurchaserDerivedData { TwentyFourMonthsDataCoveragePayments { PaymentPeriodSummary { PaymentsWithHighCredit { HighCreditMaximumAmount
decimal, Optional
The greatest monetary
figure owed to the
supplier by the subject
over the period of time
specified by the
Summary Period.
OrderProductResponse { OrderProductResponseDetail { Product { Organization { BusinessTrading { Purchaser { PurchaserDerivedData { TwentyFourMonthsDataCoveragePayments { PaymentPeriodSummary { PaymentsWithHighCredit { AverageHighCreditAmount
decimal, Optional
A monetary figure
specifying the average
high credit is determined
by dividing the total
dollar amount by the
number of experiences
in file for the last 12
months.
End: OrderProductResponse } OrderProductResponseDetail } Product } Organization }BusinessTrading } Purchaser } PurchaserDerivedData }TwentyFourMonthsDataCoveragePayments } PaymentPeriodSummary }PaymentsWithHighCredit
/Aggregate
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 259
Name Characteristics
End: OrderProductResponse } OrderProductResponseDetail } Product } Organization }BusinessTrading } Purchaser } PurchaserDerivedData }TwentyFourMonthsDataCoveragePayments } PaymentPeriodSummary
/Aggregate
End: OrderProductResponse } OrderProductResponseDetail } Product } Organization }BusinessTrading } Purchaser } PurchaserDerivedData }TwentyFourMonthsDataCoveragePayments
/Aggregate
OrderProductResponse { OrderProductResponseDetail { Product { Organization { BusinessTrading { Purchaser { PurchaserDerivedData { GlobalDataCoveragePayments
Aggregate, Optional
Records the details of
the data required to
calculate the derived
value without
considering the period.
OrderProductResponse { OrderProductResponseDetail { Product { Organization { BusinessTrading { Purchaser { PurchaserDerivedData { GlobalDataCoveragePayments { PaymentPeriodSummary
Aggregate, Optional(Infinite)
An entry loop which can
repeat to allow the
recording of the results
of summarizing the
payments made by the
subjects.
OrderProductResponse { OrderProductResponseDetail { Product { Organization { BusinessTrading { Purchaser { PurchaserDerivedData { GlobalDataCoveragePayments { PaymentPeriodSummary { PaymentsWithHighCredit
Aggregate, Optional
Records the details of
the highest amount
from each of a subject’s
accounts that was
extended to it on the
expectation of payment
within the agreed upon
terms.
OrderProductResponse { OrderProductResponseDetail { Product { Organization { BusinessTrading { Purchaser { PurchaserDerivedData { GlobalDataCoveragePayments { PaymentPeriodSummary { PaymentsWithHighCredit { HighCreditMaximumAmount
decimal, Optional
The greatest monetary
figure owed to the
supplier by the subject
over the period of time
specified by the
Summary Period.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 260
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { BusinessTrading { Purchaser { PurchaserDerivedData { GlobalDataCoveragePayments { PaymentPeriodSummary { PaymentsWithHighCredit { AverageHighCreditAmount
decimal, Optional
A monetary figure
specifying the average
high credit is determined
by dividing the total
dollar amount by the
number of experiences
in file for the last 12
months.
End: OrderProductResponse } OrderProductResponseDetail } Product } Organization }BusinessTrading } Purchaser } PurchaserDerivedData } GlobalDataCoveragePayments }PaymentPeriodSummary } PaymentsWithHighCredit
/Aggregate
End: OrderProductResponse } OrderProductResponseDetail } Product } Organization }BusinessTrading } Purchaser } PurchaserDerivedData } GlobalDataCoveragePayments }PaymentPeriodSummary
/Aggregate
End: OrderProductResponse } OrderProductResponseDetail } Product } Organization }BusinessTrading } Purchaser } PurchaserDerivedData } GlobalDataCoveragePayments
/Aggregate
End: OrderProductResponse } OrderProductResponseDetail } Product } Organization }BusinessTrading } Purchaser } PurchaserDerivedData
/Aggregate
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization }BusinessTrading } Purchaser
/Aggregate
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization }BusinessTrading
/Aggregate
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 261
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement
Records details of the
Principals (e.g.,
President, Vice
President, Directors) and
Managers responsible
for the business
strategy, decision
making and day to day
running of the subjects
operations. This includes
names, addresses and
identification numbers
of the principals. Whilst
a principal will usually be
an individual in some
countries it is legally
acceptable for a
registered business
entity to act as a
principal in another
business. This excludes
shareholders and similar
owners who are not
responsible for the
management of the
organization but
includes proprietors and
partners who, whilst
owners, are also
generally the principals
running the
business.Records details
of the Principals (e.g.,
President, Vice
President, Directors) and
Managers responsible
for the business
strategy, decision
making and day to day
running of the subjects
operations. This includes
names, addresses and
identification numbers
of the principals. Whilst
a principal will usually be
an individual in some
countries it is legally
acceptable for a
registered business
entity to act as a
principal in another
business. This excludes
shareholders and similar
owners who are not
responsible for the
management of the
organization but
includes proprietors and
partners who, whilst
owners, are also
generally the principals
running the business.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 262
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { MostSeniorPrincipal
Aggregate, Optional
Records the details of
the most important
principal.
OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { MostSeniorPrincipal { PrincipalAge
string, up to 3 chars,Optional [M+]
Records the age of the
principal in years.
Monitor Path:
//Organization
/PrincipalsAndManagem
ent /MostSeniorPrincipal
OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { MostSeniorPrincipal { CurrentManagementResponsibility
Aggregate, Optional(Infinite)
An entry loop which can
repeat multiple times to
allow the recording of
the code values
identifying the current
business function of the
principal represented as
a standard Management
Responsibility Code
(MRC).
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 263
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { MostSeniorPrincipal { CurrentManagementResponsibility { ManagementResponsibilityText
string, up to 256 chars,Required [M+]
Text identifying the
business function of the
principal derived from a
standard Management
Responsibility Code
(MRC).
Monitor Path:
//Organization
/PrincipalsAndManagem
ent /MostSeniorPrincipal
OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { MostSeniorPrincipal { CurrentManagementResponsibility { ManagementResponsibilityText @ManagementResponsibilityCode
[M+]
Monitor Path:
//Organization
/PrincipalsAndManagem
ent /MostSeniorPrincipal
OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { MostSeniorPrincipal { CurrentManagementResponsibility { StartDate
date, Optional [M+]
The date when the
principal or manager
was appointed to this
position. This is not
necessarily the date
when the principal or
manager was first
employed by the subject;
this is simply the date
when they moved to this
position, e.g., due to a
promotion.
Monitor Path:
//Organization
/PrincipalsAndManagem
ent /MostSeniorPrincipal
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 264
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { MostSeniorPrincipal { CurrentManagementResponsibility { StartDate @DatePrecisionText
string, up to 256 chars,Attribute (1x)
OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { MostSeniorPrincipal { CurrentManagementResponsibility { StartDate @DatePrecisionDNBCodeValue
integer, up to 7 digits,Attribute (1x)
OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { MostSeniorPrincipal { CurrentManagementResponsibility { StartDate @DatePrecisionDNBCodeTableNumber
integer, Attribute (1x)
OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { MostSeniorPrincipal { CurrentManagementResponsibility { DisplaySequence
integer, Optional
A number which may be
used to define the order
in which the Position
should be presented
relative to any other
occurrences of Position
where lower the
number the earlier the
data is presented.
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization }PrincipalsAndManagement } MostSeniorPrincipal } CurrentManagementResponsibility
/Aggregate
OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { MostSeniorPrincipal { PrincipalIdentificationNumberDetail
Aggregate, Optional(Infinite)
An entry loop which can
repeat multiple times to
allow the recording of
several different
identification/registratio
n numbers for the
Principal.
OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { MostSeniorPrincipal { PrincipalIdentificationNumberDetail @DNBCodeValue
Possible values: 24215 -
Coofficial ID
OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { MostSeniorPrincipal { PrincipalIdentificationNumberDetail @TypeText
Possible values:
Coofficial ID
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 265
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { MostSeniorPrincipal { PrincipalIdentificationNumberDetail { PrincipalIdentificationNumber
string, Optional [M+]
A number assigned by
an external body or by
D&B which either
uniquely identifies or
helps to identify an
individual.
Monitor Path:
//Organization
/PrincipalsAndManagem
ent /MostSeniorPrincipal
End: OrderProductResponse } OrderProductResponseDetail } Product } Organization }PrincipalsAndManagement } MostSeniorPrincipal } PrincipalIdentificationNumberDetail
/Aggregate
OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { MostSeniorPrincipal { CurrentCompensation
Aggregate, Optional
OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { MostSeniorPrincipal { CurrentCompensation { CompensationDate
date, Optional [M+]
Monitor Path:
//Organization
/PrincipalsAndManagem
ent /MostSeniorPrincipal
OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { MostSeniorPrincipal { CurrentCompensation { CompensationDetail
Aggregate, Optional(Infinite)
OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { MostSeniorPrincipal { CurrentCompensation { CompensationDetail { CompensationTypeText
string, up to 256 chars,Optional [M+]
Possible values: 23622
[Bonus]; 23623 [Salary];
23621 [Total
Compensation]
Monitor Path:
//Organization
/PrincipalsAndManagem
ent /MostSeniorPrincipal
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 266
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { MostSeniorPrincipal { CurrentCompensation { CompensationDetail { CompensationTypeText @DNBCodeValue
integer, up to 7 digits,Attribute (1x)
Possible values: 23622
[Bonus]; 23623 [Salary];
23621 [Total
Compensation]
OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { MostSeniorPrincipal { CurrentCompensation { CompensationDetail { CompensationAmount
decimal, Optional [M+]
Monitor Path:
//Organization
/PrincipalsAndManagem
ent /MostSeniorPrincipal
OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { MostSeniorPrincipal { CurrentCompensation { CompensationDetail { CompensationAmount @UnitOfSize
string, up to 12 chars,Attribute (1x)
OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { MostSeniorPrincipal { CurrentCompensation { CompensationDetail { CompensationAmount @CurrencyISOAlpha3Code
string, up to 3 chars,Attribute (1x)
OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { MostSeniorPrincipal { CurrentCompensation { CompensationDetail { CompensationAmount @ReliabilityText
string, up to 256 chars,Attribute (1x)
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization }PrincipalsAndManagement } MostSeniorPrincipal } CurrentCompensation }CompensationDetail
/Aggregate
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization }PrincipalsAndManagement } MostSeniorPrincipal } CurrentCompensation
/Aggregate
OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { MostSeniorPrincipal { PrincipalName
Aggregate, Optional
Records the different
names for the Principal.
OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { MostSeniorPrincipal { PrincipalName @type
OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { MostSeniorPrincipal { PrincipalName { FirstName
string, up to 64 chars,Optional [M+]
Monitor Path:
//Organization
/PrincipalsAndManagem
ent /MostSeniorPrincipal
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 267
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { MostSeniorPrincipal { PrincipalName { MiddleName
string, up to 64 chars,Optional [M+]
Monitor Path:
//Organization
/PrincipalsAndManagem
ent /MostSeniorPrincipal
OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { MostSeniorPrincipal { PrincipalName { LastName
string, up to 64 chars,Optional [M+]
Monitor Path:
//Organization
/PrincipalsAndManagem
ent /MostSeniorPrincipal
OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { MostSeniorPrincipal { PrincipalName { FullName
string, up to 256 chars,Optional [M+]
Monitor Path:
//Organization
/PrincipalsAndManagem
ent /MostSeniorPrincipal
OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { MostSeniorPrincipal { PrincipalName { NameSuffix
Aggregate, Optional(Infinite) [M+]
Monitor Path:
//Organization
/PrincipalsAndManagem
ent /MostSeniorPrincipal
OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { MostSeniorPrincipal { PrincipalName { NameSuffix { NameSuffixText
string, up to 16 chars,Optional [M+]
Monitor Path:
//Organization
/PrincipalsAndManagem
ent /MostSeniorPrincipal
OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { MostSeniorPrincipal { PrincipalName { NamePrefix
Aggregate, Optional(Infinite) [M+]
Monitor Path:
//Organization
/PrincipalsAndManagem
ent /MostSeniorPrincipal
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 268
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { MostSeniorPrincipal { PrincipalName { NamePrefix { NamePrefixText
string, up to 16 chars,Optional [M+]
Monitor Path:
//Organization
/PrincipalsAndManagem
ent /MostSeniorPrincipal
OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { MostSeniorPrincipal { PrincipalName { OrganizationPrimaryName
Aggregate
OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { MostSeniorPrincipal { PrincipalName { OrganizationPrimaryName { OrganizationName
string, up to 256 chars,Optional [M+]
Monitor Path:
//Organization
/PrincipalsAndManagem
ent /MostSeniorPrincipal
End: OrderProductResponse } OrderProductResponseDetail } Product } Organization }PrincipalsAndManagement } MostSeniorPrincipal } PrincipalName }OrganizationPrimaryName
/Aggregate
End: OrderProductResponse } OrderProductResponseDetail } Product } Organization }PrincipalsAndManagement } MostSeniorPrincipal } PrincipalName
/Aggregate
OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { MostSeniorPrincipal { JobTitle
Aggregate, Optional(Infinite)
An entry loop which can
repeat multiple times to
allow the recording of
the name used by the
organization to describe
this person's job, e.g.,
Leader Global
Communication,
Manager National
Technical Support
Center.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 269
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { MostSeniorPrincipal { JobTitle { JobTitleText
string, up to 3000 chars,Optional [M+]
Text that denotes a
position held by the
principal or manager.
Monitor Path:
//Organization
/PrincipalsAndManagem
ent /MostSeniorPrincipal
OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { MostSeniorPrincipal { JobTitle { JobTitleText@WritingScriptISOAlpha4Code
OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { MostSeniorPrincipal { JobTitle { JobTitleText @LanguageCode
End: OrderProductResponse } OrderProductResponseDetail } Product } Organization }PrincipalsAndManagement } MostSeniorPrincipal } JobTitle
/Aggregate
OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { MostSeniorPrincipal { GenderText
string, up to 256 chars,Optional
Text identifying the
gender of the principal.
The possible values are
Male, Female, Unknown.
Possible values: Male;
Female
OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { MostSeniorPrincipal { GenderText @DNBCodeValue
End: OrderProductResponse } OrderProductResponseDetail } Product } Organization }PrincipalsAndManagement } MostSeniorPrincipal
/Aggregate
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 270
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { CurrentPrincipal
Aggregate, Optional(Infinite)
An entry loop which can
repeat multiple times to
allow recording of the
information of each
principal that are actively
associated with the
subject organization.
OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { CurrentPrincipal { PrincipalAge
string, up to 3 chars,Optional [M+]
Records the age of the
principal in years.
Monitor Path:
//Organization
/PrincipalsAndManagem
ent /CurrentPrincipal
OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { CurrentPrincipal { CurrentManagementResponsibility
Aggregate, Optional(Infinite)
An entry loop which can
repeat multiple times to
allow the recording of
the code values
identifying the current
business function of the
principal represented as
a standard Management
Responsibility Code
(MRC).
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 271
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { CurrentPrincipal { CurrentManagementResponsibility { ManagementResponsibilityText
string, up to 256 chars,Required [M+]
Text identifying the
business function of the
principal derived from a
standard Management
Responsibility Code
(MRC).
Monitor Path:
//Organization
/PrincipalsAndManagem
ent /CurrentPrincipal
OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { CurrentPrincipal { CurrentManagementResponsibility { ManagementResponsibilityText @ManagementResponsibilityCode
[M+]
Monitor Path:
//Organization
/PrincipalsAndManagem
ent /CurrentPrincipal
OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { CurrentPrincipal { CurrentManagementResponsibility { StartDate
date, Optional [M+]
The date when the
principal or manager
was appointed to this
position. This is not
necessarily the date
when the principal or
manager was first
employed by the subject;
this is simply the date
when they moved to this
position, e.g., due to a
promotion.
Monitor Path:
//Organization
/PrincipalsAndManagem
ent /CurrentPrincipal
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 272
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { CurrentPrincipal { CurrentManagementResponsibility { DisplaySequence
integer, Optional
A number which may be
used to define the order
in which the Position
should be presented
relative to any other
occurrences of Position
where lower the
number the earlier the
data is presented.
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization }PrincipalsAndManagement } CurrentPrincipal } CurrentManagementResponsibility
/Aggregate
OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { CurrentPrincipal { PrincipalIdentificationNumberDetail
Aggregate, Optional(Infinite)
An entry loop which can
repeat multiple times to
allow the recording of
several different
identification/registratio
n numbers for the
Principal.
OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { CurrentPrincipal { PrincipalIdentificationNumberDetail @DNBCodeValue
OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { CurrentPrincipal { PrincipalIdentificationNumberDetail @TypeText
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 273
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { CurrentPrincipal { PrincipalIdentificationNumberDetail { PrincipalIdentificationNumber
string, Optional [M+]
A number assigned by
an external body or by
D&B which either
uniquely identifies or
helps to identify an
individual.
Monitor Path:
//Organization
/PrincipalsAndManagem
ent /CurrentPrincipal
End: OrderProductResponse } OrderProductResponseDetail } Product } Organization }PrincipalsAndManagement } CurrentPrincipal } PrincipalIdentificationNumberDetail
/Aggregate
OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { CurrentPrincipal { PrincipalName
Aggregate, Optional
Records the different
names for the Principal.
OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { CurrentPrincipal { PrincipalName { NamePrefix
Aggregate, Optional(Infinite) [M+]
Monitor Path:
//Organization
/PrincipalsAndManagem
ent /CurrentPrincipal
OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { CurrentPrincipal { PrincipalName { NamePrefix { NamePrefixText
string, up to 16 chars,Optional [M+]
Monitor Path:
//Organization
/PrincipalsAndManagem
ent /CurrentPrincipal
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization }PrincipalsAndManagement } CurrentPrincipal } PrincipalName } NamePrefix
/Aggregate
OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { CurrentPrincipal { PrincipalName { FirstName
string, up to 64 chars,Optional [M+]
Monitor Path:
//Organization
/PrincipalsAndManagem
ent /CurrentPrincipal
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 274
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { CurrentPrincipal { PrincipalName { MiddleName
string, up to 64 chars,Optional [M+]
Monitor Path:
//Organization
/PrincipalsAndManagem
ent /CurrentPrincipal
OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { CurrentPrincipal { PrincipalName { LastName
string, up to 64 chars,Optional [M+]
Monitor Path:
//Organization
/PrincipalsAndManagem
ent /CurrentPrincipal
OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { CurrentPrincipal { PrincipalName { FullName
string, up to 256 chars,Optional [M+]
Monitor Path:
//Organization
/PrincipalsAndManagem
ent /CurrentPrincipal
OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { CurrentPrincipal { PrincipalName { NameSuffix
Aggregate, Optional(Infinite) [M+]
Monitor Path:
//Organization
/PrincipalsAndManagem
ent /CurrentPrincipal
OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { CurrentPrincipal { PrincipalName { NameSuffix { NameSuffixText
string, up to 16 chars,Optional [M+]
Monitor Path:
//Organization
/PrincipalsAndManagem
ent /CurrentPrincipal
End: OrderProductResponse } OrderProductResponseDetail } Product } Organization }PrincipalsAndManagement } CurrentPrincipal } PrincipalName
/Aggregate
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 275
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { CurrentPrincipal { JobTitle
Aggregate, Optional(Infinite)
An entry loop which can
repeat multiple times to
allow the recording of
the name used by the
organization to describe
this person's job, e.g.,
Leader Global
Communication,
Manager National
Technical Support
Center.
OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { CurrentPrincipal { JobTitle { JobTitleText
string, up to 3000 chars,Optional [M+]
Text that denotes a
position held by the
principal or manager.
Monitor Path:
//Organization
/PrincipalsAndManagem
ent /CurrentPrincipal
OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { CurrentPrincipal { JobTitle { JobTitleText@WritingScriptISOAlpha4Code
OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { CurrentPrincipal { JobTitle { JobTitleText @LanguageCode
End: OrderProductResponse } OrderProductResponseDetail } Product } Organization }PrincipalsAndManagement } CurrentPrincipal } JobTitle
/Aggregate
OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { CurrentPrincipal { EmploymentBiography
Aggregate, Optional(Infinite)
An entry loop which can
repeat multiple times to
allow the recording of a
concise description
about the principal.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 276
Name Characteristics
End: OrderProductResponse } OrderProductResponseDetail } Product } Organization }PrincipalsAndManagement } CurrentPrincipal } EmploymentBiography
/Aggregate
OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { CurrentPrincipal { CurrentCompensation
Aggregate, Optional
OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { CurrentPrincipal { CurrentCompensation { CompensationDate
date, Optional [M+]
Monitor Path:
//Organization
/PrincipalsAndManagem
ent /CurrentPrincipal
OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { CurrentPrincipal { CurrentCompensation { CompensationDetail
Aggregate, Optional(Infinite)
OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { CurrentPrincipal { CurrentCompensation { CompensationDetail{ CompensationTypeText
string, up to 256 chars,Optional [M+]
Possible values: 23622
[Bonus]; 23623 [Salary];
23621 [Total
Compensation]
Monitor Path:
//Organization
/PrincipalsAndManagem
ent /CurrentPrincipal
OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { CurrentPrincipal { CurrentCompensation { CompensationDetail{ CompensationTypeText @DNBCodeValue
integer, up to 7 digits,Attribute (1x)
Possible values: 23622
[Bonus]; 23623 [Salary];
23621 [Total
Compensation]
OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { CurrentPrincipal { CurrentCompensation { CompensationDetail{ CompensationAmount
decimal, Optional [M+]
Monitor Path:
//Organization
/PrincipalsAndManagem
ent /CurrentPrincipal
OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { CurrentPrincipal { CurrentCompensation { CompensationDetail{ CompensationAmount @UnitOfSize
string, up to 12 chars,Attribute (1x)
OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { CurrentPrincipal { CurrentCompensation { CompensationDetail{ CompensationAmount @CurrencyISOAlpha3Code
string, up to 3 chars,Attribute (1x)
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 277
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { CurrentPrincipal { CurrentCompensation { CompensationDetail{ CompensationAmount @ReliabilityText
string, up to 256 chars,Attribute (1x)
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization }PrincipalsAndManagement } CurrentPrincipal } CurrentCompensation } CompensationDetail
/Aggregate
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization }PrincipalsAndManagement } CurrentPrincipal } CurrentCompensation
/Aggregate
End: OrderProductResponse } OrderProductResponseDetail } Product } Organization }PrincipalsAndManagement } CurrentPrincipal
/Aggregate
End: OrderProductResponse } OrderProductResponseDetail } Product } Organization }PrincipalsAndManagement
/Aggregate
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification
Aggregate, Optional
Records information
about subjects'
categorization into Socio
Economic or Statistical
groups.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 278
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { MinorityOwnedIndicator
boolean, Optional [M]
When 'true' indicates
that this organization is
certified as a business
that is greater than 50%
owned by, and whose
management and daily
business operations are
controlled by, one or
more minority group
members. When 'false'
indicates that this
organization is not
certified as a business
that is greater than 50%
owned by, and whose
management and daily
business operations are
controlled by, one or
more minority group
members; however as
this is the assumed
condition there is no
requirement to create
this tag to represent this
fact. Note: The
percentage of
ownership requirement
may differ by country.
For example, in the US,
for a business to be
considered minority
owned, the percentage
of ownership must be at
least 51%.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 279
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { FemaleOwnedIndicator
boolean, Optional [M]
When 'true' indicates
that this organization is
certified as a business
that is greater than 50%
owned by, and whose
management and daily
business operations are
controlled by, one or
more female persons.
When 'false' indicates
that this organization is
not certified as a
business that is greater
than 50% owned by, and
whose management
and daily business
operations are not
controlled by, one or
more female persons;
however as this is the
assumed condition there
is no requirement to
create this tag to
represent this fact.
Note: The percentage of
ownership requirement
may differ by country.
For example, in the US,
for a business to be
considered female
owned, the percentage
of ownership must be at
least 51%.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 280
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { SmallDisadvantagedBusinessIndicator
boolean, Optional [M]
When 'true' indicates
that this organization is
certified as a business
that is greater than 50%
owned by, and whose
management and daily
business operations are
controlled by, socially
and economically
disadvantaged persons.
When 'false' indicates
that this organization is
not certified as a
business that is greater
than 50% owned by, and
whose management
and daily business
operations are controlled
by, socially and
economically
disadvantaged persons;
however as this is the
assumed condition there
is no requirement to
create this tag to
represent this fact.
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { AlaskanNativeCorporationIndicator
boolean, Optional [M]
When 'true' indicates
that the tribe is an
Alaskan Native
Corporation.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 281
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { CertifiedSmallBusinessIndicator
boolean, Optional [M]
When 'true' indicates
that the business is
small, certified by a
federal, state or local
government agency or
organization as having
met all of the
government standards
that award eligibility.
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { MinorityCollegeIndicator
boolean, Optional [M]
When 'true' indicates
that this organization is
a college or university
where the profile of the
majority of students is
of minority ethnicity. For
example, if maximum
percentage of students
in a college or university
are from black ethnicity,
this would be a 'Minority
College' with black
ethnicity type. An
example of Minority
College is 'Delaware
State University'. When
'false' indicates that this
organization is not a
college or university
where the profile of the
majority of students is
of minority ethnicity;
however as this is the
assumed condition there
is no requirement to
create this tag to
represent this fact.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 282
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { DisabledOwnedIndicator
boolean, Optional [M]
When 'true' indicates
that this organization is
certified as a business
that is greater than 50%
owned by, and whose
management and daily
business operations are
controlled by, one or
more persons who have
a condition which
prevents the person
from performing all
usual physical or mental
functions When 'false'
indicates that this
organization is not
certified as a business
that is greater than 50%
owned by, and whose
management and daily
business operations are
not controlled by, one or
more disabled persons;
however as this is the
assumed condition there
is no requirement to
create this tag to
represent this fact.
Note: The percentage of
ownership requirement
may differ by country.
For example, in the US,
for a business to be
considered disabled
owned, the percentage
of ownership must be at
least 51%.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 283
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { ServiceDisabledVeteranOwnedIndicator
boolean, Optional [M]
When 'true' indicates
that the business is at
least 51% owned by one
or more veterans with a
disability that is service
connected. The term
“service connected”
means, with respect to
disability or death, that
such disability was
incurred or aggravated,
in the line of duty in the
active military, naval or
air service.
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { VietnamVeteranOwnedIndicator
boolean, Optional [M]
When 'true' indicates
that the business is a
least 51% owned by one
or more Vietnam
Veterans who served
between 1/1/59 and
5/7/75 and have control
and operate the
business. Control in this
context means
exercising the power to
make policy decisions
and operate means to be
actively involved in the
day-to-day management
of the business.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 284
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { AirportConcessionDisadvantagedBusinessEnterpriseIndicator
boolean, Optional [M]
When 'true' indicates
that the business
operates as a
concessionaire at one of
the nation's airports and
meets the ownership
eligibility requirements
as set forth by the
regulations outlined in
49 CFR Part 23.
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { DisabledVeteranBusinessEnterpriseIndicator
boolean, Optional [M]
When 'true' indicates
that the business is
recognized by the state
of California, meaning a
veteran of the U.S.
military, naval, or air
service, with a service-
connected disability of at
least 10% or more and
who is a California
resident; where at least
51% is owned by disabled
veteran/s and conducts
daily business
management and
control. The home office
can not be a branch or
subsidiary of a foreign
corporation, foreign firm
or other foreign-based
business.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 285
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { DisadvantagedBusinessEnterpriseIndicator
boolean, Optional [M]
When 'true' indicates
that the business is
certified by a federal,
state or local
government agency as
having met all of the
government standards
that award eligibility, but
may include women,
minority, disabled and
other disadvantaged
businesses as a result of
economic disadvantages
with respect to
education, employment,
residence or business
location or social
disadvantage and lack of
business training.
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { DisadvantagedVeteranEnterpriseIndicator
boolean, Optional [M]
When 'true' indicates
that the business is a
small business concern
owned and controlled by
veterans, where not less
than 51% is owned
controlled and managed
by veterans.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 286
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { MinorityBusinessEnterpriseIndicator
boolean, Optional [M]
When 'true' indicates
that the business is
certified by a federal,
state or local
government agency
through an application
and/or premise visit
process as having met all
of the government
standards and
requirements. When
'false' indicates that the
business is not certified
by a federal, state or
local government agency
through an application
and/or premise visit
process as having met all
of the government
standards and
requirements.
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { FemaleOwnedBusinessEnterpriseIndicator
boolean, Optional [M]
When 'true' indicates
the business is certified
by a federal, state or
local government agency
as having met all of the
government standards
and requirements.
When 'false' indicates
the business is not
certified by a federal,
state or local
government agency as
having met all of the
government standards
and requirements.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 287
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { MinorityOwnedDetails
Aggregate, Optional(Infinite)
An entry loop which can
repeat multiple times to
allow the recording of
information about the
characterization of the
organization as minority
owned. A minority
owned organization is a
business that is greater
than 50% owned by, and
whose management
and daily business
operations are controlled
by, one or more minority
group members. Note:
The percentage of
ownership requirement
may differ by country.
For example, in the US,
for a business to be
considered minority
owned, the percentage
of ownership must be at
least 51%.
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { MinorityOwnedDetails { CertificationStartDate
date, Optional [M+]
The date when
certification period for
this organization begins.
Monitor Path:
//Organization
/SocioEconomicIdentific
ation
/MinorityOwnedDetails
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 288
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { MinorityOwnedDetails { CertificationExpirationDate
date, Optional [M+]
The date when the
certificate expires.
Monitor Path:
//Organization
/SocioEconomicIdentific
ation
/MinorityOwnedDetails
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { MinorityOwnedDetails { CertificationReferenceIdentifier
string, up to 64 chars,Optional [M+]
An alphanumeric
identifier assigned by
the data provider to
identify the document
attesting that the
organization has
satisfied the standards
or requirements of their
socio-economic program.
Monitor Path:
//Organization
/SocioEconomicIdentific
ation
/MinorityOwnedDetails
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { MinorityOwnedDetails { DataProviderDetail
Aggregate, Optional
Records details of the
source from which this
data was originally
obtained.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 289
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { MinorityOwnedDetails { DataProviderDetail { CertifyingIndicator
boolean, Optional [M+]
When 'true' indicates
that data provider is
certified to endorse the
subject authoritatively.
When 'false' indicates
that this data provider is
not certified to endorse
the subject
authoritatively.
Monitor Path:
//Organization
/SocioEconomicIdentific
ation
/MinorityOwnedDetails
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { MinorityOwnedDetails { DataProviderDetail { VerifyingIndicator
boolean, Optional [M+]
When 'true' indicates
that certification has
been verified to endorse
the subject
authoritatively. When
'false' indicates that the
certification has not
verified to endorse the
subject authoritatively.
Monitor Path:
//Organization
/SocioEconomicIdentific
ation
/MinorityOwnedDetails
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 290
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { MinorityOwnedDetails { DataProviderDetail { DiversityDNBDataProviderName
string, up to 256 chars,Optional [M+]
Name identifying the
source from which this
socio economic data was
originally obtained by
D&B
Monitor Path:
//Organization
/SocioEconomicIdentific
ation
/MinorityOwnedDetails
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { MinorityOwnedDetails { DataProviderDetail { DataProviderTypeText
string, up to 256 chars,Optional [M+]
Text that describes in
general terms the type
of data provider this is,
e.g., National
Government, National
Coverage Organization,
Local Non-Profit
Organization.This is used
in statistical reporting
regarding D&B's socio
economic data coverage.
Monitor Path:
//Organization
/SocioEconomicIdentific
ation
/MinorityOwnedDetails
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization }SocioEconomicIdentification } MinorityOwnedDetails } DataProviderDetail
/Aggregate
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 291
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { MinorityOwnedDetails { DNBReceivedDate
date, Optional [M+]
The date when D&B
obtained this data from
the source.
Monitor Path:
//Organization
/SocioEconomicIdentific
ation
/MinorityOwnedDetails
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { MinorityOwnedDetails { OwnershipEthnicity
Aggregate, Optional(Infinite)
Records the racial,
national, tribal, or
cultural classifications
that are applied to an
organization based on
the ethnicity of a
majority of its
ownership.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 292
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { MinorityOwnedDetails { OwnershipEthnicity { EthnicityTypeText
string, up to 256 chars,Optional [M+]
Text that uniquely
identifies the ethnic
classification that's
applied to this
organization based on
the racial, national,
tribal, or cultural group
that describes a majority
of its ownership, e.g.,
Asian, Hispanic, African
American (Black).
Monitor Path:
//Organization
/SocioEconomicIdentific
ation
/MinorityOwnedDetails
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization }SocioEconomicIdentification } MinorityOwnedDetails } OwnershipEthnicity
/Aggregate
End: OrderProductResponse } OrderProductResponseDetail } Product } Organization }SocioEconomicIdentification } MinorityOwnedDetails
/Aggregate
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 293
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { FemaleOwnedDetail
Aggregate, Optional(Infinite)
An entry loop that can
repeat multiple times to
record the information
about the
characterization of the
organization as female
owned. A female owned
organization is a
business that is greater
than 50% owned by, and
whose management
and daily business
operations are controlled
by, one or more female
persons. Note: The
percentage of
ownership requirement
may differ by country.
For example, in the US,
for a business to be
considered female
owned, the percentage
of ownership must be at
least 51%.
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { FemaleOwnedDetail { CertificationStartDate
date, Optional [M+]
The date when
certification period for
this organization begins.
Monitor Path:
//Organization
/SocioEconomicIdentific
ation
/FemaleOwnedDetail
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 294
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { FemaleOwnedDetail { CertificationExpirationDate
date, Optional [M+]
The date when the
certificate expires.
Monitor Path:
//Organization
/SocioEconomicIdentific
ation
/FemaleOwnedDetail
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { FemaleOwnedDetail { CertificationReferenceIdentifier
string, up to 64 chars,Optional [M+]
An alphanumeric
identifier assigned by
the data provider to
identify the document
attesting that the
organization has
satisfied the standards
or requirements of their
socio-economic program.
Monitor Path:
//Organization
/SocioEconomicIdentific
ation
/FemaleOwnedDetail
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { FemaleOwnedDetail { DataProviderDetail
Aggregate, Optional
Records details of the
source from which this
data was originally
obtained.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 295
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { FemaleOwnedDetail { DataProviderDetail { CertifyingIndicator
boolean, Optional [M+]
When 'true' indicates
that data provider is
certified to endorse the
subject authoritatively.
When 'false' indicates
that this data provider is
not certified to endorse
the subject
authoritatively.
Monitor Path:
//Organization
/SocioEconomicIdentific
ation
/FemaleOwnedDetail
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { FemaleOwnedDetail { DataProviderDetail { VerifyingIndicator
boolean, Optional [M+]
When 'true' indicates
that certification has
been verified to endorse
the subject
authoritatively. When
'false' indicates that the
certification has not
verified to endorse the
subject authoritatively.
Monitor Path:
//Organization
/SocioEconomicIdentific
ation
/FemaleOwnedDetail
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 296
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { FemaleOwnedDetail { DataProviderDetail { DiversityDNBDataProviderName
string, up to 256 chars,Optional [M+]
Name identifying the
source from which this
socio economic data was
originally obtained by
D&B
Monitor Path:
//Organization
/SocioEconomicIdentific
ation
/FemaleOwnedDetail
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { FemaleOwnedDetail { DataProviderDetail { DataProviderTypeText
string, up to 256 chars,Optional [M+]
Text that describes in
general terms the type
of data provider this is,
e.g., National
Government, National
Coverage Organization,
Local Non-Profit
Organization.This is used
in statistical reporting
regarding D&B's socio
economic data coverage.
Monitor Path:
//Organization
/SocioEconomicIdentific
ation
/FemaleOwnedDetail
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization }SocioEconomicIdentification } FemaleOwnedDetail } DataProviderDetail
/Aggregate
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 297
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { FemaleOwnedDetail { DNBReceivedDate
date, Optional [M+]
The date when D&B
obtained this data from
the source.
Monitor Path:
//Organization
/SocioEconomicIdentific
ation
/FemaleOwnedDetail
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization }SocioEconomicIdentification } FemaleOwnedDetail
/Aggregate
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { VeteranOwnedDetail
Aggregate, Optional(Infinite)
An entry loop that can
repeat multiple times to
record information
about the
characterization of the
organization as veteran
owned. A veteran owned
organization is a
business that is greater
than 50% owned by, and
whose management
and daily business
operations are controlled
by, one or more
veterans. Note: The
percentage of
ownership requirement
may differ by country.
For example, in the US,
for a business to be
considered veteran
owned, the percentage
of ownership must be at
least 51%.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 298
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { VeteranOwnedDetail { CertificationStartDate
date, Optional [M+]
The date when
certification period for
this organization begins.
Monitor Path:
//Organization
/SocioEconomicIdentific
ation
/VeteranOwnedDetail
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { VeteranOwnedDetail { CertificationExpirationDate
date, Optional [M+]
The date when the
certificate expires.
Monitor Path:
//Organization
/SocioEconomicIdentific
ation
/VeteranOwnedDetail
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { VeteranOwnedDetail { CertificationReferenceIdentifier
string, up to 64 chars,Optional [M+]
An alphanumeric
identifier assigned by
the data provider to
identify the document
attesting that the
organization has
satisfied the standards
or requirements of their
socio-economic program.
Monitor Path:
//Organization
/SocioEconomicIdentific
ation
/VeteranOwnedDetail
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 299
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { VeteranOwnedDetail { DataProviderDetail
Aggregate, Optional
Records details of the
source from which this
data was originally
obtained.
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { VeteranOwnedDetail { DataProviderDetail { CertifyingIndicator
boolean, Optional [M+]
When 'true' indicates
that data provider is
certified to endorse the
subject authoritatively.
When 'false' indicates
that this data provider is
not certified to endorse
the subject
authoritatively.
Monitor Path:
//Organization
/SocioEconomicIdentific
ation
/VeteranOwnedDetail
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { VeteranOwnedDetail { DataProviderDetail { VerifyingIndicator
boolean, Optional [M+]
When 'true' indicates
that certification has
been verified to endorse
the subject
authoritatively. When
'false' indicates that the
certification has not
verified to endorse the
subject authoritatively.
Monitor Path:
//Organization
/SocioEconomicIdentific
ation
/VeteranOwnedDetail
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 300
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { VeteranOwnedDetail { DataProviderDetail { DiversityDNBDataProviderName
string, up to 256 chars,Optional [M+]
Name identifying the
source from which this
socio economic data was
originally obtained by
D&B
Monitor Path:
//Organization
/SocioEconomicIdentific
ation
/VeteranOwnedDetail
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { VeteranOwnedDetail { DataProviderDetail { DataProviderTypeText
string, up to 256 chars,Optional [M+]
Text that describes in
general terms the type
of data provider this is,
e.g., National
Government, National
Coverage Organization,
Local Non-Profit
Organization.This is used
in statistical reporting
regarding D&B's socio
economic data coverage.
Monitor Path:
//Organization
/SocioEconomicIdentific
ation
/VeteranOwnedDetail
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization }SocioEconomicIdentification } VeteranOwnedDetail } DataProviderDetail
/Aggregate
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 301
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { VeteranOwnedDetail { DNBReceivedDate
date, Optional [M+]
The date when D&B
obtained this data from
the source.
Monitor Path:
//Organization
/SocioEconomicIdentific
ation
/VeteranOwnedDetail
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization }SocioEconomicIdentification } VeteranOwnedDetail
/Aggregate
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { AirportConcessionDisadvantagedBusinessEnterpriseDetail
Aggregate, Optional(Infinite)
An entry loop that can
repeat multiple times to
record the details of the
small business operates
as a concessionaire at
one of the nation's
airports and meets the
ownership eligibility
requirements.
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { AirportConcessionDisadvantagedBusinessEnterpriseDetail { DataProviderDetail
Aggregate, Optional
Records the details of
the source from which
this data was originally
obtained.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 302
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { AirportConcessionDisadvantagedBusinessEnterpriseDetail { DataProviderDetail { DiversityDNBDataProviderName
string, up to 256 chars,Optional [M+]
Name identifying the
source from which this
socio economic data was
originally obtained by
D&B
Monitor Path:
//Organization
/SocioEconomicIdentific
ation
/AirportConcessionDisad
vantagedBusinessEnter
priseDetail
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { AirportConcessionDisadvantagedBusinessEnterpriseDetail { DataProviderDetail { DataProviderTypeText
string, up to 256 chars,Optional [M+]
Text that describes in
general terms the type
of data provider this is,
e.g., National
Government, National
Coverage Organization,
Local Non-Profit
Organization.This is used
in statistical reporting
regarding D&B's socio
economic data coverage.
Monitor Path:
//Organization
/SocioEconomicIdentific
ation
/AirportConcessionDisad
vantagedBusinessEnter
priseDetail
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 303
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { AirportConcessionDisadvantagedBusinessEnterpriseDetail { DataProviderDetail { Location
Aggregate, Optional
Records the address
details for a subject. An
address is the
designation of a place
where a subject can be
located or may be
communicated with.
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { AirportConcessionDisadvantagedBusinessEnterpriseDetail { DataProviderDetail { Location { TerritoryAbbreviatedName
string, up to 64 chars,Optional [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
/SocioEconomicIdentific
ation
/AirportConcessionDisad
vantagedBusinessEnter
priseDetail
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 304
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { AirportConcessionDisadvantagedBusinessEnterpriseDetail { DataProviderDetail { Location { CountryISOAlpha2Code
string, at least 2 chars,up to 2 chars, Optional[M+]
The two-letter country
code, defined in the ISO
3166-1 scheme
published by
International
Organization for
Standardization (ISO),
identifying the country
for this address.
Monitor Path:
//Organization
/SocioEconomicIdentific
ation
/AirportConcessionDisad
vantagedBusinessEnter
priseDetail
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization }SocioEconomicIdentification } AirportConcessionDisadvantagedBusinessEnterpriseDetail }DataProviderDetail } Location
/Aggregate
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization }SocioEconomicIdentification } AirportConcessionDisadvantagedBusinessEnterpriseDetail }DataProviderDetail
/Aggregate
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization }SocioEconomicIdentification } AirportConcessionDisadvantagedBusinessEnterpriseDetail
/Aggregate
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 305
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { DisadvantagedBusinessEnterpriseDetail
Aggregate, Optional(Infinite)
An entry loop that can
repeat multiple times to
record the information
about the
businesswhich is
certified by a federal,
state or local
government agency as
having met all of the
government standards
that award eligibility, but
may include women,
minority, disabled and
other disadvantaged
businesses as a result of
economic disadvantages
with respect to
education, employment,
residence or business
location or social
disadvantage and lack of
business training.
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { DisadvantagedBusinessEnterpriseDetail { CertificationStartDate
date, Optional [M+]
The date when
certification period for
this organization begins.
Monitor Path:
//Organization
/SocioEconomicIdentific
ation
/DisadvantagedBusiness
EnterpriseDetail
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 306
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { DisadvantagedBusinessEnterpriseDetail { CertificationExpirationDate
date, Optional [M+]
The date when the
certificate expires.
Monitor Path:
//Organization
/SocioEconomicIdentific
ation
/DisadvantagedBusiness
EnterpriseDetail
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { DisadvantagedBusinessEnterpriseDetail { CertificationReferenceIdentifier
string, up to 64 chars,Optional [M+]
An alphanumeric
identifier assigned by
the data provider to
identify the document
attesting that the
organization has
satisfied the standards
or requirements of their
socio-economic program.
Monitor Path:
//Organization
/SocioEconomicIdentific
ation
/DisadvantagedBusiness
EnterpriseDetail
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { DisadvantagedBusinessEnterpriseDetail { DataProviderDetail
Aggregate, Optional
Records details of the
source from which this
data was originally
obtained.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 307
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { DisadvantagedBusinessEnterpriseDetail { DataProviderDetail { CertifyingIndicator
boolean, Optional [M+]
When 'true' indicates
that data provider is
certified to endorse the
subject authoritatively.
When 'false' indicates
that this data provider is
not certified to endorse
the subject
authoritatively.
Monitor Path:
//Organization
/SocioEconomicIdentific
ation
/DisadvantagedBusiness
EnterpriseDetail
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { DisadvantagedBusinessEnterpriseDetail { DataProviderDetail { VerifyingIndicator
boolean, Optional [M+]
When 'true' indicates
that certification has
been verified to endorse
the subject
authoritatively. When
'false' indicates that the
certification has not
verified to endorse the
subject authoritatively.
Monitor Path:
//Organization
/SocioEconomicIdentific
ation
/DisadvantagedBusiness
EnterpriseDetail
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 308
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { DisadvantagedBusinessEnterpriseDetail { DataProviderDetail { DiversityDNBDataProviderName
string, up to 256 chars,Optional [M+]
Name identifying the
source from which this
socio economic data was
originally obtained by
D&B
Monitor Path:
//Organization
/SocioEconomicIdentific
ation
/DisadvantagedBusiness
EnterpriseDetail
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { DisadvantagedBusinessEnterpriseDetail { DataProviderDetail { DataProviderTypeText
string, up to 256 chars,Optional [M+]
Text that describes in
general terms the type
of data provider this is,
e.g., National
Government, National
Coverage Organization,
Local Non-Profit
Organization.This is used
in statistical reporting
regarding D&B's socio
economic data coverage.
Monitor Path:
//Organization
/SocioEconomicIdentific
ation
/DisadvantagedBusiness
EnterpriseDetail
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization }SocioEconomicIdentification } DisadvantagedBusinessEnterpriseDetail } DataProviderDetail
/Aggregate
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 309
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { DisadvantagedBusinessEnterpriseDetail { DNBReceivedDate
date, Optional [M+]
The date when D&B
obtained this data from
the source.
Monitor Path:
//Organization
/SocioEconomicIdentific
ation
/DisadvantagedBusiness
EnterpriseDetail
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization }SocioEconomicIdentification } DisadvantagedBusinessEnterpriseDetail
/Aggregate
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 310
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { HUBZoneCertifiedBusinessIndicator
When 'true' indicates
that this organization is
certified by the US Small
Business Administration
as being a recipient of
the HUB Zone program.
A small business must
meet all of the following
criteria to qualify for the
HUB Zone program: It
must be located in a
'historically underutilized
business zone'. It must
be owned and controlled
by one or more U.S
Citizens. Greater than
35% of its employees
must reside in a
HUBZone. A HUBZone
(Historically
Underutilized Business
Zone) is an area that is
located in one or more of
the following - a) A
qualified census tract (as
defined in section 42(d)
(5)(C)(i)(I) of the Internal
Revenue Code of 1986).
b) A qualified 'non-
metropolitan county' (as
defined in section 143(k)
(2)(B) of the Internal
Revenue Code of 1986)
with a median
household income of
less than 80% of the
State median household
income or with an
unemployment rate of
not less than 140% of
the statewide average,
based on U.S.
Department of Labor
recent data. c) Lands
within the boundaries of
federally recognized
Indian reservations.
When 'false' indicates
that this organization is
not certified by the US
Small Business
Administration as being
a recipient of the HUB
Zone program; however
as this is the assumed
condition there is no
requirement to create
this tag to represent this
fact.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 311
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { EightACertifiedBusinessIndicator
boolean, Optional [M]
When 'true' indicates
that this organization is
certified by the US Small
Business Administration
as being a recipient of
the 8(a) Business
Development Program, a
business development
program created to help
small disadvantaged
businesses compete in
the American economy
and access the federal
procurement market.
When 'false' indicates
that this organization is
not certified by the US
Small Business
Administration as being
a recipient of the 8(a)
Business Development
Program; however as
this is the assumed
condition there is no
requirement to create
this tag to represent this
fact.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 312
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { EightACertifiedBusinessDetails
Aggregate, Optional
Records the details of
one or more certification
information of the
organization as an 8A
certified organization.
The 8(a) program is a
business development
program created to help
small disadvantaged
businesses compete in
the American economy
and access the federal
procurement market.
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { EightACertifiedBusinessDetails { CertificationStartDate
date, Optional [M+]
The date when
certification period for
this organization begins.
Monitor Path:
//Organization
/SocioEconomicIdentific
ation
/EightACertifiedBusines
sDetails
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { EightACertifiedBusinessDetails { CertificationExpirationDate
date, Optional [M+]
The date when the
certificate expires.
Monitor Path:
//Organization
/SocioEconomicIdentific
ation
/EightACertifiedBusines
sDetails
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 313
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { EightACertifiedBusinessDetails { CertificationReferenceIdentifier
string, up to 64 chars,Optional [M+]
An alphanumeric
identifier assigned by
the data provider to
identify the document
attesting that the
organization has
satisfied the standards
or requirements of their
socio-economic program.
Monitor Path:
//Organization
/SocioEconomicIdentific
ation
/EightACertifiedBusines
sDetails
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { EightACertifiedBusinessDetails { DataProviderDetail
Aggregate, Optional
Records details of the
source from which this
data was originally
obtained.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 314
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { EightACertifiedBusinessDetails { DataProviderDetail { CertifyingIndicator
boolean, Optional [M+]
When 'true' indicates
that data provider is
certified to endorse the
subject authoritatively.
When 'false' indicates
that this data provider is
not certified to endorse
the subject
authoritatively.
Monitor Path:
//Organization
/SocioEconomicIdentific
ation
/EightACertifiedBusines
sDetails
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { EightACertifiedBusinessDetails { DataProviderDetail { VerifyingIndicator
boolean, Optional [M+]
When 'true' indicates
that certification has
been verified to endorse
the subject
authoritatively. When
'false' indicates that the
certification has not
verified to endorse the
subject authoritatively.
Monitor Path:
//Organization
/SocioEconomicIdentific
ation
/EightACertifiedBusines
sDetails
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 315
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { EightACertifiedBusinessDetails { DataProviderDetail { DiversityDNBDataProviderName
string, up to 256 chars,Optional [M+]
Name identifying the
source from which this
socio economic data was
originally obtained by
D&B
Monitor Path:
//Organization
/SocioEconomicIdentific
ation
/EightACertifiedBusines
sDetails
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { EightACertifiedBusinessDetails { DataProviderDetail { DataProviderTypeText
string, up to 256 chars,Optional [M+]
Text that describes in
general terms the type
of data provider this is,
e.g., National
Government, National
Coverage Organization,
Local Non-Profit
Organization.This is used
in statistical reporting
regarding D&B's socio
economic data coverage.
Monitor Path:
//Organization
/SocioEconomicIdentific
ation
/EightACertifiedBusines
sDetails
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization }SocioEconomicIdentification } EightACertifiedBusinessDetails } DataProviderDetail
/Aggregate
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 316
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { EightACertifiedBusinessDetails { DNBReceivedDate
date, Optional [M+]
The date when D&B
obtained this data from
the source.
Monitor Path:
//Organization
/SocioEconomicIdentific
ation
/EightACertifiedBusines
sDetails
End: OrderProductResponse } OrderProductResponseDetail } Product } Organization }SocioEconomicIdentification } EightACertifiedBusinessDetails
/Aggregate
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { SmallDisadvantagedBusinessDetail
Aggregate, Optional
Records the information
about the business
meets certification
eligibility criteria
established by the SBA
effective 7/1/99. All
firms must be certified
by one of the Small
Disadvantaged Business
Certification Agencies
designated by the SBA.
To qualify must be a
small business, not
exceed standards for
Primary SIC, meet
Contracting Officers’
assigned SIC code, be a
U.S. Citizen and be 51%
owned and controlled by
one or more Socially and
Economically
Disadvantaged
Individuals.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 317
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { SmallDisadvantagedBusinessDetail { CertificationStartDate
date, Optional [M+]
The date when
certification period for
this organization begins.
Monitor Path:
//Organization
/SocioEconomicIdentific
ation
/SmallDisadvantagedBu
sinessDetail
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { SmallDisadvantagedBusinessDetail { CertificationExpirationDate
date, Optional [M+]
The date when the
certificate expires.
Monitor Path:
//Organization
/SocioEconomicIdentific
ation
/SmallDisadvantagedBu
sinessDetail
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { SmallDisadvantagedBusinessDetail { DataProviderDetail
Aggregate, Optional
Records the details of
the source from which
this data was originally
obtained.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 318
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { SmallDisadvantagedBusinessDetail { DataProviderDetail { CertifyingIndicator
boolean, Optional [M+]
When 'true' indicates
that data provider is
certified to endorse the
subject authoritatively.
When 'false' indicates
that this data provider is
not certified to endorse
the subject
authoritatively.
Monitor Path:
//Organization
/SocioEconomicIdentific
ation
/SmallDisadvantagedBu
sinessDetail
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { SmallDisadvantagedBusinessDetail { DataProviderDetail { VerifyingIndicator
boolean, Optional [M+]
When 'true' indicates
that certification has
been verified to endorse
the subject
authoritatively. When
'false' indicates that the
certification has not
verified to endorse the
subject authoritatively.
Monitor Path:
//Organization
/SocioEconomicIdentific
ation
/SmallDisadvantagedBu
sinessDetail
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 319
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { SmallDisadvantagedBusinessDetail { DataProviderDetail { DiversityDNBDataProviderName
string, up to 256 chars,Optional [M+]
Name identifying the
source from which this
socio economic data was
originally obtained by
D&B
Monitor Path:
//Organization
/SocioEconomicIdentific
ation
/SmallDisadvantagedBu
sinessDetail
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { SmallDisadvantagedBusinessDetail { DataProviderDetail { DataProviderTypeText
string, up to 256 chars,Optional [M+]
Text that describes in
general terms the type
of data provider this is,
e.g., National
Government, National
Coverage Organization,
Local Non-Profit
Organization.This is used
in statistical reporting
regarding D&B's socio
economic data coverage.
Monitor Path:
//Organization
/SocioEconomicIdentific
ation
/SmallDisadvantagedBu
sinessDetail
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization }SocioEconomicIdentification } SmallDisadvantagedBusinessDetail } DataProviderDetail
/Aggregate
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 320
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { SmallDisadvantagedBusinessDetail { DNBReceivedDate
date, Optional [M+]
The date when D&B
obtained this data from
the source.
Monitor Path:
//Organization
/SocioEconomicIdentific
ation
/SmallDisadvantagedBu
sinessDetail
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization }SocioEconomicIdentification } SmallDisadvantagedBusinessDetail
/Aggregate
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { CertifiedSmallBusinessDetail
Aggregate, Optional(Infinite)
An entry loop that can
repeat multiple times to
record the information
about the business
usually certified by a
federal, state or local
government agency or
organization as having
met all of the
government standards
that award eligibility.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 321
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { CertifiedSmallBusinessDetail { CertificationStartDate
date, Optional [M+]
The date on which a
certification period for a
given subject
organization begins.
Monitor Path:
//Organization
/SocioEconomicIdentific
ation
/CertifiedSmallBusiness
Detail
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { CertifiedSmallBusinessDetail { CertificationExpirationDate
date, Optional [M+]
The date on when the
certificate expires.
Monitor Path:
//Organization
/SocioEconomicIdentific
ation
/CertifiedSmallBusiness
Detail
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 322
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { CertifiedSmallBusinessDetail { CertificationReferenceIdentifier
string, up to 32 chars,Optional [M+]
An alphanumeric
identifier assigned by
the data provider to
identify the document
attesting that the
organization has
satisfied the standards
or requirements of their
socio-economic program.
Monitor Path:
//Organization
/SocioEconomicIdentific
ation
/CertifiedSmallBusiness
Detail
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { CertifiedSmallBusinessDetail { DataProviderDetail
Aggregate, Optional
Records the details of
the source from which
this data was originally
obtained.
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { CertifiedSmallBusinessDetail { DataProviderDetail { DiversityDNBDataProviderName
string, up to 256 chars,Optional [M+]
Name identifying the
source from which this
socio economic data was
originally obtained by
D&B
Monitor Path:
//Organization
/SocioEconomicIdentific
ation
/CertifiedSmallBusiness
Detail
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 323
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { CertifiedSmallBusinessDetail { DataProviderDetail { DataProviderTypeText
string, up to 256 chars,Optional [M+]
Text that describes in
general terms the type
of data provider this is,
e.g., National
Government, National
Coverage Organization,
Local Non-Profit
Organization.This is used
in statistical reporting
regarding D&B's socio
economic data coverage.
Monitor Path:
//Organization
/SocioEconomicIdentific
ation
/CertifiedSmallBusiness
Detail
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization }SocioEconomicIdentification } CertifiedSmallBusinessDetail } DataProviderDetail
/Aggregate
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization }SocioEconomicIdentification } CertifiedSmallBusinessDetail
/Aggregate
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 324
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { DisabledOwnedDetail
Aggregate, Optional(Infinite)
An entry loop that can
repeat multiple times to
record the information
about the business
which is a least 51%
owned by one or more
disabled persons who
control and operate the
business. Control in this
context means
exercising the power to
make policy decisions
and operate means to be
actively involved in the
day-to-day management
of the business.
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { DisabledOwnedDetail { CertificationStartDate
date, Optional [M+]
The date when
certification period for
this organization begins.
Monitor Path:
//Organization
/SocioEconomicIdentific
ation
/DisabledOwnedDetail
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { DisabledOwnedDetail { CertificationExpirationDate
date, Optional [M+]
The date when the
certificate expires.
Monitor Path:
//Organization
/SocioEconomicIdentific
ation
/DisabledOwnedDetail
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 325
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { DisabledOwnedDetail { CertificationReferenceIdentifier
string, up to 64 chars,Optional [M+]
An alphanumeric
identifier assigned by
the data provider to
identify the document
attesting that the
organization has
satisfied the standards
or requirements of their
socio-economic program.
Monitor Path:
//Organization
/SocioEconomicIdentific
ation
/DisabledOwnedDetail
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { DisabledOwnedDetail { DataProviderDetail
Aggregate, Optional
Records details of the
source from which this
data was originally
obtained.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 326
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { DisabledOwnedDetail { DataProviderDetail { CertifyingIndicator
boolean, Optional [M+]
When 'true' indicates
that data provider is
certified to endorse the
subject authoritatively.
When 'false' indicates
that this data provider is
not certified to endorse
the subject
authoritatively.
Monitor Path:
//Organization
/SocioEconomicIdentific
ation
/DisabledOwnedDetail
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { DisabledOwnedDetail { DataProviderDetail { VerifyingIndicator
boolean, Optional [M+]
When 'true' indicates
that certification has
been verified to endorse
the subject
authoritatively. When
'false' indicates that the
certification has not
verified to endorse the
subject authoritatively.
Monitor Path:
//Organization
/SocioEconomicIdentific
ation
/DisabledOwnedDetail
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 327
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { DisabledOwnedDetail { DataProviderDetail { DiversityDNBDataProviderName
string, up to 256 chars,Optional [M+]
Name identifying the
source from which this
socio economic data was
originally obtained by
D&B
Monitor Path:
//Organization
/SocioEconomicIdentific
ation
/DisabledOwnedDetail
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { DisabledOwnedDetail { DataProviderDetail { DataProviderTypeText
string, up to 256 chars,Optional [M+]
Text that describes in
general terms the type
of data provider this is,
e.g., National
Government, National
Coverage Organization,
Local Non-Profit
Organization.This is used
in statistical reporting
regarding D&B's socio
economic data coverage.
Monitor Path:
//Organization
/SocioEconomicIdentific
ation
/DisabledOwnedDetail
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization }SocioEconomicIdentification } DisabledOwnedDetail } DataProviderDetail
/Aggregate
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 328
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { DisabledOwnedDetail { DNBReceivedDate
date, Optional [M+]
The date when D&B
obtained this data from
the source.
Monitor Path:
//Organization
/SocioEconomicIdentific
ation
/DisabledOwnedDetail
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization }SocioEconomicIdentification } DisabledOwnedDetail
/Aggregate
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 329
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { VeteranOwnedIndicator
When 'true' indicates
that this organization is
certified as a business
that is greater than 50%
owned by, and whose
management and daily
business operations are
controlled by, one or
more veterans. A
veteran refers to a
person who served in
the active military, naval,
or air service, and who
was discharged or
released therefrom
under conditions other
than dishonorable.
When 'false' indicates
that this organization is
not certified as a
business that is greater
than 50% owned by, and
whose management
and daily business
operations are controlled
by, one or more
veterans; however as
this is the assumed
condition there is no
requirement to create
this tag to represent this
fact. Note: The
percentage of
ownership requirement
may differ by country.
For example, in the US,
for a business to be
considered veteran
owned, the percentage
of ownership must be at
least 51%.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 330
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { LaborSurplusAreaIndicator
boolean, Optional [M]
When 'true' indicates
that this organization is
certified as a business
that operates in a labor
surplus area. A labor
surplus area is a
geographical area
identified by the
Department of Labor, as
an area of concentrated
unemployment or
underemployment or an
area of labor surplus.
When 'false' indicates
that this organization is
not certified as a
business that operates
in a labor surplus area;
however as this is the
assumed condition there
is no requirement to
create this tag to
represent this fact.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 331
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { SmallBusinessIndicator
boolean, Optional [M]
When 'true' indicates
that this organization is
certified as a small
business. A small
business is an entity
that is usually privately
owned and operated,
with a small number of
employees and relatively
low volume of sales.
Small businesses are
normally privately
owned corporations,
partnerships, or sole
proprietorships. The
legal definition of small"
varies by country and by
industry
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { VeteranBusinessEnterpriseIndicator
boolean, Optional [M]
When 'true' indicates
that the business falls
under SBA Guidelines
Small Business Act (PL
85-536), which as
amended states: Small
Business Concerns
owned and controlled by
veterans not less than
51% owned by one or
more veterans and in
the case of a publicly
owned business not less
than 51% of the stock is
owned by one or more
veterans.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 332
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { OwnershipEthnicity
Aggregate, Optional(Infinite)
An entry loop that can
repeat multiple times to
record the racial,
national, tribal, or
cultural classifications
that are applied to an
organization based on
the ethnicity of a
majority of its
ownership.
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { OwnershipEthnicity { EthnicityTypeText
string, up to 256 chars,Optional [M+]
Text that uniquely
identifies the ethnic
classification that's
applied to this
organization based on
the racial, national,
tribal, or cultural group
that describes a majority
of its ownership, e.g.,
Asian, Hispanic, African
American (Black).
Monitor Path:
//Organization
/SocioEconomicIdentific
ation
/OwnershipEthnicity
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 333
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { SocioEconomicIdentification { OwnershipEthnicity { EthnicityTypeText @DNBCodeValue
integer, up to 7 digits,Attribute (1x)
Possible values: Code
Table 224:; 10881
[Asian]; 10882 [Black];
10884 [Hispanic]; 18044
[Alaskan Native
American]; 10885 [Indian
Subcontinent]; 0
[Unknown]
End: OrderProductResponse } OrderProductResponseDetail } Product } Organization }SocioEconomicIdentification } OwnershipEthnicity
/Aggregate
End: OrderProductResponse } OrderProductResponseDetail } Product } Organization }SocioEconomicIdentification
/Aggregate
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Competitors Aggregate, Optional
Records information on
a competing
organization.
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Competitors{ Competitor
Aggregate, Required(Infinite)
An entry loop which can
repeat multiple times to
record information on a
competing organization.
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Competitors{ Competitor { OrganizationPrimaryName
Aggregate, Optional(Infinite)
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Competitors{ Competitor { OrganizationPrimaryName @RegisteredNameIndicator
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Competitors{ Competitor { OrganizationPrimaryName { OrganizationName
string, up to 256 chars,Required
Text recording a name
of this organization in
the specified language
and/or writing script.
End:OrderProductResponse } OrderProductResponseDetail } Product } Organization }Competitors } Competitor } OrganizationPrimaryName
/Aggregate
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 334
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Competitors{ Competitor { SalesRevenueAmount
decimal, Optional(Infinite) [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.
Monitor Path:
//Organization
/Competitors
/Competitor
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Competitors{ Competitor { SalesRevenueAmount @UnitOfSize
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Competitors{ Competitor { SalesRevenueAmount @CurrencyISOAlpha3Code
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Competitors{ Competitor { SalesRevenueAmount @ReliabilityText
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 335
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Competitors{ Competitor { IndividualEmployeeQuantity
long, Optional [M+]
A number that defines
how many people are
directly engaged and
paid by the organization
to perform or support its
business operations.
Monitor Path:
//Organization
/Competitors
/Competitor
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Competitors{ Competitor { IssuedShareCapitalAmount
decimal, Optional [M+]
The total dollar amount
of capital authorized for
all classes of issued
stock.
Monitor Path:
//Organization
/Competitors
/Competitor
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Competitors{ Competitor { IssuedShareCapitalAmount @UnitOfSize
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Competitors{ Competitor { IssuedShareCapitalAmount @CurrencyISOAlpha3Code
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Competitors{ Competitor { IssuedShareCapitalAmount @ReliabilityText
End: OrderProductResponse } OrderProductResponseDetail } Product } Organization }Competitors } Competitor
/Aggregate
End: OrderProductResponse } OrderProductResponseDetail } Product } Organization }Competitors
/Aggregate
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 336
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events Aggregate, Optional
Records the information
about events that have
either involved or
affected the subject
(usually an organization,
but sometimes an
individual who is an
owner or principal of an
organization). It covers
legal events, significant
events and financing
events.
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { PublicFilingHeader
Aggregate, Optional
Records the information
about Legal and
Financing Events.
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { PublicFilingHeader { DisclaimerText
string, up to 720 chars,Optional [M]
The text that intended
to specify or delimit the
scope of rights and
obligations that may be
exercised and enforced
by parties in a legally-
recognized relationship.
In contrast to other
terms for legally
operative language, the
term disclaimer usually
implies situations that
involve some level of
uncertainty, waiver, or
risk.
End: OrderProductResponse } OrderProductResponseDetail } Product } Organization } Events }PublicFilingHeader
/Aggregate
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 337
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { LegalEvents
Aggregate, Optional
Records legal actions
targeting the subject,
such as criminal
proceedings, protested
bills, county court
judgments,
receiverships,
bankruptcies.
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { LegalEvents { ClaimsIndicator
boolean, Optional [M]
When TRUE (set to 1),it
indicates that open
claim(s), lien(s),
protested bill(s), warrant
(s), Social Securities
Summon(s) and/or
equivalent exist in the
D&B database for this
subject. When FALSE
(set to 0),it indicates that
no open claim(s), lien(s),
protested bill(s), warrant
(s), Social Securities
Summon(s) and/or
equivalent exist in the
D&B database for this
subject.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 338
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { LegalEvents { SuitsAndOrJudgmentsIndicator
boolean, Optional [M]
When TRUE (set to 1),it
indicates that open
suits, judgments,
petitions or payment
remarks exist in the
D&B database for this
subject. When FALSE
(set to 0),it indicates that
no open suits,
judgments, petitions or
payment remarks exist
in the D&B database for
this subject.
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { LegalEvents { CriminalProceedingsIndicator
boolean, Optional [M]
When TRUE (set to 1),it
indicates that criminal
proceedings against the
subject exists in the
D&B database. When
FALSE (set to 0),it
indicates that no
criminal proceedings
against the subject
exists in the D&B
database.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 339
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { LegalEvents { DebarmentsInformation
Aggregate, Optional
Records the details and
the summarized views
about the exclusion of
the subject from
participating in a
procurement activity for
an extended period of
time as specified by law,
because of previous
illegal or irresponsible
action
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { LegalEvents { DebarmentsInformation { DebarmentsSummary
Aggregate, Required
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { LegalEvents { DebarmentsInformation { DebarmentsSummary { TotalFilingCount
integer, Optional [M]
The total number of all
legal events of the type
covered by this
summary.
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization } Events }LegalEvents } DebarmentsInformation } DebarmentsSummary
/Aggregate
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization } Events }LegalEvents } DebarmentsInformation
/Aggregate
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { LegalEvents { FinancialEmbarrassmentIndicator
boolean, Optional [M]
When TRUE (set to 1),it
indicates that open
bankruptcy, receivership
liquidation or equivalent
exist in the D&B
database for this
subject. When FALSE
(set to 0),it indicates that
no open bankruptcy,
receivership liquidation
or equivalent exist in the
D&B database for this
subject.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 340
Name Characteristics
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization } Events }LegalEvents
/Aggregate
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { FinancingEvents
Aggregate, Optional
Records the information
about the events which
have occurred and
directly affect the
subject's finances. For
example, the means by
which moneys are
obtained by the subject,
financial securities
which have been filed
which affect the
subject.
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { FinancingEvents { SecuredFilingsIndicator
boolean, Optional [M]
When 'true' indicates
that open secured filings
such as secured
charges/mortgages
pledgings or equivalent
exist in the D&B
database.
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization } Events }FinancingEvents
/Aggregate
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 341
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { SignificantEvents
Aggregate, Optional
Records information
about key events which
may affect the subject.
It covers such things as:
natural disasters (e.g.,
floods, hurricane),
accidents (e.g., chemical
spillage), major events at
the business
(e.g.,change of
control,business
interruption, awarded
contract), societal events
(e.g., war, civil
disturbance).
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { SignificantEvents { DisasterSpecialEventsIndicator
boolean, Optional [M]
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization } Events }SignificantEvents
/Aggregate
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { OperationalSpecialEventsIndicator
boolean, Optional [M]
When 'true' indicates
that there are one or
more special events
concerning changes to
operational aspects of
the organization
recorded in D&B's
databases for this
subject. This may
include but is not limited
to name changes,
change in management,
change of control,
address change.
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { FinancialOrLegalOrSpecialEventsIndicator
boolean, Optional [M]
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 342
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { OtherSpecialEventsIndicator
boolean, Optional [M]
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization } Events /Aggregate
OrderProductResponse { OrderProductResponseDetail { Product { Organization { FinancialAssetArticle
Aggregate, Optional
Records information on
tangible items of value
that a subject owns,
holds, or manages. It
may provide additional
information, such the
number of assets of a
particular type, the
details about specific
assets, the asset's
financial value, the
asset's registration
information, and
identification of other
subjects involved in the
asset (e.g., insurer).
OrderProductResponse { OrderProductResponseDetail { Product { Organization { FinancialAssetArticle { AssetArticleSummary
Aggregate, Optional(Infinite)
An entry loop specifies
what kinds of items of
value are held, owned, or
managed by an
organization or
unclassified subject. It
may also specify the
quantity and the general
asset category.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 343
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { FinancialAssetArticle { AssetArticleSummary { AssetTypeText
string, up to 256 chars,Required [M+]
Text identifying the kind
of item of value that is
held, owned, or
managed by the subject,
e.g., truck, office
equipment, freighter,
textile goods, accounts
receivables.
Possible values: SCoTS
Decode of 11340
[Computer Equipment]
Monitor Path:
//Organization
/FinancialAssetArticle
/AssetArticleSummary
/AssetTypeText@DNBC
odeValue
OrderProductResponse { OrderProductResponseDetail { Product { Organization { FinancialAssetArticle { AssetArticleSummary { AssetTypeText @DNBCodeValue
integer, up to 7 digits,Attribute (1x)
Possible values: 11340
OrderProductResponse { OrderProductResponseDetail { Product { Organization { FinancialAssetArticle { AssetArticleSummary { AssetArticleQuantity
integer, up to 6 digits,Optional [M]
A numeric value
specifying how many of
this particular asset type
are held, owned, or
managed by the subject.
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization }FinancialAssetArticle } AssetArticleSummary
/Aggregate
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization }FinancialAssetArticle
/Aggregate
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 344
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Banking Aggregate, Optional
Records details of any
Banks or other financial
institutions at which the
subject has an account.
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Banking { Bank
Aggregate, Optional(Infinite)
An entry loop which can
repeat multiple times to
allow the recording of
name and address of
any Banks or other
financial institutions at
which the subject has
an account. This
includes any
identification numbers
for the particular branch
of the Bank and the
number of the subjects
account.
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Banking { Bank { 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.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 345
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Banking { Bank { 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 { Banking { Bank { OrganizationName { OrganizationPrimaryName { OrganizationName
string, up to 256 chars,Required [M]
Text recording a name
of this organization in
the specified language
and/or writing script.
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization }Banking } Bank } OrganizationName } OrganizationPrimaryName
/Aggregate
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization }Banking } Bank } OrganizationName
/Aggregate
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization }Banking } Bank
/Aggregate
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization }Banking
/Aggregate
OrderProductResponse { OrderProductResponseDetail { Product { Organization { ThirdPartyAssessment
Aggregate, Optional
Records the
appraisal/opinion
assigned to this Subject
by an entity other than
the D&B Worldwide
Network (WWN).
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 346
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { ThirdPartyAssessment { ThirdPartyAssessment
Aggregate, Optional(Infinite)
An entry loop which can
repeat multiple times to
allow the recording of
the appraisals/opinions
assigned to this Subject
by an entity other than
the D&B Worldwide
Network (WWN).
OrderProductResponse { OrderProductResponseDetail { Product { Organization { ThirdPartyAssessment { ThirdPartyAssessment { AssessmentValue
string, Optional [M+]
Text that records
appraisal/opinion that
was assigned to this
Subject by a third party.
Monitor Path:
//Organization
/ThirdPartyAssessment
/ThirdPartyAssessment
OrderProductResponse { OrderProductResponseDetail { Product { Organization { ThirdPartyAssessment { ThirdPartyAssessment { AssessmentTypeValue
string, Optional [M+]
An alphanumeric value
as assigned by the third
party to define the kind
of appraisal/opinion that
was assigned to this
subject by the third
party, e.g., Moody's Long
Term Obligation Rating,
FICO score, Vantage
Score.
Monitor Path:
//Organization
/ThirdPartyAssessment
/ThirdPartyAssessment
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 347
Name Characteristics
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization }ThirdPartyAssessment } ThirdPartyAssessment
/Aggregate
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization }ThirdPartyAssessment
/Aggregate
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization /Aggregate
OrderProductResponse { OrderProductResponseDetail { Product { InDateStatusText string, up to 256 chars,Optional
End: OrderProductResponse } OrderProductResponseDetail } Product /Aggregate
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.
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 givenelement does not include these attributes, the values provided in the statement header should be utilized.
Abbreviated Territory Names
When present, the Territory Abbreviated Name field will contain local abbreviations, which may be based onstandard designations. For companies domiciled in the United States or Canada, this field will contain thesecond component of ISO 3166-2 codes. For example, the ISO 3166-2:US code for New Jersey is "US-NJ" andthe value "NJ" will be delivered in this field. Similarly, the ISO 3166-2:CA code for Ontario is "CA-ON" and thevalue "ON" will be delivered in this field.
Language/Character Sets
The text contained within D&B Direct 2.0 data layers is returned in English. Several reports, including theD&B Business Information Report (BIR), provide additional language options. Data layers are encoded usingthe ISO 8859-1 character set standard (also known as Latin-1), EXCEPT when the organization is domiciled inthe Czech Republic (CZ), Hungary (HU), Poland (PL) or Slovakia (SK). Data from these markets is currentlyencoded using the ISO 8859-2 (also known as Latin-2) character set standard.
Response Codes
Successful service requests will return a CM000 response code. Otherwise, one of the D&B Direct standardresponse codes will be returned.
D&B Direct API Documentation Currency Codes/Units
©Dun & Bradstreet, Inc. 2014 348
This operation may return the following response codes: CM001-CM005, CM007-CM012, CM014, CM017,CM018, PD001, PD003, PD005, PD006, PD015, PD016, and SC001-SC012.
Product (Data Layer) Details
Title / Overview Link Product Code Countries
Detailed Company Profile - Standard DCP_STD See chart
Detailed Company Profile - Enhanced DCP_ENH See chart
Detailed Company Profile - Premium DCP_PREM See chart
Alternative Detailed Company Profile - Standard DCP_ALT_STD See chart
Alternative Detailed Company Profile - Enhanced DCP_ALT_ENH See chart
Alternative Detailed Company Profile - Premium DCP_ALT_PREM See chart
Detailed Company Profile - SDMR DCP_SDMR See chart
Detailed Company Profile - WB1784 DCP_WB1784 See chart
Diversity Indicators - Standard DVR_STD See chart
Diversity Indicators - Enhanced DVR_ENH See chart
USA PATRIOT Act Plus PAC_PLUS See chart
Data Dictionary
Copies of the request and response data field tables, with columns that permit filtering by specific productcode, are included in the service-specific Samples file mentioned in the following section.
Country Availability Chart
A chart detailing the availability of each D&B Direct product by country is included in the Samples file. Thischart also provides the country codes required by this service.
Samples (Download)
Request and response samples are available for this D&B Direct web services. The samples may cover avariety of scenarios (when applicable) and are designed for use in the test environment.
Firmographic Product Service
Extras: Samples, Data Dictionary, Country Chart(when applicable)
http://developer.dnb.com/docs/2.0/firmographic/3.1/DnB-
Firmographic.zip
D&B Direct API Documentation Product (Data Layer) Details
©Dun & Bradstreet, Inc. 2014 349
Related Topics
{productservice}:RetrieveProduct (REST)
D&B Direct API Documentation Related Topics
©Dun & Bradstreet, Inc. 2014 350
Firmographic:OrderProduct (SOAP)This operation -- part of the Firmographic Product Service -- provides access to multiple products, controlled byunique product codes.
Authentication, Endpoint & WSDL
D&B Direct web services require authentication, and the data environment (i.e. production, trial or sandbox) isdetermined by the credentials submitted with each API request. Refer to the service page for the correct versionof the operation.
Endpoint
https://maxcvservices.dnb.com/FirmographicsProduct/V{version}
Product Request
The following parameters are accepted by this operation; however, the requirements for a specific requestmay differ based the product being requested. Please refer to the downloadable data dictionary (filterable byproduct code) to determine which fields are applicable.
The default value for ArchiveProductOptOutIndicator is 'true', indicating that the request will NOT beautomatically archived.
Name Characteristics
OrderProductRequest Aggregate
OrderProductRequest@ServiceVersionNumber
Attribute
OrderProductRequest.TransactionDetail
Aggregate, Optional
Records information necessary to process this request.
OrderProductRequest.TransactionDetail.ApplicationTransactionID
string, up to 64 chars, Optional
A number assigned by the calling application to uniquely identify this request.
OrderProductRequest.TransactionDetail.TransactionTimestamp
DateTimestamp, Optional
The date and time when this request was created. When the request is from an
intermediary, such as a workflow manager or service bus, this is the date and time
when the message was sent to the D&B function, i.e., the date and time when the
xml document was created by the requesting intermediary.
D&B Direct API Documentation Firmographic:OrderProduct (SOAP)
©Dun & Bradstreet, Inc. 2014 351
Name Characteristics
OrderProductRequest.TransactionDetail.SubmittingOfficeID
string, up to 64 chars, Optional
A number that identifies the system or the software application from where this
request originated. / A number used to uniquely identfy the D&B business
segment or delivery channel from where this request originated.
End: OrderProductRequest.TransactionDetail
/Aggregate
OrderProductRequest.OrderProductRequestDetail
Aggregate, Optional
Records data relating to requests for a product. This may include such details as the
product required, the subject about which the product should be produced, the
content of the product.
OrderProductRequest.OrderProductRequestDetail.InquiryDetail
Aggregate, Required
Records data that allows the customer to specify identifying information about the
subject being inquired, e.g., the DUNS Number, the address, the telephone number.
OrderProductRequest.OrderProductRequestDetail.InquiryDetail. DUNSNumber
string, up to 15 chars Pattern: {([0-9a-zA-Z]*)}, Optional
The D-U-N-S Number is D&B's identification number, which provides unique
identification of this organization, in accordance with the Data Universal
Numbering System (D-U-N-S).
OrderProductRequest.OrderProductRequestDetail.InquiryDetail.CountryISOAlpha2Code
string, at least 2 chars up to 2 chars, Optional
The two-letter country code, defined in the ISO 3166-1 scheme published by
International Organization for Standardization (ISO)identifying the country of the
inquired subject.
End: OrderProductRequest.OrderProductRequestDetail.InquiryDetail
/Aggregate
OrderProductRequest.OrderProductRequestDetail.ProductSpecification
Aggregate, Required
Records data that allows the customer to specify the details of the requested
product. This may include details such as the identifier of the product, the language
in which the product needs to be rendered, the format in which the product needs
to be rendered.
OrderProductRequest.OrderProductRequestDetail.ProductSpecification.DNBProductID
string, Optional
An alphanumeric string that uniquely identifies the product being requested.
D&B Direct API Documentation Product Request
©Dun & Bradstreet, Inc. 2014 352
Name Characteristics
OrderProductRequest.OrderProductRequestDetail.ProductSpecification.LanguagePreferenceCode
integer, up to 7 digits, Optional
A D&B code value that defines the language in which the customer wants this
product to be rendered.
Possible values: 39 [English]
OrderProductRequest.OrderProductRequestDetail.ProductSpecification.OrderReasonCode
integer, up to 7 digits, Optional
Possible values: 6332 [Credit Decision]; 6333 [Assessment of credit solvency for
intended business connection]; 6334 [Assessment of credit solvency for ongoing
business connection]; 6335 [Debt Collection]; 6336 [Commercial Credit Insurance];
6337 [Insurance Contract]; 6338 [Leasing Agreement]; 6339 [Rental Agreement]
OrderProductRequest.OrderProductRequestDetail.ProductSpecification.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
End: OrderProductRequest.OrderProductRequestDetail.ProductSpecification
/Aggregate
OrderProductRequest.OrderProductRequestDetail.ArchiveDetail
Aggregate, Optional
OrderProductRequest.OrderProductRequestDetail.ArchiveDetail.ArchiveProductOptOutIndicator
boolean, Optional
When 'true' indicates that the product being ordered is not to be stored. When
'false' indicates that the product being ordered is to be stored; however as this is
the assumed condition there is no requirement to create this tag to represent this
fact.
Possible values: true; false
D&B Direct API Documentation Product Request
©Dun & Bradstreet, Inc. 2014 353
Name Characteristics
OrderProductRequest.OrderProductRequestDetail.ArchiveDetail.ExtendArchivePeriodIndicator
boolean, Optional
When 'true' the duration to archive the data is to be extended. Note: There is an
additional cost for extending the archival period of the data purchased. When
'false' the duration to archive the data is not to be extended.
Possible values: true; false
OrderProductRequest.OrderProductRequestDetail.ArchiveDetail.PortfolioAssetContainerID
long, Optional
A number used to uniquely identify the location where this product is to be stored.
End: OrderProductRequest.OrderProductRequestDetail.ArchiveDetail
/Aggregate
OrderProductRequest.OrderProductRequestDetail.InquiryReferenceDetail
Aggregate, Optional
Records data that allows the customer to specify information to be linked to the
request in order to support subsequent order reconciliation.
OrderProductRequest.OrderProductRequestDetail.InquiryReferenceDetail.CustomerReferenceText
string, up to 240 chars, Optional (Up to 5x)
A freeform reference string provided by the customer to be linked to the product in
order to support subsequent order reconciliation.
OrderProductRequest.OrderProductRequestDetail.InquiryReferenceDetail.CustomerBillingEndorsementText
string, at least 1 chars, up to 240 chars, Optional
Text that is filled in by customer and commonly contains requesting individual or
department name, or customer's own account/reference number and/or name for
the case on which the product was provided.This text is a reference used during
the billing process.
End: OrderProductRequest.OrderProductRequestDetail.InquiryReferenceDetail
/Aggregate
End: OrderProductRequest.OrderProductRequestDetail
/Aggregate
End: OrderProductRequest /Aggregate
Testing / Sandbox
The following suggested parameters may be used for test environment (sandbox) requests to retrievesuccessful responses.
D&B Direct API Documentation Testing / Sandbox
©Dun & Bradstreet, Inc. 2014 354
Product Test D-U-N-S Number(s)
Detailed Company Profile 804735132 (US); 362241452 (US); 214567885 (GB); 754683795 (AU); 481794956(CH)
Alternative Detailed CompanyProfile
804735132 (US); 362241452 (US); 214567885 (GB); 754683795 (AU); 481794956(CH)
Diversity Indicators 804735132 (US); 362241452 (US); 214567885 (GB); 754683795 (AU); 481794956(CH)
USA PATRIOT Act Plus 804735132 (US); 362241452 (US); 214567885 (GB); 754683795 (AU); 481794956(CH)
Detailed Company Profile - SDMR
Detailed Company Profile - WB1784
The Product Availability Lookup may also be used to confirm if specific D-U-N-S Numbers are appropriate fortest scenarios required by an implementation.
Testing / Trials
When conducting testing in the production environment during a trial period, product requests will be limitedto the local market of the customer.
Product Response
The following is a list of the possible data fields returned by this operation in the XML response. Please referto individual product pages and/or the downloadable data dictionary (filterable by product code) to determinewhich fields are applicable.
For all codified data delivered by D&B Direct, the response package will include the decoded text value as adata element with the code value attached as an attribute. Refer to the Reference Data Service for access tothe D&B standard code tables.
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,Required
D&B Direct API Documentation Testing / Trials
©Dun & Bradstreet, Inc. 2014 355
Name Characteristics
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.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 356
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization. SubjectHeader.DUNSNumber
string, up to 15 charsPattern: {([0-9a-zA-Z]*)},Optional [M]
The D-U-N-S Number is
D&B's identification
number, which provides
unique identification of
this organization, in
accordance with the
Data Universal
Numbering System (D-U-
N-S).
OrderProductResponse. OrderProductResponseDetail. Product. Organization. SubjectHeader.TransferDUNSNumberRegistration
Aggregate, Optional(Infinite)
An entry loop that
repeats multiple times to
allow the recording of
changes to the D-U-N-S
number over time. This
section may include
reasons for the change.
OrderProductResponse. OrderProductResponseDetail. Product. Organization. SubjectHeader.TransferDUNSNumberRegistration. TransferReasonText
string, up to 256 chars,Optional (Infinite)
Text identifying the
reason that the D-U-N-S
Number was deleted and
possibly a new D-U-N-S
Number was assigned to
the subject.
Possible values: Duplicate
Record Transferred;
Internal Structure
Change; Straight
Deletion; Reinstated
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 357
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization. SubjectHeader.TransferDUNSNumberRegistration. TransferReasonText @DNBCodeValue
integer, up to 7 digits,Attribute (1x)
Possible values: 420
[Duplicate Record
Transferred]; 421
[Internal Structure
Change]; 333 [Straight
Deletion]; 4049
[Reinstated]
OrderProductResponse. OrderProductResponseDetail. Product. Organization. SubjectHeader.TransferDUNSNumberRegistration. TransferReasonText @DNBCodeTableNumber
integer, up to 7 digits,Attribute (1x)
OrderProductResponse. OrderProductResponseDetail. Product. Organization. SubjectHeader.TransferDUNSNumberRegistration. TransferDate
date, Optional
The date that the D-U-N-
S number was deleted or
transfer to a new D-U-N-
S number.
OrderProductResponse. OrderProductResponseDetail. Product. Organization. SubjectHeader.TransferDUNSNumberRegistration. TransferredFromDUNSNumber
string, up to 15 charsPattern: {([0-9a-zA-Z]*)},Optional [M+]
This is the D-U-N-S
number of the subject
that is deleted from the
host database.
Monitor Path:
//Organization
/SubjectHeader
/TransferDUNSNumberR
egistration
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 358
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization. SubjectHeader.TransferDUNSNumberRegistration. TransferredToDUNSNumber
string, up to 15 charsPattern: {([0-9a-zA-Z]*)},Optional [M+]
This is the D-U-N-S
number of the subject
that is retained on the
host database.
Monitor Path:
//Organization
/SubjectHeader
/TransferDUNSNumberR
egistration
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization.SubjectHeader. TransferDUNSNumberRegistration
/Aggregate
OrderProductResponse. OrderProductResponseDetail. Product. Organization. SubjectHeader.SubjectHandling
Aggregate, Optional(Infinite)
An entry loop records the
type of special handling a
subject is to receive from
D&B (or a D&B partner,
e.g., IBM, Bonnier) e.g.,
the subject is not to be
contacted by us, by
calling or any other
means, at the
organization's request.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 359
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization. SubjectHeader.SubjectHandling. SubjectHandlingText
string, up to 256 chars,Required [M+]
Text specifying the
manner in which the
Subject is to receive
special care from D&B
when it is being
contacted; e.g., do not
call, do not send
information requests. In
many cases this process
was specifically
requested by the Subject.
Possible values: De-listed
Monitor Path:
//Organization
/SubjectHeader
/SubjectHandling
/SubjectHandlingText@
DNBCodeValue
OrderProductResponse. OrderProductResponseDetail. Product. Organization. SubjectHeader.SubjectHandling. SubjectHandlingText @DNBCodeValue
integer, up to 7 digits,Attribute (1x)
Possible values: 11028
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization.SubjectHeader. SubjectHandling
/Aggregate
OrderProductResponse. OrderProductResponseDetail. Product. Organization. SubjectHeader.TotalContinuousInquiriesCount
integer, Optional
The number of unique
subscriber inquiries with
Continuous Service
registered against this
subject over the last 12
months.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 360
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization. SubjectHeader.TotalInquiriesCount
integer, Optional
The number of unique
subscriber inquiries
registered against the
subject over the last 12
months.
OrderProductResponse. OrderProductResponseDetail. Product. Organization. SubjectHeader.MarketabilityIndicator
boolean, Optional [M]
When 'true' indicates
that the record satisfies
D&B marketability rules.
When 'false' indicates
that the record does not
satisfy D&B marketability
rules; however, there is
no requirement to create
this tag to represent this
fact.
OrderProductResponse. OrderProductResponseDetail. Product. Organization. SubjectHeader.NonMarketableReasonText
string, up to 256 chars,Optional (Infinite) [M+]
Text specifying the
reason why the subject's
data is not considered
marketable by D&B.
Monitor Path:
//Organization
/SubjectHeader
/NonMarketableReasonT
ext@DNBCodeValue
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 361
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization. SubjectHeader.NonMarketableReasonText @DNBCodeValue
integer, up to 7 digits,Attribute (1x)
Possible values: Code
Table 233; 11024 [Out of
business]; 11025 [No
business name]; 11026
[Invalid SIC code]; 11027
[NIXIE]; 11028 [De-listed];
11029 [TIXIE]; 11030 [No
telephone number];
11031 [Update date over
24 months old]; 11032
[No postal code]; 11033
[Record date over 36
months old]
OrderProductResponse. OrderProductResponseDetail. Product. Organization. SubjectHeader.LastUpdateDate
date, Optional [M]
The date when the
subject's record was last
updated on D&B's
system.
OrderProductResponse. OrderProductResponseDetail. Product. Organization. SubjectHeader.OrganizationSummaryText
string, up to 3000 chars,Optional [M]
Text that records a brief
statement or account of
this organization.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 362
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization. SubjectHeader.DUNSSelfRequestIndicator
boolean, Optional [M]
When 'true' indicates
that the D-U-N-S Number
for this subject was
created at the request of
the subject. When 'false'
indicates that the D-U-N-
S Number for this
subject was not created
at the request of the
subject.; however as this
is the assumed condition
there is no requirement
to create this tag to
represent this fact.
OrderProductResponse. OrderProductResponseDetail. Product. Organization. SubjectHeader.DUNSSelfRequestDate
date, Optional [M]
The date when the
subject requested a D-U-
N-S number for itself.
OrderProductResponse. OrderProductResponseDetail. Product. Organization. SubjectHeader.FullReportDate
date | year | year &month, Optional [M]
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization.SubjectHeader
/Aggregate
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location Aggregate, Optional
Records the address
details for a subject. An
address is the
designation of a place
where a subject can be
located or may be
communicated with, e.g.,
primary address,
registered address,
mailing address.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 363
Name Characteristics
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.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 364
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location.PrimaryAddress. StreetAddressLine. LineText
string, up to 240 chars,Required [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 /Location
/PrimaryAddress
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location.PrimaryAddress. StreetAddressLine. DisplaySequence
integer, up to 3 digits,Optional
A number which may be
used to define the order
in which this street
address line should be
presented relative to
other street address lines
where the lower the
number the earlier the
data is presented.
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location.PrimaryAddress. StreetAddressLine
/Aggregate
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 365
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location.PrimaryAddress. PrimaryTownName
string, up to 64 chars,Optional [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. CountryISOAlpha2Code
string, at least 2 chars,up to 2 chars, Optional[M+]
The two-letter country
code, defined in the ISO
3166-1 scheme published
by International
Organization for
Standardization (ISO),
identifying the country
for this address.
Monitor Path:
//Organization /Location
/PrimaryAddress
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location.PrimaryAddress. MinorTownName
string, up to 64 chars,Optional [M+]
Text recording the name
of a village, town or
suburb where this is not
a Primary Town/City. For
example, 'Booker' in
Booker, High Wycombe.
Monitor Path:
//Organization /Location
/PrimaryAddress
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 366
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location.PrimaryAddress. CountyOfficialName
string, up to 64 chars,Optional [M+]
Monitor Path:
//Organization /Location
/PrimaryAddress
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location.PrimaryAddress. PostalCode
string, up to 16 chars,Optional [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 [M+]
Monitor Path:
//Organization /Location
/PrimaryAddress
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location.PrimaryAddress. TerritoryAbbreviatedName
string, up to 64 chars,Optional [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
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 367
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location.PrimaryAddress. UndeliverableIndicator
boolean, Optional [M+]
Monitor Path:
//Organization /Location
/PrimaryAddress
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location.PrimaryAddress. AddressUsageTenureDetail
Aggregate, Optional(Infinite)
An entry loop records the
basis upon which the
subject inhabits the
premises at the address,
e.g., owns, rents, leases.
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location.PrimaryAddress. AddressUsageTenureDetail. TenureTypeText
string, up to 256 chars,Required [M+]
Text specifies the terms
under which this subject
occupies the premises
(i.e., one or more
facilities) at the primary
address, e.g., owned,
rented or leased.
Monitor Path:
//Organization /Location
/PrimaryAddress
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 368
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location.PrimaryAddress. AddressUsageTenureDetail. TenureTypeText @DNBCodeValue
integer, up to 7 digits,Attribute (1x)
Possible values: 440 Co-
owns; 1128 Owns; 1129
Rents; 1130 Leases; 1131
Shares; 3921 Occupies;
6228 Partly Owns/Partly
Rents; 6723 Rent from
shareholder/parent
company; 6724 Rent
from group company;
6725 Rent from principal;
6726 GE rental contract;
11206 Partly Owns/Partly
Leases; 21218 Assigned;
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location.PrimaryAddress. AddressUsageTenureDetail
/Aggregate
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location.PrimaryAddress. PoliticalDistrict
Aggregate, Optional(Infinite)
An entry loop that
repeats multiple times to
record different distinct
territorial subdivision for
holding a separate
election for one or more
seats in a legislative body
to which this address
belong.
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location.PrimaryAddress. PoliticalDistrict. PoliticalDistrictText
string, up to 256 chars,Required [M+]
Monitor Path:
//Organization /Location
/PrimaryAddress
End: OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location.PrimaryAddress. PoliticalDistrict
/Aggregate
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 369
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location.PrimaryAddress. RegisteredAddressIndicator
boolean, Optional [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. ResidentialAddressIndicator
boolean, Optional [M+]
When 'true' indicates
that the Primary Address
which has been
presented is also the
Residential Address.
When 'false' indicates
that the Primary Address
which has been
presented is not a
Residential Address.
Monitor Path:
//Organization /Location
/PrimaryAddress
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location.PrimaryAddress. CountryGroupName
string, up to 64 chars,Optional [M+]
Monitor Path:
//Organization /Location
/PrimaryAddress
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 370
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location.PrimaryAddress. PremisesDetail
Aggregate, Optional(Infinite)
An entry loop which can
repeat multiple times to
allow the recording of
several different types of
premises which the
subject utilizes at the
address.
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location.PrimaryAddress. PremisesDetail. PremisesAreaMeasurement
decimal, Optional [M+]
A number specifying the
overall space covered by
the premises described
by the PremisesTypeText
used by the subject at
the address e.g., the 2000
in 2000 square meters.
Monitor Path:
//Organization /Location
/PrimaryAddress
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location.PrimaryAddress. PremisesDetail. PremisesAreaMeasurementReliabilityText
string, up to 256 chars,Optional [M+]
Text that describes the
accuracy of the
measurement found in
PremisesAreaMeasurem
ent; e.g., actual,
estimated, modeled.
Possible values: Actual;
Minimum value from a
range; Estimated
Monitor Path:
//Organization /Location
/PrimaryAddress
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 371
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location.PrimaryAddress. PremisesDetail. PremisesAreaMeasurementReliabilityText@DNBCodeValue
integer, up to 7 digits,Attribute (1x)
Possible values: 9092
[Actual]; 11078
[Minimum value from a
range]; 9093 [Estimated]
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location.PrimaryAddress. PremisesDetail. PremisesAreaMeasurementUnitText
string, up to 256 chars,Optional [M+]
Text that describes the
measurement unit used
to express the Premises
Usage Area
Measurement; e.g. acre,
square meters, square
feet.
Possible values: square
foot
Monitor Path:
//Organization /Location
/PrimaryAddress
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location.PrimaryAddress. PremisesDetail. PremisesAreaMeasurementUnitText @DNBCodeValue
integer, up to 7 digits,Attribute (1x)
Possible values: 3848
[square foot]
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location.PrimaryAddress. PremisesDetail
/Aggregate
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 372
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location.PrimaryAddress. PremisesUsageDetail
Aggregate, Optional(Infinite)
An entry loop that
describes the premises
strictly with respect to a
subject and identifies: 1.
the nature of the
facilities or grounds used
by the subject at this
address, e.g., office,
warehouse, factory,
farmland, mine/quarry,
brewery 2. the type of
structures or features in
the facility or on the
grounds, where floor,
seats, room, suite are
examples of internal
structures or features
and where building,
harbour, quay are
examples of external
structures or features 3.
identification of the
specific structures or
features at this place of
business, e.g.,
Conference Center
Building, Block A, 3rd
Floor, 9th - 15th Floors,
Suite 101and how they
relate to each other
using a hierarchy
structure.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 373
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location.PrimaryAddress. PremisesUsageDetail. PremisesUsageFunctionDetail
Aggregate, Optional(Infinite)
An entry loop which
specifies how the
premises are explicitly
being used, or not used,
by the subject, e.g., for
cattle ranching, for food
preparation, for
accounting, for catering.
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location.PrimaryAddress. PremisesUsageDetail. PremisesUsageFunctionDetail.PremisesFunctionText
string, up to 256 chars,Optional [M+]
Text specifying an
activity that is performed
or is not performed at
this facility by the
subject, e.g.,
manufacturing,
warehousing, printing,
packaging, office work.
Monitor Path:
//Organization /Location
/PrimaryAddress
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location.PrimaryAddress. PremisesUsageDetail. PremisesUsageFunctionDetail.PremisesFunctionText @DNBCodeValue
integer, up to 7 digits,Attribute (1x)
Possible values: 12058
[Manufacturing]
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location.PrimaryAddress. PremisesUsageDetail. PremisesUsageFunctionDetail
/Aggregate
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location.PrimaryAddress. PremisesUsageDetail
/Aggregate
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location.PrimaryAddress. LongitudeMeasurement
decimal, up to 10 digits,maximum of 6 decimalplaces, Optional [M+]
Monitor Path:
//Organization /Location
/PrimaryAddress
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 374
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location.PrimaryAddress. LatitudeMeasurement
decimal, up to 9 digits,maximum of 6 decimalplaces, Optional [M+]
Monitor Path:
//Organization /Location
/PrimaryAddress
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location.PrimaryAddress. GeographicalPrecisionText
string, up to 256 chars,Optional [M+]
Monitor Path:
//Organization /Location
/PrimaryAddress
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location.PrimaryAddress. MetropolitanStatisticalAreaUSCensusCode
string, Optional (Infinite)[M+]
A Geographical Region
with a relatively high
population density at its
core and close economic
ties throughout the area.
Monitor Path:
//Organization /Location
/PrimaryAddress
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location.PrimaryAddress. CountryOfficialName
string, up to 64 chars,Optional [M+]
Monitor Path:
//Organization /Location
/PrimaryAddress
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location.PrimaryAddress. PrimaryTownWorldBaseCode
integer, up to 32 digits,Optional [M+]
Monitor Path:
//Organization /Location
/PrimaryAddress
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 375
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location.PrimaryAddress. TerritoryWorldBaseCode
integer, up to 32 digits,Optional [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
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 [M+]
Monitor Path:
//Organization /Location
/PrimaryAddress
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 376
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location.PrimaryAddress. EconomicAreaOfInfluenceCode
integer, up to 3 digits,Optional
A code assigned by the
U.S Bureau of Economic
Analysis to identify the
subject's regional market
that surrounds a
metropolitan or
micropolitan statistical
area serving as a regional
center of economic
activity.
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location.PrimaryAddress. CountryFIPSCode
string, up to 4 chars,Optional [M+]
Text that describes the
Federal Information
Processing Standards
(FIPS) code value
assigned by the U.S
Department of
Commerce which
identifies the country
where this subject is
located.
Monitor Path:
//Organization /Location
/PrimaryAddress
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 377
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location.PrimaryAddress. TerritoryFIPSCode
integer, up to 2 digits,Optional [M+]
A Federal Information
Processing Standards
(FIPS) code value
assigned by the U.S
Department of
Commerce which
identifies the territory
where this subject is
located.
Monitor Path:
//Organization /Location
/PrimaryAddress
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location.PrimaryAddress. MetropolitanStatisticalAreaFIPSCode
integer, up to 4 digits,Optional [M+]
A Federal Information
Processing Standards
(FIPS) code value
assigned by the U.S
Department of
Commerce which
identifies the
Metropolitan Statistical
Area where this subject
is located.
Monitor Path:
//Organization /Location
/PrimaryAddress
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 378
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location.PrimaryAddress. CountyPopulationRankNumber
integer, up to 1 digit,Optional
A number ranging from 0
to 9 assigned by D&B
classifying the county of
the subject based on the
resident population; 0
denoting lowest
population range and 9
denoting highest
population range.
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location.PrimaryAddress. CountyFIPSCode
integer, up to 3 digits,Optional [M+]
A Federal Information
Processing Standards
(FIPS) code value
assigned by the U.S
Department of
Commerce which
identifies the county
where this subject is
located.
Monitor Path:
//Organization /Location
/PrimaryAddress
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location.PrimaryAddress
/Aggregate
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 379
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location.MailingAddress
Aggregate, Optional(Infinite)
An entry loop which can
repeat multiple times to
allow the recording of
address which is mainly
utilized for the purpose
of mail delivery. This
usually includes a Post
Office Box number or
similar mailing details.
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location.MailingAddress. 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.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 380
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location.MailingAddress. StreetAddressLine. LineText
string, up to 240 chars,Required [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 /Location
/MailingAddress
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location.MailingAddress. StreetAddressLine. DisplaySequence
integer, up to 3 digits,Optional
A number which may be
used to define the order
in which this street
address line should be
presented relative to
other street address lines
where the lower the
number the earlier the
data is presented.
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location.MailingAddress. StreetAddressLine
/Aggregate
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 381
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location.MailingAddress. PrimaryTownName
string, up to 64 chars,Optional [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. CountryISOAlpha2Code
string, at least 2 chars,up to 2 chars, Optional[M+]
The two-letter country
code, defined in the ISO
3166-1 scheme published
by International
Organization for
Standardization (ISO),
identifying the country
for this address.
Monitor Path:
//Organization /Location
/MailingAddress
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location.MailingAddress. CountyOfficialName
string, up to 64 chars,Optional [M+]
Monitor Path:
//Organization /Location
/MailingAddress
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 382
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location.MailingAddress. PostalCode
string, up to 16 chars,Optional [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 [M+]
Monitor Path:
//Organization /Location
/MailingAddress
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location.MailingAddress. TerritoryAbbreviatedName
string, up to 64 chars,Optional [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
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 383
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location.MailingAddress. PostalRouteNumber
string, up to 64 chars,Optional
An identifier of a postal
route such as a rural
route" in the United
States or a "Cedex" in
France. Clarification
Note: Though this
attribute is referred to as
a number
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location.MailingAddress. PostalRouteTypeText
string, up to 256 chars,Optional
Text that decribes the
type of of postal route
such as a rural route" in
the United States or a
"Cedex" in France."
Possible values: Rural
Route; Cedex; City; Post
Box; Highway Contract
Route; General Delivery
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location.MailingAddress. PostalRouteTypeText @DNBCodeValue Possible values: 139
[Rural Route]; 140
[Cedex]; 27865 [City];
27866 [Post Box]; 27868
[Highway Contract
Route]; 27869 [General
Delivery]
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location.MailingAddress. CountryOfficialName
string, up to 64 chars,Optional [M+]
Monitor Path:
//Organization /Location
/MailingAddress
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 384
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location.MailingAddress. PrimaryTownWorldBaseCode
integer, up to 32 digits,Optional [M+]
Monitor Path:
//Organization /Location
/MailingAddress
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location.MailingAddress. TerritoryWorldBaseCode
integer, up to 32 digits,Optional [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 [M+]
The D&B three digit
WorldBase code value
that identifies country
where the business is
located.
Monitor Path:
//Organization /Location
/MailingAddress
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 385
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location.MailingAddress. CountryGroupName
string, up to 64 chars,Optional [M+]
Monitor Path:
//Organization /Location
/MailingAddress
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location.MailingAddress. CountyWorldBaseCode
integer, up to 32 digits,Optional
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location.MailingAddress
/Aggregate
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location /Aggregate
OrderProductResponse. OrderProductResponseDetail. Product. Organization.Telecommunication
Aggregate, Optional
Records information
about the different
modes of
Telecommunication
addresses used by a
subject for external
contact purposes. The
modes of
communication include
telephone, fax, e-mail,
web address.
OrderProductResponse. OrderProductResponseDetail. Product. Organization.Telecommunication. TelephoneNumber
Aggregate, Optional(Infinite)
An entry loop which can
allow multiple Telephone
contact information used
for voice communication
with the subject.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 386
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.Telecommunication. TelephoneNumber. TelecommunicationNumber
string, at least 1 char,up to 50 chars, Required[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.
Monitor Path:
//Organization
/Telecommunication
OrderProductResponse. OrderProductResponseDetail. Product. Organization.Telecommunication. TelephoneNumber. InternationalDialingCode
string, up to 7 chars,Optional [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
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 387
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.Telecommunication. TelephoneNumber. UnreachableIndicator
boolean, Optional
When 'true' indicates
that telecommunication
number cannot be
connected to
successfully. When
'false' indicates that
telecommunication
number can be
connected to
successfully. When set to
NULL, it indicates that
D&B does not know
whether the
telecommunication
number can be
connected to
successfully.
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization.Telecommunication. TelephoneNumber
/Aggregate
OrderProductResponse. OrderProductResponseDetail. Product. Organization.Telecommunication. FacsimileNumber
Aggregate, Optional(Infinite)
An entry loop which can
allow multiple Facsimile
contact information used
for data communication
with the subject.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 388
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.Telecommunication. FacsimileNumber. TelecommunicationNumber
string, at least 1 char,up to 50 chars, Required[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.
Monitor Path:
//Organization
/Telecommunication
OrderProductResponse. OrderProductResponseDetail. Product. Organization.Telecommunication. FacsimileNumber. InternationalDialingCode
string, up to 7 chars,Optional [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
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 389
Name Characteristics
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization.Telecommunication. FacsimileNumber
/Aggregate
OrderProductResponse. OrderProductResponseDetail. Product. Organization.Telecommunication. WebPageAddress
Aggregate, Optional(Infinite)
An entry loop which can
allow multiple Internet
URLs used for online
information and
communication with the
subject.
OrderProductResponse. OrderProductResponseDetail. Product. Organization.Telecommunication. WebPageAddress. TelecommunicationAddress
string, up to 240 chars,Required [M+]
The Internet URL
(Uniform Resource
Locator) which uniquely
identifies the propreitary
website of the subject or
the website preferred by
the subject which gives
more information on the
subject. Note: The
communications protocol
followed by a colon and
two slashes (http://) is
not included in the Web
Page address.
Monitor Path:
//Organization
/Telecommunication
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization.Telecommunication. WebPageAddress
/Aggregate
OrderProductResponse. OrderProductResponseDetail. Product. Organization.Telecommunication. SocialMediaDetail
Aggregate, Optional(Infinite)
OrderProductResponse. OrderProductResponseDetail. Product. Organization.Telecommunication. SocialMediaDetail. SocialMediaPlatformName
string, up to 256 chars,Required [M+]
Monitor Path:
//Organization
/Telecommunication
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 390
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.Telecommunication. SocialMediaDetail. SocialMediaPlatformName @DNBCodeValue
integer, up to 7 digits,Attribute (1x)
Possible values: 25868
[Wikipedia ]
OrderProductResponse. OrderProductResponseDetail. Product. Organization.Telecommunication. SocialMediaDetail. WebPageURL
string, Optional [M+]
Text identifying the
internet URL of the
subject's content in the
social media platform.
Monitor Path:
//Organization
/Telecommunication
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization.Telecommunication. SocialMediaDetail
/Aggregate
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization.Telecommunication
/Aggregate
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 391
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Financial Aggregate, Optional
Records a standardized
view the financial results
of a subject usually
extracted from a set of
accounts. This includes
the financial period to
which those results
apply, the terms of its
audited status, whether
is fiscal or estimated,
whether it is a
group/consolidated or
individual statement etc.
The identifying data for
the financial statement
(e.g. The financial period
to which it refers) and
the 70 D&B global
standard financial items
are recorded in the
'Statement' aggregate.
Additionally the full
granular view of the
financial statement may
be recorded in the
'Financial Statement
Schedule' sub-
aggregation.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 392
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Financial.KeyFinancialFiguresOverview
Aggregate, Optional(Infinite)
An entry loop which can
repeat multiple times to
record highlights of the
financial statements
(Balance sheet, Income
statement, cash flow
statement etc.) across
years and gives a
snapshot view of how
the company has been
performing on items in
these financial
statements.
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Financial.KeyFinancialFiguresOverview. StatementHeaderDetails. FinancialStatementToDate
date, Optional [M]
The date when the
accounting period ended.
If the Reliability Code
denotes the figures are
projected (future), then
this is the date when the
accounting period will
end.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 393
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Financial.KeyFinancialFiguresOverview. StatementHeaderDetails. TimePeriodText
string, up to 256 chars,Optional [M+]
Text denoting the
timeframe in the past for
which this information is
recorded.
Monitor Path:
//Organization /Financial
/KeyFinancialFiguresOver
view
/StatementHeaderDetail
s
/TimePeriodText@DNBC
odeValue
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Financial.KeyFinancialFiguresOverview. StatementHeaderDetails. TimePeriodText @DnbCodeValue
integer, up to 7 digits,Attribute (1x)
Possible values: 11096
[Between 0 and 12
months]; 13711 [1-3
years]; 13721 [1-5 years]
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Financial.KeyFinancialFiguresOverview. StatementHeaderDetails. FinancialPeriodDuration
duration, Optional [M]
Records the period of the
Financial Summary when
this cannot be expressed
using 'Summary Date'
and 'Number of Months'
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 394
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Financial.KeyFinancialFiguresOverview. SalesRevenueAmount
decimal, Optional(Infinite) [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 @UnitOfSize
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Financial.KeyFinancialFiguresOverview. SalesRevenueAmount @CurrencyISOAlpha3Code
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Financial.KeyFinancialFiguresOverview. SalesRevenueAmount @ReliabilityText
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Financial.KeyFinancialFiguresOverview. ProfitOrLossAmount
decimal, Optional(Infinite) [M]
A monetory figure that
shows the difference
between Sales Revenue
and Cost of Sales before
the deduction of selling,
distribution,
administration and other
costs.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 395
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Financial.KeyFinancialFiguresOverview. SalesTurnoverGrowthRate
decimal, Optional [M]
The amount by which a
SalesTurnover increases
over a given period of
time as a percentage of
its previous value.
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Financial.KeyFinancialFiguresOverview. ProfitOrLossGrowthRate
decimal, Optional [M]
The rate of change in the
difference between Sales
Revenue and Cost of
Sales before the
deduction of selling,
distribution,
administration and other
costs.
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Financial.KeyFinancialFiguresOverview. EmployeeQuantityGrowthRate
decimal, Optional [M]
The annual rate at which
total number of
employees in a firm's has
been or is expected to
grow.Needs to be moved
to Employee figures
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 396
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Financial.KeyFinancialFiguresOverview. EmployeeQuantity
integer, Optional [M]
The number of
employees for the
subject as published on
the financial statement.
If figure is stored locally
with 000's omitted then
this must be multiplied
and the full figure
populated to the record.
E.g. If number of
employees is 97 with
000's omitted then the
figure of 97000 should be
populated.
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Financial.KeyFinancialFiguresOverview. EmployeeQuantityReliabilityText
string, up to 256 chars,Optional [M]
Text that describes the
integrity of the employee
figures, e.g. audited,
actual, estimated,
modeled.
Possible values: 9092
[Actual]; 11078 [Low End
Range]; 9093 [Estimated
Value]
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Financial.KeyFinancialFiguresOverview. EmployeeQuantityReliabilityText @DNBCodeValue
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization. Financial.KeyFinancialFiguresOverview
/Aggregate
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 397
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Financial.FinancialStatement
Aggregate, Optional(Infinite)
An entry loop which can
repeat multiple times to
record information
characterizing an
organization's financial
health, such as its
operation results (over a
specified period of time),
the ownership equity in
the business, its money
management (at a point
in time), and derived
ratios that give insight
into its profitability,
solvency, liquidity, and
other characteristics. The
financial figures may be
provided as actual or
estimated figures by the
subject, an outside
source, or modeled by
D&B. It may cover a
single organization or
multiple related
organizations. The
figures may be qualified
based on the auditor's
remarks.
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Financial.FinancialStatement. StatementHeaderDetails
Aggregate, Optional
Records high level
information which either
identifies the presence of
a financial statement for
the subject or is derived
from multiple financial
statements.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 398
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Financial.FinancialStatement. StatementHeaderDetails. FinancialStatementToDate
date, Optional [M+]
The date when the
accounting period ended.
If the Reliability Code
denotes the figures are
projected (future), then
this is the date when the
accounting period will
end.
Monitor Path:
//Organization /Financial
/FinancialStatement
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Financial.FinancialStatement. StatementHeaderDetails. CurrencyISOAlpha3Code
string, up to 3 chars,Optional [M+]
The three-letter code,
published by
International
Organization for
Standardization (ISO),
identifying the type of
money that is primarily
used by this subject
Monitor Path:
//Organization /Financial
/FinancialStatement
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 399
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Financial.FinancialStatement. StatementHeaderDetails. UnitOfSizeText
string, up to 256 chars,Optional [M+]
Text which identifies the
unit of size in which the
financial summary
figures are provided, e.g.,
in 1,000s; in 1,000,000s.
The financial figures
should be populated to
the record with the 000's
or 000,000's omitted, e.g.,
If Sales are 54398 with
000's omitted then the
figure of 54398 (NOT
54398000) should be
populated.
Monitor Path:
//Organization /Financial
/FinancialStatement
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Financial.FinancialStatement. StatementHeaderDetails. UnitOfSizeText @DNBCodeValue
integer, up to 7 digits,Attribute (1x)
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Financial.FinancialStatement. StatementHeaderDetails. UnitOfSizeText @DNBCodeTableNumber
integer, up to 7 digits,Attribute (1x)
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Financial.FinancialStatement. StatementHeaderDetails. FinancialPeriodDuration
string, up to 20 chars,Optional [M+]
Records the period of the
Financial Summary when
this cannot be expressed
using 'Summary Date'
and 'Number of Months'
Monitor Path:
//Organization /Financial
/FinancialStatement
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization. Financial.FinancialStatement. StatementHeaderDetails
/Aggregate
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 400
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Financial.FinancialStatement. BalanceSheet
Aggregate, Optional
Summarizes an
organization or
individual's assets, equity
and liabilities at a specific
point in time.
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Financial.FinancialStatement. BalanceSheet. Liabilities
Aggregate, Optional
Records the legal debts or
obligations of a company
that arise during the
course of business
operations. Liabilities are
settled over time
through the transfer of
economic benefits
including money, goods
or services.
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Financial.FinancialStatement. BalanceSheet. Liabilities. TotalEquityAmount
decimal, Optional [M+]
The total value of share
capital/stock originally
invested by
shareholders/stockholde
rs plus any reserves
which have arisen, such
as retained profits, which
are ploughed back into
the firm.
Monitor Path:
//Organization /Financial
/FinancialStatement
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Financial.FinancialStatement. BalanceSheet. Liabilities. TotalEquityAmount @CurrencyISOAlpha3Code
string, up to 3 chars,Attribute (1x)
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization. Financial.FinancialStatement. BalanceSheet. Liabilities
/Aggregate
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 401
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Financial.FinancialStatement. BalanceSheet. TotalAssetsAmount
decimal, Optional [M+]
The combined value of
Total Current Assets and
Total Long Term Assets.
This therefore includes
all of the assets used by
an organization no
matter how they are
financed.
Monitor Path:
//Organization /Financial
/FinancialStatement
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization. Financial.FinancialStatement. BalanceSheet
/Aggregate
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Financial.FinancialStatement. FinancialRatios
Aggregate, Optional
Financial Ratio records a
business' financial figure
(s) in terms of another of
the business' financial
figures. These ratios are
indicators used to
evaluate a business'
financial condition and
potential risk. They are
especially meaningful in
comparisons, e.g., a
business' ratio in
comparison to that of its
industry, a business' ratio
over time (trend). These
ratios may give insight,
for example, into a
business' profitability,
liquidity, activity
(operations), or leverage.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 402
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Financial.FinancialStatement. FinancialRatios. FinancialRatioCategory
Aggregate, Optional(Infinite)
An entry loop which can
repeat multiple times to
allow the recording of
financial ratios which are
grouped logically
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Financial.FinancialStatement. FinancialRatios. FinancialRatioCategory. FinancialRatioItem
Aggregate, Optional(Infinite)
An entry loop which can
repeat multiple times to
allow the recording of
financial ratios relating
to the stated financial
period.
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Financial.FinancialStatement. FinancialRatios. FinancialRatioCategory. FinancialRatioItem.ItemDescriptionText
string, up to 256 chars,Optional [M+]
Text describes which
calculated financial
figure is stored in Item
Amount, e.g., quick ratio,
current ratio, total
liabilities over net worth
ratio.
Monitor Path:
//Organization /Financial
/FinancialStatement
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Financial.FinancialStatement. FinancialRatios. FinancialRatioCategory. FinancialRatioItem.ItemDescriptionText @DNBCodeValue
integer, up to 7 digits,Attribute (1x)
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 403
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Financial.FinancialStatement. FinancialRatios. FinancialRatioCategory. FinancialRatioItem. ItemRatio
decimal, up to 19 digits,maximum of 6 decimalplaces, Optional [M+]
A number expressing
proportionally what one
or more of the business'
financial figures is in
relation to one or more
of the business' other
financial figures. This
figure is an indicator
used to evaluate the
business' financial
condition or potential
risk. For example, a Quick
Ratio, which is the sum
of a business' cash and
accounts receivable
amounts divided by its
current liabilities, is a
predictor of how likely
the business is to pay its
bills on time.
Monitor Path:
//Organization /Financial
/FinancialStatement
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization. Financial.FinancialStatement. FinancialRatios. FinancialRatioCategory. FinancialRatioItem
/Aggregate
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization. Financial.FinancialStatement. FinancialRatios. FinancialRatioCategory
/Aggregate
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization. Financial.FinancialStatement. FinancialRatios
/Aggregate
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 404
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Financial.FinancialStatement. AccountantDetails
Aggregate, Optional(Infinite)
An entry loop which can
repeat multiple times to
allow the recording of
detail regarding the
accountants such as
their name and their
opinion regarding the
statement.
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Financial.FinancialStatement. AccountantDetails. AccountantName
Aggregate, Optional(Infinite)
Text that records the
name of the person who
makes and keeps records
in mutiple languages
and/or writing scripts.
They are the practioners
of accountancy (UK) or
accounting (US), which is
the measurement,
disclosure or provision of
assurance about
financial information
that helps managers,
investors, tax authorities
and others make
decisions about
allocating resources.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 405
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Financial.FinancialStatement. AccountantDetails. AccountantName. FullName
string, up to 256 chars,Optional [M+]
The entire name of the
subject where the
subject is either an
individual or an
organization.
Monitor Path:
//Organization /Financial
/FinancialStatement
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization. Financial.FinancialStatement. AccountantDetails. AccountantName
/Aggregate
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization. Financial.FinancialStatement. AccountantDetails
/Aggregate
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization. Financial.FinancialStatement
/Aggregate
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Financial.GrowthRates. FinancialStatementHeader
Aggregate, Optional
The Financial Statement
period for which this
growth rate is calculated
for.
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Financial.GrowthRates. FinancialStatementHeader. TimePeriodText
string, up to 256 chars,Optional [M+]
Text denoting the
timeframe in the past for
which this information is
recorded.
Monitor Path:
//Organization /Financial
/GrowthRates
/FinancialStatementHea
der
/TimePeRiodText@DNBC
odeValue
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 406
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Financial.GrowthRates. FinancialStatementHeader. TimePeriodText @DnbCodeValue
integer, up to 7 digits,Attribute (1x)
Possible values: 11096
[Between 0 and 12
months]
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Financial.GrowthRates. FinancialStatementHeader
Aggregate, Optional
The Financial Statement
period for which this
growth rate is calculated
for.
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Financial.GrowthRates. ComparedToFinancialStatementHeader
Aggregate, Optional
The earlier Financial
Statement period used in
comparison to calculate
the growth rate.
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Financial.GrowthRates. ComparedToFinancialStatementHeader. TimePeriodText
string, up to 256 chars,Optional [M+]
Text denoting the
timeframe in the past for
which this information is
recorded.
Monitor Path:
//Organization /Financial
/GrowthRates
/ComparedToFinancialSt
atementHeader
/TimePeRiodText@DNBC
odeValue
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Financial.GrowthRates. ComparedToFinancialStatementHeader. TimePeriodText @DnbCodeValue
integer, up to 7 digits,Attribute (1x)
Possible values: 13711 [1-
3 years]; 13721 [1-5
years]
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 407
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Financial.GrowthRates. ComparedToFinancialStatementHeader
Aggregate, Optional
The earlier Financial
Statement period used in
comparison to calculate
the growth rate.
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Financial.GrowthRates. GrowthRateItem
Aggregate, Optional(Infinite)
An entry loop which can
repeat multiple times to
record different figures
from the financial
Statement Growth Rate.
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Financial.GrowthRates. GrowthRateItem. ItemDescriptionText
string, up to 256 chars,Optional [M+]
Text that describes the
type of derived result
recorded in 'Item Rate'.
Monitor Path:
//Organization /Financial
/GrowthRates
/GrowthRateItem
/ItemDescriptionText@D
NBCodeValue
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Financial.GrowthRates. GrowthRateItem. ItemDescriptionText @DNBCodeValue
integer, up to 7 digits,Attribute (1x)
Possible values: 7542 [net
income]; 3110 [Sales
Revenue]; 23714
[Adjusted Diluted
Earnings Or Loss Per
Share (B/S)]; 5927
[Dividends]; 3110 [Sales
Revenue]; 6240 [Total
number of employees]
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 408
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Financial.GrowthRates. GrowthRateItem. ItemRate
decimal, Optional [M]
Percentage of change
compared to prior year.
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization. Financial.GrowthRates. GrowthRateItem
/Aggregate
End: OrderProductResponse. OrderProductResponseDetail. Product. Organization. Financial /Aggregate
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 [M]
Text recording a name of
this organization in the
specified language
and/or writing script.
OrderProductResponse. OrderProductResponseDetail. Product. Organization.OrganizationName. OrganizationPrimaryName. OrganizationName @LanguageCode
integer, up to 3 digits,Attribute (1x)
OrderProductResponse. OrderProductResponseDetail. Product. Organization.OrganizationName. OrganizationPrimaryName. OrganizationName@WritingScriptISOAlpha4Code
string, Attribute (1x)
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 409
Name Characteristics
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization.OrganizationName. OrganizationPrimaryName
/Aggregate
OrderProductResponse. OrderProductResponseDetail. Product. Organization.OrganizationName. FormerOrganizationPrimaryName
Aggregate, Optional(Infinite)
An entry loop which can
repeat multiple times to
allow the recording of
names by which the
organization was
primarily known /
identified previously in
different languages
and/or writing scripts .
OrderProductResponse. OrderProductResponseDetail. Product. Organization.OrganizationName. FormerOrganizationPrimaryName. OrganizationName
string, up to 256 chars,Required
Text recording a name of
this organization in the
specified language
and/or writing script.
OrderProductResponse. OrderProductResponseDetail. Product. Organization.OrganizationName. FormerOrganizationPrimaryName. OrganizationName@WritingScriptISOAlpha4Code
string, Attribute (1x)
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization.OrganizationName. FormerOrganizationPrimaryName
/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.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 410
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.OrganizationName. TradeStyleName. OrganizationName
string, up to 256 chars,Required [M+]
Text recording a name of
this organization in the
specified language
and/or writing script.
Monitor Path:
//Organization
/OrganizationName
/TradeStyleName
OrderProductResponse. OrderProductResponseDetail. Product. Organization.OrganizationName. TradeStyleName. OrganizationName @LanguageCode
integer, up to 3 digits,Attribute (1x)
OrderProductResponse. OrderProductResponseDetail. Product. Organization.OrganizationName. TradeStyleName. OrganizationName @WritingScriptISOAlpha4Code
string, Attribute (1x)
OrderProductResponse. OrderProductResponseDetail. Product. Organization.OrganizationName. TradeStyleName. DisplaySequence
integer, up to 3 digits,Optional
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
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 411
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.OrganizationDetail
Aggregate, Optional
Records fundamental
information about a
Subject which may vary
over time.
OrderProductResponse. OrderProductResponseDetail. Product. Organization.OrganizationDetail. FamilyTreeMemberRole
Aggregate, Optional(Infinite)
An entry loop that can
repeat multiple times to
allow the recording of
various parts that the
Subject plays as a
member of an ownership
structured family tree.
OrderProductResponse. OrderProductResponseDetail. Product. Organization.OrganizationDetail. FamilyTreeMemberRole. FamilyTreeMemberRoleText
string, up to 256 chars,Optional [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
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 412
Name Characteristics
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. FamilyTreeMemberRole. FamilyTreeMemberRoleText@DNBCodeTableNumber
integer, up to 7 digits,Attribute (1x)
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization.OrganizationDetail. FamilyTreeMemberRole
/Aggregate
OrderProductResponse. OrderProductResponseDetail. Product. Organization.OrganizationDetail. StandaloneOrganizationIndicator
boolean, Optional [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.,
FamilyTreeMemberRoleT
ext cannot be present.
When 'false' indicates
that this organization is a
member of a legal family
tree. In this condition the
FamilyTreeMemberRoleT
ext must be present.
OrderProductResponse. OrderProductResponseDetail. Product. Organization.OrganizationDetail. ControlOwnershipDate
date, Optional [M]
The date when the
current owners took over
this business.
OrderProductResponse. OrderProductResponseDetail. Product. Organization.OrganizationDetail. ControlOwnershipDate @DatePrecisionText
string, up to 256 chars,Attribute (1x)
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 413
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.OrganizationDetail. ControlOwnershipDate @DatePrecisionDNBCodeValue
integer, up to 7 digits,Attribute (1x)
OrderProductResponse. OrderProductResponseDetail. Product. Organization.OrganizationDetail. ControlOwnershipTypeText
string, up to 256 chars,Optional [M]
Text that describes the
type of controlling
ownership, e.g., publicly
owned, privately owned,
state owned.
Clarification Note: For
some countries,
controlling ownership
can be derived from the
legal form.
OrderProductResponse. OrderProductResponseDetail. Product. Organization.OrganizationDetail. ControlOwnershipTypeText @DNBCodeValue
integer, up to 7 digits,Attribute (1x)
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 414
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.OrganizationDetail. OperatingStatusText
string, up to 256 chars,Optional [M+]
Text describing this
organization's functional
state / trading status,
e.g. active, out of
business, dormant.
Possible values: Out of
Business; Active;
Dormant; Out of
business - Unfavourable;
Out of business -
Favourable; Ceased
trading; Assumed Out of
Business - Unable to
Confirm Active
Operations
Monitor Path:
//Organization
/OrganizationDetail
/OperatingStatusText@
DNBCodeValue
OrderProductResponse. OrderProductResponseDetail. Product. Organization.OrganizationDetail. OrganizationStartYear
integer, Optional [M]
The year when
operations undertaken
by the organization
commenced.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 415
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.OrganizationDetail. FranchiseOperationTypeText
string, up to 256 chars,Optional [M+]
Text that denotes
whether the franchise
rights are operated by a
company or directly by
the franchisee; i.e.
franchisee, franchisor.
Monitor Path:
//Organization
/OrganizationDetail
/FranchiseOperationType
Text@DNBCodeValue
OrderProductResponse. OrderProductResponseDetail. Product. Organization.OrganizationDetail. BoneyardOrganizationIndicator
boolean, Optional [M]
When 'true' indicates
that data on the
company is no longer
collected and was
covered by Hoover's
Editorial staff before
getting acquired or going
out of business. When
'false' indicates that data
on the company is still
collected.
OrderProductResponse. OrderProductResponseDetail. Product. Organization.OrganizationDetail. OperatingStatusComment
Aggregate, Optional(Infinite)
An entry loop which can
repeat multiple times to
allow the recording of
several facts regarding
the subject's trading
status.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 416
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.OrganizationDetail. OperatingStatusComment. OperatingStatusFreeFormComment
string, Optional [M]
Free form text which
records the summary of
the company's trading
status.
End: OrderProductResponse. OrderProductResponseDetail. Product. Organization.OrganizationDetail. OperatingStatusComment
/Aggregate
End: OrderProductResponse. OrderProductResponseDetail. Product. Organization.OrganizationDetail
/Aggregate
OrderProductResponse. OrderProductResponseDetail. Product. Organization.RegisteredDetail
Aggregate, Optional
Records the
constitutional status of a
subject as defined under
the laws of a country
E.g.; Limited Company,
Partnership, co-operative
Society and the Stock
Equity or share structure
employed by a business
according to the legal
form and rules of
incorporation. The
owners of the stock or
shares are the owners of
the business.
OrderProductResponse. OrderProductResponseDetail. Product. Organization.RegisteredDetail. IncorporationYear
integer, Optional [M]
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 417
Name Characteristics
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 @TypeText
string, up to 256 chars,Attribute (1x)
OrderProductResponse. OrderProductResponseDetail. Product. Organization.RegisteredDetail. OrganizationIdentificationNumberDetail.OrganizationIdentificationNumber
string, at least 1 char,up to 40 chars, Required[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
/OrganizationIdentificati
onNumberDetail@DNBC
odeValue
/OrganizationIdentificati
onNumber
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 418
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.RegisteredDetail. OrganizationIdentificationNumberDetail. RegistrationLocation
Aggregate, Optional
Records the address
details where the
Organization
Identification Number is
registered.
OrderProductResponse. OrderProductResponseDetail. Product. Organization.RegisteredDetail. OrganizationIdentificationNumberDetail. RegistrationLocation.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.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 419
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.RegisteredDetail. OrganizationIdentificationNumberDetail. RegistrationLocation.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.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 420
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.RegisteredDetail. OrganizationIdentificationNumberDetail. RegistrationLocation.PrimaryAddress. StreetAddressLine. LineText
string, up to 240 chars,Required [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
/RegisteredDetail
/OrganizationIdentificati
onNumberDetail@DNBC
odeValue
/RegistrationLocation
/PrimaryAddress
OrderProductResponse. OrderProductResponseDetail. Product. Organization.RegisteredDetail. OrganizationIdentificationNumberDetail. RegistrationLocation.PrimaryAddress. StreetAddressLine. DisplaySequence
integer, up to 3 digits,Optional
A number which may be
used to define the order
in which this street
address line should be
presented relative to
other street address lines
where the lower the
number the earlier the
data is presented.
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization.RegisteredDetail. OrganizationIdentificationNumberDetail. RegistrationLocation.PrimaryAddress. StreetAddressLine
/Aggregate
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 421
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.RegisteredDetail. OrganizationIdentificationNumberDetail. RegistrationLocation.PrimaryAddress. PrimaryTownName
string, up to 64 chars,Optional [M+]
The name of the town or
city recognized by the
Postal Authority for
delivering mail.
Monitor Path:
//Organization
/RegisteredDetail
/OrganizationIdentificati
onNumberDetail@DNBC
odeValue
/RegistrationLocation
/PrimaryAddress
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 422
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.RegisteredDetail. OrganizationIdentificationNumberDetail. RegistrationLocation.PrimaryAddress. TerritoryName
string, up to 128 chars,Optional [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
/RegisteredDetail
/OrganizationIdentificati
onNumberDetail@DNBC
odeValue
/RegistrationLocation
/PrimaryAddress
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 423
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.RegisteredDetail. OrganizationIdentificationNumberDetail. RegistrationLocation.PrimaryAddress. PostalCode
string, up to 16 chars,Optional [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
/RegisteredDetail
/OrganizationIdentificati
onNumberDetail@DNBC
odeValue
/RegistrationLocation
/PrimaryAddress
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization.RegisteredDetail. OrganizationIdentificationNumberDetail. RegistrationLocation.PrimaryAddress
/Aggregate
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization.RegisteredDetail. OrganizationIdentificationNumberDetail. RegistrationLocation
/Aggregate
OrderProductResponse. OrderProductResponseDetail. Product. Organization.RegisteredDetail. OrganizationIdentificationNumberDetail. StartDate
date, Optional [M+]
The date when the
Organization Identifier
became current, i.e., was
first used / registered.
Monitor Path:
//Organization
/RegisteredDetail
/OrganizationIdentificati
onNumberDetail@DNBC
odeValue /StartDate
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 424
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.RegisteredDetail. OrganizationIdentificationNumberDetail. FilingOrganizationName
string, up to 256 chars,Optional [M+]
The name of the filing
organization.
Monitor Path:
//Organization
/RegisteredDetail
/OrganizationIdentificati
onNumberDetail@DNBC
odeValue
/FilingOrganizationName
OrderProductResponse. OrderProductResponseDetail. Product. Organization.RegisteredDetail. OrganizationIdentificationNumberDetail. RegistrationIssuerDUNSNumber
string, up to 15 charsPattern: {([0-9a-zA-Z]*)},Optional [M+]
The DUNSNumber of the
authority issuing the
Registration Number.
Monitor Path:
//Organization
/RegisteredDetail
/OrganizationIdentificati
onNumberDetail@DNBC
odeValue
/RegistrationIssuerDUNS
Number
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 425
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.RegisteredDetail. OrganizationIdentificationNumberDetail. RegistrationIssuerName
string, Optional [M+]
The name recording of
the the authority issuing
the Registration Number.
Monitor Path:
//Organization
/RegisteredDetail
/OrganizationIdentificati
onNumberDetail@DNBC
odeValue
/RegistrationIssuerName
OrderProductResponse. OrderProductResponseDetail. Product. Organization.RegisteredDetail. OrganizationIdentificationNumberDetail. DisplaySequence
integer, Optional
This indicates the best
FEIN by Hierarchical logic.
OrderProductResponse. OrderProductResponseDetail. Product. Organization.RegisteredDetail. OrganizationIdentificationNumberDetail. AssignmentMethodText
string, up to 128 chars,Optional [M+]
Text which indicates if
the inquiry DUNS was
assigned based on a
direct source such as an
Agency or if assigned
based on the branch
process which utilizes
the HQ linkage to assign
the HQ FEIN to each
Branch.
Monitor Path:
//Organization
/RegisteredDetail
/OrganizationIdentificati
onNumberDetail@DNBC
odeValue
/AssignmentMethodText
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization.RegisteredDetail. OrganizationIdentificationNumberDetail
/Aggregate
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 426
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.RegisteredDetail. LegalFormDetails
Aggregate, Optional
Records the details on
the current legal form of
a subject.
OrderProductResponse. OrderProductResponseDetail. Product. Organization.RegisteredDetail. LegalFormDetails. LegalFormText
string, up to 256 chars,Required [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 4
Monitor Path:
//Organization
/RegisteredDetail
/LegalFormDetails
/LegalFormText@DNBCo
deValue
OrderProductResponse. OrderProductResponseDetail. Product. Organization.RegisteredDetail. LegalFormDetails. LegalFormText @DNBCodeValue
integer, up to 7 digits,Attribute (1x)
Possible values: Code
Table 4
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization.RegisteredDetail. LegalFormDetails
/Aggregate
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 427
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.RegisteredDetail. StockExchangeDetails
Aggregate, Optional(Infinite)
An entry loop which can
repeat multiple times to
allow the recording of
any Stock Exchanges on
which the subject's
shares are traded.
OrderProductResponse. OrderProductResponseDetail. Product. Organization.RegisteredDetail. StockExchangeDetails. StockExchangeName
string, up to 256 chars,Optional [M+]
The name of a Stock
Exchange on which the
subject's shares are
traded.
Monitor Path:
//Organization
/RegisteredDetail
/StockExchangeDetails
OrderProductResponse. OrderProductResponseDetail. Product. Organization.RegisteredDetail. StockExchangeDetails. StockExchangeName @DNBCodeValue
integer, up to 7 digits,Attribute (1x)
OrderProductResponse. OrderProductResponseDetail. Product. Organization.RegisteredDetail. StockExchangeDetails. StockExchangeTickerName
string, up to 100 chars,Optional [M+]
Text by which this
subject is identified at
this Stock Exchange for
share trading purposes,
e.g., DNB.
Monitor Path:
//Organization
/RegisteredDetail
/StockExchangeDetails
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 428
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.RegisteredDetail. StockExchangeDetails. PrimaryStockExchangeIndicator
boolean, Optional [M+]
When 'true' indicates
that this is the most
important stock
exchange among all the
stock exchanges where
this subject's shares are
traded. When 'false'
indicates that this is not
the most important stock
exchange among all the
stock exchanges where
this subject's shares are
traded, however as this is
the assumed condition
there is no requirement
to create this tag to
represent this fact.
Monitor Path:
//Organization
/RegisteredDetail
/StockExchangeDetails
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 429
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.RegisteredDetail. StockExchangeDetails. CountryISOAlpha2Code
string, at least 2 chars,up to 2 chars, Optional[M+]
The two-letter country
code, defined in the ISO
3166-1 scheme published
by International
Organization for
Standardization (ISO),
identifying the country
for this stock exchange.
Monitor Path:
//Organization
/RegisteredDetail
/StockExchangeDetails
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization.RegisteredDetail. StockExchangeDetails
/Aggregate
OrderProductResponse. OrderProductResponseDetail. Product. Organization.RegisteredDetail. ShareCapitalDetails
Aggregate, Optional(Infinite)
An entry loop which can
repeat multiple times to
allow the recording of
the current Capital
information.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 430
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.RegisteredDetail. ShareCapitalDetails. CapitalAmount
decimal, Optional [M+]
The amount of the
capital of this type. If
figure is stored locally
with 000s omitted then
this must be multiplied
and the full figure
populated to the record,
e.g., If Capital is 543 with
000s omitted then the
figure of 543000 should
be populated.
Monitor Path:
//Organization
/RegisteredDetail
/ShareCapitalDetails@D
NBCodeValue
OrderProductResponse. OrderProductResponseDetail. Product. Organization.RegisteredDetail. ShareCapitalDetails. CapitalAmount @UnitOfSize
string, up to 12 chars,Attribute (1x)
OrderProductResponse. OrderProductResponseDetail. Product. Organization.RegisteredDetail. ShareCapitalDetails. CapitalAmount @CurrencyISOAlpha3Code
string, up to 3 chars,Attribute (1x)
OrderProductResponse. OrderProductResponseDetail. Product. Organization.RegisteredDetail. ShareCapitalDetails. CapitalAmount @ReliabilityText
string, up to 256 chars,Attribute (1x)
OrderProductResponse. OrderProductResponseDetail. Product. Organization.RegisteredDetail. ShareCapitalDetails. StartDate
date, Optional [M+]
The date on which the
Capital Amount was first
registered.
Monitor Path:
//Organization
/RegisteredDetail
/ShareCapitalDetails@D
NBCodeValue
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization.RegisteredDetail. ShareCapitalDetails
/Aggregate
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization.RegisteredDetail
/Aggregate
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 431
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization. IndustryCode Aggregate, Optional
Records the business
activities in which an
organization is actively
engaged using
standardized coding
schemes such as
European NACE and U.S.
Standard Industry
Classifications (SIC).
Examples of business
activities are: commercial
printing, legal services,
drug store, sheet
metalwork fabricator.
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 @DNBCodeValue
integer, up to 7 digits,Attribute (1x)
OrderProductResponse. OrderProductResponseDetail. Product. Organization. IndustryCode.IndustryCode @TypeText
string, up to 256 chars,Attribute (1x)
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 432
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization. IndustryCode.IndustryCode. IndustryCode
string, up to 16 chars,Required [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@DNBCod
eValue
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 433
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization. IndustryCode.IndustryCode. IndustryCodeDescription
string, up to 256 chars,Optional (Infinite) [M+]
Text that describes the
business activity based
on the scheme specified
by the attribute typeText.
E.g., 'highway and street
construction' is the
description of industry
code 1611 in the U.S. SIC
(Standard Industrial
Classification) system.
Monitor Path:
//Organization
/IndustryCode
/IndustryCode@DNBCod
eValue
OrderProductResponse. OrderProductResponseDetail. Product. Organization. IndustryCode.IndustryCode. IndustryCodeDescription @LanguageCode
integer, up to 3 digits,Attribute (1x)
OrderProductResponse. OrderProductResponseDetail. Product. Organization. IndustryCode.IndustryCode. IndustryCodeDescription @WritingScriptISOAlpha4Code
string, Attribute (1x)
OrderProductResponse. OrderProductResponseDetail. Product. Organization. IndustryCode.IndustryCode. DisplaySequence
integer, up to 3 digits,Optional
A number which may be
used to define the order
in which this industry
code should be presented
relative to other industry
codes of the same type
where the lower the
number the earlier the
data is presented.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 434
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization. IndustryCode.IndustryCode. SalesPercentage
decimal, up to 8 digits,maximum of 2 decimalplaces, Optional [M+]
The value of annual sales
which are attributable to
the operations defined by
Industry Code Number as
a percentage of total
annual sales.
Monitor Path:
//Organization
/IndustryCode
/IndustryCode@DNBCod
eValue
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization.IndustryCode. IndustryCode
/Aggregate
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization.IndustryCode
/Aggregate
OrderProductResponse. OrderProductResponseDetail. Product. Organization.ActivitiesAndOperations
Aggregate, Optional
Records the description
of operations continued
by a business including
market information such
as the number of
customers, agency
details and
import/export details.
OrderProductResponse. OrderProductResponseDetail. Product. Organization.ActivitiesAndOperations. OperationsText
string, Optional (Infinite)[M]
Text that describes
detailed information
regarding a business
operation.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 435
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.ActivitiesAndOperations. LineOfBusinessDetails
Aggregate, Optional(Infinite)
An entry loop which can
repeat multiple times to
allow the recording of
several different
descriptions of
operations continued by
a business in different
languages.
OrderProductResponse. OrderProductResponseDetail. Product. Organization.ActivitiesAndOperations. LineOfBusinessDetails. LineOfBusinessDescription
string, up to 3000 chars,Optional [M+]
Records the textual
description of operations
continued by a business.
Monitor Path:
//Organization
/ActivitiesAndOperations
/LineOfBusinessDetails
OrderProductResponse. OrderProductResponseDetail. Product. Organization.ActivitiesAndOperations. LineOfBusinessDetails. LineOfBusinessDescription@LanguageCode
integer, up to 3 digits,Attribute (1x)
OrderProductResponse. OrderProductResponseDetail. Product. Organization.ActivitiesAndOperations. LineOfBusinessDetails. LineOfBusinessDescription@WritingScriptISOAlpha4Code
string, Attribute (1x)
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization.ActivitiesAndOperations. LineOfBusinessDetails
/Aggregate
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 436
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.ActivitiesAndOperations. ImportDetails
Aggregate, Optional
Records the details of
several different
countries or
international regions
from which the subject
imports, and the
percentage of the
subject’s annual
purchases that are made
in each of those
locations.
OrderProductResponse. OrderProductResponseDetail. Product. Organization.ActivitiesAndOperations. ImportDetails. ImportIndicator
boolean, Optional [M]
When 'true' indicates
that the subject
company imports a
quantity of goods from
other countries.
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization.ActivitiesAndOperations. ImportDetails
/Aggregate
OrderProductResponse. OrderProductResponseDetail. Product. Organization.ActivitiesAndOperations. ExportDetails
Aggregate, Optional
Records the details of
several different
countries or
international regions to
which the subject
exports, and the
percentage of the
subject’s annual sales
that are made in each of
those locations.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 437
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.ActivitiesAndOperations. ExportDetails. ExportIndicator
boolean, Optional [M]
When 'true' indicates
that the subject
company exports a
quantity of goods to
other countries.
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization.ActivitiesAndOperations. ExportDetails
/Aggregate
OrderProductResponse. OrderProductResponseDetail. Product. Organization.ActivitiesAndOperations. SubjectIsAgentDetails
Aggregate, Optional
Record the various details
of the subject acts as an
agent to promote goods
or services.
OrderProductResponse. OrderProductResponseDetail. Product. Organization.ActivitiesAndOperations. SubjectIsAgentDetails. AgentIndicator
boolean, Optional [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.
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization.ActivitiesAndOperations. SubjectIsAgentDetails
/Aggregate
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 438
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.ActivitiesAndOperations. PrimarySICCategoryValue
string, up to 1 char,Optional [M]
Possible values: A
[Agriculture; Forestry and
Fishing]; B [Mining]; C
[Construction]; D
[Manufacturing]; E
[Transportation;
Communications;
Electric; Gas and Sanitary
Services]; F [Wholesale
Trade]; G [Retail Sale]; H
[Finance; Insurance; and
Real Estate]; I [Services]; J
[Public Administration]
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization.ActivitiesAndOperations
/Aggregate
OrderProductResponse. OrderProductResponseDetail. Product. Organization.EmployeeFigures
Aggregate, Optional
Records information
about the number of
people engaged by an
organization to perform
its business
operations.Several
different Employee
Figures for a subject
could be recorded, e.g.,
consolidated, individual
entity, headquarters
only. A further
breakdown of employee
figures is recorded based
on employment basis
(e.g., full time, part time,
contract) and/or
employee category (e.g.,
clerical, management,
marketing, sales, blue
collar).
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 439
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.EmployeeFigures. IndividualEntityEmployeeDetails
Aggregate, Optional
Records current
employee data to the
individual entity. If the
organization is classified
by D&B as a business"
OrderProductResponse. OrderProductResponseDetail. Product. Organization.EmployeeFigures. IndividualEntityEmployeeDetails. EmployeeFiguresDate
date, Optional [M]
The date for which the
employee figure was
reported by the
organization.
OrderProductResponse. OrderProductResponseDetail. Product. Organization.EmployeeFigures. IndividualEntityEmployeeDetails. TotalEmployeeQuantity
long, Optional [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 [M+]
Text that describes the
integrity of the employee
figures, e.g. audited,
actual, estimated,
modeled.
Monitor Path:
//Organization
/EmployeeFigures
/IndividualEntityEmploye
eDetails
/ReliabilityText@DNBCod
eValue
OrderProductResponse. OrderProductResponseDetail. Product. Organization.EmployeeFigures. IndividualEntityEmployeeDetails. ReliabilityText @DNBCodeValue
integer, up to 7 digits,Attribute (1x)
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 440
Name Characteristics
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization.EmployeeFigures. IndividualEntityEmployeeDetails
/Aggregate
OrderProductResponse. OrderProductResponseDetail. Product. Organization.EmployeeFigures. IndividualEntityEmployeeDetailsHistory
Aggregate, Optional(Infinite)
Records current
employee data to the
individual entity. If the
organization is classified
by D&B as a business"
OrderProductResponse. OrderProductResponseDetail. Product. Organization.EmployeeFigures. IndividualEntityEmployeeDetailsHistory. EmployeeFiguresDate
date, Optional [M]
The date for which the
employee figure was
reported by the
organization.
OrderProductResponse. OrderProductResponseDetail. Product. Organization.EmployeeFigures. IndividualEntityEmployeeDetailsHistory. TotalEmployeeQuantity
long, Optional [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. IndividualEntityEmployeeDetailsHistory. ReliabilityText
string, up to 256 chars,Optional [M+]
Text that describes the
integrity of the employee
figures, e.g. audited,
actual, estimated,
modeled.
Monitor Path:
//Organization
/EmployeeFigures
/IndividualEntityEmploye
eDetailsHistory
/ReliabilityText@DNBCod
eValue
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 441
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.EmployeeFigures. IndividualEntityEmployeeDetailsHistory. ReliabilityText @DNBCodeValue
integer, up to 7 digits,Attribute (1x)
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization.EmployeeFigures. IndividualEntityEmployeeDetailsHistory
/Aggregate
OrderProductResponse. OrderProductResponseDetail. Product. Organization.EmployeeFigures. ConsolidatedEmployeeDetails
Aggregate, Optional
Records current
employee data which
includes all employees
who are engaged in the
operations of the legal
entity (including
employees located at
branch locations) as well
as all employees who are
engaged in the
operations of every direct
descendant in its family
tree (based on controlling
interest). I.e.
Subsidiaries. Note: An
organization which is
classified by D&B as a
branch" location cannot
have an "Consolidated"
employee figure."
OrderProductResponse. OrderProductResponseDetail. Product. Organization.EmployeeFigures. ConsolidatedEmployeeDetails. EmployeeFiguresDate
date, Optional [M]
The date for which the
employee figure was
reported by the
organization.
OrderProductResponse. OrderProductResponseDetail. Product. Organization.EmployeeFigures. ConsolidatedEmployeeDetails. TotalEmployeeQuantity
long, Optional [M]
A number that defines
how many people are
directly engaged and paid
by the organization to
perform or support its
business operations.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 442
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.EmployeeFigures. ConsolidatedEmployeeDetails. ReliabilityText
string, up to 256 chars,Optional [M+]
Text that describes the
integrity of the employee
figures, e.g. audited,
actual, estimated,
modeled.
Monitor Path:
//Organization
/EmployeeFigures
/ConsolidatedEmployeeD
etails
/ReliabilityText@DNBCod
eValue
OrderProductResponse. OrderProductResponseDetail. Product. Organization.EmployeeFigures. ConsolidatedEmployeeDetails. ReliabilityText @DNBCodeValue
integer, up to 7 digits,Attribute (1x)
OrderProductResponse. OrderProductResponseDetail. Product. Organization.EmployeeFigures. ConsolidatedEmployeeDetails. EmployeeCategoryDetails
Aggregate, Optional(Infinite)
An entry loop which can
repeat multiple times to
allow the recording of
employee figures for the
different function levels
of an organization.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 443
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.EmployeeFigures. ConsolidatedEmployeeDetails. EmployeeCategoryDetails.EmployeeBasisText
string, up to 256 chars,Optional [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
/ConsolidatedEmployeeD
etails
/EmployeeCategoryDetai
ls
/EmployeeBasisText@D
NBCodeValue
OrderProductResponse. OrderProductResponseDetail. Product. Organization.EmployeeFigures. ConsolidatedEmployeeDetail. EmployeeCategoryDetails.EmployeeBasisText @DNBCodeValue
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization.EmployeeFigures. ConsolidatedEmployeeDetails. EmployeeCategoryDetails
/Aggregate
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization.EmployeeFigures. ConsolidatedEmployeeDetails
/Aggregate
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 444
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.EmployeeFigures. ConsolidatedEmployeeDetailsHistory
Aggregate, Optional(Infinite)
Records previous
employee data which
includes all employees
who are engaged in the
operations of the legal
entity (including
employees located at
branch locations) as well
as all employees who are
engaged in the
operations of every direct
descendant in its family
tree (based on controlling
interest). I.e.
Subsidiaries. Note: An
organization which is
classified by D&B as a
branch" location cannot
have an "Consolidated"
employee figure."
OrderProductResponse. OrderProductResponseDetail. Product. Organization.EmployeeFigures. ConsolidatedEmployeeDetailsHistory. EmployeeFiguresDate
date, Optional [M]
The date for which the
employee figure was
reported by the
organization.
OrderProductResponse. OrderProductResponseDetail. Product. Organization.EmployeeFigures. ConsolidatedEmployeeDetailsHistory. TotalEmployeeQuantity
long, Optional [M]
A number that defines
how many people are
directly engaged and paid
by the organization to
perform or support its
business operations.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 445
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.EmployeeFigures. ConsolidatedEmployeeDetailsHistory. ReliabilityText
string, up to 256 chars,Optional [M+]
Text that describes the
integrity of the employee
figures, e.g. audited,
actual, estimated,
modeled.
Monitor Path:
//Organization
/EmployeeFigures
/ConsolidatedEmployeeD
etailsHistory
/ReliabilityText@DNBCod
eValue
OrderProductResponse. OrderProductResponseDetail. Product. Organization.EmployeeFigures. ConsolidatedEmployeeDetailsHistory. ReliabilityText @DNBCodeValue
integer, up to 7 digits,Attribute (1x)
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization.EmployeeFigures. ConsolidatedEmployeeDetailsHistory
/Aggregate
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 446
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.EmployeeFigures. GroupEmployeeDetails
Aggregate, Optional
Records current
employee data of the
entire family up and
down the family tree.
The employee figures
include all employees
who are engaged in the
operations of all
organizations which
make up the entire
family. An organization
which is classified by
D&B as a 'branch'
location cannot have an
employee figure where
the scope code is set to
'Entire Group'. An
organization which is the
global ultimate of a
family should not have
an employee figure
where the scope is set to
'Entire Group'. This scope
should only be recorded
when the subject is a
subsidiary organization.
Note that figures
received with this
information scope do not
meet D&B's standard,
and this should only be
used when the
'consolidated' and
'individual' employee
figures can not be
provided for a subject.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 447
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.EmployeeFigures. GroupEmployeeDetails. TotalEmployeeQuantity
long, Optional
A number that defines
how many people are
directly engaged and paid
by the organization to
perform or support its
business operations.
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization.EmployeeFigures. GroupEmployeeDetails
/Aggregate
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization.EmployeeFigures
/Aggregate
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Linkage Aggregate, Optional
Records the relationship
between the subject and
the next subject UP in
the family tree. E.g. Its
parent, HQ, Joint parent
or shareholder. Also
records names,
addresses and
registration numbers for
the related subject. This
data topic may also be
used to record the details
of the relationship
between the subject and
the business founder;
however if a simple
textual reference to the
business founder is all
that is required then the
'Started By' element in
'Subject Details' should
be used
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 448
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Linkage.LinkageSummary
Aggregate, Optional
Records the indicative or
derived information
about the subject UP and
DOWN in the family tree.
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Linkage.LinkageSummary. GlobalUltimateFamilyTreeLinkageCount
integer, up to 8 digits,Optional [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.
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization. Linkage.LinkageSummary
/Aggregate
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Linkage.GlobalUltimateOrganization
Aggregate, Optional
Records information
about the top most
business in the family
tree, tracing each parent
up to its own parent. For
example, Company A is a
business based in the US
and has company B as its
parent also in the US. In
turn company B is owned
by company C, also in the
US, which is owned by
company D which is in
the UK. Thus the global
ultimate" of this family
tree (and therefore of
each member of the
family tree) is Company
D."
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 449
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Linkage.GlobalUltimateOrganization. DUNSNumber
string, up to 15 charsPattern: {([0-9a-zA-Z]*)},Optional [M]
The D-U-N-S Number is
D&B's identification
number, which provides
unique identification of
this organization, in
accordance with the
Data Universal
Numbering System (D-U-
N-S).
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Linkage.GlobalUltimateOrganization. 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. Linkage.GlobalUltimateOrganization. OrganizationPrimaryName. OrganizationName
string, up to 256 chars,Required [M]
Text recording a name of
this organization in the
specified language
and/or writing script.
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization. Linkage.GlobalUltimateOrganization. OrganizationPrimaryName
/Aggregate
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 450
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Linkage.GlobalUltimateOrganization. CountryISOAlpha2Code
string, at least 2 chars,up to 2 chars, Optional[M]
The two-letter country
code, defined in the ISO
3166-1 scheme published
by International
Organization for
Standardization (ISO)
identifying the country of
the inquired subject.
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Linkage.GlobalUltimateOrganization. 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. Linkage.GlobalUltimateOrganization. PrimaryAddress @LanguageCode
integer, up to 3 digits,Attribute (1x)
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Linkage.GlobalUltimateOrganization. PrimaryAddress @WritingScriptCode
integer, up to 7 digits,Attribute (1x)
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 451
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Linkage.GlobalUltimateOrganization. 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. Linkage.GlobalUltimateOrganization. PrimaryAddress. StreetAddressLine. LineText
string, up to 240 chars,Required [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
/GlobalUltimateOrganiza
tion /PrimaryAddress
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 452
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Linkage.GlobalUltimateOrganization. PrimaryAddress. StreetAddressLine. DisplaySequence
integer, up to 3 digits,Optional
A number which may be
used to define the order
in which this street
address line should be
presented relative to
other street address lines
where the lower the
number the earlier the
data is presented.
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization. Linkage.GlobalUltimateOrganization. PrimaryAddress. StreetAddressLine
/Aggregate
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Linkage.GlobalUltimateOrganization. PrimaryAddress. PrimaryTownName
string, up to 64 chars,Optional [M+]
The name of the town or
city recognized by the
Postal Authority for
delivering mail.
Monitor Path:
//Organization /Linkage
/GlobalUltimateOrganiza
tion /PrimaryAddress
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 453
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Linkage.GlobalUltimateOrganization. PrimaryAddress. CountryISOAlpha2Code
string, at least 2 chars,up to 2 chars, Optional[M+]
The two-letter country
code, defined in the ISO
3166-1 scheme published
by International
Organization for
Standardization (ISO),
identifying the country
for this address.
Monitor Path:
//Organization /Linkage
/GlobalUltimateOrganiza
tion /PrimaryAddress
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Linkage.GlobalUltimateOrganization. PrimaryAddress. TerritoryName
string, up to 128 chars,Optional [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
/GlobalUltimateOrganiza
tion /PrimaryAddress
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 454
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Linkage.GlobalUltimateOrganization. PrimaryAddress. TerritoryAbbreviatedName
string, up to 64 chars,Optional [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
/GlobalUltimateOrganiza
tion /PrimaryAddress
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Linkage.GlobalUltimateOrganization. PrimaryAddress. PostalCode
string, up to 16 chars,Optional [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
/GlobalUltimateOrganiza
tion /PrimaryAddress
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Linkage.GlobalUltimateOrganization. PrimaryAddress. CountryOfficialName
string, up to 64 chars,Optional [M+]
Monitor Path:
//Organization /Linkage
/GlobalUltimateOrganiza
tion /PrimaryAddress
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 455
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Linkage.GlobalUltimateOrganization. PrimaryAddress. PrimaryTownWorldBaseCode
integer, up to 32 digits,Optional [M+]
Monitor Path:
//Organization /Linkage
/GlobalUltimateOrganiza
tion /PrimaryAddress
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Linkage.GlobalUltimateOrganization. PrimaryAddress. CountryWorldBaseCode
integer, up to 3 digits,Optional [M+]
The D&B three digit
WorldBase code value
that identifies country
where the business is
located.
Monitor Path:
//Organization /Linkage
/GlobalUltimateOrganiza
tion /PrimaryAddress
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Linkage.GlobalUltimateOrganization. PrimaryAddress. CountryGroupName
string, up to 64 chars,Optional [M+]
Monitor Path:
//Organization /Linkage
/GlobalUltimateOrganiza
tion /PrimaryAddress
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 456
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Linkage.GlobalUltimateOrganization. PrimaryAddress. CountryFIPSCode
string, up to 4 chars,Optional [M+]
Text that describes the
Federal Information
Processing Standards
(FIPS) code value
assigned by the U.S
Department of
Commerce which
identifies the country
where this subject is
located.
Monitor Path:
//Organization /Linkage
/GlobalUltimateOrganiza
tion /PrimaryAddress
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Linkage.GlobalUltimateOrganization. PrimaryAddress. CountyWorldBaseCode
integer, up to 32 digits,Optional [M+]
Monitor Path:
//Organization /Linkage
/ParentOrganization
/PrimaryAddress
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization. Linkage.GlobalUltimateOrganization. PrimaryAddress
/Aggregate
End: OrderProductResponse. OrderProductResponseDetail. Product. Organization. Linkage.GlobalUltimateOrganization
/Aggregate
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 457
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Linkage.DomesticUltimateOrganization
Aggregate, Optional
Records information
about the last business
in the tree, when
reviewing upwards,
which is in the same
country as the other
subject. For example,
Company A is a business
based in the US and has
company B as its parent
also in the US. In turn
company B is owned by
company C, also in the
US, which is owned by
company D which is in
the UK. Thus the
domestic ultimate" of
Company A is actually
Company C as this is the
last business in the
parent chain which is in
the US"
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Linkage.DomesticUltimateOrganization. DUNSNumber
string, up to 15 charsPattern: {([0-9a-zA-Z]*)},Optional [M]
The D-U-N-S Number is
D&B's identification
number, which provides
unique identification of
this organization, in
accordance with the
Data Universal
Numbering System (D-U-
N-S).
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 458
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Linkage.DomesticUltimateOrganization. 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. Linkage.DomesticUltimateOrganization. OrganizationPrimaryName. OrganizationName
string, up to 256 chars,Required [M]
Text recording a name of
this organization in the
specified language
and/or writing script.
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization. Linkage.DomesticUltimateOrganization. OrganizationPrimaryName
/Aggregate
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Linkage.DomesticUltimateOrganization. CountryISOAlpha2Code
string, at least 2 chars,up to 2 chars, Optional[M]
The two-letter country
code, defined in the ISO
3166-1 scheme published
by International
Organization for
Standardization (ISO)
identifying the country of
the inquired subject.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 459
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Linkage.DomesticUltimateOrganization. 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. Linkage.DomesticUltimateOrganization. PrimaryAddress @LanguageCode
integer, up to 3 digits,Attribute (1x)
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Linkage.DomesticUltimateOrganization. PrimaryAddress @WritingScriptCode
integer, up to 7 digits,Attribute (1x)
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Linkage.DomesticUltimateOrganization. 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.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 460
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Linkage.DomesticUltimateOrganization. PrimaryAddress. StreetAddressLine. LineText
string, up to 240 chars,Required [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
/DomesticUltimateOrga
nization /PrimaryAddress
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Linkage.DomesticUltimateOrganization. PrimaryAddress. StreetAddressLine. DisplaySequence
integer, up to 3 digits,Optional
A number which may be
used to define the order
in which this street
address line should be
presented relative to
other street address lines
where the lower the
number the earlier the
data is presented.
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization. Linkage.DomesticUltimateOrganization. PrimaryAddress. StreetAddressLine
/Aggregate
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 461
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Linkage.DomesticUltimateOrganization. PrimaryAddress. PrimaryTownName
string, up to 64 chars,Optional [M+]
The name of the town or
city recognized by the
Postal Authority for
delivering mail.
Monitor Path:
//Organization /Linkage
/DomesticUltimateOrga
nization /PrimaryAddress
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Linkage.DomesticUltimateOrganization. PrimaryAddress. CountryISOAlpha2Code
string, at least 2 chars,up to 2 chars, Optional[M+]
The two-letter country
code, defined in the ISO
3166-1 scheme published
by International
Organization for
Standardization (ISO),
identifying the country
for this address.
Monitor Path:
//Organization /Linkage
/DomesticUltimateOrga
nization /PrimaryAddress
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 462
Name Characteristics
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 [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
/DomesticUltimateOrga
nization /PrimaryAddress
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 463
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Linkage.DomesticUltimateOrganization. PrimaryAddress. PostalCode
string, up to 16 chars,Optional [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
/DomesticUltimateOrga
nization /PrimaryAddress
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Linkage.DomesticUltimateOrganization. PrimaryAddress. PrimaryTownWorldBaseCode
integer, up to 32 digits,Optional [M+]
Monitor Path:
//Organization /Linkage
/DomesticUltimateOrga
nization /PrimaryAddress
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Linkage.DomesticUltimateOrganization. PrimaryAddress. CountryWorldBaseCode
integer, up to 3 digits,Optional [M+]
The D&B three digit
WorldBase code value
that identifies country
where the business is
located.
Monitor Path:
//Organization /Linkage
/DomesticUltimateOrga
nization /PrimaryAddress
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 464
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Linkage.DomesticUltimateOrganization. PrimaryAddress. CountryFIPSCode
string, up to 4 chars,Optional [M+]
Text that describes the
Federal Information
Processing Standards
(FIPS) code value
assigned by the U.S
Department of
Commerce which
identifies the country
where this subject is
located.
Monitor Path:
//Organization /Linkage
/DomesticUltimateOrga
nization /PrimaryAddress
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization. Linkage.DomesticUltimateOrganization. PrimaryAddress
/Aggregate
End: OrderProductResponse. OrderProductResponseDetail. Product. Organization. Linkage.DomesticUltimateOrganization
/Aggregate
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Linkage.HeadquartersOrganization
Aggregate, Optional
Records information
about the office that
serves as the
administrative center of
an enterprise.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 465
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Linkage.HeadquartersOrganization. DUNSNumber
string, up to 15 charsPattern: {([0-9a-zA-Z]*)},Optional [M]
The D-U-N-S Number is
D&B's identification
number, which provides
unique identification of
this organization, in
accordance with the
Data Universal
Numbering System (D-U-
N-S).
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Linkage.HeadquartersOrganization. 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. Linkage.HeadquartersOrganization. OrganizationPrimaryName. OrganizationName
string, up to 256 chars,Required [M]
Text recording a name of
this organization in the
specified language
and/or writing script.
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization. Linkage.HeadquartersOrganization. OrganizationPrimaryName
/Aggregate
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 466
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Linkage.HeadquartersOrganization. CountryISOAlpha2Code
string, at least 2 chars,up to 2 chars, Optional[M]
The two-letter country
code, defined in the ISO
3166-1 scheme published
by International
Organization for
Standardization (ISO)
identifying the country of
the inquired subject.
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Linkage.HeadquartersOrganization. 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. Linkage.HeadquartersOrganization. PrimaryAddress @LanguageCode
integer, up to 3 digits,Attribute (1x)
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Linkage.HeadquartersOrganization. PrimaryAddress @WritingScriptCode
integer, up to 7 digits,Attribute (1x)
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 467
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Linkage.HeadquartersOrganization. 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. Linkage.HeadquartersOrganization. PrimaryAddress. StreetAddressLine. LineText
string, up to 240 chars,Required [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
/HeadquartersOrganizati
on /PrimaryAddress
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 468
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Linkage.HeadquartersOrganization. PrimaryAddress. StreetAddressLine. DisplaySequence
integer, up to 3 digits,Optional
A number which may be
used to define the order
in which this street
address line should be
presented relative to
other street address lines
where the lower the
number the earlier the
data is presented.
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization. Linkage.HeadquartersOrganization. PrimaryAddress. StreetAddressLine
/Aggregate
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Linkage.HeadquartersOrganization. PrimaryAddress. PrimaryTownName
string, up to 64 chars,Optional [M+]
The name of the town or
city recognized by the
Postal Authority for
delivering mail.
Monitor Path:
//Organization /Linkage
/HeadquartersOrganizati
on /PrimaryAddress
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 469
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Linkage.HeadquartersOrganization. PrimaryAddress. CountryISOAlpha2Code
string, at least 2 chars,up to 2 chars, Optional[M+]
The two-letter country
code, defined in the ISO
3166-1 scheme published
by International
Organization for
Standardization (ISO),
identifying the country
for this address.
Monitor Path:
//Organization /Linkage
/HeadquartersOrganizati
on /PrimaryAddress
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Linkage.HeadquartersOrganization. PrimaryAddress. TerritoryName
string, up to 128 chars,Optional [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
/HeadquartersOrganizati
on /PrimaryAddress
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 470
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Linkage.HeadquartersOrganization. PrimaryAddress. TerritoryAbbreviatedName
string, up to 64 chars,Optional [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
/HeadquartersOrganizati
on /PrimaryAddress
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Linkage.HeadquartersOrganization. PrimaryAddress. PostalCode
string, up to 16 chars,Optional [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
/HeadquartersOrganizati
on /PrimaryAddress
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Linkage.HeadquartersOrganization. PrimaryAddress. CountryOfficialName
string, up to 64 chars,Optional [M+]
Monitor Path:
//Organization /Linkage
/HeadquartersOrganizati
on /PrimaryAddress
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 471
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Linkage.HeadquartersOrganization. PrimaryAddress. PrimaryTownWorldBaseCode
integer, up to 32 digits,Optional [M+]
Monitor Path:
//Organization /Linkage
/HeadquartersOrganizati
on /PrimaryAddress
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Linkage.HeadquartersOrganization. PrimaryAddress. CountryWorldBaseCode
integer, up to 3 digits,Optional [M+]
The D&B three digit
WorldBase code value
that identifies country
where the business is
located.
Monitor Path:
//Organization /Linkage
/HeadquartersOrganizati
on /PrimaryAddress
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Linkage.HeadquartersOrganization. PrimaryAddress. CountryGroupName
string, up to 64 chars,Optional [M+]
Monitor Path:
//Organization /Linkage
/HeadquartersOrganizati
on /PrimaryAddress
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 472
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Linkage.HeadquartersOrganization. PrimaryAddress. CountryFIPSCode
string, up to 4 chars,Optional [M+]
Text that describes the
Federal Information
Processing Standards
(FIPS) code value
assigned by the U.S
Department of
Commerce which
identifies the country
where this subject is
located.
Monitor Path:
//Organization /Linkage
/HeadquartersOrganizati
on /PrimaryAddress
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Linkage.HeadquartersOrganization. PrimaryAddress. CountyWorldbaseCode
integer, up to 32 digits,Optional
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization. Linkage.HeadquartersOrganization. PrimaryAddress
/Aggregate
End: OrderProductResponse. OrderProductResponseDetail. Product. Organization. Linkage.HeadquartersOrganization
/Aggregate
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Linkage.ParentOrganization
Aggregate, Optional
Records information
about the organization
which owns more than
50% of the subject and
the organization at the
very top of the legal
family.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 473
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Linkage.ParentOrganization. DUNSNumber
string, up to 15 charsPattern: {([0-9a-zA-Z]*)},Optional [M]
The D-U-N-S Number is
D&B's identification
number, which provides
unique identification of
this organization, in
accordance with the
Data Universal
Numbering System (D-U-
N-S).
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Linkage.ParentOrganization. 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. Linkage.ParentOrganization. OrganizationPrimaryName. OrganizationName
string, up to 256 chars,Required [M]
Text recording a name of
this organization in the
specified language
and/or writing script.
End: OrderProductResponse. OrderProductResponseDetail. Product. Organization. Linkage.ParentOrganization. OrganizationPrimaryName
/Aggregate
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 474
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Linkage.ParentOrganization. CountryISOAlpha2Code
string, at least 2 chars,up to 2 chars, Optional[M]
The two-letter country
code, defined in the ISO
3166-1 scheme published
by International
Organization for
Standardization (ISO)
identifying the country of
the inquired subject.
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Linkage.ParentOrganization. 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. Linkage.ParentOrganization. PrimaryAddress @LanguageCode
integer, up to 3 digits,Attribute (1x)
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Linkage.ParentOrganization. PrimaryAddress @WritingScriptCode
integer, up to 7 digits,Attribute (1x)
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 475
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Linkage.ParentOrganization. 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. Linkage.ParentOrganization. PrimaryAddress. StreetAddressLine. LineText
string, up to 240 chars,Required [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
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 476
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Linkage.ParentOrganization. PrimaryAddress. StreetAddressLine. DisplaySequence
integer, up to 3 digits,Optional
A number which may be
used to define the order
in which this street
address line should be
presented relative to
other street address lines
where the lower the
number the earlier the
data is presented.
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization. Linkage.ParentOrganization. PrimaryAddress. StreetAddressLine
/Aggregate
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Linkage.ParentOrganization. PrimaryAddress. PrimaryTownName
string, up to 64 chars,Optional [M+]
The name of the town or
city recognized by the
Postal Authority for
delivering mail.
Monitor Path:
//Organization /Linkage
/ParentOrganization
/PrimaryAddress
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 477
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Linkage.ParentOrganization. PrimaryAddress. CountryISOAlpha2Code
string, at least 2 chars,up to 2 chars, Optional[M+]
The two-letter country
code, defined in the ISO
3166-1 scheme published
by International
Organization for
Standardization (ISO),
identifying the country
for this address.
Monitor Path:
//Organization /Linkage
/ParentOrganization
/PrimaryAddress
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Linkage.ParentOrganization. PrimaryAddress. TerritoryName
string, up to 128 chars,Optional [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
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 478
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Linkage.ParentOrganization. PrimaryAddress. TerritoryAbbreviatedName
string, up to 64 chars,Optional [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 [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 [M+]
Monitor Path:
//Organization /Linkage
/ParentOrganization
/PrimaryAddress
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 479
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Linkage.ParentOrganization. PrimaryAddress. PrimaryTownWorldBaseCode
integer, up to 32 digits,Optional [M+]
Monitor Path:
//Organization /Linkage
/ParentOrganization
/PrimaryAddress
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Linkage.ParentOrganization. PrimaryAddress. CountryWorldBaseCode
integer, up to 3 digits,Optional [M+]
The D&B three digit
WorldBase code value
that identifies country
where the business is
located.
Monitor Path:
//Organization /Linkage
/GlobalUltimateOrganiza
tion /PrimaryAddress
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Linkage.ParentOrganization. PrimaryAddress. CountryGroupName
string, up to 64 chars,Optional [M+]
Monitor Path:
//Organization /Linkage
/ParentOrganization
/PrimaryAddress
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 480
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Linkage.ParentOrganization. PrimaryAddress. CountryFIPSCode
string, up to 4 chars,Optional [M+]
Text that describes the
Federal Information
Processing Standards
(FIPS) code value
assigned by the U.S
Department of
Commerce which
identifies the country
where this subject is
located.
Monitor Path:
//Organization /Linkage
/ParentOrganization
/PrimaryAddress
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Linkage.ParentOrganization. PrimaryAddress. CountyWorldbaseCode
integer, up to 32 digits,Optional
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization. Linkage.ParentOrganization. PrimaryAddress
/Aggregate
End: OrderProductResponse. OrderProductResponseDetail. Product. Organization. Linkage.ParentOrganization
/Aggregate
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Linkage.FamilyTreeHierarchyLevel
integer, up to 2 digits,Optional [M]
End: OrderProductResponse. OrderProductResponseDetail. Product. Organization. Linkage /Aggregate
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 481
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Assessment Aggregate, Optional
Records insightful and
value added information
on organizations, such
as: - recommendations
on how much credit to
extend to them, -
assessments of their
liquidity, - concise
evaluations of their
performance and
behavior, - predictions on
the risk of conducting
business with them. The
predictive scores are
usually calculated and
assigned by D&B, but
such assessments may
also be recorded when
assigned by third parties.
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Assessment.HistoryRatingText
string, up to 256 chars,Optional [M+]
Text that specifies if
D&B has any
information that may
reflect unfavorably on
this organization, e.g.,
clear, incomplete,
management, business.
Monitor Path:
//Organization
/Assessment
/HistoryRatingText@DN
BCodeValue
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Assessment.HistoryRatingText @DNBCodeValue
integer, up to 7 digits,Attribute (1x)
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 482
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Assessment.CommercialCreditScore
Aggregate, Optional(Infinite)
An entry loop that
repeats multiple times to
allow the recording of
the most recent risk
scores that are assigned
to this organization on a
given date/time using a
scoring model that help
predict the likelihood that
the organization will pay
its bills in a severely
delinquent manner (90+
days past due) over the
next 12 months.
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Assessment.CommercialCreditScore. MarketingRiskClassText
string, up to 256 chars,Optional [M+]
Possible values: Low;
Moderate; High
Monitor Path:
//Organization
/Assessment
/CommercialCreditScore
/MarketingRiskClassText
@DNBCodeValue
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Assessment.CommercialCreditScore. MarketingRiskClassText @DNBCodeValue Possible values: 10925
[Low]; 10926 [Moderate];
10927 [High]
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization.Assessment. CommercialCreditScore
/Aggregate
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Assessment.MarketingSegmentationClusterValue
integer, up to 2 digits,Optional [M]
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Assessment.USPatriotActComplianceRiskScore
Aggregate, Optional
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Assessment.USPatriotActComplianceRiskScore. ComplianceRiskClassIndex
string, up to 64 chars,Optional [M]
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 483
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Assessment.USPatriotActComplianceRiskScore. ComplianceRiskIndex
integer, up to 3 digits,Optional [M]
The compliance risk
index is intended to
provide organisations
subject to the USA
Patriot Act with an
additional tool in
performing compliance
risk based assessment of
trading partners. The
Index is a numeric value
that represents an
aggregation of weighted
risk flags, assigned
through a proprietary
rules based algorithm.
Values range form 0 to
~255. Higher Index values
represent a higher
perceived level of risk.
End: OrderProductResponse. OrderProductResponseDetail. Product. Organization.Assessment. USPatriotActComplianceRiskScore
/Aggregate
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Assessment.ProofOfRightCount
integer, Optional [M]
End: OrderProductResponse. OrderProductResponseDetail. Product. Organization.Assessment
/Aggregate
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 484
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.BusinessTrading
Aggregate, Optional
Records references or
opinions in terms of the
timeliness of payment,
the amounts of the
transactions and the
terms of sale applied to
the transactions and
summarized views of
this data that involves
the subject either as a
buyer or supplier of
goods or services.
OrderProductResponse. OrderProductResponseDetail. Product. Organization.BusinessTrading. Purchaser
Aggregate, Optional
Records trade data
where the subject is a
purchaser of good or
services.
OrderProductResponse. OrderProductResponseDetail. Product. Organization.BusinessTrading. Purchaser. CurrentPaydexScore
Aggregate, Optional
Records subject's current
Paydex Score. A
calculated element
summarizing the
payment habits of a
subject based on trade
experiences obtained
from its suppliers.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 485
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.BusinessTrading. Purchaser. CurrentPaydexScore. TwentyFourMonthsPaydex
Aggregate, Optional (Upto 2x)
An entry loop which can
repeat to allow the
recording of the numeric
value assigned to an
organization by a D&B
algorithm, assessing the
organization's ability to
meet future obligations
of a particular monetary
range based on the
twenty four most recent
months of trade
experiences as of the
current month, from
different sources.
OrderProductResponse. OrderProductResponseDetail. Product. Organization.BusinessTrading. Purchaser. CurrentPaydexScore. TwentyFourMonthsPaydex. PaydexScore
integer, up to 3 digits,Required
A calculated element
summarizing the
payment habits of a
subject based on trade
experiences obtained
from its suppliers over
the last 3 months.
OrderProductResponse. OrderProductResponseDetail. Product. Organization.BusinessTrading. Purchaser. CurrentPaydexScore. TwentyFourMonthsPaydex.TotalPaymentExperiencesUsedCount
long, Optional
The number of payment
experiences that
contributed to this
payment index score. As
an example, the score
may have been derived
from 18 payment
experiences from various
suppliers.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 486
Name Characteristics
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization.BusinessTrading. Purchaser. CurrentPaydexScore. TwentyFourMonthsPaydex
/Aggregate
OrderProductResponse. OrderProductResponseDetail. Product. Organization.BusinessTrading. Purchaser. CurrentPaydexScore. GlobalPaydex
Aggregate, Optional (Upto 2x)
An entry loop which can
repeat to allow the
recording of the numeric
value assigned to an
organization by a D&B
algorithm, assessing the
organization's ability to
meet future obligations
of a particular monetary
range based on the trade
experiences during a
time period that cannot
be specified.
OrderProductResponse. OrderProductResponseDetail. Product. Organization.BusinessTrading. Purchaser. CurrentPaydexScore. GlobalPaydex. PaydexDate
date, Optional
The date marking the
end of the time period
covered by the payment
performance score.
OrderProductResponse. OrderProductResponseDetail. Product. Organization.BusinessTrading. Purchaser. CurrentPaydexScore. GlobalPaydex. PaydexScore
integer, up to 3 digits,Required
A calculated element
summarizing the
payment habits of a
subject based on trade
experiences obtained
from its suppliers over
the last 3 months.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 487
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.BusinessTrading. Purchaser. CurrentPaydexScore. GlobalPaydex.TotalPaymentExperiencesUsedCount
long, Optional
The number of payment
experiences that
contributed to this
payment index score. As
an example, the score
may have been derived
from 18 payment
experiences from various
suppliers.
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization.BusinessTrading. Purchaser. CurrentPaydexScore. GlobalPaydex
/Aggregate
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization.BusinessTrading. Purchaser. CurrentPaydexScore
/Aggregate
OrderProductResponse. OrderProductResponseDetail. Product. Organization.BusinessTrading. Purchaser. PurchaserDerivedData
Aggregate, Optional(Infinite)
An entry loop which can
repeat multiple times to
allow the recording of
the payment-based
derived data that has
been summarized for a
purchaser. Each
occurrence of this
aggregate represents a
single derived data
element and its value.
OrderProductResponse. OrderProductResponseDetail. Product. Organization.BusinessTrading. Purchaser. PurchaserDerivedData.TwentyFourMonthsDataCoveragePayments
Aggregate, Optional
Records the details of the
data required to calculate
the derived value
considering twenty four
months data.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 488
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.BusinessTrading. Purchaser. PurchaserDerivedData.TwentyFourMonthsDataCoveragePayments. PaymentPeriodSummary
Aggregate, Optional(Infinite)
An entry loop which can
repeat to allow the
recording of the results
of summarizing the
payments made by the
subjects.
OrderProductResponse. OrderProductResponseDetail. Product. Organization.BusinessTrading. Purchaser. PurchaserDerivedData.TwentyFourMonthsDataCoveragePayments. PaymentPeriodSummary.PaymentsWithHighCredit
Aggregate, Optional
Records the details of the
highest amount from
each of a subject’s
accounts that was
extended to it on the
expectation of payment
within the agreed upon
terms.
OrderProductResponse. OrderProductResponseDetail. Product. Organization.BusinessTrading. Purchaser. PurchaserDerivedData.TwentyFourMonthsDataCoveragePayments. PaymentPeriodSummary.PaymentsWithHighCredit. HighCreditMaximumAmount
decimal, Optional
The greatest monetary
figure owed to the
supplier by the subject
over the period of time
specified by the
Summary Period.
OrderProductResponse. OrderProductResponseDetail. Product. Organization.BusinessTrading. Purchaser. PurchaserDerivedData.TwentyFourMonthsDataCoveragePayments. PaymentPeriodSummary.PaymentsWithHighCredit. AverageHighCreditAmount
decimal, Optional
A monetary figure
specifying the average
high credit is determined
by dividing the total dollar
amount by the number
of experiences in file for
the last 12 months.
End: OrderProductResponse. OrderProductResponseDetail. Product. Organization.BusinessTrading. Purchaser. PurchaserDerivedData.TwentyFourMonthsDataCoveragePayments. PaymentPeriodSummary.PaymentsWithHighCredit
/Aggregate
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 489
Name Characteristics
End: OrderProductResponse. OrderProductResponseDetail. Product. Organization.BusinessTrading. Purchaser. PurchaserDerivedData.TwentyFourMonthsDataCoveragePayments. PaymentPeriodSummary
/Aggregate
End: OrderProductResponse. OrderProductResponseDetail. Product. Organization.BusinessTrading. Purchaser. PurchaserDerivedData.TwentyFourMonthsDataCoveragePayments
/Aggregate
OrderProductResponse. OrderProductResponseDetail. Product. Organization.BusinessTrading. Purchaser. PurchaserDerivedData. GlobalDataCoveragePayments
Aggregate, Optional
Records the details of the
data required to calculate
the derived value
without considering the
period.
OrderProductResponse. OrderProductResponseDetail. Product. Organization.BusinessTrading. Purchaser. PurchaserDerivedData. GlobalDataCoveragePayments.PaymentPeriodSummary
Aggregate, Optional(Infinite)
An entry loop which can
repeat to allow the
recording of the results
of summarizing the
payments made by the
subjects.
OrderProductResponse. OrderProductResponseDetail. Product. Organization.BusinessTrading. Purchaser. PurchaserDerivedData. GlobalDataCoveragePayments.PaymentPeriodSummary. PaymentsWithHighCredit
Aggregate, Optional
Records the details of the
highest amount from
each of a subject’s
accounts that was
extended to it on the
expectation of payment
within the agreed upon
terms.
OrderProductResponse. OrderProductResponseDetail. Product. Organization.BusinessTrading. Purchaser. PurchaserDerivedData. GlobalDataCoveragePayments.PaymentPeriodSummary. PaymentsWithHighCredit. HighCreditMaximumAmount
decimal, Optional
The greatest monetary
figure owed to the
supplier by the subject
over the period of time
specified by the
Summary Period.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 490
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.BusinessTrading. Purchaser. PurchaserDerivedData. GlobalDataCoveragePayments.PaymentPeriodSummary. PaymentsWithHighCredit. AverageHighCreditAmount
decimal, Optional
A monetary figure
specifying the average
high credit is determined
by dividing the total dollar
amount by the number
of experiences in file for
the last 12 months.
End: OrderProductResponse. OrderProductResponseDetail. Product. Organization.BusinessTrading. Purchaser. PurchaserDerivedData. GlobalDataCoveragePayments.PaymentPeriodSummary. PaymentsWithHighCredit
/Aggregate
End: OrderProductResponse. OrderProductResponseDetail. Product. Organization.BusinessTrading. Purchaser. PurchaserDerivedData. GlobalDataCoveragePayments.PaymentPeriodSummary
/Aggregate
End: OrderProductResponse. OrderProductResponseDetail. Product. Organization.BusinessTrading. Purchaser. PurchaserDerivedData. GlobalDataCoveragePayments
/Aggregate
End: OrderProductResponse. OrderProductResponseDetail. Product. Organization.BusinessTrading. Purchaser. PurchaserDerivedData
/Aggregate
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization.BusinessTrading. Purchaser
/Aggregate
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization.BusinessTrading
/Aggregate
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 491
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.PrincipalsAndManagement
Records details of the
Principals (e.g., President,
Vice President, Directors)
and Managers
responsible for the
business strategy,
decision making and day
to day running of the
subjects operations. This
includes names,
addresses and
identification numbers of
the principals. Whilst a
principal will usually be
an individual in some
countries it is legally
acceptable for a
registered business
entity to act as a principal
in another business. This
excludes shareholders
and similar owners who
are not responsible for
the management of the
organization but includes
proprietors and partners
who, whilst owners, are
also generally the
principals running the
business.Records details
of the Principals (e.g.,
President, Vice President,
Directors) and Managers
responsible for the
business strategy,
decision making and day
to day running of the
subjects operations. This
includes names,
addresses and
identification numbers of
the principals. Whilst a
principal will usually be
an individual in some
countries it is legally
acceptable for a
registered business
entity to act as a principal
in another business. This
excludes shareholders
and similar owners who
are not responsible for
the management of the
organization but includes
proprietors and partners
who, whilst owners, are
also generally the
principals running the
business.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 492
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.PrincipalsAndManagement. MostSeniorPrincipal
Aggregate, Optional
Records the details of the
most important principal.
OrderProductResponse. OrderProductResponseDetail. Product. Organization.PrincipalsAndManagement. MostSeniorPrincipal. PrincipalAge
string, up to 3 chars,Optional [M+]
Records the age of the
principal in years.
Monitor Path:
//Organization
/PrincipalsAndManagem
ent /MostSeniorPrincipal
OrderProductResponse. OrderProductResponseDetail. Product. Organization.PrincipalsAndManagement. MostSeniorPrincipal. CurrentManagementResponsibility
Aggregate, Optional(Infinite)
An entry loop which can
repeat multiple times to
allow the recording of
the code values
identifying the current
business function of the
principal represented as
a standard Management
Responsibility Code
(MRC).
OrderProductResponse. OrderProductResponseDetail. Product. Organization.PrincipalsAndManagement. MostSeniorPrincipal. CurrentManagementResponsibility.ManagementResponsibilityText
string, up to 256 chars,Required [M+]
Text identifying the
business function of the
principal derived from a
standard Management
Responsibility Code
(MRC).
Monitor Path:
//Organization
/PrincipalsAndManagem
ent /MostSeniorPrincipal
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 493
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.PrincipalsAndManagement. MostSeniorPrincipal. CurrentManagementResponsibility.ManagementResponsibilityText @ManagementResponsibilityCode
[M+]
Monitor Path:
//Organization
/PrincipalsAndManagem
ent /MostSeniorPrincipal
OrderProductResponse. OrderProductResponseDetail. Product. Organization.PrincipalsAndManagement. MostSeniorPrincipal. CurrentManagementResponsibility.StartDate
date, Optional [M+]
The date when the
principal or manager was
appointed to this
position. This is not
necessarily the date
when the principal or
manager was first
employed by the subject;
this is simply the date
when they moved to this
position, e.g., due to a
promotion.
Monitor Path:
//Organization
/PrincipalsAndManagem
ent /MostSeniorPrincipal
OrderProductResponse. OrderProductResponseDetail. Product. Organization.PrincipalsAndManagement. MostSeniorPrincipal. CurrentManagementResponsibility.StartDate @DatePrecisionText
string, up to 256 chars,Attribute (1x)
OrderProductResponse. OrderProductResponseDetail. Product. Organization.PrincipalsAndManagement. MostSeniorPrincipal. CurrentManagementResponsibility.StartDate @DatePrecisionDNBCodeValue
integer, up to 7 digits,Attribute (1x)
OrderProductResponse. OrderProductResponseDetail. Product. Organization.PrincipalsAndManagement. MostSeniorPrincipal. CurrentManagementResponsibility.StartDate @DatePrecisionDNBCodeTableNumber
integer, Attribute (1x)
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 494
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.PrincipalsAndManagement. MostSeniorPrincipal. CurrentManagementResponsibility.DisplaySequence
integer, Optional
A number which may be
used to define the order
in which the Position
should be presented
relative to any other
occurrences of Position
where lower the number
the earlier the data is
presented.
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization.PrincipalsAndManagement. MostSeniorPrincipal. CurrentManagementResponsibility
/Aggregate
OrderProductResponse. OrderProductResponseDetail. Product. Organization.PrincipalsAndManagement. MostSeniorPrincipal. PrincipalIdentificationNumberDetail
Aggregate, Optional(Infinite)
An entry loop which can
repeat multiple times to
allow the recording of
several different
identification/registratio
n numbers for the
Principal.
OrderProductResponse. OrderProductResponseDetail. Product. Organization.PrincipalsAndManagement. MostSeniorPrincipal. PrincipalIdentificationNumberDetail @DNBCodeValue
Possible values: 24215 -
Coofficial ID
OrderProductResponse. OrderProductResponseDetail. Product. Organization.PrincipalsAndManagement. MostSeniorPrincipal. PrincipalIdentificationNumberDetail @TypeText
Possible values: Coofficial
ID
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 495
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.PrincipalsAndManagement. MostSeniorPrincipal. PrincipalIdentificationNumberDetail.PrincipalIdentificationNumber
string, Optional [M+]
A number assigned by an
external body or by D&B
which either uniquely
identifies or helps to
identify an individual.
Monitor Path:
//Organization
/PrincipalsAndManagem
ent /MostSeniorPrincipal
End: OrderProductResponse. OrderProductResponseDetail. Product. Organization.PrincipalsAndManagement. MostSeniorPrincipal. PrincipalIdentificationNumberDetail
/Aggregate
OrderProductResponse. OrderProductResponseDetail. Product. Organization.PrincipalsAndManagement. MostSeniorPrincipal. CurrentCompensation
Aggregate, Optional
OrderProductResponse. OrderProductResponseDetail. Product. Organization.PrincipalsAndManagement. MostSeniorPrincipal. CurrentCompensation.CompensationDate
date, Optional [M+]
Monitor Path:
//Organization
/PrincipalsAndManagem
ent /MostSeniorPrincipal
OrderProductResponse. OrderProductResponseDetail. Product. Organization.PrincipalsAndManagement. MostSeniorPrincipal. CurrentCompensation.CompensationDetail
Aggregate, Optional(Infinite)
OrderProductResponse. OrderProductResponseDetail. Product. Organization.PrincipalsAndManagement. MostSeniorPrincipal. CurrentCompensation.CompensationDetail. CompensationTypeText
string, up to 256 chars,Optional [M+]
Possible values: 23622
[Bonus]; 23623 [Salary];
23621 [Total
Compensation]
Monitor Path:
//Organization
/PrincipalsAndManagem
ent /MostSeniorPrincipal
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 496
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.PrincipalsAndManagement. MostSeniorPrincipal. CurrentCompensation.CompensationDetail. CompensationTypeText @DNBCodeValue
integer, up to 7 digits,Attribute (1x)
Possible values: 23622
[Bonus]; 23623 [Salary];
23621 [Total
Compensation]
OrderProductResponse. OrderProductResponseDetail. Product. Organization.PrincipalsAndManagement. MostSeniorPrincipal. CurrentCompensation.CompensationDetail. CompensationAmount
decimal, Optional [M+]
Monitor Path:
//Organization
/PrincipalsAndManagem
ent /MostSeniorPrincipal
OrderProductResponse. OrderProductResponseDetail. Product. Organization.PrincipalsAndManagement. MostSeniorPrincipal. CurrentCompensation.CompensationDetail. CompensationAmount @UnitOfSize
string, up to 12 chars,Attribute (1x)
OrderProductResponse. OrderProductResponseDetail. Product. Organization.PrincipalsAndManagement. MostSeniorPrincipal. CurrentCompensation.CompensationDetail. CompensationAmount @CurrencyISOAlpha3Code
string, up to 3 chars,Attribute (1x)
OrderProductResponse. OrderProductResponseDetail. Product. Organization.PrincipalsAndManagement. MostSeniorPrincipal. CurrentCompensation.CompensationDetail. CompensationAmount @ReliabilityText
string, up to 256 chars,Attribute (1x)
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization.PrincipalsAndManagement. MostSeniorPrincipal. CurrentCompensation.CompensationDetail
/Aggregate
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization.PrincipalsAndManagement. MostSeniorPrincipal. CurrentCompensation
/Aggregate
OrderProductResponse. OrderProductResponseDetail. Product. Organization.PrincipalsAndManagement. MostSeniorPrincipal. PrincipalName
Aggregate, Optional
Records the different
names for the Principal.
OrderProductResponse. OrderProductResponseDetail. Product. Organization.PrincipalsAndManagement. MostSeniorPrincipal. PrincipalName @type
OrderProductResponse. OrderProductResponseDetail. Product. Organization.PrincipalsAndManagement. MostSeniorPrincipal. PrincipalName. FirstName
string, up to 64 chars,Optional [M+]
Monitor Path:
//Organization
/PrincipalsAndManagem
ent /MostSeniorPrincipal
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 497
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.PrincipalsAndManagement. MostSeniorPrincipal. PrincipalName. MiddleName
string, up to 64 chars,Optional [M+]
Monitor Path:
//Organization
/PrincipalsAndManagem
ent /MostSeniorPrincipal
OrderProductResponse. OrderProductResponseDetail. Product. Organization.PrincipalsAndManagement. MostSeniorPrincipal. PrincipalName. LastName
string, up to 64 chars,Optional [M+]
Monitor Path:
//Organization
/PrincipalsAndManagem
ent /MostSeniorPrincipal
OrderProductResponse. OrderProductResponseDetail. Product. Organization.PrincipalsAndManagement. MostSeniorPrincipal. PrincipalName. FullName
string, up to 256 chars,Optional [M+]
Monitor Path:
//Organization
/PrincipalsAndManagem
ent /MostSeniorPrincipal
OrderProductResponse. OrderProductResponseDetail. Product. Organization.PrincipalsAndManagement. MostSeniorPrincipal. PrincipalName. NameSuffix
Aggregate, Optional(Infinite) [M+]
Monitor Path:
//Organization
/PrincipalsAndManagem
ent /MostSeniorPrincipal
OrderProductResponse. OrderProductResponseDetail. Product. Organization.PrincipalsAndManagement. MostSeniorPrincipal. PrincipalName. NameSuffix.NameSuffixText
string, up to 16 chars,Optional [M+]
Monitor Path:
//Organization
/PrincipalsAndManagem
ent /MostSeniorPrincipal
OrderProductResponse. OrderProductResponseDetail. Product. Organization.PrincipalsAndManagement. MostSeniorPrincipal. PrincipalName. NamePrefix
Aggregate, Optional(Infinite) [M+]
Monitor Path:
//Organization
/PrincipalsAndManagem
ent /MostSeniorPrincipal
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 498
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.PrincipalsAndManagement. MostSeniorPrincipal. PrincipalName. NamePrefix.NamePrefixText
string, up to 16 chars,Optional [M+]
Monitor Path:
//Organization
/PrincipalsAndManagem
ent /MostSeniorPrincipal
OrderProductResponse. OrderProductResponseDetail. Product. Organization.PrincipalsAndManagement. MostSeniorPrincipal. PrincipalName. OrganizationPrimaryName
Aggregate
OrderProductResponse. OrderProductResponseDetail. Product. Organization.PrincipalsAndManagement. MostSeniorPrincipal. PrincipalName. OrganizationPrimaryName.OrganizationName
string, up to 256 chars,Optional [M+]
Monitor Path:
//Organization
/PrincipalsAndManagem
ent /MostSeniorPrincipal
End: OrderProductResponse. OrderProductResponseDetail. Product. Organization.PrincipalsAndManagement. MostSeniorPrincipal. PrincipalName. OrganizationPrimaryName
/Aggregate
End: OrderProductResponse. OrderProductResponseDetail. Product. Organization.PrincipalsAndManagement. MostSeniorPrincipal. PrincipalName
/Aggregate
OrderProductResponse. OrderProductResponseDetail. Product. Organization.PrincipalsAndManagement. MostSeniorPrincipal. JobTitle
Aggregate, Optional(Infinite)
An entry loop which can
repeat multiple times to
allow the recording of
the name used by the
organization to describe
this person's job, e.g.,
Leader Global
Communication,
Manager National
Technical Support
Center.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 499
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.PrincipalsAndManagement. MostSeniorPrincipal. JobTitle. JobTitleText
string, up to 3000 chars,Optional [M+]
Text that denotes a
position held by the
principal or manager.
Monitor Path:
//Organization
/PrincipalsAndManagem
ent /MostSeniorPrincipal
OrderProductResponse. OrderProductResponseDetail. Product. Organization.PrincipalsAndManagement. MostSeniorPrincipal. JobTitle. JobTitleText@WritingScriptISOAlpha4Code
OrderProductResponse. OrderProductResponseDetail. Product. Organization.PrincipalsAndManagement. MostSeniorPrincipal. JobTitle. JobTitleText @LanguageCode
End: OrderProductResponse. OrderProductResponseDetail. Product. Organization.PrincipalsAndManagement. MostSeniorPrincipal. JobTitle
/Aggregate
OrderProductResponse. OrderProductResponseDetail. Product. Organization.PrincipalsAndManagement. MostSeniorPrincipal. GenderText
string, up to 256 chars,Optional
Text identifying the
gender of the principal.
The possible values are
Male, Female, Unknown.
Possible values: Male;
Female
OrderProductResponse. OrderProductResponseDetail. Product. Organization.PrincipalsAndManagement. MostSeniorPrincipal. GenderText @DNBCodeValue
End: OrderProductResponse. OrderProductResponseDetail. Product. Organization.PrincipalsAndManagement. MostSeniorPrincipal
/Aggregate
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 500
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.PrincipalsAndManagement. CurrentPrincipal
Aggregate, Optional(Infinite)
An entry loop which can
repeat multiple times to
allow recording of the
information of each
principal that are actively
associated with the
subject organization.
OrderProductResponse. OrderProductResponseDetail. Product. Organization.PrincipalsAndManagement. CurrentPrincipal. PrincipalAge
string, up to 3 chars,Optional [M+]
Records the age of the
principal in years.
Monitor Path:
//Organization
/PrincipalsAndManagem
ent /CurrentPrincipal
OrderProductResponse. OrderProductResponseDetail. Product. Organization.PrincipalsAndManagement. CurrentPrincipal. CurrentManagementResponsibility
Aggregate, Optional(Infinite)
An entry loop which can
repeat multiple times to
allow the recording of
the code values
identifying the current
business function of the
principal represented as
a standard Management
Responsibility Code
(MRC).
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 501
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.PrincipalsAndManagement. CurrentPrincipal. CurrentManagementResponsibility.ManagementResponsibilityText
string, up to 256 chars,Required [M+]
Text identifying the
business function of the
principal derived from a
standard Management
Responsibility Code
(MRC).
Monitor Path:
//Organization
/PrincipalsAndManagem
ent /CurrentPrincipal
OrderProductResponse. OrderProductResponseDetail. Product. Organization.PrincipalsAndManagement. CurrentPrincipal. CurrentManagementResponsibility.ManagementResponsibilityText @ManagementResponsibilityCode
[M+]
Monitor Path:
//Organization
/PrincipalsAndManagem
ent /CurrentPrincipal
OrderProductResponse. OrderProductResponseDetail. Product. Organization.PrincipalsAndManagement. CurrentPrincipal. CurrentManagementResponsibility. StartDate
date, Optional [M+]
The date when the
principal or manager was
appointed to this
position. This is not
necessarily the date
when the principal or
manager was first
employed by the subject;
this is simply the date
when they moved to this
position, e.g., due to a
promotion.
Monitor Path:
//Organization
/PrincipalsAndManagem
ent /CurrentPrincipal
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 502
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.PrincipalsAndManagement. CurrentPrincipal. CurrentManagementResponsibility.DisplaySequence
integer, Optional
A number which may be
used to define the order
in which the Position
should be presented
relative to any other
occurrences of Position
where lower the number
the earlier the data is
presented.
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization.PrincipalsAndManagement. CurrentPrincipal. CurrentManagementResponsibility
/Aggregate
OrderProductResponse. OrderProductResponseDetail. Product. Organization.PrincipalsAndManagement. CurrentPrincipal. PrincipalIdentificationNumberDetail
Aggregate, Optional(Infinite)
An entry loop which can
repeat multiple times to
allow the recording of
several different
identification/registratio
n numbers for the
Principal.
OrderProductResponse. OrderProductResponseDetail. Product. Organization.PrincipalsAndManagement. CurrentPrincipal. PrincipalIdentificationNumberDetail @DNBCodeValue
OrderProductResponse. OrderProductResponseDetail. Product. Organization.PrincipalsAndManagement. CurrentPrincipal. PrincipalIdentificationNumberDetail @TypeText
OrderProductResponse. OrderProductResponseDetail. Product. Organization.PrincipalsAndManagement. CurrentPrincipal. PrincipalIdentificationNumberDetail.PrincipalIdentificationNumber
string, Optional [M+]
A number assigned by an
external body or by D&B
which either uniquely
identifies or helps to
identify an individual.
Monitor Path:
//Organization
/PrincipalsAndManagem
ent /CurrentPrincipal
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 503
Name Characteristics
End: OrderProductResponse. OrderProductResponseDetail. Product. Organization.PrincipalsAndManagement. CurrentPrincipal. PrincipalIdentificationNumberDetail
/Aggregate
OrderProductResponse. OrderProductResponseDetail. Product. Organization.PrincipalsAndManagement. CurrentPrincipal. PrincipalName
Aggregate, Optional
Records the different
names for the Principal.
OrderProductResponse. OrderProductResponseDetail. Product. Organization.PrincipalsAndManagement. CurrentPrincipal. PrincipalName. NamePrefix
Aggregate, Optional(Infinite) [M+]
Monitor Path:
//Organization
/PrincipalsAndManagem
ent /CurrentPrincipal
OrderProductResponse. OrderProductResponseDetail. Product. Organization.PrincipalsAndManagement. CurrentPrincipal. PrincipalName. NamePrefix. NamePrefixText
string, up to 16 chars,Optional [M+]
Monitor Path:
//Organization
/PrincipalsAndManagem
ent /CurrentPrincipal
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization.PrincipalsAndManagement. CurrentPrincipal. PrincipalName. NamePrefix
/Aggregate
OrderProductResponse. OrderProductResponseDetail. Product. Organization.PrincipalsAndManagement. CurrentPrincipal. PrincipalName. FirstName
string, up to 64 chars,Optional [M+]
Monitor Path:
//Organization
/PrincipalsAndManagem
ent /CurrentPrincipal
OrderProductResponse. OrderProductResponseDetail. Product. Organization.PrincipalsAndManagement. CurrentPrincipal. PrincipalName. MiddleName
string, up to 64 chars,Optional [M+]
Monitor Path:
//Organization
/PrincipalsAndManagem
ent /CurrentPrincipal
OrderProductResponse. OrderProductResponseDetail. Product. Organization.PrincipalsAndManagement. CurrentPrincipal. PrincipalName. LastName
string, up to 64 chars,Optional [M+]
Monitor Path:
//Organization
/PrincipalsAndManagem
ent /CurrentPrincipal
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 504
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.PrincipalsAndManagement. CurrentPrincipal. PrincipalName. FullName
string, up to 256 chars,Optional [M+]
Monitor Path:
//Organization
/PrincipalsAndManagem
ent /CurrentPrincipal
OrderProductResponse. OrderProductResponseDetail. Product. Organization.PrincipalsAndManagement. CurrentPrincipal. PrincipalName. NameSuffix
Aggregate, Optional(Infinite) [M+]
Monitor Path:
//Organization
/PrincipalsAndManagem
ent /CurrentPrincipal
OrderProductResponse. OrderProductResponseDetail. Product. Organization.PrincipalsAndManagement. CurrentPrincipal. PrincipalName. NameSuffix. NameSuffixText
string, up to 16 chars,Optional [M+]
Monitor Path:
//Organization
/PrincipalsAndManagem
ent /CurrentPrincipal
End: OrderProductResponse. OrderProductResponseDetail. Product. Organization.PrincipalsAndManagement. CurrentPrincipal. PrincipalName
/Aggregate
OrderProductResponse. OrderProductResponseDetail. Product. Organization.PrincipalsAndManagement. CurrentPrincipal. JobTitle
Aggregate, Optional(Infinite)
An entry loop which can
repeat multiple times to
allow the recording of
the name used by the
organization to describe
this person's job, e.g.,
Leader Global
Communication,
Manager National
Technical Support
Center.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 505
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.PrincipalsAndManagement. CurrentPrincipal. JobTitle. JobTitleText
string, up to 3000 chars,Optional [M+]
Text that denotes a
position held by the
principal or manager.
Monitor Path:
//Organization
/PrincipalsAndManagem
ent /CurrentPrincipal
OrderProductResponse. OrderProductResponseDetail. Product. Organization.PrincipalsAndManagement. CurrentPrincipal. JobTitle. JobTitleText@WritingScriptISOAlpha4Code
OrderProductResponse. OrderProductResponseDetail. Product. Organization.PrincipalsAndManagement. CurrentPrincipal. JobTitle. JobTitleText @LanguageCode
End: OrderProductResponse. OrderProductResponseDetail. Product. Organization.PrincipalsAndManagement. CurrentPrincipal. JobTitle
/Aggregate
OrderProductResponse. OrderProductResponseDetail. Product. Organization.PrincipalsAndManagement. CurrentPrincipal. EmploymentBiography
Aggregate, Optional(Infinite)
An entry loop which can
repeat multiple times to
allow the recording of a
concise description about
the principal.
End: OrderProductResponse. OrderProductResponseDetail. Product. Organization.PrincipalsAndManagement. CurrentPrincipal. EmploymentBiography
/Aggregate
OrderProductResponse. OrderProductResponseDetail. Product. Organization.PrincipalsAndManagement. CurrentPrincipal. CurrentCompensation
Aggregate, Optional
OrderProductResponse. OrderProductResponseDetail. Product. Organization.PrincipalsAndManagement. CurrentPrincipal. CurrentCompensation. CompensationDate
date, Optional [M+]
Monitor Path:
//Organization
/PrincipalsAndManagem
ent /CurrentPrincipal
OrderProductResponse. OrderProductResponseDetail. Product. Organization.PrincipalsAndManagement. CurrentPrincipal. CurrentCompensation. CompensationDetail
Aggregate, Optional(Infinite)
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 506
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.PrincipalsAndManagement. CurrentPrincipal. CurrentCompensation. CompensationDetail.CompensationTypeText
string, up to 256 chars,Optional [M+]
Possible values: 23622
[Bonus]; 23623 [Salary];
23621 [Total
Compensation]
Monitor Path:
//Organization
/PrincipalsAndManagem
ent /CurrentPrincipal
OrderProductResponse. OrderProductResponseDetail. Product. Organization.PrincipalsAndManagement. CurrentPrincipal. CurrentCompensation. CompensationDetail.CompensationTypeText @DNBCodeValue
integer, up to 7 digits,Attribute (1x)
Possible values: 23622
[Bonus]; 23623 [Salary];
23621 [Total
Compensation]
OrderProductResponse. OrderProductResponseDetail. Product. Organization.PrincipalsAndManagement. CurrentPrincipal. CurrentCompensation. CompensationDetail.CompensationAmount
decimal, Optional [M+]
Monitor Path:
//Organization
/PrincipalsAndManagem
ent /CurrentPrincipal
OrderProductResponse. OrderProductResponseDetail. Product. Organization.PrincipalsAndManagement. CurrentPrincipal. CurrentCompensation. CompensationDetail.CompensationAmount @UnitOfSize
string, up to 12 chars,Attribute (1x)
OrderProductResponse. OrderProductResponseDetail. Product. Organization.PrincipalsAndManagement. CurrentPrincipal. CurrentCompensation. CompensationDetail.CompensationAmount @CurrencyISOAlpha3Code
string, up to 3 chars,Attribute (1x)
OrderProductResponse. OrderProductResponseDetail. Product. Organization.PrincipalsAndManagement. CurrentPrincipal. CurrentCompensation. CompensationDetail.CompensationAmount @ReliabilityText
string, up to 256 chars,Attribute (1x)
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization.PrincipalsAndManagement. CurrentPrincipal. CurrentCompensation. CompensationDetail
/Aggregate
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization.PrincipalsAndManagement. CurrentPrincipal. CurrentCompensation
/Aggregate
End: OrderProductResponse. OrderProductResponseDetail. Product. Organization.PrincipalsAndManagement. CurrentPrincipal
/Aggregate
End: OrderProductResponse. OrderProductResponseDetail. Product. Organization.PrincipalsAndManagement
/Aggregate
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 507
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification
Aggregate, Optional
Records information
about subjects'
categorization into Socio
Economic or Statistical
groups.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 508
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. MinorityOwnedIndicator
boolean, Optional [M]
When 'true' indicates
that this organization is
certified as a business
that is greater than 50%
owned by, and whose
management and daily
business operations are
controlled by, one or
more minority group
members. When 'false'
indicates that this
organization is not
certified as a business
that is greater than 50%
owned by, and whose
management and daily
business operations are
controlled by, one or
more minority group
members; however as
this is the assumed
condition there is no
requirement to create
this tag to represent this
fact. Note: The
percentage of ownership
requirement may differ
by country. For example,
in the US, for a business
to be considered minority
owned, the percentage
of ownership must be at
least 51%.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 509
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. FemaleOwnedIndicator
boolean, Optional [M]
When 'true' indicates
that this organization is
certified as a business
that is greater than 50%
owned by, and whose
management and daily
business operations are
controlled by, one or
more female persons.
When 'false' indicates
that this organization is
not certified as a
business that is greater
than 50% owned by, and
whose management and
daily business operations
are not controlled by, one
or more female persons;
however as this is the
assumed condition there
is no requirement to
create this tag to
represent this fact. Note:
The percentage of
ownership requirement
may differ by country. For
example, in the US, for a
business to be
considered female
owned, the percentage
of ownership must be at
least 51%.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 510
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. SmallDisadvantagedBusinessIndicator
boolean, Optional [M]
When 'true' indicates
that this organization is
certified as a business
that is greater than 50%
owned by, and whose
management and daily
business operations are
controlled by, socially and
economically
disadvantaged persons.
When 'false' indicates
that this organization is
not certified as a
business that is greater
than 50% owned by, and
whose management and
daily business operations
are controlled by, socially
and economically
disadvantaged persons;
however as this is the
assumed condition there
is no requirement to
create this tag to
represent this fact.
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. AlaskanNativeCorporationIndicator
boolean, Optional [M]
When 'true' indicates
that the tribe is an
Alaskan Native
Corporation.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 511
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. CertifiedSmallBusinessIndicator
boolean, Optional [M]
When 'true' indicates
that the business is
small, certified by a
federal, state or local
government agency or
organization as having
met all of the
government standards
that award eligibility.
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. MinorityCollegeIndicator
boolean, Optional [M]
When 'true' indicates
that this organization is a
college or university
where the profile of the
majority of students is of
minority ethnicity. For
example, if maximum
percentage of students
in a college or university
are from black ethnicity,
this would be a 'Minority
College' with black
ethnicity type. An
example of Minority
College is 'Delaware
State University'. When
'false' indicates that this
organization is not a
college or university
where the profile of the
majority of students is of
minority ethnicity;
however as this is the
assumed condition there
is no requirement to
create this tag to
represent this fact.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 512
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. DisabledOwnedIndicator
boolean, Optional [M]
When 'true' indicates
that this organization is
certified as a business
that is greater than 50%
owned by, and whose
management and daily
business operations are
controlled by, one or
more persons who have
a condition which
prevents the person
from performing all
usual physical or mental
functions When 'false'
indicates that this
organization is not
certified as a business
that is greater than 50%
owned by, and whose
management and daily
business operations are
not controlled by, one or
more disabled persons;
however as this is the
assumed condition there
is no requirement to
create this tag to
represent this fact. Note:
The percentage of
ownership requirement
may differ by country. For
example, in the US, for a
business to be
considered disabled
owned, the percentage
of ownership must be at
least 51%.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 513
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. ServiceDisabledVeteranOwnedIndicator
boolean, Optional [M]
When 'true' indicates
that the business is at
least 51% owned by one
or more veterans with a
disability that is service
connected. The term
“service connected”
means, with respect to
disability or death, that
such disability was
incurred or aggravated,
in the line of duty in the
active military, naval or
air service.
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. VietnamVeteranOwnedIndicator
boolean, Optional [M]
When 'true' indicates
that the business is a
least 51% owned by one
or more Vietnam
Veterans who served
between 1/1/59 and
5/7/75 and have control
and operate the
business. Control in this
context means
exercising the power to
make policy decisions and
operate means to be
actively involved in the
day-to-day management
of the business.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 514
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. AirportConcessionDisadvantagedBusinessEnterpriseIndicator
boolean, Optional [M]
When 'true' indicates
that the business
operates as a
concessionaire at one of
the nation's airports and
meets the ownership
eligibility requirements
as set forth by the
regulations outlined in 49
CFR Part 23.
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. DisabledVeteranBusinessEnterpriseIndicator
boolean, Optional [M]
When 'true' indicates
that the business is
recognized by the state
of California, meaning a
veteran of the U.S.
military, naval, or air
service, with a service-
connected disability of at
least 10% or more and
who is a California
resident; where at least
51% is owned by disabled
veteran/s and conducts
daily business
management and
control. The home office
can not be a branch or
subsidiary of a foreign
corporation, foreign firm
or other foreign-based
business.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 515
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. DisadvantagedBusinessEnterpriseIndicator
boolean, Optional [M]
When 'true' indicates
that the business is
certified by a federal,
state or local
government agency as
having met all of the
government standards
that award eligibility, but
may include women,
minority, disabled and
other disadvantaged
businesses as a result of
economic disadvantages
with respect to
education, employment,
residence or business
location or social
disadvantage and lack of
business training.
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. DisadvantagedVeteranEnterpriseIndicator
boolean, Optional [M]
When 'true' indicates
that the business is a
small business concern
owned and controlled by
veterans, where not less
than 51% is owned
controlled and managed
by veterans.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 516
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. MinorityBusinessEnterpriseIndicator
boolean, Optional [M]
When 'true' indicates
that the business is
certified by a federal,
state or local
government agency
through an application
and/or premise visit
process as having met all
of the government
standards and
requirements. When
'false' indicates that the
business is not certified
by a federal, state or local
government agency
through an application
and/or premise visit
process as having met all
of the government
standards and
requirements.
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. FemaleOwnedBusinessEnterpriseIndicator
boolean, Optional [M]
When 'true' indicates the
business is certified by a
federal, state or local
government agency as
having met all of the
government standards
and requirements. When
'false' indicates the
business is not certified
by a federal, state or local
government agency as
having met all of the
government standards
and requirements.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 517
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. MinorityOwnedDetails
Aggregate, Optional(Infinite)
An entry loop which can
repeat multiple times to
allow the recording of
information about the
characterization of the
organization as minority
owned. A minority
owned organization is a
business that is greater
than 50% owned by, and
whose management and
daily business operations
are controlled by, one or
more minority group
members. Note: The
percentage of ownership
requirement may differ
by country. For example,
in the US, for a business
to be considered minority
owned, the percentage
of ownership must be at
least 51%.
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. MinorityOwnedDetails. CertificationStartDate
date, Optional [M+]
The date when
certification period for
this organization begins.
Monitor Path:
//Organization
/SocioEconomicIdentifica
tion
/MinorityOwnedDetails
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 518
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. MinorityOwnedDetails. CertificationExpirationDate
date, Optional [M+]
The date when the
certificate expires.
Monitor Path:
//Organization
/SocioEconomicIdentifica
tion
/MinorityOwnedDetails
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. MinorityOwnedDetails. CertificationReferenceIdentifier
string, up to 64 chars,Optional [M+]
An alphanumeric
identifier assigned by the
data provider to identify
the document attesting
that the organization has
satisfied the standards or
requirements of their
socio-economic program.
Monitor Path:
//Organization
/SocioEconomicIdentifica
tion
/MinorityOwnedDetails
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. MinorityOwnedDetails. DataProviderDetail
Aggregate, Optional
Records details of the
source from which this
data was originally
obtained.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 519
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. MinorityOwnedDetails. DataProviderDetail. CertifyingIndicator
boolean, Optional [M+]
When 'true' indicates
that data provider is
certified to endorse the
subject authoritatively.
When 'false' indicates
that this data provider is
not certified to endorse
the subject
authoritatively.
Monitor Path:
//Organization
/SocioEconomicIdentifica
tion
/MinorityOwnedDetails
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. MinorityOwnedDetails. DataProviderDetail. VerifyingIndicator
boolean, Optional [M+]
When 'true' indicates
that certification has
been verified to endorse
the subject
authoritatively. When
'false' indicates that the
certification has not
verified to endorse the
subject authoritatively.
Monitor Path:
//Organization
/SocioEconomicIdentifica
tion
/MinorityOwnedDetails
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 520
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. MinorityOwnedDetails. DataProviderDetail.DiversityDNBDataProviderName
string, up to 256 chars,Optional [M+]
Name identifying the
source from which this
socio economic data was
originally obtained by
D&B
Monitor Path:
//Organization
/SocioEconomicIdentifica
tion
/MinorityOwnedDetails
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. MinorityOwnedDetails. DataProviderDetail.DataProviderTypeText
string, up to 256 chars,Optional [M+]
Text that describes in
general terms the type of
data provider this is, e.g.,
National Government,
National Coverage
Organization, Local Non-
Profit Organization.This
is used in statistical
reporting regarding
D&B's socio economic
data coverage.
Monitor Path:
//Organization
/SocioEconomicIdentifica
tion
/MinorityOwnedDetails
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. MinorityOwnedDetails. DataProviderDetail
/Aggregate
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 521
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. MinorityOwnedDetails. DNBReceivedDate
date, Optional [M+]
The date when D&B
obtained this data from
the source.
Monitor Path:
//Organization
/SocioEconomicIdentifica
tion
/MinorityOwnedDetails
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. MinorityOwnedDetails. OwnershipEthnicity
Aggregate, Optional(Infinite)
Records the racial,
national, tribal, or
cultural classifications
that are applied to an
organization based on
the ethnicity of a
majority of its
ownership.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 522
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. MinorityOwnedDetails. OwnershipEthnicity. EthnicityTypeText
string, up to 256 chars,Optional [M+]
Text that uniquely
identifies the ethnic
classification that's
applied to this
organization based on
the racial, national, tribal,
or cultural group that
describes a majority of its
ownership, e.g., Asian,
Hispanic, African
American (Black).
Monitor Path:
//Organization
/SocioEconomicIdentifica
tion
/MinorityOwnedDetails
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. MinorityOwnedDetails. OwnershipEthnicity
/Aggregate
End: OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. MinorityOwnedDetails
/Aggregate
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 523
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. FemaleOwnedDetail
Aggregate, Optional(Infinite)
An entry loop that can
repeat multiple times to
record the information
about the
characterization of the
organization as female
owned. A female owned
organization is a
business that is greater
than 50% owned by, and
whose management and
daily business operations
are controlled by, one or
more female persons.
Note: The percentage of
ownership requirement
may differ by country. For
example, in the US, for a
business to be
considered female
owned, the percentage
of ownership must be at
least 51%.
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. FemaleOwnedDetail. CertificationStartDate
date, Optional [M+]
The date when
certification period for
this organization begins.
Monitor Path:
//Organization
/SocioEconomicIdentifica
tion
/FemaleOwnedDetail
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 524
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. FemaleOwnedDetail. CertificationExpirationDate
date, Optional [M+]
The date when the
certificate expires.
Monitor Path:
//Organization
/SocioEconomicIdentifica
tion
/FemaleOwnedDetail
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. FemaleOwnedDetail. CertificationReferenceIdentifier
string, up to 64 chars,Optional [M+]
An alphanumeric
identifier assigned by the
data provider to identify
the document attesting
that the organization has
satisfied the standards or
requirements of their
socio-economic program.
Monitor Path:
//Organization
/SocioEconomicIdentifica
tion
/FemaleOwnedDetail
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. FemaleOwnedDetail. DataProviderDetail
Aggregate, Optional
Records details of the
source from which this
data was originally
obtained.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 525
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. FemaleOwnedDetail. DataProviderDetail. CertifyingIndicator
boolean, Optional [M+]
When 'true' indicates
that data provider is
certified to endorse the
subject authoritatively.
When 'false' indicates
that this data provider is
not certified to endorse
the subject
authoritatively.
Monitor Path:
//Organization
/SocioEconomicIdentifica
tion
/FemaleOwnedDetail
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. FemaleOwnedDetail. DataProviderDetail. VerifyingIndicator
boolean, Optional [M+]
When 'true' indicates
that certification has
been verified to endorse
the subject
authoritatively. When
'false' indicates that the
certification has not
verified to endorse the
subject authoritatively.
Monitor Path:
//Organization
/SocioEconomicIdentifica
tion
/FemaleOwnedDetail
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 526
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. FemaleOwnedDetail. DataProviderDetail.DiversityDNBDataProviderName
string, up to 256 chars,Optional [M+]
Name identifying the
source from which this
socio economic data was
originally obtained by
D&B
Monitor Path:
//Organization
/SocioEconomicIdentifica
tion
/FemaleOwnedDetail
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. FemaleOwnedDetail. DataProviderDetail.DataProviderTypeText
string, up to 256 chars,Optional [M+]
Text that describes in
general terms the type of
data provider this is, e.g.,
National Government,
National Coverage
Organization, Local Non-
Profit Organization.This
is used in statistical
reporting regarding
D&B's socio economic
data coverage.
Monitor Path:
//Organization
/SocioEconomicIdentifica
tion
/FemaleOwnedDetail
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. FemaleOwnedDetail. DataProviderDetail
/Aggregate
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 527
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. FemaleOwnedDetail. DNBReceivedDate
date, Optional [M+]
The date when D&B
obtained this data from
the source.
Monitor Path:
//Organization
/SocioEconomicIdentifica
tion
/FemaleOwnedDetail
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. FemaleOwnedDetail
/Aggregate
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. VeteranOwnedDetail
Aggregate, Optional(Infinite)
An entry loop that can
repeat multiple times to
record information about
the characterization of
the organization as
veteran owned. A
veteran owned
organization is a
business that is greater
than 50% owned by, and
whose management and
daily business operations
are controlled by, one or
more veterans. Note: The
percentage of ownership
requirement may differ
by country. For example,
in the US, for a business
to be considered veteran
owned, the percentage
of ownership must be at
least 51%.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 528
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. VeteranOwnedDetail. CertificationStartDate
date, Optional [M+]
The date when
certification period for
this organization begins.
Monitor Path:
//Organization
/SocioEconomicIdentifica
tion
/VeteranOwnedDetail
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. VeteranOwnedDetail. CertificationExpirationDate
date, Optional [M+]
The date when the
certificate expires.
Monitor Path:
//Organization
/SocioEconomicIdentifica
tion
/VeteranOwnedDetail
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. VeteranOwnedDetail. CertificationReferenceIdentifier
string, up to 64 chars,Optional [M+]
An alphanumeric
identifier assigned by the
data provider to identify
the document attesting
that the organization has
satisfied the standards or
requirements of their
socio-economic program.
Monitor Path:
//Organization
/SocioEconomicIdentifica
tion
/VeteranOwnedDetail
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 529
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. VeteranOwnedDetail. DataProviderDetail
Aggregate, Optional
Records details of the
source from which this
data was originally
obtained.
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. VeteranOwnedDetail. DataProviderDetail. CertifyingIndicator
boolean, Optional [M+]
When 'true' indicates
that data provider is
certified to endorse the
subject authoritatively.
When 'false' indicates
that this data provider is
not certified to endorse
the subject
authoritatively.
Monitor Path:
//Organization
/SocioEconomicIdentifica
tion
/VeteranOwnedDetail
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. VeteranOwnedDetail. DataProviderDetail. VerifyingIndicator
boolean, Optional [M+]
When 'true' indicates
that certification has
been verified to endorse
the subject
authoritatively. When
'false' indicates that the
certification has not
verified to endorse the
subject authoritatively.
Monitor Path:
//Organization
/SocioEconomicIdentifica
tion
/VeteranOwnedDetail
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 530
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. VeteranOwnedDetail. DataProviderDetail.DiversityDNBDataProviderName
string, up to 256 chars,Optional [M+]
Name identifying the
source from which this
socio economic data was
originally obtained by
D&B
Monitor Path:
//Organization
/SocioEconomicIdentifica
tion
/VeteranOwnedDetail
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. VeteranOwnedDetail. DataProviderDetail.DataProviderTypeText
string, up to 256 chars,Optional [M+]
Text that describes in
general terms the type of
data provider this is, e.g.,
National Government,
National Coverage
Organization, Local Non-
Profit Organization.This
is used in statistical
reporting regarding
D&B's socio economic
data coverage.
Monitor Path:
//Organization
/SocioEconomicIdentifica
tion
/VeteranOwnedDetail
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. VeteranOwnedDetail. DataProviderDetail
/Aggregate
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 531
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. VeteranOwnedDetail. DNBReceivedDate
date, Optional [M+]
The date when D&B
obtained this data from
the source.
Monitor Path:
//Organization
/SocioEconomicIdentifica
tion
/VeteranOwnedDetail
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. VeteranOwnedDetail
/Aggregate
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. AirportConcessionDisadvantagedBusinessEnterpriseDetail
Aggregate, Optional(Infinite)
An entry loop that can
repeat multiple times to
record the details of the
small business operates
as a concessionaire at
one of the nation's
airports and meets the
ownership eligibility
requirements.
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. AirportConcessionDisadvantagedBusinessEnterpriseDetail.DataProviderDetail
Aggregate, Optional
Records the details of the
source from which this
data was originally
obtained.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 532
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. AirportConcessionDisadvantagedBusinessEnterpriseDetail.DataProviderDetail. DiversityDNBDataProviderName
string, up to 256 chars,Optional [M+]
Name identifying the
source from which this
socio economic data was
originally obtained by
D&B
Monitor Path:
//Organization
/SocioEconomicIdentifica
tion
/AirportConcessionDisad
vantagedBusinessEnterp
riseDetail
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. AirportConcessionDisadvantagedBusinessEnterpriseDetail.DataProviderDetail. DataProviderTypeText
string, up to 256 chars,Optional [M+]
Text that describes in
general terms the type of
data provider this is, e.g.,
National Government,
National Coverage
Organization, Local Non-
Profit Organization.This
is used in statistical
reporting regarding
D&B's socio economic
data coverage.
Monitor Path:
//Organization
/SocioEconomicIdentifica
tion
/AirportConcessionDisad
vantagedBusinessEnterp
riseDetail
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 533
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. AirportConcessionDisadvantagedBusinessEnterpriseDetail.DataProviderDetail. Location
Aggregate, Optional
Records the address
details for a subject. An
address is the
designation of a place
where a subject can be
located or may be
communicated with.
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. AirportConcessionDisadvantagedBusinessEnterpriseDetail.DataProviderDetail. Location. TerritoryAbbreviatedName
string, up to 64 chars,Optional [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
/SocioEconomicIdentifica
tion
/AirportConcessionDisad
vantagedBusinessEnterp
riseDetail
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 534
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. AirportConcessionDisadvantagedBusinessEnterpriseDetail.DataProviderDetail. Location. CountryISOAlpha2Code
string, at least 2 chars,up to 2 chars, Optional[M+]
The two-letter country
code, defined in the ISO
3166-1 scheme published
by International
Organization for
Standardization (ISO),
identifying the country
for this address.
Monitor Path:
//Organization
/SocioEconomicIdentifica
tion
/AirportConcessionDisad
vantagedBusinessEnterp
riseDetail
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. AirportConcessionDisadvantagedBusinessEnterpriseDetail.DataProviderDetail. Location
/Aggregate
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. AirportConcessionDisadvantagedBusinessEnterpriseDetail.DataProviderDetail
/Aggregate
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. AirportConcessionDisadvantagedBusinessEnterpriseDetail
/Aggregate
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 535
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. DisadvantagedBusinessEnterpriseDetail
Aggregate, Optional(Infinite)
An entry loop that can
repeat multiple times to
record the information
about the businesswhich
is certified by a federal,
state or local
government agency as
having met all of the
government standards
that award eligibility, but
may include women,
minority, disabled and
other disadvantaged
businesses as a result of
economic disadvantages
with respect to
education, employment,
residence or business
location or social
disadvantage and lack of
business training.
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. DisadvantagedBusinessEnterpriseDetail.CertificationStartDate
date, Optional [M+]
The date when
certification period for
this organization begins.
Monitor Path:
//Organization
/SocioEconomicIdentifica
tion
/DisadvantagedBusiness
EnterpriseDetail
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 536
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. DisadvantagedBusinessEnterpriseDetail.CertificationExpirationDate
date, Optional [M+]
The date when the
certificate expires.
Monitor Path:
//Organization
/SocioEconomicIdentifica
tion
/DisadvantagedBusiness
EnterpriseDetail
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. DisadvantagedBusinessEnterpriseDetail.CertificationReferenceIdentifier
string, up to 64 chars,Optional [M+]
An alphanumeric
identifier assigned by the
data provider to identify
the document attesting
that the organization has
satisfied the standards or
requirements of their
socio-economic program.
Monitor Path:
//Organization
/SocioEconomicIdentifica
tion
/DisadvantagedBusiness
EnterpriseDetail
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. DisadvantagedBusinessEnterpriseDetail. DataProviderDetail
Aggregate, Optional
Records details of the
source from which this
data was originally
obtained.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 537
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. DisadvantagedBusinessEnterpriseDetail. DataProviderDetail.CertifyingIndicator
boolean, Optional [M+]
When 'true' indicates
that data provider is
certified to endorse the
subject authoritatively.
When 'false' indicates
that this data provider is
not certified to endorse
the subject
authoritatively.
Monitor Path:
//Organization
/SocioEconomicIdentifica
tion
/DisadvantagedBusiness
EnterpriseDetail
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. DisadvantagedBusinessEnterpriseDetail. DataProviderDetail.VerifyingIndicator
boolean, Optional [M+]
When 'true' indicates
that certification has
been verified to endorse
the subject
authoritatively. When
'false' indicates that the
certification has not
verified to endorse the
subject authoritatively.
Monitor Path:
//Organization
/SocioEconomicIdentifica
tion
/DisadvantagedBusiness
EnterpriseDetail
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 538
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. DisadvantagedBusinessEnterpriseDetail. DataProviderDetail.DiversityDNBDataProviderName
string, up to 256 chars,Optional [M+]
Name identifying the
source from which this
socio economic data was
originally obtained by
D&B
Monitor Path:
//Organization
/SocioEconomicIdentifica
tion
/DisadvantagedBusiness
EnterpriseDetail
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. DisadvantagedBusinessEnterpriseDetail. DataProviderDetail.DataProviderTypeText
string, up to 256 chars,Optional [M+]
Text that describes in
general terms the type of
data provider this is, e.g.,
National Government,
National Coverage
Organization, Local Non-
Profit Organization.This
is used in statistical
reporting regarding
D&B's socio economic
data coverage.
Monitor Path:
//Organization
/SocioEconomicIdentifica
tion
/DisadvantagedBusiness
EnterpriseDetail
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. DisadvantagedBusinessEnterpriseDetail. DataProviderDetail
/Aggregate
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 539
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. DisadvantagedBusinessEnterpriseDetail. DNBReceivedDate
date, Optional [M+]
The date when D&B
obtained this data from
the source.
Monitor Path:
//Organization
/SocioEconomicIdentifica
tion
/DisadvantagedBusiness
EnterpriseDetail
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. DisadvantagedBusinessEnterpriseDetail
/Aggregate
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 540
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. HUBZoneCertifiedBusinessIndicator
When 'true' indicates
that this organization is
certified by the US Small
Business Administration
as being a recipient of
the HUB Zone program. A
small business must
meet all of the following
criteria to qualify for the
HUB Zone program: It
must be located in a
'historically underutilized
business zone'. It must
be owned and controlled
by one or more U.S
Citizens. Greater than
35% of its employees
must reside in a
HUBZone. A HUBZone
(Historically Underutilized
Business Zone) is an area
that is located in one or
more of the following - a)
A qualified census tract
(as defined in section 42
(d)(5)(C)(i)(I) of the
Internal Revenue Code of
1986). b) A qualified 'non-
metropolitan county' (as
defined in section 143(k)
(2)(B) of the Internal
Revenue Code of 1986)
with a median household
income of less than 80%
of the State median
household income or
with an unemployment
rate of not less than
140% of the statewide
average, based on U.S.
Department of Labor
recent data. c) Lands
within the boundaries of
federally recognized
Indian reservations.
When 'false' indicates
that this organization is
not certified by the US
Small Business
Administration as being a
recipient of the HUB
Zone program; however
as this is the assumed
condition there is no
requirement to create
this tag to represent this
fact.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 541
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. EightACertifiedBusinessIndicator
boolean, Optional [M]
When 'true' indicates
that this organization is
certified by the US Small
Business Administration
as being a recipient of
the 8(a) Business
Development Program, a
business development
program created to help
small disadvantaged
businesses compete in
the American economy
and access the federal
procurement market.
When 'false' indicates
that this organization is
not certified by the US
Small Business
Administration as being a
recipient of the 8(a)
Business Development
Program; however as
this is the assumed
condition there is no
requirement to create
this tag to represent this
fact.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 542
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. EightACertifiedBusinessDetails
Aggregate, Optional
Records the details of
one or more certification
information of the
organization as an 8A
certified organization.
The 8(a) program is a
business development
program created to help
small disadvantaged
businesses compete in
the American economy
and access the federal
procurement market.
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. EightACertifiedBusinessDetails. CertificationStartDate
date, Optional [M+]
The date when
certification period for
this organization begins.
Monitor Path:
//Organization
/SocioEconomicIdentifica
tion
/EightACertifiedBusiness
Details
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. EightACertifiedBusinessDetails. CertificationExpirationDate
date, Optional [M+]
The date when the
certificate expires.
Monitor Path:
//Organization
/SocioEconomicIdentifica
tion
/EightACertifiedBusiness
Details
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 543
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. EightACertifiedBusinessDetails.CertificationReferenceIdentifier
string, up to 64 chars,Optional [M+]
An alphanumeric
identifier assigned by the
data provider to identify
the document attesting
that the organization has
satisfied the standards or
requirements of their
socio-economic program.
Monitor Path:
//Organization
/SocioEconomicIdentifica
tion
/EightACertifiedBusiness
Details
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. EightACertifiedBusinessDetails. DataProviderDetail
Aggregate, Optional
Records details of the
source from which this
data was originally
obtained.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 544
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. EightACertifiedBusinessDetails. DataProviderDetail.CertifyingIndicator
boolean, Optional [M+]
When 'true' indicates
that data provider is
certified to endorse the
subject authoritatively.
When 'false' indicates
that this data provider is
not certified to endorse
the subject
authoritatively.
Monitor Path:
//Organization
/SocioEconomicIdentifica
tion
/EightACertifiedBusiness
Details
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. EightACertifiedBusinessDetails. DataProviderDetail.VerifyingIndicator
boolean, Optional [M+]
When 'true' indicates
that certification has
been verified to endorse
the subject
authoritatively. When
'false' indicates that the
certification has not
verified to endorse the
subject authoritatively.
Monitor Path:
//Organization
/SocioEconomicIdentifica
tion
/EightACertifiedBusiness
Details
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 545
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. EightACertifiedBusinessDetails. DataProviderDetail.DiversityDNBDataProviderName
string, up to 256 chars,Optional [M+]
Name identifying the
source from which this
socio economic data was
originally obtained by
D&B
Monitor Path:
//Organization
/SocioEconomicIdentifica
tion
/EightACertifiedBusiness
Details
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. EightACertifiedBusinessDetails. DataProviderDetail.DataProviderTypeText
string, up to 256 chars,Optional [M+]
Text that describes in
general terms the type of
data provider this is, e.g.,
National Government,
National Coverage
Organization, Local Non-
Profit Organization.This
is used in statistical
reporting regarding
D&B's socio economic
data coverage.
Monitor Path:
//Organization
/SocioEconomicIdentifica
tion
/EightACertifiedBusiness
Details
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. EightACertifiedBusinessDetails. DataProviderDetail
/Aggregate
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 546
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. EightACertifiedBusinessDetails. DNBReceivedDate
date, Optional [M+]
The date when D&B
obtained this data from
the source.
Monitor Path:
//Organization
/SocioEconomicIdentifica
tion
/EightACertifiedBusiness
Details
End: OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. EightACertifiedBusinessDetails
/Aggregate
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. SmallDisadvantagedBusinessDetail
Aggregate, Optional
Records the information
about the business
meets certification
eligibility criteria
established by the SBA
effective 7/1/99. All firms
must be certified by one
of the Small
Disadvantaged Business
Certification Agencies
designated by the SBA.
To qualify must be a
small business, not
exceed standards for
Primary SIC, meet
Contracting Officers’
assigned SIC code, be a
U.S. Citizen and be 51%
owned and controlled by
one or more Socially and
Economically
Disadvantaged
Individuals.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 547
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. SmallDisadvantagedBusinessDetail. CertificationStartDate
date, Optional [M+]
The date when
certification period for
this organization begins.
Monitor Path:
//Organization
/SocioEconomicIdentifica
tion
/SmallDisadvantagedBus
inessDetail
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. SmallDisadvantagedBusinessDetail.CertificationExpirationDate
date, Optional [M+]
The date when the
certificate expires.
Monitor Path:
//Organization
/SocioEconomicIdentifica
tion
/SmallDisadvantagedBus
inessDetail
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. SmallDisadvantagedBusinessDetail. DataProviderDetail
Aggregate, Optional
Records the details of the
source from which this
data was originally
obtained.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 548
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. SmallDisadvantagedBusinessDetail. DataProviderDetail.CertifyingIndicator
boolean, Optional [M+]
When 'true' indicates
that data provider is
certified to endorse the
subject authoritatively.
When 'false' indicates
that this data provider is
not certified to endorse
the subject
authoritatively.
Monitor Path:
//Organization
/SocioEconomicIdentifica
tion
/SmallDisadvantagedBus
inessDetail
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. SmallDisadvantagedBusinessDetail. DataProviderDetail.VerifyingIndicator
boolean, Optional [M+]
When 'true' indicates
that certification has
been verified to endorse
the subject
authoritatively. When
'false' indicates that the
certification has not
verified to endorse the
subject authoritatively.
Monitor Path:
//Organization
/SocioEconomicIdentifica
tion
/SmallDisadvantagedBus
inessDetail
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 549
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. SmallDisadvantagedBusinessDetail. DataProviderDetail.DiversityDNBDataProviderName
string, up to 256 chars,Optional [M+]
Name identifying the
source from which this
socio economic data was
originally obtained by
D&B
Monitor Path:
//Organization
/SocioEconomicIdentifica
tion
/SmallDisadvantagedBus
inessDetail
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. SmallDisadvantagedBusinessDetail. DataProviderDetail.DataProviderTypeText
string, up to 256 chars,Optional [M+]
Text that describes in
general terms the type of
data provider this is, e.g.,
National Government,
National Coverage
Organization, Local Non-
Profit Organization.This
is used in statistical
reporting regarding
D&B's socio economic
data coverage.
Monitor Path:
//Organization
/SocioEconomicIdentifica
tion
/SmallDisadvantagedBus
inessDetail
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. SmallDisadvantagedBusinessDetail. DataProviderDetail
/Aggregate
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 550
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. SmallDisadvantagedBusinessDetail. DNBReceivedDate
date, Optional [M+]
The date when D&B
obtained this data from
the source.
Monitor Path:
//Organization
/SocioEconomicIdentifica
tion
/SmallDisadvantagedBus
inessDetail
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. SmallDisadvantagedBusinessDetail
/Aggregate
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. CertifiedSmallBusinessDetail
Aggregate, Optional(Infinite)
An entry loop that can
repeat multiple times to
record the information
about the business
usually certified by a
federal, state or local
government agency or
organization as having
met all of the
government standards
that award eligibility.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 551
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. CertifiedSmallBusinessDetail. CertificationStartDate
date, Optional [M+]
The date on which a
certification period for a
given subject
organization begins.
Monitor Path:
//Organization
/SocioEconomicIdentifica
tion
/CertifiedSmallBusiness
Detail
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. CertifiedSmallBusinessDetail. CertificationExpirationDate
date, Optional [M+]
The date on when the
certificate expires.
Monitor Path:
//Organization
/SocioEconomicIdentifica
tion
/CertifiedSmallBusiness
Detail
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 552
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. CertifiedSmallBusinessDetail. CertificationReferenceIdentifier
string, up to 32 chars,Optional [M+]
An alphanumeric
identifier assigned by the
data provider to identify
the document attesting
that the organization has
satisfied the standards or
requirements of their
socio-economic program.
Monitor Path:
//Organization
/SocioEconomicIdentifica
tion
/CertifiedSmallBusiness
Detail
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. CertifiedSmallBusinessDetail. DataProviderDetail
Aggregate, Optional
Records the details of the
source from which this
data was originally
obtained.
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. CertifiedSmallBusinessDetail. DataProviderDetail.DiversityDNBDataProviderName
string, up to 256 chars,Optional [M+]
Name identifying the
source from which this
socio economic data was
originally obtained by
D&B
Monitor Path:
//Organization
/SocioEconomicIdentifica
tion
/CertifiedSmallBusiness
Detail
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 553
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. CertifiedSmallBusinessDetail. DataProviderDetail.DataProviderTypeText
string, up to 256 chars,Optional [M+]
Text that describes in
general terms the type of
data provider this is, e.g.,
National Government,
National Coverage
Organization, Local Non-
Profit Organization.This
is used in statistical
reporting regarding
D&B's socio economic
data coverage.
Monitor Path:
//Organization
/SocioEconomicIdentifica
tion
/CertifiedSmallBusiness
Detail
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. CertifiedSmallBusinessDetail. DataProviderDetail
/Aggregate
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. CertifiedSmallBusinessDetail
/Aggregate
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 554
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. DisabledOwnedDetail
Aggregate, Optional(Infinite)
An entry loop that can
repeat multiple times to
record the information
about the business
which is a least 51%
owned by one or more
disabled persons who
control and operate the
business. Control in this
context means
exercising the power to
make policy decisions and
operate means to be
actively involved in the
day-to-day management
of the business.
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. DisabledOwnedDetail. CertificationStartDate
date, Optional [M+]
The date when
certification period for
this organization begins.
Monitor Path:
//Organization
/SocioEconomicIdentifica
tion
/DisabledOwnedDetail
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. DisabledOwnedDetail. CertificationExpirationDate
date, Optional [M+]
The date when the
certificate expires.
Monitor Path:
//Organization
/SocioEconomicIdentifica
tion
/DisabledOwnedDetail
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 555
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. DisabledOwnedDetail. CertificationReferenceIdentifier
string, up to 64 chars,Optional [M+]
An alphanumeric
identifier assigned by the
data provider to identify
the document attesting
that the organization has
satisfied the standards or
requirements of their
socio-economic program.
Monitor Path:
//Organization
/SocioEconomicIdentifica
tion
/DisabledOwnedDetail
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. DisabledOwnedDetail. DataProviderDetail
Aggregate, Optional
Records details of the
source from which this
data was originally
obtained.
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. DisabledOwnedDetail. DataProviderDetail. CertifyingIndicator
boolean, Optional [M+]
When 'true' indicates
that data provider is
certified to endorse the
subject authoritatively.
When 'false' indicates
that this data provider is
not certified to endorse
the subject
authoritatively.
Monitor Path:
//Organization
/SocioEconomicIdentifica
tion
/DisabledOwnedDetail
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 556
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. DisabledOwnedDetail. DataProviderDetail. VerifyingIndicator
boolean, Optional [M+]
When 'true' indicates
that certification has
been verified to endorse
the subject
authoritatively. When
'false' indicates that the
certification has not
verified to endorse the
subject authoritatively.
Monitor Path:
//Organization
/SocioEconomicIdentifica
tion
/DisabledOwnedDetail
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. DisabledOwnedDetail. DataProviderDetail.DiversityDNBDataProviderName
string, up to 256 chars,Optional [M+]
Name identifying the
source from which this
socio economic data was
originally obtained by
D&B
Monitor Path:
//Organization
/SocioEconomicIdentifica
tion
/DisabledOwnedDetail
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 557
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. DisabledOwnedDetail. DataProviderDetail.DataProviderTypeText
string, up to 256 chars,Optional [M+]
Text that describes in
general terms the type of
data provider this is, e.g.,
National Government,
National Coverage
Organization, Local Non-
Profit Organization.This
is used in statistical
reporting regarding
D&B's socio economic
data coverage.
Monitor Path:
//Organization
/SocioEconomicIdentifica
tion
/DisabledOwnedDetail
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. DisabledOwnedDetail. DataProviderDetail
/Aggregate
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. DisabledOwnedDetail. DNBReceivedDate
date, Optional [M+]
The date when D&B
obtained this data from
the source.
Monitor Path:
//Organization
/SocioEconomicIdentifica
tion
/DisabledOwnedDetail
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. DisabledOwnedDetail
/Aggregate
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 558
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. VeteranOwnedIndicator
When 'true' indicates
that this organization is
certified as a business
that is greater than 50%
owned by, and whose
management and daily
business operations are
controlled by, one or
more veterans. A veteran
refers to a person who
served in the active
military, naval, or air
service, and who was
discharged or released
therefrom under
conditions other than
dishonorable. When
'false' indicates that this
organization is not
certified as a business
that is greater than 50%
owned by, and whose
management and daily
business operations are
controlled by, one or
more veterans; however
as this is the assumed
condition there is no
requirement to create
this tag to represent this
fact. Note: The
percentage of ownership
requirement may differ
by country. For example,
in the US, for a business
to be considered veteran
owned, the percentage
of ownership must be at
least 51%.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 559
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. LaborSurplusAreaIndicator
boolean, Optional [M]
When 'true' indicates
that this organization is
certified as a business
that operates in a labor
surplus area. A labor
surplus area is a
geographical area
identified by the
Department of Labor, as
an area of concentrated
unemployment or
underemployment or an
area of labor surplus.
When 'false' indicates
that this organization is
not certified as a
business that operates in
a labor surplus area;
however as this is the
assumed condition there
is no requirement to
create this tag to
represent this fact.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 560
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. SmallBusinessIndicator
boolean, Optional [M]
When 'true' indicates
that this organization is
certified as a small
business. A small
business is an entity that
is usually privately owned
and operated, with a
small number of
employees and relatively
low volume of sales.
Small businesses are
normally privately owned
corporations,
partnerships, or sole
proprietorships. The legal
definition of small" varies
by country and by
industry
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. VeteranBusinessEnterpriseIndicator
boolean, Optional [M]
When 'true' indicates
that the business falls
under SBA Guidelines
Small Business Act (PL
85-536), which as
amended states: Small
Business Concerns
owned and controlled by
veterans not less than
51% owned by one or
more veterans and in the
case of a publicly owned
business not less than
51% of the stock is
owned by one or more
veterans.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 561
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. OwnershipEthnicity
Aggregate, Optional(Infinite)
An entry loop that can
repeat multiple times to
record the racial,
national, tribal, or
cultural classifications
that are applied to an
organization based on
the ethnicity of a
majority of its
ownership.
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. OwnershipEthnicity. EthnicityTypeText
string, up to 256 chars,Optional [M+]
Text that uniquely
identifies the ethnic
classification that's
applied to this
organization based on
the racial, national, tribal,
or cultural group that
describes a majority of its
ownership, e.g., Asian,
Hispanic, African
American (Black).
Monitor Path:
//Organization
/SocioEconomicIdentifica
tion /OwnershipEthnicity
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 562
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. OwnershipEthnicity. EthnicityTypeText @DNBCodeValue
integer, up to 7 digits,Attribute (1x)
Possible values: Code
Table 224:; 10881 [Asian];
10882 [Black]; 10884
[Hispanic]; 18044
[Alaskan Native
American]; 10885 [Indian
Subcontinent]; 0
[Unknown]
End: OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification. OwnershipEthnicity
/Aggregate
End: OrderProductResponse. OrderProductResponseDetail. Product. Organization.SocioEconomicIdentification
/Aggregate
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Competitors Aggregate, Optional
Records information on a
competing organization.
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Competitors.Competitor
Aggregate, Required(Infinite)
An entry loop which can
repeat multiple times to
record information on a
competing organization.
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Competitors.Competitor. OrganizationPrimaryName
Aggregate, Optional(Infinite)
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Competitors.Competitor. OrganizationPrimaryName @RegisteredNameIndicator
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Competitors.Competitor. OrganizationPrimaryName. OrganizationName
string, up to 256 chars,Required
Text recording a name of
this organization in the
specified language
and/or writing script.
End:OrderProductResponse. OrderProductResponseDetail. Product. Organization.Competitors. Competitor. OrganizationPrimaryName
/Aggregate
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 563
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Competitors.Competitor. SalesRevenueAmount
decimal, Optional(Infinite) [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.
Monitor Path:
//Organization
/Competitors
/Competitor
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Competitors.Competitor. SalesRevenueAmount @UnitOfSize
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Competitors.Competitor. SalesRevenueAmount @CurrencyISOAlpha3Code
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Competitors.Competitor. SalesRevenueAmount @ReliabilityText
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 564
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Competitors.Competitor. IndividualEmployeeQuantity
long, Optional [M+]
A number that defines
how many people are
directly engaged and paid
by the organization to
perform or support its
business operations.
Monitor Path:
//Organization
/Competitors
/Competitor
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Competitors.Competitor. IssuedShareCapitalAmount
decimal, Optional [M+]
The total dollar amount
of capital authorized for
all classes of issued stock.
Monitor Path:
//Organization
/Competitors
/Competitor
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Competitors.Competitor. IssuedShareCapitalAmount @UnitOfSize
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Competitors.Competitor. IssuedShareCapitalAmount @CurrencyISOAlpha3Code
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Competitors.Competitor. IssuedShareCapitalAmount @ReliabilityText
End: OrderProductResponse. OrderProductResponseDetail. Product. Organization.Competitors. Competitor
/Aggregate
End: OrderProductResponse. OrderProductResponseDetail. Product. Organization.Competitors
/Aggregate
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 565
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Events Aggregate, Optional
Records the information
about events that have
either involved or
affected the subject
(usually an organization,
but sometimes an
individual who is an
owner or principal of an
organization). It covers
legal events, significant
events and financing
events.
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Events.PublicFilingHeader
Aggregate, Optional
Records the information
about Legal and
Financing Events.
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Events.PublicFilingHeader. DisclaimerText
string, up to 720 chars,Optional [M]
The text that intended to
specify or delimit the
scope of rights and
obligations that may be
exercised and enforced
by parties in a legally-
recognized relationship.
In contrast to other
terms for legally
operative language, the
term disclaimer usually
implies situations that
involve some level of
uncertainty, waiver, or
risk.
End: OrderProductResponse. OrderProductResponseDetail. Product. Organization. Events.PublicFilingHeader
/Aggregate
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 566
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Events.LegalEvents
Aggregate, Optional
Records legal actions
targeting the subject,
such as criminal
proceedings, protested
bills, county court
judgments,
receiverships,
bankruptcies.
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Events.LegalEvents. ClaimsIndicator
boolean, Optional [M]
When TRUE (set to 1),it
indicates that open claim
(s), lien(s), protested bill
(s), warrant(s), Social
Securities Summon(s)
and/or equivalent exist
in the D&B database for
this subject. When FALSE
(set to 0),it indicates that
no open claim(s), lien(s),
protested bill(s), warrant
(s), Social Securities
Summon(s) and/or
equivalent exist in the
D&B database for this
subject.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 567
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Events.LegalEvents. SuitsAndOrJudgmentsIndicator
boolean, Optional [M]
When TRUE (set to 1),it
indicates that open suits,
judgments, petitions or
payment remarks exist in
the D&B database for
this subject. When FALSE
(set to 0),it indicates that
no open suits,
judgments, petitions or
payment remarks exist in
the D&B database for
this subject.
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Events.LegalEvents. CriminalProceedingsIndicator
boolean, Optional [M]
When TRUE (set to 1),it
indicates that criminal
proceedings against the
subject exists in the D&B
database. When FALSE
(set to 0),it indicates that
no criminal proceedings
against the subject
exists in the D&B
database.
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Events.LegalEvents. DebarmentsInformation
Aggregate, Optional
Records the details and
the summarized views
about the exclusion of
the subject from
participating in a
procurement activity for
an extended period of
time as specified by law,
because of previous
illegal or irresponsible
action
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 568
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Events.LegalEvents. DebarmentsInformation. DebarmentsSummary
Aggregate, Required
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Events.LegalEvents. DebarmentsInformation. DebarmentsSummary. TotalFilingCount
integer, Optional [M]
The total number of all
legal events of the type
covered by this summary.
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization. Events.LegalEvents. DebarmentsInformation. DebarmentsSummary
/Aggregate
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization. Events.LegalEvents. DebarmentsInformation
/Aggregate
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Events.LegalEvents. FinancialEmbarrassmentIndicator
boolean, Optional [M]
When TRUE (set to 1),it
indicates that open
bankruptcy, receivership
liquidation or equivalent
exist in the D&B
database for this subject.
When FALSE (set to 0),it
indicates that no open
bankruptcy, receivership
liquidation or equivalent
exist in the D&B
database for this subject.
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization. Events.LegalEvents
/Aggregate
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Events.FinancingEvents
Aggregate, Optional
Records the information
about the events which
have occurred and
directly affect the
subject's finances. For
example, the means by
which moneys are
obtained by the subject,
financial securities which
have been filed which
affect the subject.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 569
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Events.FinancingEvents. SecuredFilingsIndicator
boolean, Optional [M]
When 'true' indicates
that open secured filings
such as secured
charges/mortgages
pledgings or equivalent
exist in the D&B
database.
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization. Events.FinancingEvents
/Aggregate
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Events.SignificantEvents
Aggregate, Optional
Records information
about key events which
may affect the subject. It
covers such things as:
natural disasters (e.g.,
floods, hurricane),
accidents (e.g., chemical
spillage), major events at
the business (e.g.,change
of control,business
interruption, awarded
contract), societal events
(e.g., war, civil
disturbance).
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Events.SignificantEvents. DisasterSpecialEventsIndicator
boolean, Optional [M]
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization. Events.SignificantEvents
/Aggregate
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 570
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Events.OperationalSpecialEventsIndicator
boolean, Optional [M]
When 'true' indicates
that there are one or
more special events
concerning changes to
operational aspects of
the organization
recorded in D&B's
databases for this
subject. This may include
but is not limited to
name changes, change
in management, change
of control, address
change.
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Events.FinancialOrLegalOrSpecialEventsIndicator
boolean, Optional [M]
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Events.OtherSpecialEventsIndicator
boolean, Optional [M]
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization. Events /Aggregate
OrderProductResponse. OrderProductResponseDetail. Product. Organization.FinancialAssetArticle
Aggregate, Optional
Records information on
tangible items of value
that a subject owns,
holds, or manages. It may
provide additional
information, such the
number of assets of a
particular type, the
details about specific
assets, the asset's
financial value, the
asset's registration
information, and
identification of other
subjects involved in the
asset (e.g., insurer).
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 571
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.FinancialAssetArticle. AssetArticleSummary
Aggregate, Optional(Infinite)
An entry loop specifies
what kinds of items of
value are held, owned, or
managed by an
organization or
unclassified subject. It
may also specify the
quantity and the general
asset category.
OrderProductResponse. OrderProductResponseDetail. Product. Organization.FinancialAssetArticle. AssetArticleSummary. AssetTypeText
string, up to 256 chars,Required [M+]
Text identifying the kind
of item of value that is
held, owned, or managed
by the subject, e.g., truck,
office equipment,
freighter, textile goods,
accounts receivables.
Possible values: SCoTS
Decode of 11340
[Computer Equipment]
Monitor Path:
//Organization
/FinancialAssetArticle
/AssetArticleSummary
/AssetTypeText@DNBCo
deValue
OrderProductResponse. OrderProductResponseDetail. Product. Organization.FinancialAssetArticle. AssetArticleSummary. AssetTypeText @DNBCodeValue
integer, up to 7 digits,Attribute (1x)
Possible values: 11340
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 572
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.FinancialAssetArticle. AssetArticleSummary. AssetArticleQuantity
integer, up to 6 digits,Optional [M]
A numeric value
specifying how many of
this particular asset type
are held, owned, or
managed by the subject.
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization.FinancialAssetArticle. AssetArticleSummary
/Aggregate
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization.FinancialAssetArticle
/Aggregate
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Banking Aggregate, Optional
Records details of any
Banks or other financial
institutions at which the
subject has an account.
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Banking. Bank Aggregate, Optional(Infinite)
An entry loop which can
repeat multiple times to
allow the recording of
name and address of any
Banks or other financial
institutions at which the
subject has an account.
This includes any
identification numbers
for the particular branch
of the Bank and the
number of the subjects
account.
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 573
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Banking. Bank.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. Banking. Bank.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. Banking. Bank.OrganizationName. OrganizationPrimaryName. OrganizationName
string, up to 256 chars,Required [M]
Text recording a name of
this organization in the
specified language
and/or writing script.
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization. Banking.Bank. OrganizationName. OrganizationPrimaryName
/Aggregate
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization. Banking.Bank. OrganizationName
/Aggregate
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization. Banking.Bank
/Aggregate
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization. Banking /Aggregate
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 574
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.ThirdPartyAssessment
Aggregate, Optional
Records the
appraisal/opinion
assigned to this Subject
by an entity other than
the D&B Worldwide
Network (WWN).
OrderProductResponse. OrderProductResponseDetail. Product. Organization.ThirdPartyAssessment. ThirdPartyAssessment
Aggregate, Optional(Infinite)
An entry loop which can
repeat multiple times to
allow the recording of
the appraisals/opinions
assigned to this Subject
by an entity other than
the D&B Worldwide
Network (WWN).
OrderProductResponse. OrderProductResponseDetail. Product. Organization.ThirdPartyAssessment. ThirdPartyAssessment. AssessmentValue
string, Optional [M+]
Text that records
appraisal/opinion that
was assigned to this
Subject by a third party.
Monitor Path:
//Organization
/ThirdPartyAssessment
/ThirdPartyAssessment
D&B Direct API Documentation Product Response
©Dun & Bradstreet, Inc. 2014 575
Name Characteristics
OrderProductResponse. OrderProductResponseDetail. Product. Organization.ThirdPartyAssessment. ThirdPartyAssessment. AssessmentTypeValue
string, Optional [M+]
An alphanumeric value
as assigned by the third
party to define the kind
of appraisal/opinion that
was assigned to this
subject by the third
party, e.g., Moody's Long
Term Obligation Rating,
FICO score, Vantage
Score.
Monitor Path:
//Organization
/ThirdPartyAssessment
/ThirdPartyAssessment
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization.ThirdPartyAssessment. ThirdPartyAssessment
/Aggregate
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization.ThirdPartyAssessment
/Aggregate
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization /Aggregate
OrderProductResponse. OrderProductResponseDetail. Product. InDateStatusText string, up to 256 chars,Optional
End: OrderProductResponse. OrderProductResponseDetail. Product /Aggregate
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.
Note: There may be additional request and/or response elements specified in the WSDL that are notapplicable for D&B Direct customers. Data elements that are not listed on this page are currently unusedby this operation.
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 givenelement does not include these attributes, the values provided in the statement header should be utilized.
D&B Direct API Documentation Currency Codes/Units
©Dun & Bradstreet, Inc. 2014 576
Abbreviated Territory Names
When present, the Territory Abbreviated Name field will contain local abbreviations, which may be based onstandard designations. For companies domiciled in the United States or Canada, this field will contain thesecond component of ISO 3166-2 codes. For example, the ISO 3166-2:US code for New Jersey is "US-NJ" andthe value "NJ" will be delivered in this field. Similarly, the ISO 3166-2:CA code for Ontario is "CA-ON" and thevalue "ON" will be delivered in this field.
Language/Character Sets
The text contained within D&B Direct 2.0 data layers is returned in English. Several reports, including theD&B Business Information Report (BIR), provide additional language options. Data layers are encoded usingthe ISO 8859-1 character set standard (also known as Latin-1), EXCEPT when the organization is domiciled inthe Czech Republic (CZ), Hungary (HU), Poland (PL) or Slovakia (SK). Data from these markets is currentlyencoded using the ISO 8859-2 (also known as Latin-2) character set standard.
Response Codes
Successful service requests will return a CM000 response code. Otherwise, one of the D&B Direct standardresponse 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, and SC001-SC012.
Product (Data Layer) Details
Title / Overview Link Product Code Countries Product Sample
Detailed Company Profile - Standard DCP_STD See chart XML
Detailed Company Profile - Enhanced DCP_ENH See chart XML
Detailed Company Profile - Premium DCP_PREM See chart XML
Alternative Detailed Company Profile - Standard DCP_ALT_STD See chart XML
Alternative Detailed Company Profile - Enhanced DCP_ALT_ENH See chart XML
Alternative Detailed Company Profile - Premium DCP_ALT_PREM See chart XML
Detailed Company Profile - SDMR DCP_SDMR See chart XML
Detailed Company Profile - WB1784 DCP_WB1784 See chart XML
Diversity Indicators - Standard DVR_STD See chart XML
Diversity Indicators - Enhanced DVR_ENH See chart XML
USA PATRIOT Act Plus PAC_PLUS See chart XML
D&B Direct API Documentation Abbreviated Territory Names
©Dun & Bradstreet, Inc. 2014 577
Data Dictionary
Copies of the request and response data field tables, with columns that permit filtering by specific productcode, are included in the service-specific Samples file mentioned in the following section.
Country Availability Chart
A chart detailing the availability of each D&B Direct product by country is included in the Samples file. Thischart also provides the country codes required by this service.
Samples (Download)
Request and response samples are available for this D&B Direct web services. The samples may cover avariety of scenarios (when applicable) and are designed for use in the test environment.
Firmographic Product Service
Extras: Samples, Data Dictionary, Country Chart(when applicable)
http://developer.dnb.com/docs/2.0/firmographic/3.1/DnB-
Firmographic.zip
Related Topics
{productservice}:RetrieveProduct (SOAP)
D&B Direct API Documentation Data Dictionary
©Dun & Bradstreet, Inc. 2014 578
Authentication ProcessBefore D&B Direct API services can be invoked, the credentials must be activated. Instructions and a link foractivating username/password combinations will be included in an email sent upon completion of theregistration process. If you do not receive an email, or unable to locate it, please contact the D&B supportteam for assistance (and specify if this a production, trial or sandbox related issue).
The system will generate a unique username for accounts created after December 6, 2013. Prior to that date,the customer-supplied email address was used as the username. No change is required for existing credentials.
Most of the D&B Direct products and features require contractual entitlement prior to production (and trial)environment access. Please refer to the data layer entitlement page for more details.
SOAP Authentication
All D&B Direct API services require that a valid username and password be provided in the SOAP header witheach call to an operation. The 2.0 services do not require that an API key be supplied.
If the credentials are valid and the associated account is entitled to access the product or feature, the requestwill be processed. If the authentication process fails, an error response code will be returned. The securityrelated response codes are prefixed with "SC."
Sample Request
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:com="http://services.dnb.com/CompanyServiceV2.0">
<soapenv:Header><wsse:Security soapenv:mustUnderstand="0" xmlns:wsse="http://do
cs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd" xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">
<wsse:UsernameToken wsu:Id="UsernameToken-11"><wsse:Username>MyUsername</wsse:Username><wsse:Password Type="http://docs.oasis-open.org/wss/2004/
01/oasis-200401-wss-username-token-profile-1.0#PasswordText">MyPassword</wsse:Password>
</wsse:UsernameToken></wsse:Security>
</soapenv:Header><soapenv:Body>
<!--Request Body as per the service schema-->
D&B Direct API Documentation Authentication Process
©Dun & Bradstreet, Inc. 2014 579
</soapenv:Body></soapenv:Envelope>
Response - Invalid Credentials
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
<soapenv:Body><com:MatchResponse ServiceVersionNumber="4.0" xmlns:com="http:/
/services.dnb.com/CompanyServiceV2.0"><TransactionDetail>
<ApplicationTransactionID>Id-b118ae275255a7cf0cfb742e</ApplicationTransactionID>
<ServiceTransactionID>Id-b118ae275255a7cf0cfb742e</ServiceTransactionID>
<TransactionTimestamp>2013-10-09T15:00:31</TransactionTimestamp>
</TransactionDetail><TransactionResult>
<SeverityText>Error</SeverityText><ResultID>SC001</ResultID><ResultText>Your user credentials are invalid. Please con
tact your D&B Representative or your local Customer Service Center.</ResultText>
</TransactionResult></com:MatchResponse>
</soapenv:Body></soapenv:Envelope>
REST Authentication
Implementation of D&B Direct API services using REST methodology involves obtaining anAuthentication Token, that is then submitted with subsequent requests during a particular session (up to eighthours).
Secure access to D&B Direct services is managed through the use of an Authentication Token, which can beobtained by sending an HTTP POST request to Authentication Service URL, passing a valid username andpassword in the HTTP header. The 2.0 services do not require that an API key be supplied. If the usercredentials are valid, an Authentication Token (valid for eight hours) will be returned back in theAuthorization tag in the HTTP header of the response.
D&B Direct API Documentation REST Authentication
©Dun & Bradstreet, Inc. 2014 580
Once an Authentication Token is obtained, it should be embedded in the HTTP header of all subsequentrequests. If the Authentication Token is valid and the user is entitled to access the product or feature beingrequested, the service will be processed and requested information returned as a JSON object. If theAuthentication Token is invalid, an error code will be returned in the JSON response.
Note: The D&B Direct REST implementation uses the BadgerFish approach for JSON with some minorvariations.
Sample Request - Get New Token
POST https://maxcvservices.dnb.com/rest/Authenticationx-dnb-user: MyUsernamex-dnb-pwd: MyPassword
A {version} parameter is not required when initiating a request to the Authentication service.
Response - Success
HTTP/1.1 200 OKDate: Wed, 09 Oct 2013 18:47:22 GMTAuthorization: <MyToken>x-dnb-user: MyUsernamex-dnb-pwd: MyPassword
Response - Failed
HTTP/1.1 401 ERRORDate: Wed, 09 Oct 2013 18:51:11 GMTAuthorization: INVALID CREDENTIALSx-dnb-user: MyUsernamex-dnb-pwd: MyPassword
Sample Request - Invoke Operation with Token
GET https://maxcvservices.dnb.com/V4.0/organizations?CountryISOAlpha2Code=US&SubjectName=GORMAN%20MANUFACTURING&match=true&MatchTypeText=Advanced&TerritoryName=CAAuthorization: <MyToken>
Response - Expired Authentication Token
HTTP/1.1 401 UNAUTHORIZEDDate: Thu, 10 Oct 2013 14:55:19 GMT
D&B Direct API Documentation REST Authentication
©Dun & Bradstreet, Inc. 2014 581
Authorization: <MyToken>Content-Type: application/jsonContent-Encoding: gzip
{"MatchResponse": {"TransactionDetail": {
"ApplicationTransactionID": "REST","ServiceTransactionID": "Id-c04bbdff5256bfd70a7b742e","TransactionTimestamp": "2013-10-10T10:55:19"
},"TransactionResult": {
"SeverityText": "Error","ResultID": "SC001","ResultText": "Your user credentials are invalid. Please contact
your D&B Representative or your local Customer Service Center."}
}}
D&B Direct API Documentation REST Authentication
©Dun & Bradstreet, Inc. 2014 582
Obtaining CredentialsAccess to the D&B Direct web services are secured by a username and password combination. D&B will issueyour organization a production username upon completion of the contract establishment process. Thisusername will be sent to the email address designated on the contract, along with instructions for setting upthe password. This process will also be followed for production trial requests.
D&B offers a non-billable environment (commonly referred to as the sandbox) for testing the D&B Direct webservices. Developers may establish, via a self-service interface, sandbox user id and password combinations.The production credentials assigned to your organization may NOT be used in the sandbox environment toauthenticate web services, and vice-versa.
Before D&B Direct API services can be invoked, the credentials must be activated. Instructions and a link foractivating username/password combinations will be included in an email sent upon completion of theregistration process. If you do not receive an email, or unable to locate it, please contact the D&B supportteam for assistance (and specify if this a production, trial or sandbox related issue).
The system will generate a unique username for accounts created after December 6, 2013. Prior to that date,the customer-supplied email address was used as the username. No change is required for existing credentials.
Most of the D&B Direct products and features require contractual entitlement prior to production (and trial)environment access. Please refer to the data layer entitlement page for more details.
D&B Direct API Documentation Obtaining Credentials
©Dun & Bradstreet, Inc. 2014 583
Data Layer EntitlementD&B Direct 2.0 services are provisioned to customers at the data layer, which, for some of the features, mightnot be intuitive. This page is intended to help developers clearly understand what services and operations theyare entitled to use.
Components Requiring Entitlement
Data Layer: Detailed Company ProfileService: Firmographic Product ServiceOperation: OrderProduct() + DCP_STD; DCP_ENH; DCP_PREMProducts: Detailed Company Profile - Standard; Enhanced; Premium.
Data Layer: Alternate Detailed Company ProfileService: Firmographic Product ServiceOperation: OrderProduct() + DCP_ALT_STD; DCP_ALT_ENH; DCP_ALT_PREMProducts: Alternative Detailed Company Profile - Standard; Enhanced; Premium.
Data Layer: Detailed Company Profile - Strategic Database Marketing Record LayoutService: Firmographic Product ServiceOperation: OrderProduct() + DCP_SDMRProducts: Detailed Company Profile - SDMR
Data Layer: Detailed Company Profile - WorldBase 1784 LayoutService: Firmographic Product ServiceOperation: OrderProduct() + DCP_WB1784Products: Detailed Company Profile - WB1784
Data Layer: Diversity IndicatorsService: Firmographic Product ServiceOperation: OrderProduct() + DVR_STD; DVR_ENHProducts: Diversity Indicators - Standard; Enhanced.
Data Layer: USA Patriot Act PlusService: Firmographic Product ServiceOperation: OrderProduct() + PAC_PLUSProduct: USA PATRIOT Act Plus.
Components Not Requiring Entitlement
These items are available to customers who have one or more entitled data layers.
D&B Direct API Documentation Data Layer Entitlement
©Dun & Bradstreet, Inc. 2014 584
Standard ElementsWhenever a D&B Direct data or report product request returns a single D-U-N-S Number, several businesselements 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 theMonitoring process.
*The D-U-N-S Number of the organization referenced in the results. In the case of a trade up, this will be theheadquarters D-U-N-S Number.
**This is an identification number that can be used to retrieve a given results package at a later date from theProduct Request Archive.
Name Description XML* JSON*
D-U-N-S Number The D-U-N-S Number is D&B's identification number, which provides uniqueidentification of this organization, in accordance with the Data Universal NumberingSystem (D-U-N-S). This DUNS Number represents the business entity.
SOAP REST
Country Code The two-letter country code, defined by the International Organization forStandardization (ISO) ISO 3166-1 scheme identifying the country of the businessentity.
SOAP REST
County Name Text recording the name of the county in which the business is located. SOAP REST
Family TreeMember Role
Text recording of various parts that the Subject plays as a member of an ownershipstructured family tree.
SOAP REST
FAX Number The FAX number of the business. SOAP REST
FAX NumberInternationalDialing Code
The FAX number international dialing code of the business. SOAP REST
Mailing CountryCode
The two-letter country code, defined by the International Organization forStandardization (ISO) ISO 3166-1 scheme identifying the country which the businessuses for mailing purposes.
SOAP REST
Mailing CountyName
Text recording the name of the county which the business uses for mailing purposes. SOAP REST
Mailing PostalCode
An identifier used by the local country Postal Authority which the business uses formailing purposes.
SOAP REST
Mailing Street Text recording an address which is mainly utilized for the purpose of mail delivery tothe business. This usually includes a Post Office Box number or similar mailing details.
SOAP REST
D&B Direct API Documentation Standard Elements
©Dun & Bradstreet, Inc. 2014 585
Name Description XML* JSON*
Mailing Street (2) Text recording an address which is mainly utilized for the purpose of mail delivery tothe business. This usually includes a Post Office Box number or similar mailing details.
SOAP REST
Mailing TerritoryAbbreviation
Text recording the shortened name of the locally governed area which forms part of acentrally governed nation which the business uses for mailing purposes.
SOAP REST
Mailing TerritoryName
Text recording the name of the locally governed area which forms part of a centrallygoverned nation which the business uses for mailing purposes.
SOAP REST
Mailing TownName
The address number, or post office box number, and street name which a businessuses for mailing purposes.
SOAP REST
Postal Code An identifier used by the local country Postal Authority to identify where the businessis located.
SOAP REST
Primary BusinessName
Text recording of a single name by which the organization is primarily known oridentified.
SOAP REST
StandaloneOrganizationIndicator
When true indicates that this organization is not a member of a legal family tree. TheSubject has no Parent Company, no subsidiaries or no branch/division locations.
SOAP REST
Street Address Text recording the address number, or post office box number and street namewhere the business is located.
SOAP REST
Street Address(2)
Text recording the address number, or post office box number and street namewhere the business is located.
SOAP REST
TelephoneNumber
The telephone number of the business. SOAP REST
TelephoneNumberInternationalDialing Code
The telephone number international dialing code of the business. SOAP REST
TerritoryAbbreviatedName
Text recording the shortened name of the locally governed area which forms part of acentrally governed nation to identify where the business is located.
SOAP REST
Territory Name Text recording the name of the locally governed area which forms part of a centrallygoverned nation to identify where the business is located.
SOAP REST
Town Name Text recording the name of a city, town, township, village, borough, etc. where thebusiness is located.
SOAP REST
Trade Style Name Text recording the name which an organization trades under for commercialpurposes although its registered legal name used for contracts and other formalsituations may be another name.
SOAP REST
D&B Direct API Documentation Standard Elements
©Dun & Bradstreet, Inc. 2014 586
Standard Elements (REST)The following data fields are included on all OrderProduct() and OrderCompanyReport() operation responses.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.
Name Characteristics
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 { Location
Location, Optional
Records the address details for a subject. An address is the designation
of a place where a subject can be located or may be communicated
with, e.g., primary address, registered address, mailing address.
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
StreetAddressLine, 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
D&B Direct API Documentation Standard Elements (REST)
©Dun & Bradstreet, Inc. 2014 587
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { 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 /Location /PrimaryAddress
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { PrimaryAddress { CountyOfficialName
string up to 64 chars., Optional [C] [M+]
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+]
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 { MailingAddress { StreetAddressLine
StreetAddressLine, 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.
D&B Direct API Documentation Standard Elements (REST)
©Dun & Bradstreet, Inc. 2014 588
Name Characteristics
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 { 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 /Location /MailingAddress
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { MailingAddress { CountyOfficialName
string up to 64 chars., Optional [C] [M+]
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+]
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
D&B Direct API Documentation Standard Elements (REST)
©Dun & Bradstreet, Inc. 2014 589
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Telecommunication { TelephoneNumber { TelecommunicationNumber
string at least 1 chars. 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.
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 chars. 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.
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Telecommunication { FacsimileNumber { 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 { 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.
D&B Direct API Documentation Standard Elements (REST)
©Dun & Bradstreet, Inc. 2014 590
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationName { TradeStyleName
OrganizationNameBaseType, 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 { 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; Affiliate
Monitor Path: //Organization /OrganizationDetail
/FamilyTreeMemberRole
OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationDetail { FamilyTreeMemberRole { FamilyTreeMemberRoleText@DnbCodeValue
Attribute
Possible values: 9159 (Subsidiary); 12769 (Branch); 12770 (Division);
12771 (Headquarters); 12773 (Parent); 12774 (Domestic Ultimate);
12775 (Global Ultimate); 15388 (Affiliate)
OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationDetail { StandaloneOrganizationIndicator
boolean, Optional [C] [M]
When true (set to 1) it 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 (set to 0) it indicates that this organization is a
member of a legal family tree. In this condition the
FamilyTreeMemberRoleText must be present.
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { MailingAddress { 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 /Location /MailingAddress
D&B Direct API Documentation Standard Elements (REST)
©Dun & Bradstreet, Inc. 2014 591
Name Characteristics
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { 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 /Location /PrimaryAddress
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
D&B Direct API Documentation Standard Elements (REST)
©Dun & Bradstreet, Inc. 2014 592
Standard Elements (SOAP)The following data fields are included on all OrderProduct() and OrderCompanyReport() operation responses.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.
Name Characteristics
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. Location
Location, Optional
Records the address details for a subject. An address is the designation
of a place where a subject can be located or may be communicated
with, e.g., primary address, registered address, mailing address.
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
StreetAddressLine, 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
D&B Direct API Documentation Standard Elements (SOAP)
©Dun & Bradstreet, Inc. 2014 593
Name Characteristics
OrderProductResponse.OrderProductResponseDetail. Product.Organization. Location. 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 /Location /PrimaryAddress
OrderProductResponse.OrderProductResponseDetail. Product.Organization. Location. PrimaryAddress.CountyOfficialName
string up to 64 chars., Optional [C] [M+]
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+]
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. MailingAddress.StreetAddressLine
StreetAddressLine, 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.
D&B Direct API Documentation Standard Elements (SOAP)
©Dun & Bradstreet, Inc. 2014 594
Name Characteristics
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.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 /Location /MailingAddress
OrderProductResponse.OrderProductResponseDetail. Product.Organization. Location. MailingAddress.CountyOfficialName
string up to 64 chars., Optional [C] [M+]
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+]
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
D&B Direct API Documentation Standard Elements (SOAP)
©Dun & Bradstreet, Inc. 2014 595
Name Characteristics
OrderProductResponse.OrderProductResponseDetail. Product.Organization. Telecommunication.TelephoneNumber.TelecommunicationNumber
string at least 1 chars. 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.
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 chars. 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.
OrderProductResponse.OrderProductResponseDetail. Product.Organization. Telecommunication.FacsimileNumber. 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. 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.
D&B Direct API Documentation Standard Elements (SOAP)
©Dun & Bradstreet, Inc. 2014 596
Name Characteristics
OrderProductResponse.OrderProductResponseDetail. Product.Organization. OrganizationName.TradeStyleName
OrganizationNameBaseType, 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. 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; Affiliate
Monitor Path: //Organization /OrganizationDetail
/FamilyTreeMemberRole
OrderProductResponse.OrderProductResponseDetail. Product.Organization. OrganizationDetail.FamilyTreeMemberRole.FamilyTreeMemberRoleText@DnbCodeValue
Attribute
Possible values: 9159 (Subsidiary); 12769 (Branch); 12770 (Division);
12771 (Headquarters); 12773 (Parent); 12774 (Domestic Ultimate);
12775 (Global Ultimate); 15388 (Affiliate)
OrderProductResponse.OrderProductResponseDetail. Product.Organization. OrganizationDetail.StandaloneOrganizationIndicator
boolean, Optional [C] [M]
When true (set to 1) it 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 (set to 0) it indicates that this organization is a
member of a legal family tree. In this condition the
FamilyTreeMemberRoleText must be present.
OrderProductResponse.OrderProductResponseDetail. Product.Organization. Location. MailingAddress.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 /Location /MailingAddress
D&B Direct API Documentation Standard Elements (SOAP)
©Dun & Bradstreet, Inc. 2014 597
Name Characteristics
OrderProductResponse.OrderProductResponseDetail. Product.Organization. Location. 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 /Location /PrimaryAddress
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
D&B Direct API Documentation Standard Elements (SOAP)
©Dun & Bradstreet, Inc. 2014 598
Country CodesMany of the D&B Direct web services expect to receive a country code for the company specified by the D-U-N-S Number being requested. This input parameter is case-sensitive and must be supplied in upper case.On some requests, this parameter is optional; however, D&B recommends that it be provided to reduce theresponse time of the service(s) -- including products limited to results for US companies.
D&B Direct services utilize the two-letter country code as defined by the International Organization forStandardization (ISO) in their ISO 3166-1 specification. For a list of actual country codes supported for aspecific data layer, please refer to the Country Availability tab contained in the downloadable "Extras" file forthe respective Service.
Code Substitutions
Data for the following countries is stored under the alternate country code specified.
Country Name Alternate Instructions
ABU DHABI Use the code of United Arab Emirates (AE)
ADMIRALTY ISLANDS Use the code of Papua New Guinea (PG)
AJMAN Use the code of United Arab Emirates (AE)
AL AIN Use the code of United Arab Emirates (AE)
ASCENSION ISLAND Use the code SH (Saint Helena, Ascension and Tristan da Cunha)
Cocos (Keeling) Islands Use the code AU (Australia)
DUBAI Use the code of United Arab Emirates (AE)
FUJAIRAH Use the code of United Arab Emirates (AE)
MIDWAY ISLANDS Use the code of US
RAS AL KHAIMAH Use the code of United Arab Emirates (AE)
SHARJAH Use the code of United Arab Emirates (AE)
SOUTH SANDWICH ISLANDS Use the code GS (South Georgia and the South Sandwich Islands)
South Sudan Use the code of Sudan (SD)
TURKISH CYPRUS Use the code of Cyprus (Match is not supported)
UMM-AL-QUWAIN Use the code of United Arab Emirates (AE)
While some territories of the United States (e.g. Puerto Rico) have been assigned ISO country codes, theinformation on organizations from those areas will be located under the US country code.
Data Not Available
Data for the following countries is not currently available through the D&B Direct 2.0 API.
D&B Direct API Documentation Country Codes
©Dun & Bradstreet, Inc. 2014 599
Country Name ISO Code
Antarctica AQ
Åland Islands AX
Saint Barthélemy BL
Bonaire, Saint Eustatius and Saba BQ
Bouvet Island BV
CAROLINE ISLANDS ??
Cuba CU
Curaçao CW
Western Sahara EH
Micronesia, Federated States of FM
Guernsey GG
Heard Island and McDonald Islands HM
Isle of Man IM
British Indian Ocean Territory IO
Jersey JE
Korea, Democratic People's Republic of KP
Saint Martin (French part) MF
Mongolia MN
Niue NU
Pitcairn PN
Palestinian Territory, Occupied PS
Palau PW
Svalbard and Jan Mayen SJ
Sint Maarten (Dutch part) SX
French Southern Territories TF
Wallis and Futuna WF
Wake Island ??
Mayotte YT
Please contact your local D&B Customer Service department/representative for more details; or to place aninquiry for a specific organization.
D&B Direct API Documentation Country Codes
©Dun & Bradstreet, Inc. 2014 600
Response CodesWhenever a D&B Direct web service request is unsuccessful, one of the following response codes will bereturned.
Code Description HTTPStatus*
CM000 Success 200
CM001 The given request is invalid. 400
CM002 The format of this request is invalid. 400
CM003 Missing information in the request. 400
CM004 Internal D&B system error. 500
CM005 D&B System temporarily unavailable. 503
CM006 D&B System busy. 503
CM007 Your request cannot be fulfilled for the given criteria. 404
CM008 No match found for the requested Duns number. 404
CM009 Reason Code required for Germany. 400
CM010 Partial Success. 200
CM011 Invalid Country Code provided in the request. 400
CM012 Invalid Duns number provided in the request. 400
CM013 Invalid Subject ID provided in the request. 400
CM014 Invalid Product Code provided in the request. 400
CM016 Invalid Territory provided in the request. 400
CM017 Duns number is missing in the request. 400
CM018 No candidates resulted for the given input criteria. 404
CM022 Only a Subset of request parameters were used for processing the request. 200
CM023 Duplicate record cannot be created. 400
CM026 Request accepted. Processing pending. 200
CP001 No Match for the given input criteria. 404
CP002 No candidates resulted in the Extended Search. 404
CP003 No Match for given Telephone Number. 404
CP004 No Match for given Organization Identifier. 404
CP005 Insufficient Information to determine Fraud Score. 400
PD001 Requested product not available due to insufficient data. 404
PD002 Requested subject is promised later. Preliminary report returned. 200
PD003 Requested product not available - subject is on Stop Distribution. 404
D&B Direct API Documentation Response Codes
©Dun & Bradstreet, Inc. 2014 601
Code Description HTTPStatus*
PD004 Requested product not available due to subject information is too old. 404
PD005 Requested Product not available. 404
PD006 Subject is foreign branch, therefore trade-up to HQ is not available. 404
PD007 Family Tree does not exist for requested subject. 404
PD008 Success. Returned truncated family tree, as family tree member countexceeds maximum limit for requested subject.
200
PD009 Required scoring elements missing - a Commercial or Blended Small Businessreport is not available. You may proceed with a Principal only request.
200
PD010 Requested Product not available as address is undeliverable. 200
PD011 Requested Product not available as address is undeliverable. 404
PD012 Requested Product not available on Self request. 404
PD013 Requested Product is not available currently. Product will be delivered to thecustomer at a later point of time via offline delivery channels (Email/FAX/FTPetc).
404
PD014 Requested data is not available or partially available due to data integrityerrors.
404
PD015 Trade-up to HQ is not available. Therefore delivering the data for branchorganization.
200
PD016 Requested Product is not available since the requested DUNS is transferred toa new DUNS.
200
SC001 Your user credentials are invalid. 401
SC002 Your user credentials are not eligible for this request. 401
SC003 Your user credentials have expired. 401
SC004 Your Subscriber number has expired. 401
SC005 You have reached maximum limit permitted as per the contract. 401
SC006 Transaction not processed as the permitted concurrency limit was exceeded. 401
SC007 Subscriber validation failed. 401
SC008 Your account has been locked out due to repeated attempts to login with anincorrect User ID/Password.
401
SC009 Invalid Sign On Token in the request. 401
SC010 The User ID you provided doesn’t exist in the system. n/a
SC011 The User ID you provided already exist in the system n/a
SC012 Request not processed as user activation key is invalid or expired. n/a
SC014 Your user credentials are not eligible for this request since you are in trialperiod.
401
BC001 Partial Success. One or more records in the input file were not processed. 200
D&B Direct API Documentation Response Codes
©Dun & Bradstreet, Inc. 2014 602
Code Description HTTPStatus*
BC002 Batch request is not processed since input file is not available in the specifiedlocation.
400
BC003 Batch request is not processed since the content of the input file is not in theexpected format.
400
BC004 Batch request is not processed since the count of the records specified in therequest do not match the exact count of records in the input file.
400
BC005 Intermediate Success 200
BC006 Batch request is not processed 400
BC007 Batch Execution in progress n/a
BC008 Batch Execution not yet started n/a
BC009 Batch not processed as the input file contains more records than thepermitted limit.
400
BC010 Batch files no longer available after retention period. 200
BC011 Invalid Batch Process Id provided in the request. 400
MN001 Invalid Monitoring Profile ID provided in the request. 400
MN002 Invalid Notification Profile ID provided in the request. 400
MN003 Product not registered for Level 2 Monitoring 400
MN004 Cannot delete Monitoring Profile - registrations exist 400
MN005 Cannot delete Notification Profile - registrations exist. 400
*This column displays the corresponding HTTP status code that will be returned for REST API calls.
D&B Direct API Documentation Response Codes
©Dun & Bradstreet, Inc. 2014 603
Sandbox AccessD&B Direct provides a test environment (referred to as the sandbox) that requires a separate set of credentials.Service requests made with sandbox credentials should be issued using the same endpoints (and in the case ofSOAP, using the same WSDL file).
When conducting testing in the production environment during a trial period, product requests will be limitedto the local market of the customer.
Some D&B Direct products and features may behave differently in the sandbox environment. Any limitationsor restrictions will be specified on the operation page for each interface.
Test Parameter Values
The following suggested parameters may be used for test environment (sandbox) requests to retrievesuccessful responses.
Product Test D-U-N-S Number(s)
Detailed Company Profile 804735132 (US); 362241452 (US); 214567885 (GB); 754683795 (AU); 481794956(CH)
Alternative Detailed CompanyProfile
804735132 (US); 362241452 (US); 214567885 (GB); 754683795 (AU); 481794956(CH)
Diversity Indicators 804735132 (US); 362241452 (US); 214567885 (GB); 754683795 (AU); 481794956(CH)
USA PATRIOT Act Plus 804735132 (US); 362241452 (US); 214567885 (GB); 754683795 (AU); 481794956(CH)
Company Reports
Country Reports
Static Responses
Some operations currently return a static set of results, regardless of the request parameters, in the testenvironment.
D&B Direct API Documentation Sandbox Access
©Dun & Bradstreet, Inc. 2014 604
Company Service
Match, GetCleanseMatch, SearchByFilingName, SearchByFilingNumber, and CleanseAndStandardize will returna static response in the Sandbox environment.
Entity List Service
FindCompany, FindContact, FindCompetitor, and FindIndustry will return a static response in the Sandboxenvironment.
D&B Direct API Documentation Company Service
©Dun & Bradstreet, Inc. 2014 605
{data products}:RetrieveProduct (REST)This operation -- included in all data and report product services (listed below)-- provides access to the productrequest archive. Assets may also be retrieved by using the Portfolio:RetrievePortfolioAsset (REST) operation.
Service Request Response*
Firmographic Product Service RetrieveProduct() same as OrderProduct()
*The response data field names will be prefixed with "RetrieveProductResponse.RetrieveProductResponseDetail" instead
of "OrderProductResponse.OrderProductResponseDetail".
Request Parameters
The following parameters are accepted by this operation; however, the requirements for a specific requestmay differ based the product being requested.
Name Characteristics
ApplicationTransactionID string up to 64 chars., Optional
A number assigned by the
calling application to uniquely
identify this request.
TransactionTimestamp DateTimestamp, Optional
The date and time when this
request was created. When
the request is from an
intermediary, such as a
workflow manager or service
bus, this is the date and time
when the message was sent to
the D&B function, i.e., the date
and time when the xml
document was created by the
requesting intermediary.
D&B Direct API Documentation {data products}:RetrieveProduct (REST)
©Dun & Bradstreet, Inc. 2014 606
Name Characteristics
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.
{assetID} long, Required
Response Data Fields
Refer to the respective OrderProduct operation for each service. For example, a request fromAssessment:RetrieveProduct() will return the same response as Assessment:OrderProduct(). The responseitems, however, will be prefixed with "RetrieveProductResponse.RetrieveProductResponseDetail" insteadof "OrderProductResponse.OrderProductResponseDetail".
Language/Character Sets
The text contained within D&B Direct 2.0 data layers is returned in English. Several reports, including theD&B Business Information Report (BIR), provide additional language options. Data layers are encoded usingthe ISO 8859-1 character set standard (also known as Latin-1), EXCEPT when the organization is domiciled inthe Czech Republic (CZ), Hungary (HU), Poland (PL) or Slovakia (SK). Data from these markets is currentlyencoded using the ISO 8859-2 (also known as Latin-2) character set standard.
Response Codes
Successful service requests will return a CM000 response code. Otherwise, one of the D&B Direct standardresponse codes will be returned.
This operation may return the following response codes: CM001, CM002, CM003, CM004, CM005, CM006,PT001, and SC001-SC009.
Operation-specific supplemental response code explanations:
PT001 No Portfolio asset not found for given portfolio asset identifier or investigation tracking ID or assetremoved from archive.
D&B Direct API Documentation Response Data Fields
©Dun & Bradstreet, Inc. 2014 607
SOAP Interface
This operation is also available using the SOAP architecture. Refer to {data products}:RetrieveProduct (SOAP)for details.
D&B Direct API Documentation SOAP Interface
©Dun & Bradstreet, Inc. 2014 608
{data products}:RetrieveProduct (SOAP)This operation -- included in all data and report product services (listed below)-- provides access to the productrequest archive. Assets may also be retrieved by using the Portfolio:RetrievePortfolioAsset (REST) operation.
Service Request Response*
Firmographic Product Service RetrieveProduct() same as OrderProduct()
*The response data field names will be prefixed with "RetrieveProductResponse.RetrieveProductResponseDetail" instead
of "OrderProductResponse.OrderProductResponseDetail".
Request Parameters
The following parameters are accepted by this operation; however, the requirements for a specific requestmay differ based the product being requested.
Name Characteristics
RetrieveProductRequest Aggregate
RetrieveProductRequest@ServiceVersionNumber Attribute
RetrieveProductRequest. TransactionDetail Aggregate, Optional
Records information necessary to process this request.
RetrieveProductRequest. TransactionDetail.ApplicationTransactionID
string up to 64 chars., Optional
A number assigned by the calling application to uniquely identify this
request.
RetrieveProductRequest. TransactionDetail.TransactionTimestamp
DateTimestamp, Optional
The date and time when this request was created. When the
request is from an intermediary, such as a workflow manager or
service bus, this is the date and time when the message was sent to
the D&B function, i.e., the date and time when the xml document
was created by the requesting intermediary.
RetrieveProductRequest. TransactionDetail.SubmittingOfficeID
string up to 64 chars., Optional
A number that identifies the system or the software application
from where this request originated. / A number used to uniquely
identfy the D&B business segment or delivery channel from where
this request originated.
END: RetrieveProductRequest. TransactionDetail /Aggregate
D&B Direct API Documentation {data products}:RetrieveProduct (SOAP)
©Dun & Bradstreet, Inc. 2014 609
Name Characteristics
RetrieveProductRequest.RetrieveProductRequestDetail
Aggregate, Required
RetrieveProductRequest.RetrieveProductRequestDetail. ArchiveDetail
Aggregate, Required
RetrieveProductRequest.RetrieveProductRequestDetail. ArchiveDetail.PortfolioAssetID
long, Required
END: RetrieveProductRequest.RetrieveProductRequestDetail. ArchiveDetail
/Aggregate
END: RetrieveProductRequest.RetrieveProductRequestDetail
/Aggregate
END: RetrieveProductRequest /Aggregate
Response Data Fields
Refer to the respective OrderProduct operation for each service. For example, a request fromAssessment:RetrieveProduct() will return the same response as Assessment:OrderProduct(). The responseitems, however, will be prefixed with "RetrieveProductResponse.RetrieveProductResponseDetail" insteadof "OrderProductResponse.OrderProductResponseDetail".
Language/Character Sets
The text contained within D&B Direct 2.0 data layers is returned in English. Several reports, including theD&B Business Information Report (BIR), provide additional language options. Data layers are encoded usingthe ISO 8859-1 character set standard (also known as Latin-1), EXCEPT when the organization is domiciled inthe Czech Republic (CZ), Hungary (HU), Poland (PL) or Slovakia (SK). Data from these markets is currentlyencoded using the ISO 8859-2 (also known as Latin-2) character set standard.
Response Codes
Successful service requests will return a CM000 response code. Otherwise, one of the D&B Direct standardresponse codes will be returned.
This operation may return the following response codes: CM001, CM002, CM003, CM004, CM005, CM006,PT001, and SC001-SC009.
Operation-specific supplemental response code explanations:
PT001 No Portfolio asset not found for given portfolio asset identifier or investigation tracking ID or assetremoved from archive.
D&B Direct API Documentation Response Data Fields
©Dun & Bradstreet, Inc. 2014 610
REST Interface
This operation is also available using the REST architecture. Refer to {data products}:RetrieveProduct (REST) fordetails.
D&B Direct API Documentation REST Interface
©Dun & Bradstreet, Inc. 2014 611
BadgerFish (REST)BadgerFish is a convention for translating an XML document into a JSON object. D&B Direct JSON responsesfollow this convention with a few minor variations. Exception: The responses supplied by the DataExchange Service follow the convention used by the respective business partner.
l Attributes will always be represented by prefixing with “@”. (see Example 2)l If an element is repeatable, that element will be always returned as an Array of objects in the JSON
response. (see Example 7)o If a repeatable element is not repeating in a specific JSON response, even then that element will
be returned as an Array having a single object. (see Example 9)l Element content will be represented with “$” if it has attributes (see Example 2)
o Consider a scenario where an element has an attribute as per the definition, however theattribute is not returned in a specific JSON response. Even then, the element content will berepresented as “$” in the JSON. (see Example 4)
l String values will be returned within double quotes. (see Example 14)l Numeric and Boolean values will not be returned within double quotes. (see Example 12 and Example
13)
Examples
# Scenario XML Instance JSON Instance
1 Element having noattribute
<DUNSNumber>804735132 </DUNSNumber> "DUNSNumber": "804735132"
2 Element havingAttribute
<FamilyTreeMemberRoleTextDNBCodeValue="12773">Parent</FamilyTreeMemberRoleText>
"FamilyTreeMemberRoleText": { "@DNBCodeValue": 12773, "$": "Parent" }
3 Aggregate havingattribute
<OrganizationIdentificationNumberDetailTypeText="Federal Taxpayer IdentificationNumber (US)" DNBCodeValue="6863"><OrganizationIdentificationNumber>12345</OrganizationIdentificationNumber></OrganizationIdentificationNumberDetail>
"OrganizationIdentificationNumberDetail":{ "@TypeText": "Federal TaxpayerIdentification Number (US)","@DNBCodeValue": 6863,"OrganizationIdentificationNumber":"12345" }
4 Element havingAttribute as perdefinition, howeverattribute is notreturned for aspecific JSONinstance
<OrganizationName>Gorman ManufacturingCompany, Inc. </OrganizationName>
"OrganizationName": { "$": "GormanManufacturing Company, Inc." }
D&B Direct API Documentation BadgerFish (REST)
©Dun & Bradstreet, Inc. 2014 612
# Scenario XML Instance JSON Instance
5 Aggregate havingAttribute as perdefinition, howeverattribute is notreturned for aspecific JSONinstance
<OrganizationIdentificationNumberDetail ><OrganizationIdentificationNumber>12345</OrganizationIdentificationNumber></OrganizationIdentificationNumberDetail>
"OrganizationIdentificationNumberDetail":{ "OrganizationIdentificationNumber":"12345" }
6 Non-RepeatingElement
<DUNSNumber>804735132 </DUNSNumber> "DUNSNumber": "804735132"
7 Repeating Element <SalesRevenueAmountCurrencyISOAlpha3Code="USD”>1000000</SalesRevenueAmount><SalesRevenueAmountCurrencyISOAlpha3Code="CAD”>1040000</SalesRevenueAmount>
"SalesRevenueAmount": [ { "@CurrencyISOAlpha3Code": "USD", "$":1000000 }, { "@CurrencyISOAlpha3Code":"CAD", "$": 1040000 } ]
8 Repeating Aggregate <FamilyTreeMemberRole><FamilyTreeMemberRoleTextDNBCodeValue="12773">Parent</FamilyTreeMemberRoleText></FamilyTreeMemberRole><FamilyTreeMemberRole><FamilyTreeMemberRoleTextDNBCodeValue="12775">Global Ultimate</FamilyTreeMemberRoleText></FamilyTreeMemberRole><FamilyTreeMemberRole><FamilyTreeMemberRoleTextDNBCodeValue="12774">Domestic Ultimate</FamilyTreeMemberRoleText></FamilyTreeMemberRole>
"FamilyTreeMemberRole": [ {"FamilyTreeMemberRoleText": { "@DNBCodeValue": 12773, "$": "Parent" }},{"FamilyTreeMemberRoleText": {
"@DNBCodeValue": 12775, "$": "GlobalUltimate" }},{"FamilyTreeMemberRoleText": { "@DNBCodeValue": 12774, "$": "DomesticUltimate" }} ]
9 Element isrepeatable as per thedefinition. Howeverit is not repeating ina specific JSONinstance.
<SalesRevenueAmountCurrencyISOAlpha3Code="USD”>1000000</SalesRevenueAmount>
"SalesRevenueAmount": [ { "@CurrencyISOAlpha3Code": "USD", "$":1000000 }]
10 Aggregate isrepeatable as per thedefinition. Howeverit is not repeating ina specific JSONinstance.
<FamilyTreeMemberRole><FamilyTreeMemberRoleTextDNBCodeValue="12773">Parent</FamilyTreeMemberRoleText></FamilyTreeMemberRole>
"FamilyTreeMemberRole": [ {"FamilyTreeMemberRoleText": { "@DNBCodeValue": 12773, "$": "Parent" }}]
11 Date Field <TransactionTimestamp>2013-07-11T11:08:48.067-04:00</TransactionTimestamp>
"TransactionTimestamp": "2013-07-11T11:10:39.110-04:00"
12 Boolean Field <StandaloneOrganizationIndicator>false</StandaloneOrganizationIndicator>
"StandaloneOrganizationIndicator": false
D&B Direct API Documentation Examples
©Dun & Bradstreet, Inc. 2014 613
# Scenario XML Instance JSON Instance
13 Numeric Field <RawScore>352</RawScore> "RawScore": 352
14 String Field <LineText>492 Koller Street</LineText> "LineText": "492 Koller Street"
D&B Direct API Documentation Examples
©Dun & Bradstreet, Inc. 2014 614
Firmographic Product Service - 3.0The following changes were implemented as part of the December 6, 2013 update:
1.a. Business Elements added to the Detailed Company Profile:
Name Description XML* JSON*
Bank Name Text recording the name of the banking organization with whom the businesssubject maintains an account. [C]
SOAP REST
Bonus - CurrentAmount
Bonus for the year, in requested currency. [C] SOAP REST
CurrentCompensationYear
Year of the current compensation details. [C] SOAP REST
DomesticUltimate Country
SOAP REST
DomesticUltimate PostalCode
An identifier used by the local country postal authority to identify where the domesticultimate is located.
SOAP REST
DomesticUltimate StreetAddress
Text recording the address number, or post office box number and street namewhere the domestic ultimate is located.
SOAP REST
DomesticUltimateTerritoryAbbreviatedName
Text recording the shortened name of the locally governed area which forms part of acentrally governed nation to identify where the domestic ultimate is located.
SOAP REST
DomesticUltimateTerritory Name
Text recording the name of the locally governed area which forms part of a centrallygoverned nation to identify where the domestic ultimate is located.
SOAP REST
DomesticUltimate TownName
Text recording the name of a city, town, township, village, borough, etc. where thedomestic ultimate is located.
SOAP REST
Employees at thisLocation
A number that defines how many people are directly engaged and paid by theorganization to perform or support its business operations at this location.
SOAP REST
Employees HereReliability Text
Text that describes the integrity of the employee figures e.g. audited, actual,estimated, modeled.
SOAP REST
FinancialStatement Date
The date when the accounting period ended. If the Reliability Code denotes thefigures are projected (future) then this is the date when the accounting period willend. [C]
SOAP REST
Global UltimateCountry Code
The two-letter country code, defined by the International Organization forStandardization (ISO) ISO 3166-1 scheme identifying the country of the global ultimatebusiness entity.
SOAP REST
D&B Direct API Documentation Firmographic Product Service - 3.0
©Dun & Bradstreet, Inc. 2014 615
Name Description XML* JSON*
Global UltimatePostal Code
An identifier used by the local country postal authority to identify where the globalultimate is located.
SOAP REST
Global UltimateStreet Address
Text recording the address number, or post office box number and street namewhere the global ultimate is located.
SOAP REST
Global UltimateTerritoryAbbreviatedName
Text recording the shortened name of the locally governed area which forms part of acentrally governed nation to identify where the global ultimate is located.
SOAP REST
Global UltimateTerritory Name
Text recording the name of the locally governed area which forms part of a centrallygoverned nation to identify where the global ultimate is located.
SOAP REST
Global UltimateTown Name
Text recording the name of a city, town, township, village, borough, etc. where theglobal ultimate is located.
SOAP REST
Head QuartersCountry
SOAP REST
HeadquartersPostal Code
An identifier used by the local country postal authority to identify where theheadquarters is located.
SOAP REST
HeadquartersStreet Address
Text recording the address number, or post office box number and street namewhere the headquarters is located.
SOAP REST
HeadquartersTerritoryAbbreviatedName
Text recording the shortened name of the locally governed area which forms part of acentrally governed nation to identify where the headquarters is located.
SOAP REST
HeadquartersTerritory Name
Text recording the name of the locally governed area which forms part of a centrallygoverned nation to identify where the headquarters is located.
SOAP REST
HeadquartersTown Name
Text recording the name of a city, town, township, village, borough, etc. where theheadquarters is located.
SOAP REST
Market ValueDate
The date on which the Capital Amount was first registered. SOAP REST
Most SeniorPrincipal -Current Bonus
Bonus of the most senior principal for the year, in requested currency. SOAP REST
Most SeniorPrincipal -CurrentCompensationYear
Year of the current compensation details. SOAP REST
Most SeniorPrincipal -Current Salary
Salary of the most senior principal the year, excluding bonus, in requested currency. SOAP REST
Most SeniorPrincipal -Current TotalSalary
Total compensation of the most senior principal for the year, including any bonus orother compensation, in requested currency
SOAP REST
D&B Direct API Documentation Firmographic Product Service - 3.0
©Dun & Bradstreet, Inc. 2014 616
Name Description XML* JSON*
Most SeniorPrincipal Age
The age of the principal in years. SOAP REST
Most SeniorPrincipal CurrentPosition
Text identifying the business function of the principal derived from a standardManagement Responsibility Code (MRC).
SOAP REST
Most SeniorPrincipal CurrentPosition StartDate
The date when the principal or manager was appointed to this position. This is notnecessarily the date when the principal or manager was first employed by thesubject; this is simply the date when they moved to this position, e.g. due to apromotion.
SOAP REST
Most SeniorPrincipal FirstName
Text recording the first name of the most senior principal. [C] SOAP REST
Most SeniorPrincipal LastName
Text recording the last name of the most senior principal. [C] SOAP REST
Most SeniorPrincipal MiddleName
Text recording the middle name of the most senior principal. [C] SOAP REST
Parent Country SOAP REST
Parent PostalCode
An identifier used by the local country postal authority to identify where the parentcompany is located.
SOAP REST
Parent StreetAddress
Text recording the address number, or post office box number and street namewhere the parent company is located.
SOAP REST
Parent TerritoryAbbreviatedName
Text recording the shortened name of the locally governed area which forms part of acentrally governed nation to identify where the parent company is located.
SOAP REST
Parent TerritoryName
Text recording the name of the locally governed area which forms part of a centrallygoverned nation to identify where the parent company is located.
SOAP REST
Parent TownName
Text recording the name of a city, town, township, village, borough, etc. where theparent company is located.
SOAP REST
Primary StockExchangeIndicator
When set to TRUE it specifies that this is the most important stock exchange amongall the stock exchanges where this subject's shares are traded. When set to FALSE itspecifies that this is not the most important stock exchange among all the stockexchan
SOAP REST
Principal Age The age of the principal in years. [C] SOAP REST
Principal CurrentPosition
Text identifying the business function of the principal derived from a standardManagement Responsibility Code (MRC). [C]
SOAP REST
Principal CurrentPosition StartDate
The date when the principal or manager was appointed to this position. This is notnecessarily the date when the principal or manager was first employed by thesubject; this is simply the date when they moved to this position, e.g. due to apromotion. [C]
SOAP REST
Principal FirstName
Text recording the first name of the principal. [C] SOAP REST
D&B Direct API Documentation Firmographic Product Service - 3.0
©Dun & Bradstreet, Inc. 2014 617
Name Description XML* JSON*
Principal LastName
Text recording the last name of the principal. [C] SOAP REST
Principal MiddleName
Text recording the middle name of the principal. [C] SOAP REST
Profit or LossAmount
A monetary figure that shows the difference between sales revenue and cost of salesbefore the deduction of selling, distribution, administration and other costs.
SOAP REST
Profit or LossGrowth Rate
The rate of change in the difference between sales revenue and cost of sales beforethe deduction of selling, distribution, administration and other costs.
SOAP REST
Salary - CurrentAmount
Salary for the year, excluding bonus, in requested currency [C] SOAP REST
Sales TurnoverGrowth Rate
The amount by which sales turnover increases over a given period of time as apercentage of its previous value.
SOAP REST
Share CapitalAmount
A monetary value representing the amount of Share Capital. Calculation is Price XTotal Shares Outstanding. [C]
SOAP REST
Subject HandlingText
Text specifying the manner in which the subject is to receive special care from D&Bwhen it is being contacted; e.g. do not call or do not send information requests. Inmany cases this process was specifically requested by the subject. [C]
SOAP REST
Total Assets A monetary figure representing the total amount of assets considered to beconvertible into cash within a relatively short period of time, usually a year. [C]
SOAP REST
Total EmployeeQuantity
A number that defines how many people are directly engaged and paid by theorganization to perform or support its business operations.
SOAP REST
Total EmployeesReliability Text
Text that describes the integrity of the employee figures e.g. audited, actual,estimated, modeled.
SOAP REST
Total Salary -Current Amount
Total compensation for the year, including any bonus or other compensation, inrequested currency [C]
SOAP REST
1.b. Business Elements added to the USA PATRIOT Act Plus:
Name Description XML* JSON*
Average High Credit- AllCountries Except US & CA
SOAP REST
Average High Credit- US &CA
SOAP REST
D&B Paydex - US & CA A calculated element summarizing the payment habits of a subject basedon trade experiences obtained from its suppliers.
SOAP REST
DNB Paydex - All CountriesExcept US & CA
SOAP REST
Financial Statement Date The date when the accounting period ended. If the Reliability Code denotesthe figures are projected (future) then this is the date when theaccounting period will end. [C] [M]
SOAP REST
High Credit- All CountriesExcept US & CA
SOAP REST
D&B Direct API Documentation Firmographic Product Service - 3.0
©Dun & Bradstreet, Inc. 2014 618
Name Description XML* JSON*
High Credit- US & CA SOAP REST
Total Payment ExperiencesUsed Count
The number of payment experiences that contributed to this paymentindex score. As an example the score may have been derived from 18payment experiences from various suppliers.
SOAP REST
Total Payment ExperiencesUsed Count - All CountriesExcept US and CA
The number of payment experiences that contributed to this paymentindex score. As an example, the score may have been derived from 18payment experiences from various suppliers.
SOAP REST
1.c. Business Elements added to the Alternative Detailed Company Profile:
Name Description XML* JSON*
FinancialStatementDate
The date when the accounting period ended. If the Reliability Code denotes the figures areprojected (future) then this is the date when the accounting period will end. [C] [M]
SOAP REST
2. To support upcoming changes to the delivery of PAYDEX data, several XPATH's have changed/were addedto the OrderProduct response.
Note: **Due to variations in the availability and frequency of payment information collected from certaincountries, non-US and non-Canadian payment information is delivered separately in "GlobalPaydex" and"GlobalDataCoveragePayments" data fields.
The following fields were added to the Data Field Response:
Name Characteristics
OrderProductResponse.OrderProductResponseDetail. Product.Organization. BusinessTrading. Purchaser.CurrentPaydexScore.TwentyFourMonthsPaydex. PaydexScore
int up to 3 digits., Required
A calculated element summarizing the payment habits of a subject
based on trade experiences obtained from its suppliers over the last 3
months.
OrderProductResponse.OrderProductResponseDetail. Product.Organization. BusinessTrading. Purchaser.CurrentPaydexScore.TwentyFourMonthsPaydex.TotalPaymentExperiencesUsedCount
long, Optional
The number of payment experiences that contributed to this payment
index score. As an example, the score may have been derived from 18
payment experiences from various suppliers.
OrderProductResponse.OrderProductResponseDetail. Product.Organization. BusinessTrading. Purchaser.CurrentPaydexScore. GlobalPaydex.PaydexScore
int up to 3 digits., Required
A calculated element summarizing the payment habits of a subject
based on trade experiences obtained from its suppliers over the last 3
months.
D&B Direct API Documentation Firmographic Product Service - 3.0
©Dun & Bradstreet, Inc. 2014 619
Name Characteristics
OrderProductResponse.OrderProductResponseDetail. Product.Organization. BusinessTrading. Purchaser.CurrentPaydexScore. GlobalPaydex.TotalPaymentExperiencesUsedCount
long, Optional
The number of payment experiences that contributed to this payment
index score. As an example, the score may have been derived from 18
payment experiences from various suppliers.
OrderProductResponse.OrderProductResponseDetail. Product.Organization. BusinessTrading. Purchaser.PurchaserDerivedData.TwentyFourMonthsDataCoveragePayments.PaymentPeriodSummary.PaymentsWithHighCredit.HighCreditMaximumAmount
decimal, Optional
The greatest monetary figure owed to the supplier by the subject over
the period of time specified by the Summary Period.
OrderProductResponse.OrderProductResponseDetail. Product.Organization. BusinessTrading. Purchaser.PurchaserDerivedData.TwentyFourMonthsDataCoveragePayments.PaymentPeriodSummary.PaymentsWithHighCredit.AverageHighCreditAmount
decimal, Optional
OrderProductResponse.OrderProductResponseDetail. Product.Organization. BusinessTrading. Purchaser.PurchaserDerivedData.GlobalDataCoveragePayments.PaymentPeriodSummary.PaymentsWithHighCredit.HighCreditMaximumAmount
decimal, Optional
The greatest monetary figure owed to the supplier by the subject over
the period of time specified by the Summary Period.
OrderProductResponse.OrderProductResponseDetail. Product.Organization. BusinessTrading. Purchaser.PurchaserDerivedData.GlobalDataCoveragePayments.PaymentPeriodSummary.PaymentsWithHighCredit.AverageHighCreditAmount
decimal, Optional
The following fields were removed from the Data Field Response:
D&B Direct API Documentation Firmographic Product Service - 3.0
©Dun & Bradstreet, Inc. 2014 620
Name Characteristics
OrderProductResponse.OrderProductResponseDetail. Product.Organization. BusinessTrading.Purchaser. CurrentPaydexScore.TwelveMonthsPaydex. PaydexScore
int up to 3 digits., Required [C] [M]
A calculated element summarizing the payment habits of a subject based on
trade experiences obtained from its suppliers over the last 3 months.
OrderProductResponse.OrderProductResponseDetail. Product.Organization. BusinessTrading.Purchaser. CurrentPaydexScore.TwelveMonthsPaydex.TotalPaymentExperiencesUsedCount
long, Optional [C]
The number of payment experiences that contributed to this payment index
score. As an example, the score may have been derived from 18 payment
experiences from various suppliers.
OrderProductResponse.OrderProductResponseDetail. Product.Organization. BusinessTrading.Purchaser. PurchaserDerivedData.TwelveMonthsDataCoveragePayments.PaymentPeriodSummary.PaymentsWithHighCredit.HighCreditMaximumAmount
decimal, Optional [C] [M+]
The greatest monetary figure owed to the supplier by the subject over the
period of time specified by the Summary Period.
Monitor Path: //Organization /BusinessTrading /Purchaser
/PurchaserDerivedData
OrderProductResponse.OrderProductResponseDetail. Product.Organization. BusinessTrading.Purchaser. PurchaserDerivedData.TwelveMonthsDataCoveragePayments.PaymentPeriodSummary.PaymentsWithHighCredit.AverageHighCreditAmount
decimal, Optional [C] [M+]
Monitor Path: //Organization /BusinessTrading /Purchaser
/PurchaserDerivedData
To take advantage of these new features and/or business elements, please refer to Version 3.0 of theFirmographic Product Service in the D&B Direct 2.0 API Reference.
D&B Direct API Documentation Firmographic Product Service - 3.0
©Dun & Bradstreet, Inc. 2014 621
Firmographic Product Service - 2.1The following changes were implemented as part of the October 25, 2013 update:
1. Business Elements added to Detailed Company Profile and Alternative Detailed Company Profile datalayers.
Name Description XML* JSON*
Global UtimateTotalOrganizationEmployees
A number that defines how many people are directly engaged and paid by theorganization to perform or support its business operations. Includes employees in theentire global family tree, including all direct and indirect subsidiaries of the globalultima [C]
SOAP REST
Major IndustryCategory
A narrative description of the operations or activities of the business. Relates to theprimary four-digit 1987 US SIC. In English. [C]
SOAP REST
Number ofFamily MembersIncludingSubsidiaries
This is the number of linkages in the upward and downward directions of the entireFamily tree that the subject belongs to, starting from Global Ultimate company. [C]
SOAP REST
Transfer Date The date that the D-U-N-S number was deleted or transfered to a new D-U-N-Snumber. [C]
SOAP REST
Transfer ReasonText
An entry loop that repeats multiple times to allow the recording of changes to the D-U-N-S number over time. This section may include reasons for the change. [C]
SOAP REST
To take advantage of these new features and/or business elements, please refer to Version 2.1 of theFirmographic Product Service in the D&B Direct 2.0 API Reference.
D&B Direct API Documentation Firmographic Product Service - 2.1
©Dun & Bradstreet, Inc. 2014 622
Dun & Bradstreet (D&B)
103 JFK Parkway
Short Hills, NJ 07078
www.dnb.com
©Dun & Bradstreet, Inc. 2014. All rights reserved.