Direct+ Release Change History

Direct+ Release 1.19.14 (Oct 9, 2019)

Contact Search

tickerSymbol has been made as standalone parameter

Direct+ Release 1.19.13 (Sep 19, 2019)

Criteria Search/Company List

Criteria Search supports the following additional optional filters

• isImporter
• isExporter

The following additional elements have been added to the response

• searchCandidates.organization.isImporter
• searchCandidates.organization.isExporter
• searchCandidates.organization.primaryAddress.addressCountry.name
• searchCandidates.organization.mailingAddress.addressCountry.name
• searchCandidates.organization.registeredAddress.addressCountry.name
• searchCandidates.organization.dunsControlStatus.subjectHandlingDetails.description
• searchCandidates.organization.dunsControlStatus.subjectHandlingDetails.dnbCode

Contact Search

Contact Search supports the following additional optional filter

• tickerSymbol

The following additional elements have been added to the response

• searchCandidates.contact.organization.tickerSymbol
• searchCandidates.contact.organization.numberOfEmployees.value
• searchCandidates.contact.organization.numberOfEmployees.informationScopeDescription
• searchCandidates.contact.organization.numberOfEmployees.informationScopeDnBCode
• searchCandidates.contact.organization.numberOfEmployees.reliabilityDescription
• searchCandidates.contact.organization.numberOfEmployees.reliabilityDnBCode
• searchCandidates.contact.organization.dunsControlStatus.isMarketable
• searchCandidates.contact.organization.dunsControlStatus.isMailUndeliverable
• searchCandidates.contact.organization.dunsControlStatus.isTelephoneDisconnected
• searchCandidates.contact.organization.dunsControlStatus.isDelisted

CMPTCS

German Reason code (orderReason) is mandatory when submitting requests for Germany D-U-N-S for the following products

• CMPTCS

The following elements have been added to the response

• organization.dnbAssessment.standardRating.ratingOverrideReasons.description
• organization.dnbAssessment.standardRating.ratingOverrideReasons.dnbCode
• organization.dnbAssessment.delinquencyScore.rawScore
• organization.dnbAssessment.delinquencyScore.riskIncidencePercentage
• organization.dnbAssessment.delinquencyScore.scoreOverrideReasons
• organization.dnbAssessment.delinquencyScore.scoreOverrideReasons.description
• organization.dnbAssessment.delinquencyScore.scoreOverrideReasons.dnbCode
• organization.dnbAssessment.failureScore.rawScore
• organization.dnbAssessment.failureScore.riskIncidencePercentage
• organization.dnbAssessment.failureScore.scoreOverrideReasons.description
• organization.dnbAssessment.failureScore.scoreOverrideReasons.dnbCode

German Reason Code

Monitoring Customers will now be required to populate the orderReason parameter when performing the following:

• For all New (or existing registrations that are edited) Dynamic Universe registrations, the customer will be required to enter a German Reason Code in the orderReason parameter
• For all New (or existing registrations that are edited) List of DUNS (LOD) registrations, the customer will be required to enter a German Reason Code in the orderReason parameter if they are submitting DUNS from Germany. Otherwise the German DUNS will not be accepted into the registration and will be listed in the exceptions file (with exceptions code 05011)
• Customers with existing monitoring registrations will only be required to enter a German Reason Code in the orderReason parameter if they edit their registration

The following are the list of valid orderReason codes accepted in the request

• 6332 (Credit Decision)
• 6333 (Credit Check - Intended Business Connection)
• 6334 (Credit Check - Ongoing Business Connection)
• 6335 (Debt Collection)
• 6336 (Commercial Credit Insurance)
• 6337 (Insurance Contract)
• 6338 (Lease Agreement)
• 6339 (Rental Agreement)

Direct+ Release 1.19.12 (August 30, 2019)

Criteria Search/Company List

Additional filter has been added on the industry code search which now includes the US SIC 8 digit (3599)

searchTerm can now additionally search on the following elements

• D-U-N-S
• stockTicker

Contact Search

searchTerm is added as part of the contact search which can search any of the following elements

• givenName
• middleName
• familyName
• additionalName
• companyName
• jobTitle

Direct+ Release 1.19.11 (August 08, 2019)

CMPTCS

The following elements have been added to the response:

• organization.mostSeniorPrincipals

Criteria Search/Company List

The following additional filter has been added as part of the search request and response

• isStandalone

Direct+ Release 1.19.10 (July 17, 2019)

CMPTCS

New Data Product: CMPTCS

A new data product is available that provides details on the company for managing Trade Credit Risk, Summary

See the API documentation for complete information:

• Company Profile for Managing Trade Credit Risk, Summary(CMPTCS)
• Company Profile Overview

Direct+ Release 1.19.9 (June 27, 2019)

Criteria Search/Company List

The following elements have been added to the response:

• headQuarter.duns
• headQuarter.primaryName

CMPELF

The following elements have been added to the response:

• organization.registeredAddress
• organization.corporateLinkage.globalUltimate.primaryAddress.addressCountry.fipCode
• organization.corporateLinkage.domesticUltimate.primaryAddress.addressCountry.fipCode
• organization.corporateLinkage.parent.primaryAddress.addressCountry.fipCode
• organization.corporateLinkage.headQuarter.primaryAddress.addressCountry.fipCode

Customer Reference

The customer can now provide reference text as part of the request in the following API

• Company List Search
• Contact Search
• Criteria Search
• Full Family Tree
• Industry Profile
• Typeahead Search
• Web Visitor Information

Direct+ Release 1.19.8 (June 05, 2019)

Typeahead Search

Added optional request parameter "candidateMaximumQuantity" to provide the number of candidates to be returned. Allowed values 1 to 25

Criteria Search

The following additional filter has been added as part of the search request and response

• isMinorityOwned
• isFemaleOwned
• isManufacturingLocation
• isPubliclyTradedCompany

Search results can be sorted based on the following elements in either ascending or descending. Default sorting should remain the same, if no sort order provided

• isOutOfBusiness
• yearlyRevenue
• numberOfEmployees
• countryISOAlpha2Code
• primaryName
• isBranch
• duns

The length of the following elements has been changed in the criteria search

• Telephone Number search has been modified to accept 2-20 characters and it ignores special characters like space, comma, hypen and brackets
• Street Address Line1 length has been increased from 30 to 60 characters

CMPELF

The following elements have been added to the response:

• activities
• banks
• capitalDetails
• competitors
• congressionalDistricts.district
• currentPrincipals.identificationNumber
• defaultCurrency
• formerPrimaryNames
• historyRating
• marketingRiskClass
• marketingSegmentationCluster
• mostSeniorPrincipals.identificationNumber
• numberOfEmployees.employeeFiguresDate
• numberOfEmployees.minimumValue
• numberOfEmployees.maximumValue
• numberOfEmployeesHistory
• operations
• summary

MONITORING

Active US Universe is available as part of the Universe registration

Direct+ Release 1.19.7 (May 16, 2019)

Typeahead Search

The following elements have been added to the request and response:

• isOutOfBusiness
• isMarketable
• isMailUndeliverable
• addressLocality
• addressRegion
• streetAddressLine1
• postalCode
• radiusLat
• radiusLon
• radiusPostalCode
• radiusDistance
• radiusUnit
• candidateMaximumQuantity

Find Competitors

Adding tradeUp flag as part of the request

CMPCMA

The following elements have been added to the response:

• businessTrading.totalPastDueAmount
• businessTrading.totalPastDueExperiencesCount
• businessTrading.negativeExperiencesAmount
• businessTrading.satisfactoryExperiencesAmount
• businessTrading.satisfactoryExperiencesCount
• businessTrading.slowExperiencesAmount
• businessTrading.slowExperiencesCount
• businessTrading.cashExperiencesCount
• businessTrading.placedForCollectionExperiencesCount
• businessTrading.paydexScoreHistory[*]
• businessTrading.worstPayMannerPastDueSummary[*]
• businessTrading.splitPayMannerPastDueSummary[*]
• legalEvents.judgments.openCount
• legalEvents.judgments.openAmount
• legalEvents.suits.openCount
• legalEvents.suits.openAmount
• legalEvents.liens.openCount
• legalEvents.liens.openAmount
• legalEvents.claims.openCount
• legalEvents.claims.openAmount
• financingEvents.financingStatementFilings.totalCount
• dunsControlStatus.firstReportDate
• hasCompanyMoved

Direct+ Release 1.19.6 (April 17, 2019)

Criteria Search

• The following elements have been added to the response:
• parent.duns
• parent.primaryName
• The length of the following search parameter has been increased to 60 characters:
• searchTerm
• primaryName
• tradeStyleName

Mini Investigation - Submit Request

streetAddressLine1 length has been increased to 64 characters

CMPCMA

The following elements have been added to the response:

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

• Company Profile Customer Management Accounts (CMPCMA)
• Company Profile Overview

Direct+ Release 1.19.4 (March 6, 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:

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