JSON Guidelines

D&B Direct REST responses are delivered as XML documents translated into JSON objects. The following list explains the conventions implemented by the D&B Direct API. Exception: The responses supplied by the Data Exchange Service follow the convention used by the respective business partner.

• Attributes will always be represented by prefixing with “@”. (see Example 2)
• If an element is repeatable, that element will be always returned as an Array of objects in the JSON response. (see Example 7)
  • If a repeatable element is not repeating in a specific JSON response, even then that element will be returned as an Array having a single object. (see Example 9)
• Element content will be represented with “$” if it has attributes (see Example 2)
  • Consider a scenario where an element has an attribute as per the definition, however the attribute is not returned in a specific JSON response. Even then, the element content will be represented as “$” in the JSON. (see Example 4)
• String values will be returned within double quotes. (see Example 14)
• Numeric and Boolean values will not be returned within double quotes. (see Example 12 and Example 13)

Examples

• © Dun & Bradstreet, Inc. 2019 – 2024. All rights reserved.