Consolidated Assessment Report (CAR) Investigation

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.

Content

Submit Request V2

POST Request

POST https://plus.dnb.com/v2/investigate/car/submit
Authorization: Bearer MyToken
Content-Type: application/json
{
  "duns":"123456789"
  "primaryAddress": {
    "countryISOAlpha2Code":"US"
  },
  "productID":"carbas4"
}

Response

{
  "transactionDetail": {
    "transactionID": "rrt-00d78b858b0f1d8d6-b-ea-28204-269826729-1",
    "transactionTimestamp": "2019-01-23T22:07:44.146Z",
    "inLanguage":"US"
    "serviceVersion":"46"
  },
  "inquiryDetail": {
    "duns": "123456789",
    "primaryAddress": {
    "countryISOAlpha2Code":"US"
      },
    "productID":"carbas4"
  },
  "trackingID": "912317074421a7afe7-1f82-46a9-bc11-15977b7e53deCARS"
  }

Get Status V2

Request

GET https://plus.dnb.com/v2/investigate/car/status/912317074421a7afe7-1f82-46a9-bc11-15977b7e53deCARS
Authorization: Bearer yourToken
Customer-Key: Customer key

Response

{
  "transactionDetail": {
    "transactionID": "rrt-02b319a8b19221502-c-ea-25888-106109359-1",
    "transactionTimestamp": "2019-01-23T22:09:13.491Z",
    "inLanguage":"US",
    "serviceVersion":"46"
  },
  "inquiryDetail": {
    "trackingID":"912317074421a7afe7-1f82-46a9-bc11-15977b7e53deCARS"
  },
  "investigationStatus":{
    "inquiryduns":"123456789",
    "productID":"carbas4",
    "requestTimestamp":"2019-01-23T00:00:00.000Z",
    "status":{
      "code":"1",
      "description":"Fulfilled"
    }
  }
}

Get Report V2

Request

GET https://plus.dnb.com/v2/investigate/report/912317074421a7afe7-1f82-46a9-bc11-15977b7e53deCARS?reportFormat=PDF
Authorization: Bearer yourToken
Customer-Key: Customer key

Response Status: Fulfilled

{
  "transactionDetail": {
    "transactionID": "rrt-02b319a8b19221502-c-ea-25888-106062744-25",
    "transactionTimestamp": "2019-01-23T21:48:25.820Z",
    "inLanguage":"US",
    "serviceVersion":"46"
  },
  "inquiryDetail": {
    "trackingID":"20190107131514c5218656-96bb-4a02-aff7-3bf5cbceb184CaaSS",
    "reportFormat":"PDF"
  },
  "investigationStatus":{
    "status":{
      "code":"1",
      "description":"Fulfilled"
    }
  },
  "outputDetail":{
    "contentURL":"https://www.someurl.com",
    "urlExpirationTimestamp":"2019-09-02T14:20:31.761Z"
  }
}

Submit Request V3

POST Request

POST https://plus.dnb.com/v3/investigate/car/submit
Authorization: Bearer MyToken
Content-Type: application/json

{
	"customerTransactionID": "1234",
	"duns": "804735132",
	"productID": "carbas4",
	"entityDetail": {
		"subjectName": "GORMAN MANUFACTURING COMPANY, INC.",
		"phoneticName": "GORMAN MANUFACTURING",
		"type": "Organization",
		"address": {
			"addressCountry": {
				"isoAlpha2Code": "US"
			},
			"addressLocality": {
				"name": "SAN FRANCISCO"
			},
			"addressRegion": {
				"name": "CA"
			},
			"postalCode": "941109999",
			"streetAddress": {
				"line1": "492 KOLLER ST",
				"line2": "Suite 100"
			}
		},
		"ownershipPercentage": 8.0,
		"startDate": "1985",
		"incorporatedDate": "1990",
		"dataProviderName": "Customer"
	},
	"principal": [
		{
			"name": "John Smith",
			"phoneticName": "John Smith",
			"isPerson": true,
			"birthDate": "1955",
			"jobTitles": [
				{
					"title": "CEO"
				}
			],
			"address": {
				"addressCountry": {
					"isoAlpha2Code": "US"
				},
				"addressLocality": {
					"name": "SAN FRANCISCO"
				},
				"addressRegion": {
					"name": "CA"
				},
				"postalCode": "941109999",
				"streetAddress": {
					"line1": "492 KOLLER ST",
					"line2": "Suite 100"
				}
			},
			"ownershipPercentage": 9.0,
			"nationality": "US",
			"isPEP": true,
			"dataProviderName": "Customer"
		}
	],
	"shareHolder": [
		{
			"name": "John Smith",
			"phoneticName": "John Smith",
			"isPerson": true,
			"birthDate": "1956",
			"jobTitles": [
				{
					"title": "Chairman"
				}
			],
			"address": {
				"addressCountry": {
					"isoAlpha2Code": "US"
				},
				"addressLocality": {
					"name": "SAN FRANCISCO"
				},
				"addressRegion": {
					"name": "CA"
				},
				"postalCode": "941109999",
				"streetAddress": {
					"line1": "492 KOLLER ST",
					"line2": "Suite 100"
				}
			},
			"ownershipPercentage": 7.0,
			"startDate": "1985",
			"incorporatedDate": "1990",
			"nationality": "US",
			"isPEP": true,
			"dataProviderName": "Supplier"
		}
	],
	"otherRelatedParties": [
		{
			"name": "GORMAN MANUFACTURING COMPANY, INC.",
			"phoneticName": "GORMAN",
			"isPerson": true,
			"birthDate": "1956",
			"jobTitles": [
				{
					"title": "CEO"
				}
			],
			"address": {
				"addressCountry": {
					"isoAlpha2Code": "US"
				},
				"addressLocality": {
					"name": "SAN FRANCISCO"
				},
				"addressRegion": {
					"name": "CA"
				},
				"postalCode": "941109999",
				"streetAddress": {
					"line1": "492 KOLLER ST",
					"line2": "Suite 100"
				}
			},
			"ownershipPercentage": 5.0,
			"startDate": "1985-01-01",
			"incorporatedDate": "1990-01-01",
			"nationality": "US",
			"businessEntityType": [
				"123"
			],
			"relatedPartiesType": "Affiliate",
			"isPEP": true,
			"dataProviderName": "Supplier"
		}
	],
	"customerReference": "reference text"
}

Response


{
	"transactionDetail": {
		"customerTransactionID": "1234",
		"transactionID": "rlh-hi9puyoijk-jop8u-kd-d-1",
		"transactionTimestamp": "2017-02-21T17:46:19.839Z",
		"inLanguage": "en-US",
		"serviceVersion": "1"
	},
	"inquiryDetail": {
		"duns": "804735132",
		"productID": "carbas4",
		"entityDetail": {
			"subjectName": "GORMAN MANUFACTURING COMPANY, INC.",
			"phoneticName": "GORMAN MANUFACTURING",
			"type": "Organization",
			"address": {
				"addressCountry": {
					"isoAlpha2Code": "US"
				},
				"addressLocality": {
					"name": "SAN FRANCISCO"
				},
				"addressRegion": {
					"name": "CA"
				},
				"postalCode": "941109999",
				"streetAddress": {
					"line1": "492 KOLLER ST",
					"line2": "Suite 100"
				}
			},
			"ownershipPercentage": 8.0,
			"startDate": "1985",
			"incorporatedDate": "1990",
			"dataProviderName": "Customer"
		},
		"principal": [
			{
				"name": "John Smith",
				"phoneticName": "John Smith",
				"isPerson": true,
				"birthDate": "1955",
				"jobTitles": [
					{
						"title": "CEO"
					}
				],
				"address": {
					"addressCountry": {
						"isoAlpha2Code": "US"
					},
					"addressLocality": {
						"name": "SAN FRANCISCO"
					},
					"addressRegion": {
						"name": "CA"
					},
					"postalCode": "941109999",
					"streetAddress": {
						"line1": "492 KOLLER ST",
						"line2": "Suite 100"
					}
				},
				"ownershipPercentage": 9.0,
				"nationality": "US",
				"isPEP": true,
				"dataProviderName": "Customer"
			}
		],
		"shareHolder": [
			{
				"name": "John Smith",
				"phoneticName": "John Smith",
				"isPerson": true,
				"birthDate": "1956",
				"jobTitles": [
					{
						"title": "Chairman"
					}
				],
				"address": {
					"addressCountry": {
						"isoAlpha2Code": "US"
					},
					"addressLocality": {
						"name": "SAN FRANCISCO"
					},
					"addressRegion": {
						"name": "CA"
					},
					"postalCode": "941109999",
					"streetAddress": {
						"line1": "492 KOLLER ST",
						"line2": "Suite 100"
					}
				},
				"ownershipPercentage": 7.0,
				"startDate": "1985",
				"incorporatedDate": "1990",
				"nationality": "US",
				"isPEP": true,
				"dataProviderName": "Supplier"
			}
		],
		"otherRelatedParties": [
			{
				"name": "GORMAN MANUFACTURING COMPANY, INC.",
				"phoneticName": "GORMAN",
				"isPerson": true,
				"birthDate": "1956",
				"jobTitles": [
					{
						"title": "CEO"
					}
				],
				"address": {
					"addressCountry": {
						"isoAlpha2Code": "US"
					},
					"addressLocality": {
						"name": "SAN FRANCISCO"
					},
					"addressRegion": {
						"name": "CA"
					},
					"postalCode": "941109999",
					"streetAddress": {
						"line1": "492 KOLLER ST",
						"line2": "Suite 100"
					}
				},
				"ownershipPercentage": 5.0,
				"startDate": "1985-01-01",
				"incorporatedDate": "1990-01-01",
				"nationality": "US",
				"businessEntityType": [
					"123"
				],
				"relatedPartiesType": "Affiliate",
				"isPEP": true,
				"dataProviderName": "Supplier"
			}
		],
		"customerReference": "reference text"
	},
	"trackingID": "12345678",
	"estimatedResolutionTimestamp": "2016-12-28T06:07:03.000Z"
}

Get Status V3

Request

GET https://plus.dnb.com/v3/investigate/car/status/12345678?customerTransactionID=1234
Authorization: Bearer yourToken
Customer-Key: Customer key

Response


{
	"transactionDetail": {
		"customerTransactionID": "1234",
		"transactionID": "rlh-hi9puyoijk-jop8u-kd-d-1",
		"transactionTimestamp": "2017-02-21T17:46:19.839Z",
		"inLanguage": "en-US",
		"serviceVersion": "1"
	},
	"inquiryDetail": {
		"trackingID": "12345678"
	},
	"investigationStatus": {
		"trackingID": "12345678",
		"inquiryduns": "804735132",
		"productID": "carbas4",
		"inquiryEntityDetail": {
			"subjectName": "GORMAN MANUFACTURING COMPANY, INC.",
			"phoneticName": "GORMAN MANUFACTURING",
			"type": "Organization",
			"address": {
				"addressCountry": {
					"isoAlpha2Code": "US"
				},
				"addressLocality": {
					"name": "SAN FRANCISCO"
				},
				"addressRegion": {
					"name": "CA"
				},
				"postalCode": "941109999",
				"streetAddress": {
					"line1": "492 KOLLER ST",
					"line2": "Suite 100"
				}
			},
			"ownershipPercentage": 8.0,
			"startDate": "1985",
			"incorporatedDate": "1990",
			"dataProviderName": "Customer"
		},
		"requestTimestamp": "2016-12-30T06:07:03.000Z",
		"actualResolutionTimestamp": "2016-12-30T06:07:03.000Z",
		"duns":"804735132",
		"status": {
			"code": "1",
			"description": "Fulfilled"
		}
	}
}

Get Report V3

Request

GET https://plus.dnb.com/v3/investigate/car/report/12345678??reportFormat=PDF&customerTransactionID=1234
Authorization: Bearer yourToken
Customer-Key: Customer key

Response Status: Fulfilled


{
	"transactionDetail": {
		"customerTransactionID": "1234",
		"transactionID": "rlh-hi9puyoijk-jop8u-kd-d-1",
		"transactionTimestamp": "2017-02-21T17:46:19.839Z",
		"inLanguage": "en-US",
		"serviceVersion": "1"
	},
	"inquiryDetail": {
		"trackingID": "12345678",
		"reportFormat": "PDF"
	},
	"investigationStatus": {
		"status": {
			"code": "1",
			"description": "Fulfilled"
		}
	},
	"outputDetail": {
		"contentURL": "https://www.someurl.com",
		"urlExpirationTimestamp": "2019-09-02T14:20:31.761Z"
	}
}

DNB Full Logo Direct+ Product Documentation