Reference Data Service

Version 2.0 (API) / 2.0 (Service)

Reference data is defined as information that is used in look-ups to better understand, evaluate, or manipulate other data, and includes the possible data values for each information fact that has a finite, manageable set of valid values.

The D&B Direct API uses Reference Data in the following ways:

• To decode codified data (i.e. providing a descriptive meaning),

• To perform Language Translation (e.g., a description in a specific supported language, etc.),

• To provide cross-references (e.g., SIC to NAICS codes, D&B Geographic Reference Identifier to ISO 2-Alpha Country, etc.).

For all codified data delivered by D&B Direct, the response package will include the decoded text value as a data element with the code value attached as an attribute.

All D&B Direct customers are entitled to utilize this service, and no usage fees will be incurred when invoking the operations.

Functions

This D&B Direct service includes the following functionality. The respective SOAP and/or REST pages provide technical details including input parameters, responses and sample requests.

Function / Overview Link Operation / SOAP Resource / REST
D&B Standard Code Tables ListDNBCdTbl() GET referencedata/dnbcdtbl
  ListDNBCdVal() GET referencedata/dnbcdval
  ListGeoInfo() GET referencedata/geoinfo
  ListIndsCd() GET referencedata/indscd

The ListDNBCdTbl function provides a complete list of Standard Code Table System (SCoTS) tables.

The ListDNBCdVal function provides values for a specific SCoTS table.

The ListGeoInfo function provides geographic names and tagging values for continents, countries, states/territories, counties, towns and Metropolitan Statistical Areas (MSA).

The ListIndsCd function returns complete industry code tables.

Interfaces & Endpoints

D&B Direct implements version control at the web service level, in addition to the API level. This D&B Direct 2.0 {version} of the Reference Data Service is 2.0. When contacting D&B customer support, please provide both the API and Service version numbers. The following table(s) identify version-specific access points for the available API interfaces.

SOAP
Endpoint https://maxcvservices.dnb.com/Referencedata/V{version}
WSDL*

http://developer.dnb.com/docs/2.0/referencedata/2.0/ReferenceDataService.zip

*There may be operations defined in the WSDL that are not available to D&B Direct customers at this time.

REST
ListDNBCdTbl GET https://maxcvservices.dnb.com/V{version}/referencedata/dnbcdtbl
ListDNBCdVal GET https://maxcvservices.dnb.com/V{version}/referencedata/dnbcdval
ListGeoInfo GET https://maxcvservices.dnb.com/V{version}/referencedata/geoinfo
ListIndsCd GET https://maxcvservices.dnb.com/V{version}/referencedata/indscd

D&B Direct API calls must be made using Secured Socket Layers (SSL) as reflected in the preceding table(s).

Printer-Friendly Version

An Adobe Acrobat PDF of this documentation is available for download or printing.

Back to Top