Firmographic Product Service

Version 2.0 (API) / 2.1 (Service)

Version 3.0 of this service is now available. Details...

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 Operation / SOAP Resource / REST
Deliver a data layer. (see "Product (Data Layer) Details") OrderProduct() GET organizations/{DUNS}/products/{productID}
Deliver copies of previously ordered products. RetrieveProduct() GET assets/{assetID}/{productID}

The Order Product function provides data layers for a specific company, and requires a D-U-N-S Number {DUNS}, country code and one of the product codes {productID} listed in the Product (Data Layer) Details section.

The Retrieve Product function can be used to fetch previously obtained copies of data layers from the Product Request Archive by providing the asset identifier {assetID} returned from an Order Product request. The default archival period is 120 days, unless extended (up to 365 days) when the data layer is requested.

Product (Data Layer) Details

The following D&B products may be obtained by using this service. Some data layers may be available in different levels (Standard, Enhanced and/or Premium) -- each offering additional data elements. All D&B Direct product codes are case sensitive. The Product pages provide an overview along with a list of the Business Elements.

Title / Overview Link Product Code Product Sample
Detailed Company Profile - Standard DCP_STD XML JSON
Detailed Company Profile - Enhanced DCP_ENH XML JSON
Detailed Company Profile - Premium DCP_PREM XML JSON
Alternative Detailed Company Profile - Standard DCP_ALT_STD XML JSON
Alternative Detailed Company Profile - Enhanced DCP_ALT_ENH XML JSON
Alternative Detailed Company Profile - Premium DCP_ALT_PREM XML JSON
Diversity Indicators - Standard DVR_STD XML JSON
Diversity Indicators - Enhanced DVR_ENH XML JSON
USA PATRIOT Act Plus PAC_PLUS XML JSON

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 Firmographic Product Service is 2.1. 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/FirmographicsProduct/V{version}
WSDL*

http://developer.dnb.com/docs/2.0/firmographic/2.1/FirmographicsV2.1.zip

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

REST  
OrderProduct GET https://maxcvservices.dnb.com/V{version}/organizations/{DUNS}/products/{productID}
RetrieveProduct GET https://maxcvservices.dnb.com/V{version}/assets/{assetID}/{productID}

NOTE: While "organizations" is part of the REST OrderProduct URL, there is no service by this name. D&B Direct product-related calls have a similar structure; however, the {version} component is based on the service to which a given product is associated.

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

Related Topics

How to Order D&B Data

Documentation for Previous Version

Firmographic Product Service (v2.0)

Printer-Friendly Version

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

Back to Top