- dunsControlStatus.operatingStatus.startDate
- controlOwnershipDate
- financials.financialStatementToDate
- financials.informationScopeDescription
- financials.informationScopeDnbCode
- financials.reliabilityDescription
- financials.reliabilityDnbCode
- financials.unitCode
- financials.yearlyRevenue.value
- financials.yearlyRevenue.currency
Direct+ Release 1.19.5 (March 28, 2019)
CMPCVF
The following elements have been added to the response:
- mostSeniorPrincipals.subjectType
- mostSeniorPrincipals.identificationNumber
- mostSeniorPrincipals.responsibleAreas
- currentPrincipals.subjectType
- currentPrincipals.identificationNumber
- currentPrincipals.responsibleAreas
New Data Product: CMPCMA
A new data product is available that provides details on the company for customer management accounts.
See the API documentation for complete information:
Direct+ Release 1.19.4 (March 07, 2019)
Criteria Search
The search has been modified to replace apostrophes with white space while searching.
CMPELF
The following elements have been added to the response:
- socioEconomicInformation.minorityOwnedCertifiedDate
- socioEconomicInformation.smallBusinessOwnedCertifiedDate
- socioEconomicInformation.isFemaleOwned
- socioEconomicInformation.femaleOwnedCertifiedDate
- socioEconomicInformation.isLabourSurplusArea
- socioEconomicInformation.labourSurplusAreaCertifiedDate
- socioEconomicInformation.is8AFirm
- socioEconomicInformation.8AFirmCertifiedDate
- socioEconomicInformation.isDisadvantagedBusiness
- socioEconomicInformation.isDisabledOwned
- socioEconomicInformation.isVeteranOwned
- socioEconomicInformation.isVietnamVeteranOwned
CMPFCD, CMPTPF
Restricted thirdPartyValuationRatios to deliver the most recent 5 years of data available, based on the thirdPartyValuationRatios.effectiveDate
Direct+ Release 1.19.3 (February 15, 2019)
NEW API: Refresh Check
A new API is available that allows customers to check if the D-U-N-S Number® of a given product has been updated after a specified date.
See the API documentation for complete information:
Contact Search: Standard & Premium
The following possible values have been added to industryCodes.typeDnbcode search parameter:
- 25838: D&B Hoovers Industry Code
- 19295: UK Standard Industry Code 2007
Competitors Search
The following parameters have been added to the request and response:
- customerReference
- maxResults
Reference Data
- New categories are now available in the Get All Categories API.
- Updated the names of some categories to more closely match the JSON path to which they apply.
Direct+ Release 1.19.2 (January 24, 2019)
Criteria Search
- The following elements have been added to the response:
- globalUltimate.duns
- gloabalUltimate.primaryName
- The following possible values have been added to industryCodes.typeDnbcode search parameter:
- 25838: D&B Hoovers Industry Code
- 19295: UK Standard Industry Code 2007
- The search behavior has been modified to identify words by using spaces and periods as delimiters.
For more information, please see Delimiters in the Search Guide.
New Data Product: CMPELF
A new data product is available that provides details on the company profile, executive team members, latitude and longitude, URL, stock ticker, and company financials.
See the API documentation for complete information:
NEW API: Consolidated Assessment Report (CAR) Investigation
A new API is available that allows compliance customers to request, track, and receive results of a business investigation; it includes the following features:
- Submit Request: Initiates the investigation request.
- Get Status: Allows you to get the status of the investigation.
- Get Report: Allows you download the investigation report in PDF format.
See the API documentation for complete information:
Direct+ Release 1.19.1.1 (January 17, 2019)
CMPELK v2
The following elements have been added to the response:
- marketingRiskClass.description
- marketingRiskClass.dnbCode
New Data Products: CMPFMD, CMPFCD, CMPTPF
The new data products are available as part of the Company Profile APIs.
New Data Product: AASSEM
A new data product is available that applies Dun & Bradstreet's proprietary modeling techniques to corporate family linkage information to extrapolate and complete entity, site, and region-specific size data more accurately.
See the API documentation for complete information:
Direct+ Release 1.19.1 (January 10, 2019)
Multi-Process v2
In order to implement entitlements for Multi-Process, the product ID and version ID have been moved from within the input file to the body in Job Submission as a required request parameters.
Version 1 has been deprecated. Customers who have Version 1 already implemented, will need to migrate to Version 2. All new implementations should use Version 2.
For more information, please see the documentation.
Direct+ Release 1.18.8.2 (December 7, 2018)
New API: Competitors Search
A new API is available that allows customers to find competitors for a specified D-U-N-S Number.
See the API documentation for complete information:
Search: Contacts Standard & Premium
- The Contacts Search Premium View now provides customers with salary and bonus content for the requested individual.
The following parameter has been added to the request and response:
For more information, please see the documentation page.
- The Contact Search API now allow customers to search by NAICS Industry Codes.
The following parameter has been added to the request and response:
The following elements have been added to response:
- operatingStatus
- isMarketable
WVI, IP
The following parameter has been added to the request and response for all WVI IP response variations:
Reference Data
The following categories and codes have been added to the API:
- FIPS Codes
- ISO Country Codes
- ISO Currency Codes
Direct+ Release 1.18.8.1 (November 28, 2018)
New API: News and Media
A new API is available that provides standard news and media content for the requested D-U-N-S Number.
See the API documentation for complete information:
Search
The Criteria and Company List Search API now allow customers to search for a list of D-U-N-S Numbers in the request.
The following parameter has been added to the request and response:
Documentation
The menus have been reorganized.
- Getting Started now includes:
- Introduction to Direct+ (formerly API Overview under API Reference menu).
- Using the Direct+ APIs (formerly D&B Direct+ API Overview).
- Dictionary has been moved under Resources.
- Home has been removed.
Direct+ Release 1.18.7.2 (October 24, 2018)
Documentation
- A table of contents pane has been added to the guides, allowing easier navigation of longer pages.
- The Errors and Information Messages page now includes the APIs for which each error applies. The new feature includes:
- A paginated table with error codes, description, and list of services.
- A Search box providing the ability to search for content by status or error code.
- An Export button for the option to download the content into an excel file that can be sorted or filtered as needed.
Direct+ Release 1.18.7.1 (October 4, 2018)
Data API & Identity Resolution
IDR and data products no longer return inconsistent error codes when requesting Deleted or Transferred D-U-N-S Numbers.
Montoring
Multi-Process
Extended Match no longer returns a misleading error for a D-U-N-S Number that fails the data sufficiency check.
Reference Data
- The Reference Data: Get All Codes for Category API now allows customers to retrieve category codes using the category ID in the request.
The following request and response parameter has been added:
- Reference Data API and Data Products now return the same description for Industry Code Type values.
For more information, please see the documentation:
Direct+ Release 1.18.6.2 (September 12, 2018)
Data API & WVI
For a requested D-U-N-S Number that has been transferred, the response header now populates the location value with the URL for the retained D-U-N-S Number.
For example, if 090276815 has been transferred to 879631906
- Submitted request: https://plus.dnb.com/v1/data/duns/090276815?productId=cmpelk&versionId=v2
- Response header now includes: Location: https://plus.dnb.com/v1/data/duns/879631906?productId=cmpelk&versionId=v2
Documentation
Added an FAQ menu item as part of the Resources tab, listing all commonly asked questions.
Direct+ Release 1.18.6.1 (August 30, 2018)
Monitoring
- Resolved issues with Notifications delivery frequency. Change Notification deliveries can now be set for any the following frequencies:
- INTRA_DAY
- DAILY
- WEEKLY
- MONTHLY
Registrations previously changed from DAILY to INTRA_DAY will be changed back to DAILY.
- Updated monitoring notifications to return an exception error if a D-U-N-S Number that is not data sufficient is added to a registration.
For more information, please see the Monitoring Guide.
New Data Product: CMPCVF
A new data product is available that provides data to support entity verification needs as part of their compliance process.
See the API documentation for complete information:
New Data Product: CMPSUP
A new data product is available that provides data to verify the identity of the business, the senior principal, business size, and corporate parents.
See the API documentation for complete information:
Direct+ Release 1.18.5.2 (August 1, 2018)
Criteria Search: Company List
The new criteria search endpoint allows a maximum of 10,000 results per page.
For more information, please see the documentation:
Full Family Tree
The following elements have been added to the response:
- isMarketable
- numberOfEmployees
- yearlyRevenue
Direct+ Release 1.18.5.1 (July 19, 2018)
Criteria Search
Increased the allowed distance for location search radius to: 100mi, 160km, or equivalent for other units.
Added the ability to search by the following NAICS Industry Codes:
- 24664 - North American Industry Classification System 2012
- 30832 - North American Industry Classification System 2017
Contact Search
The following elements have been added to the response:
- telephoneAccuracy
- emailAccuracy
- titleAccuracy
- dataFreshnessScore
- isSocialVerified
- isTitleMatched
- matchQualityInformation
Documentation
Added a Data Dictionary tab listing all applicable JSON paths for the available Direct+ products and capabilities. The new feature includes:
- A Search box providing the ability to search for content within the Data Dictionary.
- An Export button for the option to download the Data Dictionary as an excel file.
- Sorting capability for columns within the page.
Monitoring
Universe
Added a new Universe: Fortune 1000
Element-Level Monitoring
Added Element-Level Monitoring feature that allows customers to select specific elements (by JSON path) for which to receive notifications.
These paths can be specified when creating or updating a Registration. There are two (mutually-exclusive) options:
- jsonPathInclude: receive monitoring notifications only for the selected elements
- jsonPathExclude: receive monitoring notifications for all other elements, except the selected paths.
For more information, please see the documentation:
New API: Reference Data
A new API is available that provides details on Reference Data Categories including Scots Codes and Industry Codes. There are two options for this API:
- Retrieve Categories: Returns all reference data category IDs and descriptions.
- Retrieve Category Codes: Returns all item IDs and descriptions for a specified category.
See the API documentation for complete information:
Direct+ Release 1.18.4.2 (June 20, 2018)
Full Family Tree
The following elements have been added to the response:
- branchesExcludedMembersCount
Direct+ Release 1.18.4.1 (May 31, 2018)
Data API
The following Trade Up request parameter has been added:
Added the following parameter to the request and response:
Search
Contact Search content is now available for UK market.
WVI, Domain
Added the following new parameters to the responses for all WVI Domain response variations:
- isISP
- domainClassification
Direct+ Release 1.18.3.2 (May 11, 2018)
Criteria Search
The following response parameters have been added:
- organization.telephone.isdCode
- organization.dunsControlStatus.isDelisted
Documentation
The following updates have been enabled on the site:
- The left navigation bar has been removed and replaced with a menu at the top.
- For API responses, a function to Expand or Collapse All is now included. This function expands all levels in the list.
Direct+ Release 1.18.3.1 (Apr 20, 2018)
Full Family Tree
There is a new request parameter for Full Family Tree: exclusionCriteria=Branches.
If the new parameter is included, the response does not include branch nodes. Branches are identified when familytreeRolesPlayed = Branch/Division
Mini-Investigation
A Direct+ API is now available to call the Mini-Investigation service. Please see:
Criteria Search
Criteria Search API now allows a maximum of 1000 results with up to 50 results per page.
Direct+ Release 1.18.2.2 (Mar 30, 2018)
New API: Industry Profile
A new API is available that provides details on an Industry. There are two options for this API:
- Industry Profile Summary provides overview information on the requested industry.
- Industry Profile Detail provides detailed information on the requested industry, including industry indicators, challenges, financials, and forecast.
See the API documentation for complete information:
Direct+ Release 1.18.2.1 (Mar 8, 2018)
Contacts Search
New request parameter:
New response parameters:
Data API
Tradeup Request Parameter
The behavior of the tradeup parameter has been modified.
When executing on a request for D-U-N-S A with tradeUp=hq set, the current behavior checks that D-U-N-S Number A can be returned through the API (meets data sufficiency and product availablity rules); if not, an error message is returned.
That behavior has changed so it no longer matters if D-U-N-S A can be returned; instead it only checks if the HQ D-U-N-S Number is can be returned.
Example:
- D-U-N-S Number 123456789 is not available for CMPELK.
- The headquarters for D-U-N-S Number 123456789 is D-U-N-S Number 234567890; it is available.
- Request CMPELK for D-U-N-S Number 123456789 with tradeUp=hq:
- Previously, an error would be returned.
- Now, D-U-N-S Number 234567890 will be returned.
CMPELK v2
- The following response parameters have been added:
- organization.startDate
- organization.primaryAddress.isResidentialAddress
- Most Senior Principals and Current Principals arrays are no longer restricted to 10 values. As many entries as Dun & Bradstreet knows about will be returned.
CMPLKC
Company Profile Linkage Core is a new product; if you would like more information, please contact your Dun & Bradstreet representative.
CMPLNK
Most Senior Principals and Current Principals arrays are no longer restricted to 10 values. As many entries as Dun & Bradstreet knows about will be returned.
Family Tree
The following elements have been added to the Full Family Tree response:
- PrimaryCountryISOAlpha2Code
- TradeStyleName
- OrganizationFoundedYear
Monitoring
Notification Frequency
Additional options have been added for notification frequency: WEEKLY and MONTHLY.
For more information, see the documentation.
Direct+ Product Documentation