{data products}:RetrieveProduct (REST)

This operation -- included in all data and report product services (listed below)-- provides access to the product request archive. Assets may also be retrieved by using the Portfolio:RetrievePortfolioAsset (REST) operation.

Service Request Response*
Assessment Product Service RetrieveProduct()

same as OrderProduct()

Contact Product Service RetrieveProduct() same as OrderProduct()
Custom Product Service RetrieveProduct() same as OrderProduct()
Financial Product Service RetrieveProduct() same as OrderProduct()
Firmographic Product Service RetrieveProduct() same as OrderProduct()
Industry Product Service RetrieveProduct() same as OrderProduct()
Linkage Product Service RetrieveProduct() same as OrderProduct()
News and Media Service RetrieveProduct() same as OrderProduct()
Public Record Service RetrieveProduct() same as OrderProduct()
SBRI Product Service RetrieveProduct() same as OrderProduct()
Trade Detail Product Service RetrieveProduct() same as OrderProduct()

*The response data field names will be prefixed with "RetrieveProductResponse.RetrieveProductResponseDetail" instead of "OrderProductResponse.OrderProductResponseDetail".

Request Parameters

The following parameters are accepted by this operation; however, the requirements for a specific request may differ based the product being requested.

Name Characteristics
ApplicationTransactionID string up to 64 chars., Optional

A number assigned by the calling application to uniquely identify this request.

TransactionTimestamp DateTimestamp, Optional

The date and time when this request was created. When the request is from an intermediary, such as a workflow manager or service bus, this is the date and time when the message was sent to the D&B function, i.e., the date and time when the xml document was created by the requesting intermediary.

SubmittingOfficeID string up to 64 chars., Optional

A number that identifies the system or the software application from where this request originated. / A number used to uniquely identfy the D&B business segment or delivery channel from where this request originated.

{assetID} long, Required

Response Data Fields

Refer to the respective OrderProduct operation for each service. For example, a request from Assessment:RetrieveProduct() will return the same response as Assessment:OrderProduct(). The response items, however, will be prefixed with "RetrieveProductResponse.RetrieveProductResponseDetail" instead of "OrderProductResponse.OrderProductResponseDetail".

Language/Character Sets

The text contained within D&B Direct 2.0 data layers is returned in English. Several reports, including the D&B Business Information Report (BIR), provide additional language options. Data layers are encoded using the ISO 8859-1 character set standard (also known as Latin-1).

Response Codes

Successful service requests will return a CM000 response code. Otherwise, one of the D&B Direct standard response codes will be returned.

This operation may return the following response codes: CM001, CM002, CM003, CM004, CM005, CM006, PT001, and SC001-SC009.

Operation-specific supplemental response code explanations:

PT001 No Portfolio asset not found for given portfolio asset identifier or investigation tracking ID or asset removed from archive.

SOAP Interface

This operation is also available using the SOAP architecture. Refer to {data products}:RetrieveProduct (SOAP) for details.

Back to Top