Loading

Partners
Collapse

Discover Available Partners

ProductD&B Direct+
Featuredataexchange
Version1.0
Options(s)DUNS
View(s)n/a
Monitor optionNo
InterfaceREST
MethodGET
Format(s)JSON
Released onJuly 31, 2015

This API returns the total available records along with summary counts by data provider.

NOTE: The version of this API call will not change when data providers are added or removed from the platform. Please check the list of datasets for available data providers.

Update History

No modifications have been made to this data layer since the initial release.

Feature Request

D&B Direct+ API calls utilize access tokens - generated from a key/secret combination - for authentication based on the Client Credentials Grant flow of the OAuth 2 specification. These access tokens expire after twenty-four hours. The error code 00040 indicates the current access token being used has expired.

Contact your D&B representative to obtain your D&B Direct+ key/secret combination. These values, along with any access tokens generated, should be considered as sensitive as a password, and must be used only by authorized parties as stated in the D&B Direct+ API agreement.

Refer to "Understanding the D&B Direct+ API Authentication Flow" for more details on the steps involved in authenticating.

Available Data Providers (and Data Set Names)

The following is a list of the available data providers along with the corresponding data set name that can be used as a parameter on feature requests.

Data Set NameProvider
dnbDun & Bradstreet
bomboraBombora
farmdataUS Farm Data
hds-providerHealthcare Data Solutions
industrial-interfaceIndustrial Interface
iridiumIridium Information Resources
oxxford-energyOxxford IT/UCIS
oxxford-financialOxxford IT/UCIS

Specification

When implementing this feature, a valid D-U-N-S Number for a company will be required. An option is available to filter out the summary counts for specific data providers (using the data set names).

All D&B Direct+ function calls require the use of a secured connection (i.e. https).

Place a single {DUNS} into the following endpoint: https://plus.dnb.com/v1/dataexchange/organizations/{DUNS}/discover. If you would like results for specific data providers append "?datasets={dataset}" to the endpoint with a comma delimited list of one or more valid dataset names.

Sample Request (by D-U-N-S Number)
GET https://plus.dnb.com/v1/dataexchange/organizations/804735132/discover
Authorization: Bearer <yourToken> (from Authentication call)
Origin: www.dnb.com
Name Characteristics
DUNSstring (9 chars left zero-padded), required, path parameter
datasetstring, optional

Possible values: dnb, hds-provider, hgdata, iridium, profound

For Customers using Postman (Optional)

Postman is a Google Chrome plug-in that allows you to make API calls and inspect responses from within a browser environment. The following Postman collection is available for making calls to these features.

Direct+ Postman collection for dataexchange
DeX.plus.dnb.com.json.postman_collection

Refer to "Interacting with the D&B Data Exchange+ API Using Postman" for more details on how to quickly and easily make API calls. The consumer key/secret credentials will be required.

Feature Response

Specification

Sample Response
{
    "count": 5,
    "links": {
        "self": "/v1/organizations/009122532/discover",
        "next": null,
        "previous": null,
        "first": null,
        "last": null
    },
    "iridium": {
        "count": 2,
        "links": {
            "self": "/v1/organizations/009122532/discover?datasets=iridium",
            "next": null,
            "previous": null,
            "first": null,
            "last": null
        }
    },
    "bombora": {
        "count": 0,
        "links": {
            "self": "/v1/organizations/009122532/discover?datasets=bombora",
            "next": null,
            "previous": null,
            "first": null,
            "last": null
        }
    },
    "industrial-interface": {
        "count": 0,
        "links": {
            "self": "/v1/organizations/009122532/discover?datasets=industrial-interface",
            "next": null,
            "previous": null,
            "first": null,
            "last": null
        }
    },
    "datamyne-export": {
        "count": 0,
        "links": {
            "self": "/v1/organizations/009122532/discover?datasets=datamyne-export",
            "next": null,
            "previous": null,
            "first": null,
            "last": null
        }
    },
    "ukdata": {
        "count": 0,
        "links": {
            "self": "/v1/organizations/009122532/discover?datasets=ukdata",
            "next": null,
            "previous": null,
            "first": null,
            "last": null
        }
    },
    "dnb": {
        "count": 1,
        "links": {
            "self": "/v1/organizations/009122532/discover?datasets=dnb",
            "next": null,
            "previous": null,
            "first": null,
            "last": null
        }
    },
    "datamyne-import": {
        "count": 0,
        "links": {
            "self": "/v1/organizations/009122532/discover?datasets=datamyne-import",
            "next": null,
            "previous": null,
            "first": null,
            "last": null
        }
    },
    "farmdata": {
        "count": 0,
        "links": {
            "self": "/v1/organizations/009122532/discover?datasets=farmdata",
            "next": null,
            "previous": null,
            "first": null,
            "last": null
        }
    },
    "oxxford-energy": {
        "count": 1,
        "links": {
            "self": "/v1/organizations/009122532/discover?datasets=oxxford-energy",
            "next": null,
            "previous": null,
            "first": null,
            "last": null
        }
    },
    "hds-provider": {
        "count": 0,
        "links": {
            "self": "/v1/organizations/009122532/discover?datasets=hds-provider",
            "next": null,
            "previous": null,
            "first": null,
            "last": null
        }
    },
    "oxxford-financial": {
        "count": 1,
        "links": {
            "self": "/v1/organizations/009122532/discover?datasets=oxxford-financial",
            "next": null,
            "previous": null,
            "first": null,
            "last": null
        }
    }
}

Response Codes

Successful requests will return an HTTP 200 response. Otherwise, one of the D&B Direct+ standard response codes will be returned.

This operation may return the following HTTP Status Codes: 

HTTP Status CodeReason
200Success!
400Bad Request
404DUNS (or other resource) not found
500Server error