Research Samples

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

Mini Research Submit Case Request

POST https://plus.dnb.com/v1/researches

{
    "customerTransactionID": "TC1",
    "customerReference": "TEST_REF",
    "requestorEmails":[
    {
        "email":"jsmith@company.com",
        "roleType": 19117
    }                           
    ],
    "researchRequestType": "Mini",
    "organization": {
      
       "primaryName": "Gorman Inc",
       "countryISOAlpha2Code":"US",
       "primaryAddress": {
       	"addressCountry" :{
       		"isoAlpha2Code":"US"
       	},
    	"addressRegion": {
           "name": "CALIFORNIA"
        },
        "addressLocality": {
           "name": "SAN FRANCISCO"
        },
        "postalCode": "07020",
        "streetAddress": {
            "line1": "492 KOLLER ST"
        }
        },
		"mailingAddress": {
       	"addressCountry" :{
       		"isoAlpha2Code":"US"
       	},
    	"addressRegion": {
           "name": "CALIFORNIA"
        },
        "addressLocality": {
           "name": "SAN FRANCISCO"
        },
        "postalCode": "07020",
        "streetAddress": {
            "line1": "492 KOLLER ST"
        }
        },
		"registrationNumber":{
		"registrationNumber": "123456789",
		"typeDnBCode": 6863,
		"registrationLocation": "Vlaams Brabant"
		}

    },
    "researchComments": [
    {
    	"typeDnBCode": 33588,
        "comment": "Unable to find the business"
    }
    ],
	"orderReason":"6332"
}

Mini Research Submit Case Response


{
    "transactionDetail": {
        "transactionID": "rrt-0c8e438999f5bf166-d-ea-28248-64179817-1",
        "customerTransactionID": "TC1",
        "transactionTimestamp": "2020-01-15T22:09:07.914Z",
        "serviceVersion": "1"
    },
    "inquiryDetail": {
        "customerReference": "TEST_REF",
        "researchRequestType": "Mini",
        "organization": {
            "primaryName": "Gorman Inc"
        }
    },
    "researchRequestID": 11953,
    "caseDetails": [
        {
            "caseID": 21963,
            "subjectResearchTypes": [
                {
                    "researchType": {
                        "description": "Business does not exist in the Dun & Bradstreet database and needs to be added by assigning a new D-U-N-S Number with business identity information and/or risk level information.",
                        "dnbCode": 33532
                    },
                    "researchSubType": {
                        "description": "Create a new Mini Duns with super 7 (includes: Business Name, Address, phone, CEO, Sales, Emp, SIC) & One up Linkage",
                        "dnbCode": 33575
                    }
                }
            ]
        }
    ]
}

Mini Research Detail Request

GET https://plus.dnb.com/v1/researches/11953

Mini Research Detail Response


{
    "transactionDetail": {
        "transactionID": "rrt-0a7fa8f7f5552207e-b-ea-12200-66988813-1",
        "transactionTimestamp": "2020-01-16T16:25:40.216Z",
        "serviceVersion": "1"
    },
    "inquiryDetail": {
        "researchRequestID": 11953
    },
    "researchRequestID": 11953,
    "submissionTransactionID": "TC1",
    "customerReference": "TEST_REF",
    "submissionTimestamp": "2020-01-15T22:09:07.000+00:00",
    "userLoginKey": "dddd1111555577770000llllAAAA",
    "researchStatus": {
        "description": "Closed",
        "dnbCode": 33624
    },
    "statusTimestamp": "2020-01-16T16:23:24.000+00:00",
    "caseDetails": [
        {
            "caseID": 21963,
            "duns": "555555555",
            "primaryName": "Gorman Manufacturing Inc",
            "primaryAddress": {
                "addressCountry": {
                    "isoAlpha2Code": "US"
                },
                "addressLocality": {
                    "name": "San Franscisco"
                },
                "addressRegion": {
                    "name": "CA"
                },
                "addressCounty": {}
            },
            "caseStatus": {
                "description": "Closed",
                "dnbCode": 33624
            },
            "statusTimestamp": "2020-01-16T16:23:24.000+00:00",
            "subjectResearchTypes": [
                {
                    "researchSubType": {
                        "description": "Create a new Mini Duns with super 7 (includes: Business Name, Address, phone, CEO, Sales, Emp, SIC) & One up Linkage",
                        "dnbCode": 33575
                    },
                    "researchType": {
                        "description": "Business does not exist in the Dun & Bradstreet database and needs to be added by assigning a new D-U-N-S Number with business identity information and/or risk level information.",
                        "dnbCode": 33532
                    },
                    "subResolution": {
                        "description": "Verified through outside sources",
                        "dnbCode": 33731
                    },
                    "resolution": {
                        "description": "D-U-N-S Number created",
                        "dnbCode": 34321
                    },
                    "resolutionTimestamp": "2020-01-16T16:23:24.830+00:00"
                }
            ],
            "inquiredOrganization": {
                "duns": null,
                "primaryName": "Gorman Inc",
                "countryISOAlpha2Code": "US",
                "primaryAddress": {
                    "addressCountry": {
                        "isoAlpha2Code": "US"
                    },
                    "addressLocality": {
                        "name": "SAN FRANCISCO"
                    },
                    "addressRegion": {
                        "name": "CALIFORNIA"
                    },
                    "addressCounty": {},
                    "postalCode": "07020",
                    "streetAddress": {
                        "line1": "492 KOLLER ST"
                    }
                },
                "mailingAddress": null,
                "telephones": [],
                "registrationNumber": null,
                "tradeStyleName": null,
                "referenceContacts": [],
                "primaryIndustryCode": null,
                "activity": null,
                "url": null,
                "yearlyRevenue": null,
                "numberOfEmployees": null,
                "startYear": null,
                "controlOwnershipDate": null,
                "legalForm": null,
                "mostSeniorPrincipal": null,
                "isActiveBusiness": null,
                "acquirer": null,
                "owner": null,
                "childOrganizations": [],
                "shareOwnership": [],
                "principals": [],
                "relatedOrganizations": [],
                "duplicateDUNS": [],
                "requestorSubjectID": null
            },
            "researchResults": {
                "duns": "555555555",
                "hasDUNSChanged": null,
                "primaryName": "Gorman Manufacturing Inc",
                "countryISOAlpha2Code": "US",
                "primaryAddress": null,
                "mailingAddress": null,
                "telephones": [
                    {
                        "telephoneNumber": "6505550000",
                        "isdCode": "1"
                    }
                ],
                "registrationNumber": {
                    "typeDnBCode": 20
                },
                "tradeStyleName": "Gorman",
                "primaryIndustryCode": null,
                "url": null,
                "yearlyRevenue": null,
                "numberOfEmployees": {
                    "informationScopeDnBCode": 9067,
                    "informationScopeDescription": "Consolidated",
                    "value": 20
                },
                "startYear": null,
                "controlOwnershipDate": null,
                "legalForm": null,
                "mostSeniorPrincipal": {
                    "jobTitle": "CEO",
                    "fullName": "John Smith"
                },
                "isActiveBusiness": null,
                "dnbStandardRating": null,
                "acquirer": {},
                "formerOwnerDUNS": null,
                "owner": {},
                "childOrganizations": [],
                "shareOwnership": [],
                "principals": [],
                "relatedOrganizations": [],
                "duplicateDUNS": []
            },
            "researchComments": [
                {
                    "typeDnBCode": 33588,
                    "typeDescription": "Research Requestor Comment",
                    "comment": "Unable to find the business"
                }
            ]
        }
    ]
}

Targeted Research - Submit Case Request

POST https://plus.dnb.com/v1/researches

{
    "customerTransactionID": "TRAN_3",
    "customerReference": "SAMPLE_REF",
    "requestorEmails":[
    {
        "email":"abc@company.com",
        "roleType": 19117
    }                           
    ],
    "researchRequestType": "Targeted",
    "researchSubTypes" :[33769,33770],
    "organization" :{
	"duns" : "009479518",
	 "mailingAddress": {
       	"addressCountry" :{
       		"isoAlpha2Code":"US"
       	},
    	"addressRegion": {
           "name": "CALIFORNIA"
        },
        "addressLocality": {
           "name": "SAN FRANCISCO"
        },
        "postalCode": "07020",
        "streetAddress": {
            "line1": "492 KOLLER ST"
        }
        },
	"registrationNumber":{
		"registrationNumber": "123456789",
		"typeDnBCode": 6863,
		"registrationLocation": "Vlaams Brabant"
		}
    },
    "researchComments": [
    {
    	"typeDnBCode": 33814,
        "comment": "Please review the Financial figures which is older than 2 years."
    },
      {
    	"typeDnBCode": 33815,
        "comment": "Please review the Financial ratios."
    }
    
    ],
	"orderReason":"6332"
}

Targeted Research - Submit Case Response


{
    "transactionDetail": {
        "transactionID": "rrt-0a7fa8f7f5552207e-b-ea-12200-67122842-3",
        "customerTransactionID": "TRAN_3",
        "transactionTimestamp": "2020-01-16T17:59:30.059Z",
        "serviceVersion": "1"
    },
    "inquiryDetail": {
        "customerReference": "SAMPLE_REF",
        "researchRequestType": "Targeted",
        "organization": {
            "duns": "009479518"
        }
    },
    "researchRequestID": 11956,
    "caseDetails": [
        {
            "caseID": 21966,
            "subjectResearchTypes": [
                {
                    "researchType": {
                        "description": "Financial Information includes subject organisation's financial balance sheet, profit & loss statements and ratios.",
                        "dnbCode": 33520
                    },
                    "researchSubType": {
                        "description": "Figures in the financial statement are inaccurate.  State the issue(s) in the comment field",
                        "dnbCode": 33769
                    }
                },
                {
                    "researchType": {
                        "description": "Financial Information includes subject organisation's financial balance sheet, profit & loss statements and ratios.",
                        "dnbCode": 33520
                    },
                    "researchSubType": {
                        "description": "Financial ratios derived from financial data are inaccurate, e.g., Quick Ratio, Current Ratio, Current Liabilities to Net Worth, Return on Sales.  State the issue(s) in the comment field",
                        "dnbCode": 33770
                    }
                }
            ]
        }
    ]
}

Targeted Research Detail Request

GET https://plus.dnb.com/v1/researches/11953

Targeted Research Detail Response


{
    "transactionDetail": {
        "transactionID": "rrt-0a7fa8f7f5552207e-b-ea-12200-66988813-1",
        "transactionTimestamp": "2020-01-16T16:25:40.216Z",
        "serviceVersion": "1"
    },
    "inquiryDetail": {
        "researchRequestID": 11953
    },
    "researchRequestID": 11953,
    "submissionTransactionID": "TC1",
    "customerReference": "TEST_REF",
    "submissionTimestamp": "2020-01-15T22:09:07.000+00:00",
    "userLoginKey": "dddd1111555577770000llllAAAA",
    "researchStatus": {
        "description": "Closed",
        "dnbCode": 33624
    },
    "statusTimestamp": "2020-01-16T16:23:24.000+00:00",
    "caseDetails": [
        {
            "caseID": 21963,
            "duns": "555555555",
            "primaryName": "Gorman Manufacturing Inc",
            "primaryAddress": {
                "addressCountry": {
                    "isoAlpha2Code": "US"
                },
                "addressLocality": {
                    "name": "San Franscisco"
                },
                "addressRegion": {
                    "name": "CA"
                },
                "addressCounty": {}
            },
            "caseStatus": {
                "description": "Closed",
                "dnbCode": 33624
            },
            "statusTimestamp": "2020-01-16T16:23:24.000+00:00",
            "subjectResearchTypes": [
                {
                    "researchSubType": {
                        "description": "Create a new Mini Duns with super 7 (includes: Business Name, Address, phone, CEO, Sales, Emp, SIC) & One up Linkage",
                        "dnbCode": 33575
                    },
                    "researchType": {
                        "description": "Business does not exist in the Dun & Bradstreet database and needs to be added by assigning a new D-U-N-S Number with business identity information and/or risk level information.",
                        "dnbCode": 33532
                    },
                    "subResolution": {
                        "description": "Verified through outside sources",
                        "dnbCode": 33731
                    },
                    "resolution": {
                        "description": "D-U-N-S Number created",
                        "dnbCode": 34321
                    },
                    "resolutionTimestamp": "2020-01-16T16:23:24.830+00:00"
                }
            ],
            "inquiredOrganization": {
                "duns": null,
                "primaryName": "Gorman Inc",
                "countryISOAlpha2Code": "US",
                "primaryAddress": {
                    "addressCountry": {
                        "isoAlpha2Code": "US"
                    },
                    "addressLocality": {
                        "name": "SAN FRANCISCO"
                    },
                    "addressRegion": {
                        "name": "CALIFORNIA"
                    },
                    "addressCounty": {},
                    "postalCode": "07020",
                    "streetAddress": {
                        "line1": "492 KOLLER ST"
                    }
                },
                "mailingAddress": null,
                "telephones": [],
                "registrationNumber": null,
                "tradeStyleName": null,
                "referenceContacts": [],
                "primaryIndustryCode": null,
                "activity": null,
                "url": null,
                "yearlyRevenue": null,
                "numberOfEmployees": null,
                "startYear": null,
                "controlOwnershipDate": null,
                "legalForm": null,
                "mostSeniorPrincipal": null,
                "isActiveBusiness": null,
                "acquirer": null,
                "owner": null,
                "childOrganizations": [],
                "shareOwnership": [],
                "principals": [],
                "relatedOrganizations": [],
                "duplicateDUNS": [],
                "requestorSubjectID": null
            },
            "researchResults": {
                "duns": "555555555",
                "hasDUNSChanged": null,
                "primaryName": "Gorman Manufacturing Inc",
                "countryISOAlpha2Code": "US",
                "primaryAddress": null,
                "mailingAddress": null,
                "telephones": [
                    {
                        "telephoneNumber": "6505550000",
                        "isdCode": "1"
                    }
                ],
                "registrationNumber": {
                    "typeDnBCode": 20
                },
                "tradeStyleName": "Gorman",
                "primaryIndustryCode": null,
                "url": null,
                "yearlyRevenue": null,
                "numberOfEmployees": {
                    "informationScopeDnBCode": 9067,
                    "informationScopeDescription": "Consolidated",
                    "value": 20
                },
                "startYear": null,
                "controlOwnershipDate": null,
                "legalForm": null,
                "mostSeniorPrincipal": {
                    "jobTitle": "CEO",
                    "fullName": "John Smith"
                },
                "isActiveBusiness": null,
                "dnbStandardRating": null,
                "acquirer": {},
                "formerOwnerDUNS": null,
                "owner": {},
                "childOrganizations": [],
                "shareOwnership": [],
                "principals": [],
                "relatedOrganizations": [],
                "duplicateDUNS": []
            },
            "researchComments": [
                {
                    "typeDnBCode": 33588,
                    "typeDescription": "Research Requestor Comment",
                    "comment": "Unable to find the business"
                }
            ]
        }
    ]
}

Full Research - Submit Case Request

POST https://plus.dnb.com/v1/researches

{
    "customerTransactionID": "TRAN_2",
    "customerReference": "SAMPLE_REF",
    "requestorEmails":[
    {
        "email":"jsmith@company.com",
        "roleType": 19117
    }                           
    ],
    "researchRequestType": "FullRvw",
    "organization": {
       "primaryName": "Full Review  Inc",
       "primaryAddress": {
       	"addressCountry" :{
       		"isoAlpha2Code":"US"
       	},
    	"addressRegion": {
           "name": "New Jersey"
        },
        "addressLocality": {
           "name": "Short Hills"
        },
        "postalCode": "07020",
        "streetAddress": {
            "line1": "103 JFK PKWY"
        }
        }, 
		"mailingAddress": {
       	"addressCountry" :{
       		"isoAlpha2Code":"US"
       	},
    	"addressRegion": {
           "name": "CALIFORNIA"
        },
        "addressLocality": {
           "name": "SAN FRANCISCO"
        },
        "postalCode": "07020",
        "streetAddress": {
            "line1": "492 KOLLER ST"
        }
        },
		"registrationNumber":{
		"registrationNumber": "123456789",
		"typeDnBCode": 6863,
		"registrationLocation": "Vlaams Brabant"
		}
    },
    "researchComments": [
    {
    	"typeDnBCode": 33588,
        "comment": "Need Full Credit Risk details of the business"
    }
    ],
	"orderReason":"6332"
}

Full Research - Submit Case Response


{
    "transactionDetail": {
        "transactionID": "rrt-0017ac209d3396b2a-c-ea-23609-65119547-2",
        "customerTransactionID": "TRAN_2",
        "transactionTimestamp": "2020-01-16T16:55:56.874Z",
        "serviceVersion": "1"
    },
    "inquiryDetail": {
        "customerReference": "SAMPLE_REF",
        "researchRequestType": "FullRvw",
        "organization": {
            "primaryName": "Full Review  Inc"
        }
    },
    "researchRequestID": 11955,
    "caseDetails": [
        {
            "caseID": 21965,
            "subjectResearchTypes": [
                {
                    "researchType": {
                        "description": "Business does not exist in the Dun & Bradstreet database and needs to be added by assigning a new D-U-N-S Number with business identity information and/or risk level information.",
                        "dnbCode": 33532
                    },
                    "researchSubType": {
                        "description": "Entity does not exist in the D&B file and needs to be added with Risk level information",
                        "dnbCode": 33574
                    }
                }
            ]
        }
    ]
}

Full Research Detail Request

GET https://plus.dnb.com/v1/researches/11955

Full Research Detail Response


{
    "transactionDetail": {
        "transactionID": "rrt-0b44eb1cd4360a0a2-b-ea-31713-67172824-2",
        "transactionTimestamp": "2020-01-16T17:13:10.762Z",
        "serviceVersion": "1"
    },
    "inquiryDetail": {
        "researchRequestID": 11955
    },
    "researchRequestID": 11955,
    "submissionTransactionID": "TRAN_2",
    "customerReference": "SAMPLE_REF",
    "submissionTimestamp": "2020-01-16T16:55:56.000+00:00",
    "userLoginKey": "dddd1111555577770000llllAAAA",
    "researchStatus": {
        "description": "Closed",
        "dnbCode": 33624
    },
    "statusTimestamp": "2020-01-16T17:12:03.000+00:00",
    "caseDetails": [
        {
            "caseID": 21965,
            "duns": "222222222",
            "primaryName": "Full Review Management Inc",
            "primaryAddress": {
                "addressCountry": {
                    "isoAlpha2Code": "US"
                },
                "addressLocality": {
                    "name": "Lake Success"
                },
                "addressRegion": {
                    "name": "NY"
                },
                "addressCounty": {}
            },
            "caseStatus": {
                "description": "Closed",
                "dnbCode": 33624
            },
            "statusTimestamp": "2020-01-16T17:12:03.000+00:00",
            "subjectResearchTypes": [
                {
                    "researchSubType": {
                        "description": "Entity does not exist in the D&B file and needs to be added with Risk level information",
                        "dnbCode": 33574
                    },
                    "researchType": {
                        "description": "Business does not exist in the Dun & Bradstreet database and needs to be added by assigning a new D-U-N-S Number with business identity information and/or risk level information.",
                        "dnbCode": 33532
                    },
                    "subResolution": {
                        "description": "Verified through a company spokesperson plus outside sources",
                        "dnbCode": 33732
                    },
                    "resolution": {
                        "description": "D-U-N-S Number created",
                        "dnbCode": 34321
                    },
                    "resolutionTimestamp": "2020-01-16T17:12:02.977+00:00"
                }
            ],
            "inquiredOrganization": {
                "duns": null,
                "primaryName": "Full Review  Inc",
                "countryISOAlpha2Code": "US",
                "primaryAddress": {
                    "addressCountry": {
                        "isoAlpha2Code": "US"
                    },
                    "addressLocality": {
                        "name": "Short Hills"
                    },
                    "addressRegion": {
                        "name": "New Jersey"
                    },
                    "addressCounty": {},
                    "postalCode": "07020",
                    "streetAddress": {
                        "line1": "103 JFK PKWY"
                    }
                },
                "mailingAddress": null,
                "telephones": [],
                "registrationNumber": null,
                "tradeStyleName": null,
                "referenceContacts": [],
                "primaryIndustryCode": null,
                "activity": null,
                "url": null,
                "yearlyRevenue": null,
                "numberOfEmployees": null,
                "startYear": null,
                "controlOwnershipDate": null,
                "legalForm": null,
                "mostSeniorPrincipal": null,
                "isActiveBusiness": null,
                "acquirer": null,
                "owner": null,
                "childOrganizations": [],
                "shareOwnership": [],
                "principals": [],
                "relatedOrganizations": [],
                "duplicateDUNS": [],
                "requestorSubjectID": null
            },
            "researchResults": {
                "duns": "222222222",
                "hasDUNSChanged": null,
                "primaryName": "Full Review Management Inc",
                "countryISOAlpha2Code": "US",
                "primaryAddress": null,
                "mailingAddress": null,
                "telephones": [
                    {
                        "telephoneNumber": "2011118800",
                        "isdCode": "1"
                    }
                ],
                "registrationNumber": {
                    "registrationLocation": "Sole Proprietorship",
                    "typeDnBCode": 40
                },
                "tradeStyleName": "Full Review",
                "primaryIndustryCode": {
                    "code": "5145",
                    "typeDnBCode": 3599
                },
                "url": null,
                "yearlyRevenue": {
                    "currency": "USD",
                    "value": 3500000
                },
                "numberOfEmployees": {
                    "informationScopeDnBCode": 9067,
                    "informationScopeDescription": "Consolidated",
                    "value": 40
                },
                "startYear": 2005,
                "controlOwnershipDate": "2005-06",
                "legalForm": "Sole Proprietorship",
                "mostSeniorPrincipal": {
                    "jobTitle": "Managing Director",
                    "fullName": "Bob Jones"
                },
                "isActiveBusiness": null,
                "dnbStandardRating": "5A1",
                "acquirer": {},
                "formerOwnerDUNS": null,
                "owner": {},
                "childOrganizations": [],
                "shareOwnership": [],
                "principals": [],
                "relatedOrganizations": [],
                "duplicateDUNS": []
            },
            "researchComments": [
                {
                    "typeDnBCode": 33588,
                    "typeDescription": "Research Requestor Comment",
                    "comment": "Need Full Credit Risk details of the business"
                }
            ]
        }
    ]
}

Research Summary Request

GET https://plus.dnb.com/v1/researches?submissionStartDate=2020-08-01&submissionEndDate=2020-08-10&researchStatus=Open&isRequestedByAllUsers=true&pageSize=25&sortDirection=Ascending

Research Summary Response


{
  "transactionDetail": {
    "transactionID": "rrt-0be815aa085f67bfe-d-ea-14781-98157256-57",
    "transactionTimestamp": "2020-10-29T12:18:48.082Z",
    "serviceVersion": "1"
  },
  "inquiryDetail": {
    "submissionStartDate": "2020-08-01",
    "submissionEndDate": "2020-10-30",
    "researchStatus": "Open",
    "isRequestedByAllUsers": true,
    "pageSize": 25,
    "sortDirection": "Ascending"
  },
  "hasNextPage": true,
  "pageMarker": 32809,
  "openResearchRequestsCount": 3013,
  "researchRequests": [
    {
      "researchRequestID": 32808,
      "submissionTransactionID": "M2631600437860349770533",
      "userLoginKey": "DALQA",
      "submissionTimestamp": "2020-08-01T02:42:55.000+00:00",
      "researchStatus": {
        "description": "In Progress",
        "dnbCode": 33622
      },
      "statusTimestamp": "2020-08-01T02:43:01.000+00:00",
      "caseDetails": [
        {
          "caseID": 43161,
          "duns": "600235649",
          "primaryName": "ISRAPEL LTD",
          "primaryAddress": {
            "addressCountry": {
              "isoAlpha2Code": "IL"
            },
            "addressLocality": {
              "name": "TEL AVIV-JAFFA"
            },
            "addressRegion": {},
            "addressCounty": {}
          },
          "caseStatus": {
            "description": "In Progress",
            "dnbCode": 33622
          },
          "statusTimestamp": "2020-08-01T02:43:01.000+00:00",
          "isChallengeable": false,
          "subjectResearchTypes": [
            {
              "researchType": {
                "description": "A full review of an existing D-U-N-S Numbered organization with regard to its credit risk level",
                "dnbCode": 34377
              },
              "researchSubType": {
                "description": "A full review of an existing D-U-N-S Numbered organization with regard to its credit risk level",
                "dnbCode": 34378
              },
              "isAddedByResearcher": null,
              "resolution": {},
              "subResolution": {},
              "resolutionTimestamp": null
            }
          ]
        }
      ]
    },
    {
      "researchRequestID": 32839,
      "submissionTransactionID": "M2636083767880353974893",
      "userLoginKey": "DALQA",
      "submissionTimestamp": "2020-08-03T11:26:19.000+00:00",
      "researchStatus": {
        "description": "Received",
        "dnbCode": 33621
      },
      "statusTimestamp": "2020-08-03T11:26:19.000+00:00",
      "caseDetails": [
        {
          "caseID": 43192,
          "duns": "051739907",
          "primaryName": "John Happle Solar Inc",
          "primaryAddress": {
            "addressCountry": {
              "isoAlpha2Code": "US"
            },
            "addressLocality": {
              "name": "Lakeland"
            },
            "addressRegion": {
              "name": "FL"
            },
            "addressCounty": {
              "name": "Polk"
            }
          },
          "caseStatus": {
            "description": "Received",
            "dnbCode": 33621
          },
          "statusTimestamp": "2020-08-03T11:26:19.000+00:00",
          "isChallengeable": false,
          "subjectResearchTypes": [
            {
              "researchType": {
                "description": "A full review of an existing D-U-N-S Numbered organization with regard to its credit risk level",
                "dnbCode": 34377
              },
              "researchSubType": {
                "description": "A full review of an existing D-U-N-S Numbered organization with regard to its credit risk level",
                "dnbCode": 34378
              },
              "isAddedByResearcher": null,
              "resolution": {},
              "subResolution": {},
              "resolutionTimestamp": null
            }
          ]
        }
      ]
    }
  ]
}

Research Challenge Case Request

POST https://plus.dnb.com/v1/researches/12795/cases/22858/challenges
{
	"customerTransactionID": "CUST123",
	"customerReference": "TEST_CHALLENGE.",
	"challengeReason": 33629,
	"researchComments": [
	{
		"typeDnBCode": 33594,
		"comment": "Score is out of date and the customer has latest trade and finance information"
	}
	],
	"includeAttachments": [
	{
		"fileName": "BIR.pdf"
	}
	]
}

Research Challenge Case Response


{
    "transactionDetail": {
        "transactionID": "rrt-0623a0192b166e525-c-ea-29756-195195002-1",
        "customerTransactionID": "CUST123",
        "transactionTimestamp": "2020-05-13T17:11:58.274Z",
        "serviceVersion": "1"
    },
    "InquiryDetail": {
        "customerReference": "TEST_CHALLENGE.",
        "researchRequestID": 12795,
        "caseID": 22858,
        "challengeReason": 33629,
        "researchComments": [
            {
                "typeDnBCode": 33594,
                "comment": "Score is out of date and the customer has latest trade and finance information"
            }
        ],
        "includeAttachments": [
            {
                "fileName": "BIR.pdf"
            }
        ]
    },
    "attachmentLink": [
        {
            "fileName": "BIR.pdf",
            "url": "https://irsch-q2-datastores.s3.amazonaws.com/",
            "awsfields": {
                "acl": "public-read",
                "Content-Type": "multipart/form-data",
                "key": "attachment-upload/C22858/8409C0E0_BIR.pdf",
                "x-amz-algorithm": "AWS4-HMAC-SHA256",
                "x-amz-credential": "ASIAUIA5WTQCKMD5M4IW/20200513/us-east-1/s3/aws4_request",
                "x-amz-date": "20200513T171158Z",
                "x-amz-security-token": "IQoJb3JpZ2luX2VjEBgaCXVzLWVhc3QtMSJGMEQCIAIgpcz+/USGzXafXS0F0TFRdf0Maw9OWoOp6aYws+ZbAiBWMEcayBkELbQzBUM+h/EHbGr91uZ0FpaGg6vFRlwThSrYAQhhEAIaDDI5MjEyMDA3NTI2OCIMDDojNkynZOpd1HABKrUBmIinNvlX0MreJHizvX9m5llnn8iLZTpiDgyiDjbdC4nfuWhq5iH58VzqsN0SkPNpIcXgG75sm37niVfUQUWrHK1LQk2dgp2ul1GLIO+MPE6cXsXn5LI6uVrGJeT0sFiZdRd6XBOZehpoXGhUUptXx6BXR24NOIAfjESZmmX5EjaJrg51xF5NIEKF314yj9E86xE/IuggEVIFzv2qRCoWBVdc4hEs6Sy6RzTkAMirUbts2jWn7zDksvD1BTrhAXu74PvXdVvqnQinL3lj+la7rJt5Viydk6IDWE4flxuTsMAyuGSQhv5BpGc9yPs8rBAsDc1Z8xZw96Z50kCvmgY1VxdSN74ACc3E2fHCWHl+Wgu9v1wCH/m1oM6DC1kOaQMPPSn7VfpRyQNHdYE44UP60gF2vD7cn8kqi24Rh76ZaVZsxjX6eG0hDsfZhuoPFGzxO4v91tkl0PUagBm78yZGSdr2ENmf+NJibxq7TK4nI1jnbI5+TKXwHstqHOQ7etg3muCQqHCduyVKUbyttWFbw0WU8Yik2Sm/hyhfyoHuOA==",
                "policy": "eyJleHBpcmF0aW9uIjogIjIwMjAtMDUtMTNUMTc6MTI6NThaIiwgImNvbmRpdGlvbnMiOiBbeyJhY2wiOiAicHVibGljLXJlYWQifSwgWyJjb250ZW50LWxlbmd0aC1yYW5nZSIsIDEsIDUxMjAwMDBdLCB7ImJ1Y2tldCI6ICJpcnNjaC1xMi1kYXRhc3RvcmVzIn0sIHsia2V5IjogImF0dGFjaG1lbnQtdXBsb2FkL0MyMjg1OC84NDA5QzBFMF9CSVIucGRmIn0sIHsieC1hbXotYWxnb3JpdGhtIjogIkFXUzQtSE1BQy1TSEEyNTYifSwgeyJ4LWFtei1jcmVkZW50aWFsIjogIkFTSUFVSUE1V1RRQ0tNRDVNNElXLzIwMjAwNTEzL3VzLWVhc3QtMS9zMy9hd3M0X3JlcXVlc3QifSwgeyJ4LWFtei1kYXRlIjogIjIwMjAwNTEzVDE3MTE1OFoifSwgeyJ4LWFtei1zZWN1cml0eS10b2tlbiI6ICJJUW9KYjNKcFoybHVYMlZqRUJnYUNYVnpMV1ZoYzNRdE1TSkdNRVFDSUFJZ3BjeisvVVNHelhhZlhTMEYwVEZSZGYwTWF3OU9Xb09wNmFZd3MrWmJBaUJXTUVjYXlCa0VMYlF6QlVNK2gvRUhiR3I5MXVaMEZwYUdnNnZGUmx3VGhTcllBUWhoRUFJYURESTVNakV5TURBM05USTJPQ0lNRERvak5reW5aT3BkMUhBQktyVUJtSWluTnZsWDBNcmVKSGl6dlg5bTVsbG5uOGlMWlRwaURneWlEamJkQzRuZnVXaHE1aUg1OFZ6cXNOMFNrUE5wSWNYZ0c3NXNtMzduaVZmVVFVV3JISzFMUWsyZGdwMnVsMUdMSU8rTVBFNmNYc1huNUxJNnVWckdKZVQwc0ZpWmRSZDZYQk9aZWhwb1hHaFVVcHRYeDZCWFIyNE5PSUFmakVTWm1tWDVFamFKcmc1MXhGNU5JRUtGMzE0eWo5RTg2eEUvSXVnZ0VWSUZ6djJxUkNvV0JWZGM0aEVzNlN5NlJ6VGtBTWlyVWJ0czJqV243ekRrc3ZEMUJUcmhBWHU3NFB2WGRWdnFuUWluTDNsaitsYTdySnQ1Vml5ZGs2SURXRTRmbHh1VHNNQXl1R1NRaHY1QnBHYzl5UHM4ckJBc0RjMVo4eFp3OTZaNTBrQ3ZtZ1kxVnhkU043NEFDYzNFMmZIQ1dIbCtXZ3U5djF3Q0gvbTFvTTZEQzFrT2FRTVBQU243VmZwUnlRTkhkWUU0NFVQNjBnRjJ2RDdjbjhrcWkyNFJoNzZaYVZac3hqWDZlRzBoRHNmWmh1b1BGR3p4TzR2OTF0a2wwUFVhZ0JtNzh5WkdTZHIyRU5tZitOSmlieHE3VEs0bkkxam5iSTUrVEtYd0hzdHFIT1E3ZXRnM211Q1FxSENkdXlWS1VieXR0V0ZidzBXVThZaWsyU20vaHloZnlvSHVPQT09In1dfQ==",
                "x-amz-signature": "49ab6aa19812b0f5262b7ede0c703f008077e774285efbf391841bbc5cff35f4"
            }
        }
    ]
}

Attachment Research Submit Case Request

POST https://plus.dnb.com/v1/researches
{
    "customerTransactionID": "TRAN_REF_1",
    "customerReference": "VALIDATE_ATTACHMENT",
    "requestorEmails":[
    {
        "email":"company@abc.com",
        "roleType": 19117
    }                           
    ],
    "researchRequestType": "FullRvw",
    "organization": {
		"duns" :"112158568",
		 "mailingAddress": {
       	"addressCountry" :{
       		"isoAlpha2Code":"US"
       	},
    	"addressRegion": {
           "name": "CALIFORNIA"
        },
        "addressLocality": {
           "name": "SAN FRANCISCO"
        },
        "postalCode": "07020",
        "streetAddress": {
            "line1": "492 KOLLER ST"
        }
        },
		"registrationNumber":{
		"registrationNumber": "123456789",
		"typeDnBCode": 6863,
		"registrationLocation": "Vlaams Brabant"
		}
    },
    "researchComments": [
    {
    	"typeDnBCode": 33588,
        "comment": "I couldn't find this business in D&B. What is the primary business of this organization?"
    }
    ],
    "includeAttachments" :
    [
    	{
    		"fileName" :"264849931_BIR.pdf"
    	}
    ],
	"orderReason":"6332"
}

Attachment Research Submit Case Response


{
    "transactionDetail": {
        "transactionID": "rrt-03c360d5f4dce2c00-b-ea-3509-195055181-14",
        "customerTransactionID": "TC#1",
        "transactionTimestamp": "2020-05-13T16:18:30.414Z",
        "serviceVersion": "1"
    },
    "inquiryDetail": {
        "customerReference": "UAT_DEC",
        "researchRequestType": "FullRvw",
        "organization": {
            "duns": "112158568"
        }
    },
    "researchRequestID": 12795,
    "caseDetails": [
        {
            "caseID": 22858,
            "subjectResearchTypes": [
                {
                    "researchType": {
                        "description": "A full review of an existing D-U-N-S Numbered organization with regard to its credit risk level",
                        "dnbCode": 34377
                    },
                    "researchSubType": {
                        "description": "A full review of an existing D-U-N-S Numbered organization with regard to its credit risk level",
                        "dnbCode": 34378
                    }
                }
            ]
        }
    ],
    "attachmentLinks": [
        {
            "fileName": "264849931_BIR.pdf",
            "url": "https://irsch-q2-datastores.s3.amazonaws.com/",
            "awsFields": {
                "acl": "public-read",
                "Content-Type": "multipart/form-data",
                "key": "attachment-upload/R12795/00258F34_264849931_BIR.pdf",
                "x-amz-algorithm": "AWS4-HMAC-SHA256",
                "x-amz-credential": "ASIAUIA5WTQCJKQVLZNV/20200513/us-east-1/s3/aws4_request",
                "x-amz-date": "20200513T161830Z",
                "x-amz-security-token": "IQoJb3JpZ2luX2VjEBcaCXVzLWVhc3QtMSJIMEYCIQCm+4zeNTMCw3gGn2+Q6Sm2rttk7Bfp8o8N8Nzg1RRVLQIhALSfAzunqi86aimotMphepkVDburPKl+hJUNYGPRBaGmKuABCGAQAhoMMjkyMTIwMDc1MjY4IgwhZIWDnS/4Upk1F8wqvQErhxewt0LNK0iRgzQXmCKU4mLngr3c22Z7tLXve5UeSs+ggkcvP7WGLWegZWT8CZxAs0NNAAI1Oq08lBF+F0FBJEO56S49KnR7ClruBLsd8l2uu9GpgMv2/Vq41tRfA+wBoPd5Nqzv2T2YE4ekgmlEeXM0GXuOJqyzTGTKMHfP3v+xd2LXLgldAdJbCIT5e6tUUuxLGpariuP5HuU+GZ3tfKOUryjiw1J2giBL94NsM8SRbvqha51PLFTvXScw45Xw9QU63wFboR1jlaJ556qD3IT8GBwBWxGVUZ2iB2Q+7/1t01Z91iLUASe3KM+2e6XeOhvs7Tlp4Px/8SXxtDRl+RMND97eswA5ic5CEPCWcLei5SJ2KN89RNeodPxCpjPtOR/WM602VdLByF+4uPPVpsrqAnG1XDgtilYzNjctqTHCHQLtRN8ZEqD12YV9nYwHYMsFhbUL3QyBujVOLz7EtLwLIo6gFN5K2YI46RkQoHU7AyPmhS+Y+9nxuiGyvlF1gnPrMsGEPPDKXHSNVBkZUkw4D41Wmt6TfOU7yhiOwyv1e4qD",
                "policy": "eyJleHBpcmF0aW9uIjogIjIwMjAtMDUtMTNUMTY6MTk6MzBaIiwgImNvbmRpdGlvbnMiOiBbeyJhY2wiOiAicHVibGljLXJlYWQifSwgWyJjb250ZW50LWxlbmd0aC1yYW5nZSIsIDEsIDUxMjAwMDBdLCB7ImJ1Y2tldCI6ICJpcnNjaC1xMi1kYXRhc3RvcmVzIn0sIHsia2V5IjogImF0dGFjaG1lbnQtdXBsb2FkL1IxMjc5NS8wMDI1OEYzNF8yNjQ4NDk5MzFfQklSLnBkZiJ9LCB7IngtYW16LWFsZ29yaXRobSI6ICJBV1M0LUhNQUMtU0hBMjU2In0sIHsieC1hbXotY3JlZGVudGlhbCI6ICJBU0lBVUlBNVdUUUNKS1FWTFpOVi8yMDIwMDUxMy91cy1lYXN0LTEvczMvYXdzNF9yZXF1ZXN0In0sIHsieC1hbXotZGF0ZSI6ICIyMDIwMDUxM1QxNjE4MzBaIn0sIHsieC1hbXotc2VjdXJpdHktdG9rZW4iOiAiSVFvSmIzSnBaMmx1WDJWakVCY2FDWFZ6TFdWaGMzUXRNU0pJTUVZQ0lRQ20rNHplTlRNQ3czZ0duMitRNlNtMnJ0dGs3QmZwOG84TjhOemcxUlJWTFFJaEFMU2ZBenVucWk4NmFpbW90TXBoZXBrVkRidXJQS2wraEpVTllHUFJCYUdtS3VBQkNHQVFBaG9NTWpreU1USXdNRGMxTWpZNElnd2haSVdEblMvNFVwazFGOHdxdlFFcmh4ZXd0MExOSzBpUmd6UVhtQ0tVNG1MbmdyM2MyMlo3dExYdmU1VWVTcytnZ2tjdlA3V0dMV2VnWldUOENaeEFzME5OQUFJMU9xMDhsQkYrRjBGQkpFTzU2UzQ5S25SN0NscnVCTHNkOGwydXU5R3BnTXYyL1ZxNDF0UmZBK3dCb1BkNU5xenYyVDJZRTRla2dtbEVlWE0wR1h1T0pxeXpUR1RLTUhmUDN2K3hkMkxYTGdsZEFkSmJDSVQ1ZTZ0VVV1eExHcGFyaXVQNUh1VStHWjN0ZktPVXJ5aml3MUoyZ2lCTDk0TnNNOFNSYnZxaGE1MVBMRlR2WFNjdzQ1WHc5UVU2M3dGYm9SMWpsYUo1NTZxRDNJVDhHQndCV3hHVlVaMmlCMlErNy8xdDAxWjkxaUxVQVNlM0tNKzJlNlhlT2h2czdUbHA0UHgvOFNYeHREUmwrUk1ORDk3ZXN3QTVpYzVDRVBDV2NMZWk1U0oyS044OVJOZW9kUHhDcGpQdE9SL1dNNjAyVmRMQnlGKzR1UFBWcHNycUFuRzFYRGd0aWxZek5qY3RxVEhDSFFMdFJOOFpFcUQxMllWOW5Zd0hZTXNGaGJVTDNReUJ1alZPTHo3RXRMd0xJbzZnRk41SzJZSTQ2UmtRb0hVN0F5UG1oUytZKzlueHVpR3l2bEYxZ25Qck1zR0VQUERLWEhTTlZCa1pVa3c0RDQxV210NlRmT1U3eWhpT3d5djFlNHFEIn1dfQ==",
                "x-amz-signature": "a590844dbdf7c4fb1a1e3a627249722ffb99bd9dce0453dfc00cf9fa3e91a756"
            }
        }
    ]
}

Upload Attachment

Attachment Upload

Attachment Research Detail Request

GET https://plus.dnb.com/v1/researches/10853

Attachment Research Detail Response


{
    "transactionDetail": {
        "transactionID": "rrt-09e71b74a7dc457ac-d-ea-2132-181304193-7",
        "transactionTimestamp": "2020-05-08T21:58:06.436Z",
        "serviceVersion": "1"
    },
    "inquiryDetail": {
        "researchRequestID": 10853
    },
    "researchRequestID": 10853,
    "submissionTransactionID": "TC#1",
    "customerReference": "UAT_DEC",
    "submissionTimestamp": "2020-05-08T20:46:41.000+00:00",
    "userLoginKey": "gWzmrVPnfHg5h9Azh9RAG4MDDtTjcyA1",
    "researchStatus": {
        "description": "Received",
        "dnbCode": 33621
    },
    "statusTimestamp": "2020-05-08T20:46:41.000+00:00",
    "caseDetails": [
        {
            "caseID": 20904,
            "duns": null,
            "primaryName": "DNB Inc",
            "primaryAddress": {
                "addressCountry": {
                    "isoAlpha2Code": "US"
                },
                "addressLocality": {
                    "name": "Short Hills"
                },
                "addressRegion": {
                    "name": "New Jersey"
                },
                "addressCounty": {}
            },
            "caseStatus": {
                "description": "Received",
                "dnbCode": 33621
            },
            "statusTimestamp": "2020-05-08T20:46:41.000+00:00",
            "subjectResearchTypes": [
                {
                    "researchSubType": {
                        "description": "Create a new Mini Duns with super 7 (includes: Business Name, Address, phone, CEO, Sales, Emp, SIC) & One up Linkage",
                        "dnbCode": 33575
                    },
                    "researchType": {
                        "description": "Business does not exist in the Dun & Bradstreet database and needs to be added by assigning a new D-U-N-S Number with business identity information and/or risk level information.",
                        "dnbCode": 33532
                    },
                    "subResolution": {},
                    "resolution": {},
                    "isAddedByResearcher": null,
                    "resolutionTimestamp": null
                }
            ],
            "inquiredOrganization": {
                "duns": null,
                "primaryName": "DNB Inc",
                "countryISOAlpha2Code": "US",
                "primaryAddress": {
                    "addressCountry": {
                        "isoAlpha2Code": "US"
                    },
                    "addressLocality": {
                        "name": "Short Hills"
                    },
                    "addressRegion": {
                        "name": "New Jersey"
                    },
                    "addressCounty": {},
                    "postalCode": "07020",
                    "streetAddress": {
                        "line1": "103 JFK PKWY"
                    }
                },
                "mailingAddress": {},
                "telephones": [],
                "registrationNumber": {},
                "tradeStyleName": null,
                "referenceContacts": [],
                "primaryIndustryCode": {},
                "activity": null,
                "url": null,
                "yearlyRevenue": {},
                "numberOfEmployees": {},
                "startYear": null,
                "controlOwnershipDate": null,
                "legalForm": null,
                "mostSeniorPrincipal": {},
                "isActiveBusiness": null,
                "acquirer": {},
                "owner": {},
                "childOrganizations": [],
                "shareOwnership": [],
                "principals": [],
                "relatedOrganizations": [],
                "duplicateDUNS": [],
                "requestorSubjectID": null
            },
            "researchResults": {},
            "isChallengeable": false,
            "challenges": [],
            "caseHistory": [],
            "researchComments": [
                {
                    "typeDnBCode": 33588,
                    "typeDescription": "Research Requestor Comment",
                    "comment": "I couldn't find this business in D&B. What is the primary business of this organization?"
                }
            ],
            "attachments": [
                {
                    "fileName": "WebsiteOutput.txt",
                    "url": "https://irsch-q2-datastores.s3.amazonaws.com/attachments/R10853/94300417_WebsiteOutput.txt?X-Amz-Security-Token=IQoJb3JpZ2luX2VjEKX%2F%2F%2F%2F%2F%2F%2F%2F%2F%2FwEaCXVzLWVhc3QtMSJGMEQCID3TDLEZ%2FGHn1yZIY1L6YE%2FLaeCfF7BjLoytX%2BQOxomVAiAZ4atqTa5Bai5zLi0qSzKyyMsWNHcW8bUwvUpdxptqJCrlAQje%2F%2F%2F%2F%2F%2F%2F%2F%2F%2F8BEAIaDDI5MjEyMDA3NTI2OCIM8Jn6e4GiAX8vW6DSKrkBsinwYkWuG1pzd%2FedSxTDd2QNEDn3d72RHXflhFU65ccK35vz%2BYMaNl34Th8%2B9Mh3Vk9u2qHGbc%2BOPdDqXmjWMYKrVtW%2FrQEsenWcMSwQU4VMkZ%2BmDzr7gvMFUtf8q2SX0s0AryETxq8lpvc%2F%2FAGdrIb1X%2FGmUYSfodX6CwhrifU9BhElZGkmj%2FKXi8n2AQ9mXg%2Fpahk2x1fBC4t2pSsHxapfUDEE49N4trgKyXbSduLGhDEp%2BO5%2FMmowkIvX9QU64QExYko2fOMfr3D8HxlQxiIntLuJ8XlMJaQRkUMCJTJ0hgxo13iayqpQIuu7LmrOgdqnjey24eSjC0eoVuRHDYPKeo69iOE5gAGrBSoXjJscZ7MKMhayxZ8ENpmpnrqKeLfXaOdLevpRLDaEfQmQgWJU7Rh%2F%2BijPtEyfHahXHs%2FXfkOk1wMXdjcy%2B5VjRCYqyx%2BXl7WI8OMZTYGn3efxgkNDlrBiTIjSCzTSYypI06DFA1icWCw8SM0RXBOrmfg%2FIbExx3QnXiFYsE1E99AaEdUuAF%2F4b74Zkgp0rjTrcV0sRdM%3D&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20200508T215806Z&X-Amz-SignedHeaders=host&X-Amz-Expires=600&X-Amz-Credential=ASIAUIA5WTQCNKH5I6PM%2F20200508%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Signature=37b116dc8ed4761f391eda170fc986a056c916b48288771c355520936c51b570",
                    "attachmentType": {
                        "description": "Requester Document",
                        "dnbCode": 33762
                    },
                    "attachmentTimestamp": "2020-05-08T20:47:42.000+00:00",
                    "fileSize": "137086"
                }
            ]
        }
    ]
}

Sample Email

Research Submitted Email

Sample Research Submitted Email

Research Resolved Email

Sample Research Resolved Email

UTL Sample Research Details Response


{
	"transactionDetail": {
		"transactionID": "rrt-00bef85606189a3b7-c-ea-25240-34861380-1",
		"transactionTimestamp": "2024-02-22T20:13:42.843Z",
		"serviceVersion": "1"
	},
	"inquiryDetail": {
		"researchRequestID": 852116
	},
	"researchRequestID": 852116,
	"submissionTransactionID": "Test123",
	"submissionTimestamp": "2024-02-21T22:04:27.000+00:00",
	"userLoginKey": "a3c60502104b42c5963faa350b0a025cf022ba8712e64e3a8df8c7f4874f2314",
	"researchStatus": {
		"description": "Closed",
		"dnbCode": 33624
	},
	"statusTimestamp": "2024-02-22T13:46:57.000+00:00",
	"caseDetails": [
		{
			"caseID": 866613,
			"duns": null,
			"primaryName": "Test UTL",
			"primaryAddress": {
				"addressCountry": {
					"isoAlpha2Code": "US"
				},
				"addressLocality": {
					"name": "Test"
				},
				"addressRegion": {
					"name": "CA"
				},
				"addressCounty": {}
			},
			"caseStatus": {
				"description": "Closed",
				"dnbCode": 33624
			},
			"statusTimestamp": "2024-02-22T13:46:57.000+00:00",
			"subjectResearchTypes": [
				{
					"researchSubType": {
						"description": "Add business - Full Risk Review",
						"dnbCode": 33574
					},
					"researchType": {
						"description": "New D-U-N-S Number",
						"dnbCode": 33532
					},
					"subResolution": {
						"description": "Insufficient information provided",
						"dnbCode": 34325
					},
					"resolution": {
						"description": "D-U-N-S Number could not be created",
						"dnbCode": 34335
					},
					"isAddedByResearcher": null,
					"resolutionTimestamp": "2024-02-22T13:46:57.318+00:00"
				}
			],
			"inquiredOrganization": {
				"duns": null,
				"primaryName": "Test UTL",
				"countryISOAlpha2Code": "US",
				"primaryAddress": {
					"addressCountry": {
						"isoAlpha2Code": "US"
					},
					"addressLocality": {
						"name": "Test"
					},
					"addressRegion": {
						"name": "CA"
					},
					"addressCounty": {},
					"streetAddress": {
						"line1": "Test"
					}
				},
				"mailingAddress": {},
				"telephones": [],
				"registrationNumber": {},
				"tradeStyleName": null,
				"referenceContacts": [],
				"primaryIndustryCode": {},
				"activity": null,
				"url": null,
				"yearlyRevenue": {},
				"numberOfEmployees": {},
				"startYear": null,
				"controlOwnershipDate": null,
				"legalForm": null,
				"mostSeniorPrincipal": {},
				"isActiveBusiness": null,
				"acquirer": {},
				"owner": {},
				"childOrganizations": [],
				"shareOwnership": [],
				"principals": [],
				"relatedOrganizations": [],
				"duplicateDUNS": [],
				"requestorSubjectID": null
			},
			"researchResults": {
				"duns": null,
				"hasDUNSChanged": null,
				"primaryName": null,
				"countryISOAlpha2Code": null,
				"primaryAddress": {},
				"mailingAddress": {},
				"telephones": [],
				"registrationNumber": {},
				"tradeStyleName": null,
				"primaryIndustryCode": {},
				"url": null,
				"yearlyRevenue": {},
				"numberOfEmployees": {},
				"startYear": null,
				"controlOwnershipDate": null,
				"legalForm": null,
				"mostSeniorPrincipal": {},
				"isActiveBusiness": null,
				"dnbStandardRating": null,
				"acquirer": {
					"telephone": {}
				},
				"formerOwnerDUNS": null,
				"owner": {},
				"childOrganizations": [],
				"shareOwnership": [],
				"principals": [],
				"relatedOrganizations": [],
				"duplicateDUNS": []
			},
			"isChallengeable": true,
			"challenges": [],
			"caseHistory": [],
			"researchComments": [
				{
					"typeDnBCode": 33590,
					"typeDescription": "Resolution Comment",
					"comment": "Here is test UTL.  When a UTL is received, it will document the sources attempted to confirm the information on the business. As this time, we have insufficient information to create a DUNS."
				}
			],
			"attachments": []
		}
	]
}

SIR Sample Research Details Response


{
	"transactionDetail": {
		"transactionID": "rrt-06b4bcf2274d8cfab-b-ea-11639-37483715-1",
		"transactionTimestamp": "2024-02-22T20:23:35.755Z",
		"serviceVersion": "1"
	},
	"inquiryDetail": {
		"researchRequestID": 852117
	},
	"researchRequestID": 852117,
	"submissionTransactionID": "Test123",
	"submissionTimestamp": "2024-02-21T22:05:23.000+00:00",
	"userLoginKey": "a3c60502104b42c5963faa350b0a025cf022ba8712e64e3a8df8c7f4874f2314",
	"researchStatus": {
		"description": "Closed",
		"dnbCode": 33624
	},
	"statusTimestamp": "2024-02-22T13:45:46.000+00:00",
	"caseDetails": [
		{
			"caseID": 866614,
			"duns": "804735132",
			"primaryName": "GORMAN MANUFACTURING COMPANY, INC.",
			"primaryAddress": {
				"addressCountry": {
					"isoAlpha2Code": "US"
				},
				"addressLocality": {
					"name": "San Francisco"
				},
				"addressRegion": {
					"name": "CA"
				},
				"addressCounty": {}
			},
			"caseStatus": {
				"description": "Closed",
				"dnbCode": 33624
			},
			"statusTimestamp": "2024-02-22T13:45:46.000+00:00",
			"subjectResearchTypes": [
				{
					"researchSubType": {
						"description": "Add business - Full Risk Review",
						"dnbCode": 33574
					},
					"researchType": {
						"description": "New D-U-N-S Number",
						"dnbCode": 33532
					},
					"subResolution": {
						"description": "Match found in D&B database for the submitted business name and address",
						"dnbCode": 34486
					},
					"resolution": {
						"description": "D-U-N-S Number already exists",
						"dnbCode": 34322
					},
					"isAddedByResearcher": null,
					"resolutionTimestamp": "2024-02-22T13:45:46.515+00:00"
				}
			],
			"inquiredOrganization": {
				"duns": null,
				"primaryName": "Gorman (BIR+SIR Report) Testing",
				"countryISOAlpha2Code": "US",
				"primaryAddress": {
					"addressCountry": {
						"isoAlpha2Code": "US"
					},
					"addressLocality": {
						"name": "Test"
					},
					"addressRegion": {
						"name": "CA"
					},
					"addressCounty": {},
					"streetAddress": {
						"line1": "Test"
					}
				},
				"mailingAddress": {},
				"telephones": [],
				"registrationNumber": {},
				"tradeStyleName": null,
				"referenceContacts": [],
				"primaryIndustryCode": {},
				"activity": null,
				"url": null,
				"yearlyRevenue": {},
				"numberOfEmployees": {},
				"startYear": null,
				"controlOwnershipDate": null,
				"legalForm": null,
				"mostSeniorPrincipal": {},
				"isActiveBusiness": null,
				"acquirer": {},
				"owner": {},
				"childOrganizations": [],
				"shareOwnership": [],
				"principals": [],
				"relatedOrganizations": [],
				"duplicateDUNS": [],
				"requestorSubjectID": null
			},
			"researchResults": {
				"duns": "804735132",
				"hasDUNSChanged": null,
				"primaryName": "GORMAN MANUFACTURING COMPANY, INC.",
				"countryISOAlpha2Code": "US",
				"primaryAddress": {
					"addressCountry": {
						"isoAlpha2Code": "US"
					},
					"addressLocality": {
						"name": "San Francisco"
					},
					"addressRegion": {
						"name": "CA"
					},
					"addressCounty": {},
					"postalCode": "94110",
					"streetAddress": {
						"line1": "492 KOLLER ST"
					}
				},
				"mailingAddress": {},
				"telephones": [],
				"registrationNumber": {},
				"tradeStyleName": null,
				"primaryIndustryCode": {},
				"url": null,
				"yearlyRevenue": {},
				"numberOfEmployees": {},
				"startYear": null,
				"controlOwnershipDate": null,
				"legalForm": null,
				"mostSeniorPrincipal": {},
				"isActiveBusiness": null,
				"dnbStandardRating": null,
				"acquirer": {
					"telephone": {}
				},
				"formerOwnerDUNS": null,
				"owner": {},
				"childOrganizations": [],
				"shareOwnership": [],
				"principals": [],
				"relatedOrganizations": [],
				"duplicateDUNS": []
			},
			"isChallengeable": true,
			"challenges": [],
			"caseHistory": [],
			"researchComments": [
				{
					"typeDnBCode": 33590,
					"typeDescription": "Resolution Comment",
					"comment": "Please find the attached test SIR.  A match for the inquiry was found in the system.  As a part of the Single Inquiry Response, you will receive a copy and/or link to the current Business Information Report."
				}
			],
			"attachments": []
		}
	]
}

DNB Full Logo Direct+ Product Documentation