Direct+ Release Change History

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 parameters 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 response parameters have been added:

• 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 response parameters have been added:

• 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 response parameter has been added:

• 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.