Mini-Investigation (Legacy)

The samples provided are representative of what can be included in requests or will be returned in responses. In order to provide comprehensive samples, values may have been added for the sole purpose of these examples and may be null or empty in the actual API responses.

In addition, values in both requests and responses have been "faked" or modified to protect potentially private data (e.g., phone number) where applicable. Therefore, using requests exactly as is may not return any results.

Contents

• Submit Request
• Status

Mini-Investigation

Submit Request

Request

POST https://plus.dnb.com/v1/investigate/submit
Authorization: Bearer Your Token

{    
	"primaryName":"Dun & Bradestreet",
	"tradeStyle":"D&B",
	"primaryAddress": {
		"countryISOAlpha2Code": "US",
		"addressLocality": "Short Hills",
		"addressRegion": "NJ",
		"streetAddressLine1": "101 JFK Parkway",
		"postalCode": "07078"
	},
	"mailingAddress": {
		"addressLocality": "Short Hills",
		"addressRegion": "NJ",
		"streetAddressLine1": "101 JFK Parkway",
		"postalCode": "07078"
	},
	"telephoneNumber":"9739215500",
	"additionalInformation": "here's some additional information for you",
	"customerReference": "my request #4",
	"customerName": "My Company",
	"customerEmail":"joebloggs@mycompany.com"
}

Response

{
	"transactionDetail":{
		"transactionID": "rrt-b10efe3e-c-eu-22094-51971829-13",
		"transactionTimestamp": "2016-12-21T18:07:01.910Z",
		"inLanguage": "en-US",
		"serviceVersion": "1"
	},
	"inquiryDetail": {
		"primaryName": "Dun & Bradestreet",
		"tradeStyleName": "D&B",
		"primaryAddress": {
			"countryISOAlpha2Code": "US",
			"addressLocality": "Short Hills",
			"addressRegion": "NJ",
			"streetAddressLine1": "101 JFK Parkway",
			"postalCode": "07078"
		},
		"mailingAddress": {
			"addressLocality": "Short Hills",
			"addressRegion": "NJ",
			"streetAddressLine1": "101 JFK Parkway",
			"postalCode": "07078"
		},
		"telephoneNumber":"9739215500",
		"additionalInformation": "here's some additional information for you",
		"customerReference": "my request #4",
		"customerName": "My Company",
		"customerEmail":"joebloggs@mycompany.com"
	},
	"trackingID": "2128",
	"estimatedResolutionDate": "2016-12-28T17:00:00.000Z"
}

Status

Request

GET https://plus.dnb.com/v1/investigate/status/2128
Authorization: Bearer Your Token

Response

{
  "transactionDetail": {
    "transactionID": "rrt-b10efe3e-c-eu-22094-51974790-2",
    "transactionTimestamp": "2016-12-21T18:08:51.472Z",
    "inLanguage": "en-US",
    "serviceVersion": "1"
  },
  "inquiryDetail": {
    "trackingID": "2128"
  },
  "investigationStatus": {
    "trackingID": "2128",
    "customerReference": "customerReferenceEx ",
    "requestDate": "2016-12-21T06:07:03.000Z",
    "estimatedResolutionDate": "2016-12-28T06:07:03.000Z",
    "actualResolutionDate": "",
    "duns": "",
    "status": {
      "code": "30",
      "description": "Host Country Investigation"
    }
  },
  "comments": {
    "type": "ICOMM     ",
    "description": "additionalInformationExample"
  }
}