Direct+ Release Change History

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:

• Refresh Check

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:

• Company Profile with Executives, Linkage, and Financials (CMPELF)
• Company Profile Overview

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:

• CAR Investigation APIs Overview

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.

• Company Profile for Financial Market Data (CMPFMD) provides details on key financial metrics and ratios such as stock price, dividend rate, percent revenue growth, and more.
• Company Profile with Financial Comparative Data (CMPFCD) provides company details along with the comparison of various financial ratios and statistics across industry, sector and companies.
• Company Profile with Third Party Financials (CMPTPF) provides detailed financial data such as annual and quarterly cash flow statements, balance sheets and income statements.
• See the Company Profile Overview for complete information.

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:

• Sales & Employee Assignment Model (AASSEM)
• Analytics Assessment Overview

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.

• Multi-Process APIs

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:

• Competitors Search

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:

  • view

  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:

  • industryCodes

  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:

• isISP

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:

• News and Media, Standard

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:

• dunsList

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

• Implemented the following terms for expired contracts:
  • When a contract expires, the registration state will change to Expired and notifications will be suppressed.
  • Notifications will be suppressed for 31 days. If the contract end date is not extended before 31 days, the Registration and all stored notifications will be deleted.
  • Once the contract end date is extended, customers must unsuppress the notifications to start receiving them again. To update the contract, please contact your Dun & Bradstreet representative.
• Implemented file-level encryption for customers to provide an encryption key for handling monitoring in S3 deliveries.
  • The following request parameter has been added: encryptionKey
  • All new registrations should include an encryption key.
  • All existing registrations must be updated and will require an encryption key by the end of November.

  For more information, please see the documentation:

  • Registrations: Get Details, Edit, and Delete.
  • Monitoring guide, Configure S3 Bucket.

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:
• id
• Reference Data API and Data Products now return the same description for Industry Code Type values.

For more information, please see the documentation:

• Reference Data: Get All Codes for a Category
• Reference Data Guide

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:

• Company Profile for Compliance Verification (CMPCVF)
• Company Profile Overview

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:

• Supplier Master Data Enrichment (CMPSUP)
• Company Profile Overview

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:

• Company List Search API

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:

• Edit Registration API
• Get Registration Details API
• Monitoring Guide

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:

• Reference Data: Get All Categories
• Reference Data: Get All Codes for a Category
• Reference Data Guide

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:

• domhq

Added the following parameter to the request and response:

• customerReference

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:

• Mini-Investigation API Overview
• Mini-Investigation Guide

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:

• Industry Profile, Detail
• Industry Profile, Summary

Direct+ Release 1.18.2.1 (Mar 8, 2018)

Contacts Search

New request parameter:

• jobTitles
• primaryName

New response parameters:

• organization.primaryName

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.