Frequently Asked Questions

Direct+ APIs

Q: How many items will an array return?

A: The number of items in any given array can change depending on the source of the data. The best practice for customers is to code for N responses instead of a fixed number.

Q: What information is returned for array of simple datatype or array of object when no data is available?

A: Both array of simple datatype and array of object could be returned as empty or null.

{
"organization": {
	"tradeStyleNames": [],
	"standardizedStockExchanges": [],
	"documentFilings": [
		{
		"rolePlayers": [
			{
			"fullName": "THE CORPORATION TRUST COMPANY",
			"positions": null,
			"address": {
				"addressCountry": {
				"name": "United States",
				"isoAlpha2Code": "US"
				},
				"postalCode": "19801",
				"streetAddress": {
				"line1": "CORPORATION TRUST CENTER 1209 ORANGE STREET",
				"line2": null
				}
			}
			}
		]
		}
	],
	"dnbAssessment": {
		"viabilityRating": {
		"dataDepth": {
			"assessment": [],
			"dataDepthIndicator": "A"
		}
		}
	}
}
}

Q: What dataTypes are returned?

A: Please find below details. (Unless otherwise specified in the documentation, the following standards apply to each data types).

Data Type Length Nullable Comments
string 256 Yes Please note for some elements length could be greater than 256 characters.
integer 16 Yes
number Yes Number is represented as per RFC-7159.
boolean 5 Yes Possible values: true, false, null
string (date/time fields) Yes Format: YYYY-MM-DDThh:mm:ss.sTZD
The date and time, in ISO 8601 UTC Z standard in GMT.
string (date fields) Yes Formats:
YYYY-MM-DD
YYYY-MM
YYYY
The date, in ISO 8601 standard in GMT.

Q: What charsets is supported?

A: Direct+ API supports unicode characters using UTF-8 encoding.

Identify

Q: What are the products supported by Extended Match?

A: Extended Match supports all the Direct+ Standard Data Blocks and Data Products that are currently available. For details on the products and their attributes, please refer to the documentation:

Q: How many records are returned by Multi-Process?

A: Multi-Process returns only one result, the best candidate, and if service=extmatch, appends the data product provided in the input.

Enrich

General

Q: Does Direct+ support custom products?

A: Direct+ provides an alternate option to custom products called "Data Blocks". Data Blocks is a logical grouping of predefined data elements arranged based on a Data Topic. "Data Levels" are segmented views of the data blocks to address specific customer content requirements. "Stacking" or combining various blocks together will address specific customer use cases across domains. Customers can request data levels across deliverables (API/File/Monitoring).

Monitor

General

Q: What are the Monitorable Products?

A: Monitoring supports all the Direct+ Standard Data Blocks and Data Products that are currently available. For details on the products and their attributes, please refer to the documentation:

Q: What does the customer get when a new D-U-N-S Number® enters the Dun & Bradstreet Managed Universe?

A: When a D-U-N-S Number is added to a Universe, an ENTER notification is included as well as a SEED notification if the registration has seed file = Yes. For more information please see, D-U-N-S Number Status Types.

Q: What happens if the same D-U-N-S Number is registered twice?

A: An error will be included in the Exceptions file.

Q: Can one registration contain multiple products to be monitored?

A: No, each registration includes one product and a set of D-U-N-S Numbers (list or dynamic universe) to be monitored.

Q: Is there a limit to the number of registrations I can have?

A: There is no enforced limit. However, if there are multiple registrations for the same Product, there must be a valid reason. Registrations can be created temporarily for testing, but must be deleted once testing is completed.

Notifications

Q: Is there a maximum amount of time notifications can be suppressed?

A: The Suppress function is intended for short-term use. Dun & Bradstreet recommends notifications be suppressed for no more than a month. Instead of leaving notifications suppressed, the registration should be deleted and re-created when content can be consumed again. Dun & Bradstreet will be enforcing this policy by contacting customers with suppressed notifications.

Q: When a customer stops notification delivery and then starts it again will they receive all the changes from the time the delivery stopped?

A: Customers will receive a single set of changes where the previous value is the last value delivered before the notifications were suppressed, and the current value is the value of the last change before the notifications are delivered.

Q: What if a customer's infrastructure goes down; is there a way to pick up missed notifications?

A: This depends on the delivery method and length of down time.

If too much time has passed, the customer may need to request a new seed file.

Q: Are daily changes for a given D-U-N-S Number aggregated, or will a D-U-N-S Number be listed separately in many change notifications for a day?

A: All changes that occur in a single day for DAILY registrations are aggregated into a single DUNS record. A single D-U-N-S Number may appear more than once in a single notification file. Most often this is because the D-U-N-S Number has status changes as well as content changes.
Note that it is also possible for the same D-U-N-S Number to have more than one UPDATE notification under some circumstances, for example, when notifications are held by Dun & Bradstreet during a maintenance period. All notifications for a single D-U-N-S Number are in the same notification file and grouped together (ordered by date and time in ascending order).

Q: Will the same D-U-N-S Number ever have multiple UPDATEs in the same delivery window?

A: While it is unlikely, it is possible that the same D-U-N-S Number will have more than one UPDATE notification in a single package (file or messages).

Q: What is the difference between cumulative updates received after maintenance window and those received when notifications are unsuppressed??

A: When registration notifications are suppressed, the system aggregates the changes for each day into a single UPDATE notification. The previous value is the last value delivered before the notifications were suppressed and the current value is the value of the last change before the notifications are delivered.
When notifications are suspended during a maintenance window, the updates are individually collected and all are sent when delivery resumes. This provides you with all the interim changes that occurred during the maintenance window.

Q: If a single monitoring notification file has multiple updates for the same D-U-N-S Number, how do I make sure I get latest information?

Notifications are grouped by D-U-N-S Number and sorted in ascending order, so process notifications in order, top to bottom, and your data will be correct.

Q: What happens to Monitoring Registrations if a customer contract expires?

Notifications are suppressed for 31 days. If the contract has not been renewed, the Registration is deleted.

Q: What happens when new elements are added to an existing product?

A: If the content is new to Direct+, notifications are created for those elements since the loading of values occurs after the element is added to the product. However, if content already exists in the Direct+ system and is later added to a product, it is not considered a value change and does not trigger a notification. In such cases, customers will need to re-seed to get the new elements. Release communications and change history will include the necessary information on new elements.

Q: What happens when elements are removed from an existing product?

A: If an element is removed from a product, it is considered a breaking change and the product is versioned. There is no impact to the current version. To monitor the new version, a new registration must be created. Please see the Using Direct+ APIs page for more information on versioning.

Q: What happens if elements are "retired" (e.g., Fax Number)?

A: As long as the path is still part of the product, notification still apply. If the value becomes null, a notification is triggered. If a path is completely removed from the product, it is versioned. There is no impact on the current version. To monitor the new version, a new registration must be created. Please see the Using Direct+ APIs page for more information on versioning.

Data Transport Security

General

Q: What are the supported TLS protocols and ciphers?

Direct+ application is exposed using HTTPS and supports both TLS1.2 and TLS1.3 secure transport protocol. Please refer below the accepted list of ciphers.

Approved Ciphers

Open SSL IANA /RFC5289
TLS 1.3 TLS-AES-256-‍GCM-SHA384 TLS_AES_256_GCM_SHA384
TLS 1.3 TLS-CHACHA20-POLY1305-SHA256 TLS_CHACHA20_POLY1305_SHA256
TLS 1.3 TLS-AES-128-GCM-SHA256 TLS_AES_128_GCM_SHA256
TLS 1.3 TLS-AES-128-CCM-8-SHA256 TLS_AES_128_CCM_8_SHA256
TLS 1.3 TLS-AES-128-CCM-SHA256 TLS_AES_128_CCM_SHA256
TLS 1.2 ECDHE-ECDSA-AES256-GCM-SHA384 TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384
TLS 1.2 ECDHE-ECDSA-AES128-GCM-SHA256 TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256
TLS 1.2 ECDHE-RSA-AES256-GCM-SHA384 TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384
TLS 1.2 ECDHE-RSA-AES128-GCM-SHA256 TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256
TLS 1.2 ECDHE-ECDSA-CHACHA20-POLY1305 TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256
TLS 1.2 ECDHE-RSA-CHACHA20-POLY1305 TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256
TLS 1.2 ECDHE-ECDSA-AES256-SHA384 TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384
TLS 1.2 ECDHE-ECDSA-AES128-SHA256 TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256
TLS 1.2 ECDHE-RSA-AES256-SHA384 TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384
TLS 1.2 ECDHE-RSA-AES128-SHA256 TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256
TLS 1.2 ECDHE-RSA-AES256-SHA TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA
TLS 1.2 ECDHE-RSA-AES128-SHA TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA
TLS 1.2 AES256-GCM-SHA384 TLS_RSA_WITH_AES_256_GCM_SHA384
TLS 1.2 AES128-GCM-SHA256 TLS_RSA_WITH_AES_128_GCM_SHA256
TLS 1.2 AES256-SHA256 TLS_RSA_WITH_AES_256_CBC_SHA256
TLS 1.2 AES128-SHA256 TLS_RSA_WITH_AES_128_CBC_SHA256
TLS 1.2 AES256-SHA TLS_RSA_WITH_AES_256_CBC_SHA
TLS 1.2 AES128-SHA TLS_RSA_WITH_AES_128_CBC_SHA

Q: Does Direct+ server certificate gets changed?

Direct+ server certificate gets renewed periodically, if you are storing the Direct+ server certificate within you server store, you will need to replace it with a new server certificate.

Q: What is the IP range for Direct+ API?

Direct+ API does not have fixed IP range. Customers must white list using Direct+ API URL.

INTERNAL ONLY

The following questions are available on staging for internal users only.

Direct+ APIs

Q: Does Direct+ require DigiCert SHA2 certificate for HTTPS?

A: No it does not. Direct 2.0 does, but Direct+ only requires API credentials.

Documentation

Q: Where is Direct+ Documentation?

A: There are two documentation sites.

Do we provide WADL for the APIs?

WADL is XML. We use JSON for developing and documenting our APIs. Instead of WADL, we provide Swagger JSON. Swagger files for customer-available products and capabilities can be downloaded from each respective API pages of the documentation site.