Discover Available Partners
| Product | D&B Direct+ |
| Feature | dataexchange |
| Version | 1.0 |
| Options(s) | DUNS |
| View(s) | n/a |
| Monitor option | No |
| Interface | REST |
| Method | GET |
| Format(s) | JSON |
| Released on | July 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 Name | Provider |
|---|---|
| dnb | Dun & Bradstreet |
| bombora | Bombora |
| farmdata | US Farm Data |
| hds-provider | Healthcare Data Solutions |
| industrial-interface | Industrial Interface |
| iridium | Iridium Information Resources |
| oxxford-energy | Oxxford IT/UCIS |
| oxxford-financial | Oxxford 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.
GET https://plus.dnb.com/v1/dataexchange/organizations/804735132/discover Authorization: Bearer <yourToken> (from Authentication call) Origin: www.dnb.com
| Name | Characteristics |
|---|---|
| DUNS | string (9 chars left zero-padded), required, path parameter |
| dataset | string, 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
{
"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 Code | Reason |
|---|---|
| 200 | Success! |
| 400 | Bad Request |
| 404 | DUNS (or other resource) not found |
| 500 | Server error |