Search

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

Request

Note: This request contains all possible attributes for reference purposes. An actual search request would not contain this many request attributes. Search criteria parameters are used in AND mode so more parameters could reduce results to 0. If a DUNS is included, nothing else is necessary.

POST https://plus.dnb.com/v1/search/criteria
Authorization: Bearer 
Content-Type: application/json

{
  "duns": "804735132",
  "dunsList": ["804735132"],
  "isMarketable": true,
  "isOutOfBusiness": false,
  "isTelephoneDisconnected": false,
  "isMailUndeliverable": false,
  "searchTerm": "Manufactring",
  "primaryName": "Gorman",
  "tradeStyleName": "Gorman",
  "countryISOAlpha2Code": "CA",
  "addressRegion": "new jersey",
  "addressLocality": "San Francisco",
  "streetAddressLine1": "492 Koller St",
  "postalCode": "94110",
  "locationRadius": {
    "lat": 37.777709,
    "lon":-122.404624,
    "radius": 5,
    "unit": "km"
  },
  "telephoneNumber": "6505550000",
  "domain": "gorman.com",
  "registrationNumbers": [
    "22-3725387"
  ],
  "numberOfEmployees": {
    "informationScope": 9067,
    "maximumValue": 5000,
    "minimumValue": 2500
  },
  "businessEntityType": [
    451
  ],
  "tickerSymbol": "DNB",
  "yearlyRevenue": {
    "maximumValue": 50000000000000,
    "minimumValue": 1000000
  },
  "familytreeRolesPlayed": [
    12774,
    12275
  ],
  "isStandalone" :false,
  "isImporter":true,
  "isExporter" :true,
  "globalUltimateFamilyTreeMembersCount": {
    "maximumValue": 500,
    "minimumValue": 100
  },
  "usSicV4": [
    "2752"
  ],
  "industryCodes":[  
    {  
      "typeDnbCode":30832,
      "description":[  
         "Printing",
         "lithographic"
      ]
    },
    {  
      "typeDnbCode":24664,
      "code":[  
         "32311",
         "323113"
      ]
    },
      {  
      "typeDnbCode":3599,
      "code":[  
         "27520000"
      ]
    },
      {  
      "typeDnbCode":19295,
      "description":[  
          "Commercial"  ]
    },
     {  
      "typeDnbCode":25838,
      "description":[  
          "Printing"  ]
    }
  ],
  "pageNumber": 1,
  "pageSize": 70,
  "returnNavigators": true
}

Response

{
    "transactionDetail": {
        "transactionID": "rrt-0dae58047eafe4568-d-ea-28580-280151297-49",
        "transactionTimestamp": "2019-09-18T16:22:32.079Z",
        "inLanguage": "en-US",
        "serviceVersion": "1"
    },
    "inquiryDetail": {
        "isExporter": true,
        "telephoneNumber": "6505550000",
        "pageNumber": 1,
        "yearlyRevenue": {
            "maximumValue": 50000000000000,
            "minimumValue": 1000000
        },
        "postalCode": "94110",
        "dunsList": [
            "804735132"
        ],
        "pageSize": 70,
        "industryCodes": [
            {
                "typeDnbCode": 30832,
                "description": [
                    "Printing",
                    "lithographic"
                ]
            },
            {
                "typeDnbCode": 24664,
                "code": [
                    "32311",
                    "323113"
                ]
            },
            {
                "typeDnbCode": 3599,
                "code": [
                    "27520000"
                ]
            },
            {
                "typeDnbCode": 19295,
                "description": [
                    "Commercial"
                ]
            },
            {
                "typeDnbCode": 25838,
                "description": [
                    "Printing"
                ]
            }
        ],
        "countryISOAlpha2Code": "CA",
        "searchTerm": "Manufactring",
        "returnNavigators": true,
        "usSicV4": [
            "2752"
        ],
        "isOutOfBusiness": false,
        "isImporter": true,
        "isStandalone": false,
        "isTelephoneDisconnected": false,
        "tradeStyleName": "Gorman",
        "familytreeRolesPlayed": [
            12774,
            12275
        ],
        "addressLocality": "San Francisco",
        "addressRegion": "new jersey",
        "isMailUndeliverable": false,
        "isMarketable": true,
        "businessEntityType": [
            451
        ],
        "primaryName": "Gorman",
        "registrationNumbers": [
            "22-3725387"
        ],
        "tickerSymbol": "DNB",
        "sort": [
            {
                "item": "yearlyRevenue",
                "direction": "descending"
            },
            {
                "item": "numberOfEmployees",
                "direction": "descending"
            },
            {
                "item": "isBranch",
                "direction": "ascending"
            },
            {
                "item": "countryISOAlpha2Code",
                "direction": "ascending"
            },
            {
                "item": "primaryName",
                "direction": "ascending"
            },
            {
                "item": "duns",
                "direction": "ascending"
            }
        ],
        "streetAddressLine1": "492 Koller St",
        "numberOfEmployees": {
            "informationScope": 9067,
            "maximumValue": 5000,
            "minimumValue": 2500
        },
        "locationRadius": {
            "lat": 37.777709,
            "lon": -122.404624,
            "radius": 5,
            "unit": "km"
        },
        "globalUltimateFamilyTreeMembersCount": {
            "maximumValue": 500,
            "minimumValue": 100
        },
        "domain": "gorman.com"
    },
      "candidatesReturnedQuantity": 1,
      "candidatesMatchedQuantity": 1,
      "searchCandidates": [
          {
              "displaySequence": 1,
              "organization": {
                  "duns": "804735132",
                  "dunsControlStatus": {
                      "isOutOfBusiness": false,
                      "isMarketable": false,
                      "isTelephoneDisconnected": false,
                      "isMailUndeliverable": false,
                      "isDelisted": true
                  },
                  "primaryName": "Gorman Manufacturing Company, Inc.",
                  "primaryAddress": {
                      "addressCountry": {
                          "isoAlpha2Code": "US"
                      },
                      "addressLocality": {
                          "name": "San Francisco"
                      },
                      "addressRegion": {
                          "name": "California",
                          "abbreviatedName": "CA"
                      },
                      "postalCode": "94110",
                      "streetAddress": {
                          "line1": "492 Koller St"
                      },
                      "latitude": 37.777709,
                      "longitude": -122.404624,
                      "isManufacturingLocation": true
                  },
                  "primaryIndustryCodes": [
                      {
                          "usSicV4": "2752",
                          "usSicV4Description": "Lithographic commercial printing"
                      }
                  ],
                  "corporateLinkage": {
                      "isBranch": false,
                      "familytreeRolesPlayed": [
                          {
                              "description": "Global Ultimate",
                              "dnbCode": 12775
                          },
                          {
                              "description": "Domestic Ultimate",
                              "dnbCode": 12774
                          },
                          {
                              "description": "Parent/Headquarters",
                              "dnbCode": 9141
                          }
                      ],
                      "globalUltimateFamilyTreeMembersCount": 7,
                      "globalUltimate": {
                          "duns": "804735132",
                          "primaryName": "Gorman Manufacturing Company, Inc."
                      }
                  },
                  "financials": [
                      {
                          "yearlyRevenue": [
                              {
                                  "value": 22589957,
                                  "currency": "USD"
                              }
                          ]
                      }
                  ],
                  "numberOfEmployees": [
                      {
                          "value": 120,
                          "informationScopeDescription": "Headquarters Only (Employs Here)",
                          "informationScopeDnBCode": 9068,
                          "reliabilityDescription": "Actual",
                          "reliabilityDnBCode": 9092
                      },
                      {
                          "value": 153,
                          "informationScopeDescription": "Consolidated",
                          "informationScopeDnBCode": 9067,
                          "reliabilityDescription": "Actual",
                          "reliabilityDnBCode": 9092
                      }
                  ],
                  "industryCodes": [
                      {
                          "code": "323111",
                          "description": "Commercial Printing (except Screen and Books)",
                          "typeDescription": "North American Industry Classification System 2017",
                          "typeDnbCode": 30832,
                          "priority": 1
                      },
                      {
                          "code": "1068",
                          "description": "Commercial Printing",
                          "typeDescription": "D&B Hoovers Industry Code",
                          "typeDnbCode": 25838,
                          "priority": 1
                      },
                      {
                          "code": "27520000",
                          "description": "Commercial printing, lithographic",
                          "typeDescription": "D&B Standard Industry Code",
                          "typeDnbCode": 3599,
                          "priority": 1
                      }
                  ],
                  "telephone": [
                      {
                          "telephoneNumber": "6505550000",
                          "isdCode": "1"
                      }
                  ],
                  "businessEntityType": {
                      "dnbCode": 451,
                      "description": "Corporation"
                  },
                  "isStandalone": false
              }
          }
      ],
      "navigators": {
          "yearlyRevenue": [
              {
                  "candidatesMatchedQuantity": 0,
                  "query": {
                      "yearlyRevenue": {
                          "minimumValue": 0,
                          "maximumValue": 1000000
                      }
                  }
              },
              {
                  "candidatesMatchedQuantity": 0,
                  "query": {
                      "yearlyRevenue": {
                          "minimumValue": 1000001,
                          "maximumValue": 5000000
                      }
                  }
              },
              {
                  "candidatesMatchedQuantity": 0,
                  "query": {
                      "yearlyRevenue": {
                          "minimumValue": 5000001,
                          "maximumValue": 10000000
                      }
                  }
              },
              {
                  "candidatesMatchedQuantity": 1,
                  "query": {
                      "yearlyRevenue": {
                          "minimumValue": 10000001,
                          "maximumValue": 50000000
                      }
                  }
              },
              {
                  "candidatesMatchedQuantity": 0,
                  "query": {
                      "yearlyRevenue": {
                          "minimumValue": 50000001,
                          "maximumValue": 500000000
                      }
                  }
              },
              {
                  "candidatesMatchedQuantity": 0,
                  "query": {
                      "yearlyRevenue": {
                          "minimumValue": 500000001,
                          "maximumValue": 1000000000
                      }
                  }
              },
              {
                  "candidatesMatchedQuantity": 0,
                  "query": {
                      "yearlyRevenue": {
                          "minimumValue": 1000000001,
                          "maximumValue": 10000000000
                      }
                  }
              },
              {
                  "candidatesMatchedQuantity": 0,
                  "query": {
                      "yearlyRevenue": {
                          "minimumValue": 10000000001
                      }
                  }
              }
          ],
          "numberOfEmployees": [
              {
                  "candidatesMatchedQuantity": 0,
                  "query": {
                      "numberOfEmployees": {
                          "informationScope": 9067,
                          "minimumValue": 0,
                          "maximumValue": 5
                      }
                  }
              },
              {
                  "candidatesMatchedQuantity": 0,
                  "query": {
                      "numberOfEmployees": {
                          "informationScope": 9067,
                          "minimumValue": 6,
                          "maximumValue": 10
                      }
                  }
              },
              {
                  "candidatesMatchedQuantity": 0,
                  "query": {
                      "numberOfEmployees": {
                          "informationScope": 9067,
                          "minimumValue": 11,
                          "maximumValue": 50
                      }
                  }
              },
              {
                  "candidatesMatchedQuantity": 0,
                  "query": {
                      "numberOfEmployees": {
                          "informationScope": 9067,
                          "minimumValue": 51,
                          "maximumValue": 100
                      }
                  }
              },
              {
                  "candidatesMatchedQuantity": 1,
                  "query": {
                      "numberOfEmployees": {
                          "informationScope": 9067,
                          "minimumValue": 101,
                          "maximumValue": 500
                      }
                  }
              },
              {
                  "candidatesMatchedQuantity": 0,
                  "query": {
                      "numberOfEmployees": {
                          "informationScope": 9067,
                          "minimumValue": 501,
                          "maximumValue": 1000
                      }
                  }
              },
              {
                  "candidatesMatchedQuantity": 0,
                  "query": {
                      "numberOfEmployees": {
                          "informationScope": 9067,
                          "minimumValue": 1001,
                          "maximumValue": 5000
                      }
                  }
              },
              {
                  "candidatesMatchedQuantity": 0,
                  "query": {
                      "numberOfEmployees": {
                          "informationScope": 9067,
                          "minimumValue": 5001
                      }
                  }
              }
          ],
          "industry": [
              {
                  "candidatesMatchedQuantity": 1,
                  "query": {
                      "usSicV4": [
                          "2752"
                      ]
                  },
                  "description": "Lithographic commercial printing"
              }
          ],
          "businessEntityType": [
              {
                  "candidatesMatchedQuantity": 1,
                  "query": {
                      "businessEntityType": [
                          451
                      ]
                  },
                  "description": "Corporation"
              }
          ],
          "familyTreeRole": [
              {
                  "candidatesMatchedQuantity": 1,
                  "query": {
                      "familytreeRolesPlayed": [
                          9141
                      ]
                  },
                  "description": "Parent/Headquarters"
              },
              {
                  "candidatesMatchedQuantity": 1,
                  "query": {
                      "familytreeRolesPlayed": [
                          12774
                      ]
                  },
                  "description": "Domestic Ultimate"
              },
              {
                  "candidatesMatchedQuantity": 1,
                  "query": {
                      "familytreeRolesPlayed": [
                          12775
                      ]
                  },
                  "description": "Global Ultimate"
              }
          ],
          "location": {
              "country": [
                  {
                      "candidatesMatchedQuantity": 1,
                      "region": [
                          {
                              "candidatesMatchedQuantity": 1,
                              "query": {
                                  "addressRegion": "california"
                              },
                              "locality": [
                                  {
                                      "candidatesMatchedQuantity": 1,
                                      "query": {
                                          "addressLocality": "san francisco"
                                      }
                                  }
                              ]
                          }
                      ],
                      "query": {
                          "countryISOAlpha2Code": "us"
                      },
                      "name": "United States"
                  }
              ]
          }
      }
}

Request

GET https://plus.dnb.com/v1/search/typeahead?searchTerm=Gor&countryISOAlpha2Code=US
Authorization: Bearer 

Response

{
  "transactionDetail": {
      "transactionID": "rrt-051d25cbd8f15f5a9-b-ea-20648-54309783-3",
      "transactionTimestamp": "2018-02-28T17:11:06.454Z",
      "inLanguage": "en-US",
      "serviceVersion": "1"
  },
  "inquiryDetail": {
      "countryISOAlpha2Code": "US",
      "searchTerm": "Gor"
  },
  "candidatesReturnedQuantity": 2,
  "candidatesMatchedQuantity": 23
  "searchCandidates": [
      {
          "displaySequence": 1,
          "organization": {
              "duns": "123456789",
              "dunsControlStatus": {
                  "isOutOfBusiness": false
              },
              "primaryName": "Gorman Industries",
              "primaryAddress": {
                  "addressCountry": {
                      "isoAlpha2Code": "US"
                  },
                  "streetAddress": {
                      "line1": "555 SW 5TH ST"
                  },
                  "addressLocality": {
                      "name": "BENTONVILLE"
                  },
                  "addressRegion": {
                      "name": "Arkansas"
                  }
              },
              "corporateLinkage": {
                  "isBranch": false
              },
              "financials": [
                  {
                      "yearlyRevenue": [
                          {
                              "value": 485873000000,
                              "currency": "USD"
                          }
                      ]
                  }
              ],
              "tradeStyleNames": [
                  {
                      "name": "GORMAN",
                      "priority": 1
                  }
                  {
                      "name": "GORMAN Co.",
                      "priority": 2
                  }
              ],
              "primaryIndustryCodes": [
                  {
                      "usSicV4": "5311",
                      "usSicV4Description": "Department store"
                  }
              ]
          }
      }
              {
          "displaySequence": 2,
          "organization": {
              "duns": "023456789",
              "dunsControlStatus": {
                  "isOutOfBusiness": false
              },
              "primaryName": "Gordon Stores East, LP",
              "primaryAddress": {
                  "addressCountry": {
                      "isoAlpha2Code": "US"
                  },
                  "streetAddress": {
                      "line1": "123 SW 4TH ST"
                  },
                  "addressLocality": {
                      "name": "BENTONVILLE"
                  },
                  "addressRegion": {
                      "name": "Arkansas"
                  }
              },
              "corporateLinkage": {
                  "isBranch": false
              },
              "financials": [
                  {
                      "yearlyRevenue": [
                          {
                              "value": 436383000000,
                              "currency": "USD"
                          }
                      ]
                  }
              ],
              "tradeStyleNames": [
                  {
                      "name": "GORDON",
                      "priority": 1
                  }
                  {
                      "name": "GORDON INC",
                      "priority": 2
                  }
              ],
              "primaryIndustryCodes": [
                  {
                      "usSicV4": "5311",
                      "usSicV4Description": "Department store"
                  }
              ]
          }
      }
   }
}

Request

Note: This request contains all possible attributes for reference purposes. An actual search request would not contain this many request attributes. Search criteria parameters are used in AND mode so more parameters could reduce results to 0. If a DUNS is included, nothing else is necessary.

POST https://plus.dnb.com/v1/search/companyList
Authorization: Bearer 
Content-Type: application/json

{
  "duns": "804735132",
  "dunsList": ["804735132"],
  "isMarketable": true,
  "isOutOfBusiness": false,
  "isTelephoneDisconnected": false,
  "isMailUndeliverable": false,
  "searchTerm": "Manufactring",
  "primaryName": "Gorman",
  "tradeStyleName": "Gorman",
  "countryISOAlpha2Code": "CA",
  "addressRegion": "new jersey",
  "addressLocality": "San Francisco",
  "streetAddressLine1": "492 Koller St",
  "postalCode": "94110",
  "locationRadius": {
    "lat": 37.777709,
    "lon":-122.404624,
    "radius": 5,
    "unit": "km"
  },
  "telephoneNumber": "6505550000",
  "domain": "gorman.com",
  "registrationNumbers": [
    "22-3725387"
  ],
  "numberOfEmployees": {
    "informationScope": 9067,
    "maximumValue": 5000,
    "minimumValue": 2500
  },
  "businessEntityType": [
    451
  ],
  "tickerSymbol": "DNB",
  "yearlyRevenue": {
    "maximumValue": 50000000000000,
    "minimumValue": 1000000
  },
  "familytreeRolesPlayed": [
    12774,
    12275
  ],
  "isStandalone" :false,
  "isImporter":true,
  "isExporter" :true,
  "globalUltimateFamilyTreeMembersCount": {
    "maximumValue": 500,
    "minimumValue": 100
  },
  "usSicV4": [
    "2752"
  ],
  "industryCodes":[  
    {  
      "typeDnbCode":30832,
      "description":[  
         "Printing",
         "lithographic"
      ]
    },
    {  
      "typeDnbCode":24664,
      "code":[  
         "32311",
         "323113"
      ]
    },
      {  
      "typeDnbCode":3599,
      "code":[  
         "27520000"
      ]
    },
      {  
      "typeDnbCode":19295,
      "description":[  
          "Commercial"  ]
    },
     {  
      "typeDnbCode":25838,
      "description":[  
          "Printing"  ]
    }
  ],
  "pageNumber": 1,
  "pageSize": 10000,
  "returnNavigators": true
}

Response

{
    "transactionDetail": {
        "transactionID": "rrt-0dae58047eafe4568-d-ea-28580-280151297-49",
        "transactionTimestamp": "2019-09-18T16:22:32.079Z",
        "inLanguage": "en-US",
        "serviceVersion": "1"
    },
    "inquiryDetail": {
        "isExporter": true,
        "telephoneNumber": "6505550000",
        "pageNumber": 1,
        "yearlyRevenue": {
            "maximumValue": 50000000000000,
            "minimumValue": 1000000
        },
        "postalCode": "94110",
        "dunsList": [
            "804735132"
        ],
        "pageSize": 10000,
        "industryCodes": [
            {
                "typeDnbCode": 30832,
                "description": [
                    "Printing",
                    "lithographic"
                ]
            },
            {
                "typeDnbCode": 24664,
                "code": [
                    "32311",
                    "323113"
                ]
            },
            {
                "typeDnbCode": 3599,
                "code": [
                    "27520000"
                ]
            },
            {
                "typeDnbCode": 19295,
                "description": [
                    "Commercial"
                ]
            },
            {
                "typeDnbCode": 25838,
                "description": [
                    "Printing"
                ]
            }
        ],
        "countryISOAlpha2Code": "CA",
        "searchTerm": "Manufactring",
        "returnNavigators": true,
        "usSicV4": [
            "2752"
        ],
        "isOutOfBusiness": false,
        "isImporter": true,
        "isStandalone": false,
        "isTelephoneDisconnected": false,
        "tradeStyleName": "Gorman",
        "familytreeRolesPlayed": [
            12774,
            12275
        ],
        "addressLocality": "San Francisco",
        "addressRegion": "new jersey",
        "isMailUndeliverable": false,
        "isMarketable": true,
        "businessEntityType": [
            451
        ],
        "primaryName": "Gorman",
        "registrationNumbers": [
            "22-3725387"
        ],
        "tickerSymbol": "DNB",
        "sort": [
            {
                "item": "yearlyRevenue",
                "direction": "descending"
            },
            {
                "item": "numberOfEmployees",
                "direction": "descending"
            },
            {
                "item": "isBranch",
                "direction": "ascending"
            },
            {
                "item": "countryISOAlpha2Code",
                "direction": "ascending"
            },
            {
                "item": "primaryName",
                "direction": "ascending"
            },
            {
                "item": "duns",
                "direction": "ascending"
            }
        ],
        "streetAddressLine1": "492 Koller St",
        "numberOfEmployees": {
            "informationScope": 9067,
            "maximumValue": 5000,
            "minimumValue": 2500
        },
        "locationRadius": {
            "lat": 37.777709,
            "lon": -122.404624,
            "radius": 5,
            "unit": "km"
        },
        "globalUltimateFamilyTreeMembersCount": {
            "maximumValue": 500,
            "minimumValue": 100
        },
        "domain": "gorman.com"
    },
      "candidatesReturnedQuantity": 1,
      "candidatesMatchedQuantity": 1,
      "searchCandidates": [
          {
              "displaySequence": 1,
              "organization": {
                  "duns": "804735132",
                  "dunsControlStatus": {
                      "isOutOfBusiness": false,
                      "isMarketable": false,
                      "isTelephoneDisconnected": false,
                      "isMailUndeliverable": false,
                      "isDelisted": true
                  },
                  "primaryName": "Gorman Manufacturing Company, Inc.",
                  "primaryAddress": {
                      "addressCountry": {
                          "isoAlpha2Code": "US"
                      },
                      "addressLocality": {
                          "name": "San Francisco"
                      },
                      "addressRegion": {
                          "name": "California",
                          "abbreviatedName": "CA"
                      },
                      "postalCode": "94110",
                      "streetAddress": {
                          "line1": "492 Koller St"
                      },
                      "latitude": 37.777709,
                      "longitude": -122.404624,
                      "isManufacturingLocation": true
                  },
                  "primaryIndustryCodes": [
                      {
                          "usSicV4": "2752",
                          "usSicV4Description": "Lithographic commercial printing"
                      }
                  ],
                  "corporateLinkage": {
                      "isBranch": false,
                      "familytreeRolesPlayed": [
                          {
                              "description": "Global Ultimate",
                              "dnbCode": 12775
                          },
                          {
                              "description": "Domestic Ultimate",
                              "dnbCode": 12774
                          },
                          {
                              "description": "Parent/Headquarters",
                              "dnbCode": 9141
                          }
                      ],
                      "globalUltimateFamilyTreeMembersCount": 7,
                      "globalUltimate": {
                          "duns": "804735132",
                          "primaryName": "Gorman Manufacturing Company, Inc."
                      }
                  },
                  "financials": [
                      {
                          "yearlyRevenue": [
                              {
                                  "value": 22589957,
                                  "currency": "USD"
                              }
                          ]
                      }
                  ],
                  "numberOfEmployees": [
                      {
                          "value": 120,
                          "informationScopeDescription": "Headquarters Only (Employs Here)",
                          "informationScopeDnBCode": 9068,
                          "reliabilityDescription": "Actual",
                          "reliabilityDnBCode": 9092
                      },
                      {
                          "value": 153,
                          "informationScopeDescription": "Consolidated",
                          "informationScopeDnBCode": 9067,
                          "reliabilityDescription": "Actual",
                          "reliabilityDnBCode": 9092
                      }
                  ],
                  "industryCodes": [
                      {
                          "code": "323111",
                          "description": "Commercial Printing (except Screen and Books)",
                          "typeDescription": "North American Industry Classification System 2017",
                          "typeDnbCode": 30832,
                          "priority": 1
                      },
                      {
                          "code": "1068",
                          "description": "Commercial Printing",
                          "typeDescription": "D&B Hoovers Industry Code",
                          "typeDnbCode": 25838,
                          "priority": 1
                      },
                      {
                          "code": "27520000",
                          "description": "Commercial printing, lithographic",
                          "typeDescription": "D&B Standard Industry Code",
                          "typeDnbCode": 3599,
                          "priority": 1
                      }
                  ],
                  "telephone": [
                      {
                          "telephoneNumber": "6505550000",
                          "isdCode": "1"
                      }
                  ],
                  "businessEntityType": {
                      "dnbCode": 451,
                      "description": "Corporation"
                  },
                  "isStandalone": false
              }
          }
      ],
      "navigators": {
          "yearlyRevenue": [
              {
                  "candidatesMatchedQuantity": 0,
                  "query": {
                      "yearlyRevenue": {
                          "minimumValue": 0,
                          "maximumValue": 1000000
                      }
                  }
              },
              {
                  "candidatesMatchedQuantity": 0,
                  "query": {
                      "yearlyRevenue": {
                          "minimumValue": 1000001,
                          "maximumValue": 5000000
                      }
                  }
              },
              {
                  "candidatesMatchedQuantity": 0,
                  "query": {
                      "yearlyRevenue": {
                          "minimumValue": 5000001,
                          "maximumValue": 10000000
                      }
                  }
              },
              {
                  "candidatesMatchedQuantity": 1,
                  "query": {
                      "yearlyRevenue": {
                          "minimumValue": 10000001,
                          "maximumValue": 50000000
                      }
                  }
              },
              {
                  "candidatesMatchedQuantity": 0,
                  "query": {
                      "yearlyRevenue": {
                          "minimumValue": 50000001,
                          "maximumValue": 500000000
                      }
                  }
              },
              {
                  "candidatesMatchedQuantity": 0,
                  "query": {
                      "yearlyRevenue": {
                          "minimumValue": 500000001,
                          "maximumValue": 1000000000
                      }
                  }
              },
              {
                  "candidatesMatchedQuantity": 0,
                  "query": {
                      "yearlyRevenue": {
                          "minimumValue": 1000000001,
                          "maximumValue": 10000000000
                      }
                  }
              },
              {
                  "candidatesMatchedQuantity": 0,
                  "query": {
                      "yearlyRevenue": {
                          "minimumValue": 10000000001
                      }
                  }
              }
          ],
          "numberOfEmployees": [
              {
                  "candidatesMatchedQuantity": 0,
                  "query": {
                      "numberOfEmployees": {
                          "informationScope": 9067,
                          "minimumValue": 0,
                          "maximumValue": 5
                      }
                  }
              },
              {
                  "candidatesMatchedQuantity": 0,
                  "query": {
                      "numberOfEmployees": {
                          "informationScope": 9067,
                          "minimumValue": 6,
                          "maximumValue": 10
                      }
                  }
              },
              {
                  "candidatesMatchedQuantity": 0,
                  "query": {
                      "numberOfEmployees": {
                          "informationScope": 9067,
                          "minimumValue": 11,
                          "maximumValue": 50
                      }
                  }
              },
              {
                  "candidatesMatchedQuantity": 0,
                  "query": {
                      "numberOfEmployees": {
                          "informationScope": 9067,
                          "minimumValue": 51,
                          "maximumValue": 100
                      }
                  }
              },
              {
                  "candidatesMatchedQuantity": 1,
                  "query": {
                      "numberOfEmployees": {
                          "informationScope": 9067,
                          "minimumValue": 101,
                          "maximumValue": 500
                      }
                  }
              },
              {
                  "candidatesMatchedQuantity": 0,
                  "query": {
                      "numberOfEmployees": {
                          "informationScope": 9067,
                          "minimumValue": 501,
                          "maximumValue": 1000
                      }
                  }
              },
              {
                  "candidatesMatchedQuantity": 0,
                  "query": {
                      "numberOfEmployees": {
                          "informationScope": 9067,
                          "minimumValue": 1001,
                          "maximumValue": 5000
                      }
                  }
              },
              {
                  "candidatesMatchedQuantity": 0,
                  "query": {
                      "numberOfEmployees": {
                          "informationScope": 9067,
                          "minimumValue": 5001
                      }
                  }
              }
          ],
          "industry": [
              {
                  "candidatesMatchedQuantity": 1,
                  "query": {
                      "usSicV4": [
                          "2752"
                      ]
                  },
                  "description": "Lithographic commercial printing"
              }
          ],
          "businessEntityType": [
              {
                  "candidatesMatchedQuantity": 1,
                  "query": {
                      "businessEntityType": [
                          451
                      ]
                  },
                  "description": "Corporation"
              }
          ],
          "familyTreeRole": [
              {
                  "candidatesMatchedQuantity": 1,
                  "query": {
                      "familytreeRolesPlayed": [
                          9141
                      ]
                  },
                  "description": "Parent/Headquarters"
              },
              {
                  "candidatesMatchedQuantity": 1,
                  "query": {
                      "familytreeRolesPlayed": [
                          12774
                      ]
                  },
                  "description": "Domestic Ultimate"
              },
              {
                  "candidatesMatchedQuantity": 1,
                  "query": {
                      "familytreeRolesPlayed": [
                          12775
                      ]
                  },
                  "description": "Global Ultimate"
              }
          ],
          "location": {
              "country": [
                  {
                      "candidatesMatchedQuantity": 1,
                      "region": [
                          {
                              "candidatesMatchedQuantity": 1,
                              "query": {
                                  "addressRegion": "california"
                              },
                              "locality": [
                                  {
                                      "candidatesMatchedQuantity": 1,
                                      "query": {
                                          "addressLocality": "san francisco"
                                      }
                                  }
                              ]
                          }
                      ],
                      "query": {
                          "countryISOAlpha2Code": "us"
                      },
                      "name": "United States"
                  }
              ]
          }
      }
}

GET Request

GET https://plus.dnb.com/v1/search/contact?contactEmail=joe.bloggs@company.com
Authorization: Bearer 

Single Contact Response

{  
   "transactionDetail":{  
      "transactionID":"rrt-0d967d55c779a8af6-c-ea-32522-52508585-19",
      "transactionTimestamp":"2018-04-17T15:19:37.827Z",
      "inLanguage":"en-US",
      "serviceVersion":"1"
   },
   "inquiryDetail":{  
      "contactEmail":"joe.bloggs@company.com"
   },
   "candidatesReturnedQuantity":1,
   "candidatesMatchedQuantity":1,
   "searchCandidates":[  
      {  
         "displaySequence":1,
         "contact":{  
            "id":"00012345678",
            "email":"joe.bloggs@company.com",
            "emailDomainName":"company.com",
            "emailAccuracy":{  
               "deliverabilityScore":93,
               "verifiedDate":"2017-11-19"
            },
            "givenName":"Joe",
            "middleName":"Andrew",
            "familyName":"Bloggs",
            "namePrefix":"Dr.",
            "nameSuffix":"PhD.",
            "additionalName":"Joe",
            "titleAccuracy":{  
               "accuracyScore":50
            },
            "isTitleMatched":true,
            "organization":{  
               "duns":"123456789",
               "primaryIndustryCodes":[  
                  {  
                     "usSicV4":"3261",
                     "usSicV4Description":"Mfg vitreous plumbing fixtures"
                  }
               ],
               "dunsControlStatus":{  
                  "operatingStatus":{  
                     "description":"Active",
                     "dnbCode":9074
                  },
                  "isMarketable":false
               },
               "primaryAddress":{  
                  "addressRegion":{  
                     "name":"New Jersey",
                     "abbreviatedName":"NJ"
                  },
                  "addressLocality":{  
                     "name":"PISCATAWAY"
                  },
                  "addressCountry":{  
                     "isoAlpha2Code":"US"
                  },
                  "postalCode":"088543921"
               },
               "primaryName":"Company, Inc."
            },
            "industryCodes":[  
               {  
                  "code":"561450",
                  "description":"Credit Bureaus",
                  "typeDescription":"North American Industry Classification System 2017",
                  "typeDnbCode":30832,
                  "priority":1
               },
               {  
                  "code":"1714",
                  "description":"Credit Bureaus",
                  "typeDescription":"North American Industry Classification System 2012",
                  "typeDnbCode":24664,
                  "priority":1
               }
            ],
            "telephone":[  
               {  
                  "telephoneNumber":"(123) 456-7890",
                  "telephoneAccuracy":{  
                     "accuracyScore":0
                  }
               }
            ],
            "socialMedia":[  
               {  
                  "platform":{  
                     "description":"Twitter",
                     "dnbCode":1234
                  },
                  "url":"http://socialmedia.com"
               }
            ],
            "isSocialVerified":true,
            "jobTitles":[  
               {  
                  "title":"Sales Operations Manager - NE"
               }
            ],
            "vanityTitles":[  
               {  
                  "title":"Sales Operations Manager NE"
               }
            ],
            "managementResponsibilities":[  
               {  
                  "mrcCode":"Z799"
               }
            ],
            "dataFreshnessScore":75,
            "confidenceLevel":"41",
            "verifiedDate":"2018-02-03",
            "matchQualityInformation":{  
               "confidenceCode":10,
               "matchGrade":"AAAAAZBAFFA",
               "matchDataProfile":5
            }
         }
      }
   ],
   "links":{  
      "last":"https://plus.dnb.com/v1/search/contact?contactEmail=joe.bloggs%40company.com&page%5Bnumber%5D=1&page%5Bsize%5D=10",
      "self":"https://plus.dnb.com/v1/search/contact?contactEmail=joe.bloggs%40company.com&page%5Bnumber%5D=1&page%5Bsize%5D=10",
      "first":"https://plus.dnb.com/v1/search/contact?contactEmail=joe.bloggs%40company.com&page%5Bnumber%5D=1&page%5Bsize%5D=10"
   }
}

POST Request, all parameters

POST https://plus.dnb.com/v1/search/contact
Authorization: Bearer 
Content-Type: application/json

{
  "contactID": "000321976318",
  "contactEmail": "joe.bloggs@company.com",
  "givenName": "Joseph",
  "familyName": "Bloggs",
  "jobTitles": ["Sales Operations Manager", "Manager"],
  "duns": "965582781",
  "primaryName": "company",
  "addressLocality": "PISCATAWAY",
  "addressRegion": "NJ",
  "postalCode": "088543921",
  "countryISOAlpha2Code": "US",
  "usSicV4": ["3261","6719"],
  "mrcCode": ["A125"],
  "view":"standard",
  "industryCodes":[  
    {  
      "typeDnbCode":30832,
      "description":[  
         "Credit Bureaus",
         "Collection Agencies",
         "Reporting"
      ]
    },
    {  
      "typeDnbCode":24664,
      "code":[  
         "1714",
         "1713"
      ]
    }
  ],
  "returnNavigators": true,
  "pageNumber": 50,
  "pageSize": 2,
  "sort":[
    { "item": "searchCandidates.contact.organization.primaryAddress.country.isoAlpha2Code", "direction": "ascending" },
    { "item": "searchCandidates.contact.organization.primaryIndustryCodes.usSicV4", "direction": "descending" },
    { "item": "searchCandidates.contact.organization.duns", "direction": "ascending" },
    { "item": "searchCandidates.contact.familyName", "direction": "ascending" }
  ]
}

Multiple Contacts Response

{  
   "transactionDetail":{  
      "transactionID":"rrt-035920aa6349fa187-b-ea-3699-24471342-2",
      "transactionTimestamp":"2017-10-06T14:51:06.601Z",
      "inLanguage":"en-US",
      "serviceVersion":"1"
   },
   "inquiryDetail":{  
      "pageNumber":50,
      "contactID":"000321976318",
      "contactEmail":"joe.bloggs@company.com",
      "givenName":"Joseph",
      "postalCode":"088543921",
      "jobTitles":[  
         "Sales Operations Manager",
         "Manager"
      ],
      "pageSize":2,
      "primaryName":"company",
      "sort":[  
         {  
            "item":"searchCandidates.contact.organization.primaryAddress.country.isoAlpha2Code",
            "direction":"ascending"
         },
         {  
            "item":"searchCandidates.contact.organization.primaryIndustryCodes.usSicV4",
            "direction":"descending"
         },
         {  
            "item":"searchCandidates.contact.organization.duns",
            "direction":"ascending"
         },
         {  
            "item":"searchCandidates.contact.familyName",
            "direction":"ascending"
         }
      ],
      "countryISOAlpha2Code":"US",
      "returnNavigators":true,
      "usSicV4":[  
         "3261",
         "6719"
      ],
      "industryCodes":[  
         {  
            "typeDnbCode":30832,
            "description":[  
               "Credit Bureaus",
               "Collection Agencies",
               "Reporting"
            ]
         },
         {  
            "typeDnbCode":24664,
            "code":[  
               "1714",
               "1713"
            ]
         }
      ],
      "familyName":"Bloggs",
      "duns":"965582781",
      "addressLocality":"PISCATAWAY",
      "addressRegion":"NJ"
   },
   "candidatesReturnedQuantity":2,
   "candidatesMatchedQuantity":2,
   "searchCandidates":[  
      {  
         "displaySequence":1,
         "contact":{  
            "id":"00012345678",
            "email":"joe.bloggs@company.com",
            "emailDomainName":"company.com",
            "emailAccuracy":{  
               "deliverabilityScore":93,
               "verifiedDate":"2017-11-19"
            },
            "givenName":"Joe",
            "middleName":"Andrew",
            "familyName":"Bloggs",
            "namePrefix":"Dr.",
            "nameSuffix":"PhD.",
            "additionalName":"Joe",
            "titleAccuracy":{  
               "accuracyScore":50
            },
            "isTitleMatched":true,
            "organization":{  
               "duns":"123456789",
               "primaryIndustryCodes":[  
                  {  
                     "usSicV4":"3261",
                     "usSicV4Description":"Mfg vitreous plumbing fixtures"
                  }
               ],
               "dunsControlStatus":{  
                  "operatingStatus":{  
                     "description":"Active",
                     "dnbCode":9074
                  },
                  "isMarketable":false
               },
               "primaryAddress":{  
                  "addressRegion":{  
                     "name":"New Jersey",
                     "abbreviatedName":"NJ"
                  },
                  "addressLocality":{  
                     "name":"PISCATAWAY"
                  },
                  "addressCountry":{  
                     "isoAlpha2Code":"US"
                  },
                  "postalCode":"088543921"
               },
               "primaryName":"Company, Inc."
            },
            "industryCodes":[  
               {  
                  "code":"561450",
                  "description":"Credit Bureaus",
                  "typeDescription":"North American Industry Classification System 2017",
                  "typeDnbCode":30832,
                  "priority":1
               },
               {  
                  "code":"1714",
                  "description":"Credit Bureaus",
                  "typeDescription":"North American Industry Classification System 2012",
                  "typeDnbCode":24664,
                  "priority":1
               }
            ],
            "telephone":[  
               {  
                  "telephoneNumber":"987-654-3210",
                  "telephoneAccuracy":{  
                     "accuracyScore":0
                  }
               }
            ],
            "socialMedia":[  
               {  
                  "platform":{  
                     "description":"Twitter",
                     "dnbCode":1234
                  },
                  "url":"http://socialmedia.com"
               }
            ],
            "isSocialVerified":true,
            "jobTitles":[  
               {  
                  "title":"Sales Operations Manager - NE"
               }
            ],
            "vanityTitles":[  
               {  
                  "title":"Sales Operations Manager NE"
               }
            ],
            "managementResponsibilities":[  
               {  
                  "mrcCode":"Z799"
               }
            ],
            "dataFreshnessScore":75,
            "confidenceLevel":"41",
            "verifiedDate":"2018-02-03",
            "matchQualityInformation":{  
               "confidenceCode":10,
               "matchGrade":"AAAAAZBAFFA",
               "matchDataProfile":5
            }
         }
      },
      {  
         "displaySequence":2,
         "contact":{  
            "id":"00012345679",
            "email":"joe.bloggs@company.com",
            "emailDomainName":"company.com",
            "emailAccuracy":{  
               "deliverabilityScore":70,
               "verifiedDate":"2016-10-17"
            },
            "givenName":"Joe",
            "middleName":"Andrew",
            "familyName":"Bloggs",
            "namePrefix":"Dr.",
            "nameSuffix":"PhD.",
            "additionalName":"Joe",
            "titleAccuracy":{  
               "accuracyScore":50
            },
            "isTitleMatched":true,
            "organization":{  
               "duns":"123456789",
               "primaryIndustryCodes":[  
                  {  
                     "usSicV4":"6719",
                     "usSicV4Description":"Holding company"
                  }
               ],
               "primaryAddress":{  
                  "addressRegion":{  
                     "name":"New Jersey",
                     "abbreviatedName":"NJ"
                  },
                  "addressLocality":{  
                     "name":"PISCATAWAY"
                  },
                  "addressCountry":{  
                     "isoAlpha2Code":"US"
                  },
                  "postalCode":"088543921"
               },
               "primaryName":"Company Corp."
            },
            "industryCodes":[  
               {  
                  "code":"561450",
                  "description":"Credit Bureaus",
                  "typeDescription":"North American Industry Classification System 2017",
                  "typeDnbCode":30832,
                  "priority":1
               },
               {  
                  "code":"1714",
                  "description":"Credit Bureaus",
                  "typeDescription":"North American Industry Classification System 2012",
                  "typeDnbCode":24664,
                  "priority":1
               }
            ],
            "telephone":[  
               {  
                  "telephoneNumber":"123-456-7890",
                  "telephoneAccuracy":{  
                     "accuracyScore":4
                  }
               }
            ],
            "socialMedia":[  
               {  
                  "platform":{  
                     "description":"Twitter",
                     "dnbCode":1234
                  },
                  "url":"http://socialmedia.com"
               }
            ],
            "isSocialVerified":true,
            "jobTitles":[  
               {  
                  "title":"Sales Operations Manager"
               }
            ],
            "vanityTitles":[  
               {  
                  "title":"Sales Operations Manager"
               }
            ],
            "managementResponsibilities":[  
               {  
                  "mrcCode":"I7P1"
               }
            ],
            "dataFreshnessScore":75,
            "confidenceLevel":"100",
            "verifiedDate":"2016-10-29",
            "matchQualityInformation":{  
               "confidenceCode":8,
               "matchGrade":"AAAAAZAAFBF",
               "matchDataProfile":0
            }
         }
      }
   ],
   "navigators":{  
      "managementResponsibilities":[  
         {  
            "candidatesMatchedQuantity":35,
            "query":{  
               "mrcCode":[  
                  "Z799"
               ]
            }
         },
         {  
            "candidatesMatchedQuantity":27,
            "query":{  
               "mrcCode":[  
                  "Z699"
               ]
            }
         },
         {  
            "candidatesMatchedQuantity":22,
            "query":{  
               "mrcCode":[  
                  "A5D8"
               ]
            }
         }
      ],
      "location":{  
         "country":[  
            {  
               "candidatesMatchedQuantity":323,
               "region":[  
                  {  
                     "candidatesMatchedQuantity":323,
                     "query":{  
                        "addressRegion":"new jersey"
                     },
                     "locality":[  
                        {  
                           "candidatesMatchedQuantity":323,
                           "query":{  
                              "addressLocality":"piscataway"
                           }
                        }
                     ]
                  }
               ],
               "query":{  
                  "countryISOAlpha2Code":"us"
               }
            }
         ]
      }
   }
}

Contact Search Premium

POST Request, all parameters

POST https://plus.dnb.com/v1/search/contact
Authorization: Bearer 
Content-Type: application/json

{
  "contactID": "000321976318",
  "contactEmail": "joe.bloggs@company.com",
   "searchTerm": "Tracey",
  "givenName": "Joseph",
  "familyName": "Bloggs",
  "jobTitles": ["Sales Operations Manager", "Manager"],
  "duns": "965582781",
  "primaryName": "company",
  "addressLocality": "PISCATAWAY",
  "addressRegion": "NJ",
  "postalCode": "088543921",
  "countryISOAlpha2Code": "US",
  "usSicV4": ["3261","6719"],
  "mrcCode": ["A125"],
  "industryCodes":[  
    {  
      "typeDnbCode":30832,
      "description":[  
         "Credit Bureaus",
         "Collection Agencies",
         "Reporting"
      ]
    },
    {  
      "typeDnbCode":24664,
      "code":[  
         "1714",
         "1713"
      ]
    }
  ],
  "returnNavigators": true,
  "view":"premium",
  "pageNumber": 50,
  "pageSize": 2,
  "sort":[
    { "item": "searchCandidates.contact.organization.primaryAddress.country.isoAlpha2Code", "direction": "ascending" },
    { "item": "searchCandidates.contact.organization.primaryIndustryCodes.usSicV4", "direction": "descending" },
    { "item": "searchCandidates.contact.organization.duns", "direction": "ascending" },
    { "item": "searchCandidates.contact.familyName", "direction": "ascending" }
  ]
}

Single Contact Response

{  
   "transactionDetail":{  
      "transactionID":"rrt-0d967d55c779a8af6-c-ea-32522-52508585-19",
      "transactionTimestamp":"2018-04-17T15:19:37.827Z",
      "inLanguage":"en-US",
      "serviceVersion":"1"
   },
   "inquiryDetail":{  
     "contactEmail":"joe.bloggs@company.com",
     "searchTerm": "Tracey",
     "view":"premium",
   },
   "candidatesReturnedQuantity":1,
   "candidatesMatchedQuantity":1,
   "searchCandidates":[  
      {  
         "displaySequence":1,
         "contact":{  
            "id":"00012345678",
            "email":"joe.bloggs@company.com",
            "emailDomainName":"company.com",
            "emailAccuracy":{  
               "deliverabilityScore":93,
               "verifiedDate":"2017-11-19"
            },
            "givenName":"Joe",
            "middleName":"Andrew",
            "familyName":"Bloggs",
            "namePrefix":"Dr.",
            "nameSuffix":"PhD.",
            "additionalName":"Joe",
            "titleAccuracy":{  
               "accuracyScore":50
            },
            "isTitleMatched":true,
            "organization":{  
               "duns":"123456789",
               "primaryIndustryCodes":[  
                  {  
                     "usSicV4":"3261",
                     "usSicV4Description":"Mfg vitreous plumbing fixtures"
                  }
               ],
               "dunsControlStatus":{  
                  "operatingStatus":{  
                     "description":"Active",
                     "dnbCode":9074
                  },
                  "isMarketable":false
               },
               "primaryAddress":{  
                  "addressRegion":{  
                     "name":"New Jersey",
                     "abbreviatedName":"NJ"
                  },
                  "addressLocality":{  
                     "name":"PISCATAWAY"
                  },
                  "addressCountry":{  
                     "isoAlpha2Code":"US"
                  },
                  "postalCode":"088543921"
               },
               "primaryName":"Company, Inc."
            },
            "industryCodes":[  
               {  
                  "code":"561450",
                  "description":"Credit Bureaus",
                  "typeDescription":"North American Industry Classification System 2017",
                  "typeDnbCode":30832,
                  "priority":1
               },
               {  
                  "code":"1714",
                  "description":"Credit Bureaus",
                  "typeDescription":"North American Industry Classification System 2012",
                  "typeDnbCode":24664,
                  "priority":1
               }
            ],
            "telephone":[  
               {  
                  "telephoneNumber":"(123) 456-7890",
                  "telephoneAccuracy":{  
                     "accuracyScore":0
                  }
               }
            ],
            "socialMedia":[  
               {  
                  "platform":{  
                     "description":"Twitter",
                     "dnbCode":1234
                  },
                  "url":"http://socialmedia.com"
               }
            ],
            "isSocialVerified":true,
            "jobTitles":[  
               {  
                  "title":"Sales Operations Manager - NE"
               }
            ],
            "vanityTitles":[  
               {  
                  "title":"Sales Operations Manager NE"
               }
            ],
            "managementResponsibilities":[  
               {  
                  "mrcCode":"Z799"
               }
            ],
            "dataFreshnessScore":75,
            "confidenceLevel":"41",
            "verifiedDate":"2018-02-03",
            "matchQualityInformation":{  
               "confidenceCode":10,
               "matchGrade":"AAAAAZBAFFA",
               "matchDataProfile":5
            },
            "compensation":{
            	"fiscalYear":"12months",
            	"currency":"USD",
            	"totalCompensation":135089,
            	"salary":95000,
            	"bonus":12000,
            	"otherAnnualCompensation":10000,
            	"restrictedStockAward":2399,
            	"ltipAward":15868,
            	"optionAward":1575,
            	"nonEquityIncentiveAward":1000,
            	"changeInPensionValue":16455,
            	"otherCompensation":850,
            	"maximumPerformanceSharePotential":123,
            	"securityUnderlyingOptions":2000
            }
         }
      }
   ],
   "links":{  
      "last":"https://plus.dnb.com/v1/search/contact?contactEmail=joe.bloggs%40company.com&page%5Bnumber%5D=1&page%5Bsize%5D=10",
      "self":"https://plus.dnb.com/v1/search/contact?contactEmail=joe.bloggs%40company.com&page%5Bnumber%5D=1&page%5Bsize%5D=10",
      "first":"https://plus.dnb.com/v1/search/contact?contactEmail=joe.bloggs%40company.com&page%5Bnumber%5D=1&page%5Bsize%5D=10"
   }
}

Contact Search: Duns (GET)

Request

GET https://plus.dnb.com/v1/search/contact?duns=804735132&searchType=duns&page[size]=20&page[number]=2
Authorization: Bearer 
Content-Type: application/json

Response


{
    "transactionDetail": {
        "transactionID": "rrt-055a5bf443c47c387-d-ea-12436-94993037-1",
        "transactionTimestamp": "2020-03-31T13:14:28.928Z",
        "inLanguage": "en-US",
        "serviceVersion": "1"
    },
    "inquiryDetail": {
        "page[number]": 2,
        "duns": "804735132",
        "page[size]": 20
    },
    "candidatesReturnedQuantity": 20,
    "candidatesMatchedQuantity": 41,
    "searchCandidates": [
        {
            "displaySequence": 1,
            "contact": {
                "id": "000376583423",
                "givenName": "John",
                "familyName": "Bean",
                "namePrefix": "Mr",
                "additionalName": "Johnny",
                "titleAccuracy": {
                    "accuracyScore": 28
                },
                "organization": {
                    "duns": "804735132"
                },
                "jobTitles": [
                    {
                        "title": "Global Sales Manager"
                    }
                ],
                "vanityTitles": [
                    {
                        "title": "Global Sales Manager"
                    }
                ],
                "managementResponsibilities": [
                    {
                        "mrcCode": "Z799"
                    }
                ],
                "dataFreshnessScore": 14,
                "confidenceLevel": "90",
                "verifiedDate": "2018-04-26"
            }
        },
        {
            "displaySequence": 2,
            "contact": {
                "id": "000512773576",
                "givenName": "John",
                "familyName": "Winchester",
                "namePrefix": "Mr.",
                "additionalName": "Johnny",
                "titleAccuracy": {
                    "accuracyScore": 58
                },
                "organization": {
                    "duns": "804735132"
                },
                "jobTitles": [
                    {
                        "title": "Data Analyst"
                    }
                ],
                "vanityTitles": [
                    {
                        "title": "Data Analyst"
                    }
                ],
                "managementResponsibilities": [
                    {
                        "mrcCode": "E9FZ"
                    }
                ],
                "dataFreshnessScore": 16,
                "confidenceLevel": "4",
                "verifiedDate": "2018-08-06",
                "matchQualityInformation": {
                    "confidenceCode": 10,
                    "matchGrade": "AZAAZZAAFFA",
                    "matchDataProfile": 0
                }
            }
        },
        {
            "displaySequence": 3,
            "contact": {
                "id": "000512040507",
                "givenName": "Josh",
                "familyName": "Wallingford",
                "namePrefix": "Mr.",
                "titleAccuracy": {
                    "accuracyScore": 78
                },
                "organization": {
                    "duns": "804735132"
                },
                "isSocialVerified": true,
                "jobTitles": [
                    {
                        "title": "Support Analyst"
                    }
                ],
                "vanityTitles": [
                    {
                        "title": "Support Analyst"
                    }
                ],
                "dataFreshnessScore": 18,
                "confidenceLevel": "50",
                "verifiedDate": "2019-07-07",
                "matchQualityInformation": {
                    "confidenceCode": 10,
                    "matchGrade": "AZAAZZAAFFA",
                    "matchDataProfile": 0
                }
            }
        },
        {
            "displaySequence": 4,
            "contact": {
                "id": "000389813257",
                "givenName": "Kate",
                "familyName": "Bougas",
                "namePrefix": "Ms.",
                "additionalName": "Katie",
                "titleAccuracy": {
                    "accuracyScore": 0
                },
                "organization": {
                    "duns": "804735132"
                },
                "isSocialVerified": true,
                "jobTitles": [
                    {
                        "title": "Tem Business Analyst"
                    }
                ],
                "vanityTitles": [
                    {
                        "title": "Tem Business Analyst"
                    }
                ],
                "managementResponsibilities": [
                    {
                        "mrcCode": "C9B5"
                    }
                ],
                "dataFreshnessScore": 18,
                "confidenceLevel": "32",
                "verifiedDate": "2019-03-29",
                "matchQualityInformation": {
                    "confidenceCode": 10,
                    "matchGrade": "AZAAZZAAFFZ",
                    "matchDataProfile": 2
                }
            }
        },
        {
            "displaySequence": 5,
            "contact": {
                "id": "000512859739",
                "givenName": "Lavinia",
                "familyName": "Copper",
                "namePrefix": "Ms.",
                "titleAccuracy": {
                    "accuracyScore": 78
                },
                "organization": {
                    "duns": "804735132"
                },
                "isSocialVerified": true,
                "jobTitles": [
                    {
                        "title": "Tem Analyst"
                    }
                ],
                "vanityTitles": [
                    {
                        "title": "Tem Analyst"
                    }
                ],
                "managementResponsibilities": [
                    {
                        "mrcCode": "E9FZ"
                    }
                ],
                "dataFreshnessScore": 18,
                "confidenceLevel": "50",
                "verifiedDate": "2019-07-07",
                "matchQualityInformation": {
                    "confidenceCode": 10,
                    "matchGrade": "AZAAZZAAFFA",
                    "matchDataProfile": 0
                }
            }
        },
        {
            "displaySequence": 6,
            "contact": {
                "id": "000356046524",
                "givenName": "Lisa",
                "familyName": "Barton",
                "namePrefix": "Ms.",
                "additionalName": "Liz",
                "titleAccuracy": {
                    "accuracyScore": 74
                },
                "organization": {
                    "duns": "804735132"
                },
                "isSocialVerified": true,
                "jobTitles": [
                    {
                        "title": "Hr Administrator"
                    }
                ],
                "vanityTitles": [
                    {
                        "title": "Hr Administrator"
                    }
                ],
                "managementResponsibilities": [
                    {
                        "mrcCode": "F9B1"
                    }
                ],
                "dataFreshnessScore": 14,
                "confidenceLevel": "4",
                "verifiedDate": "2018-08-06",
                "matchQualityInformation": {
                    "confidenceCode": 10,
                    "matchGrade": "AZAAZZAAFFZ",
                    "matchDataProfile": 2
                }
            }
        },
        {
            "displaySequence": 7,
            "contact": {
                "id": "000512727822",
                "givenName": "Manjit",
                "familyName": "Birak",
                "namePrefix": "Ms.",
                "titleAccuracy": {
                    "accuracyScore": 78
                },
                "organization": {
                    "duns": "804735132"
                },
                "isSocialVerified": true,
                "jobTitles": [
                    {
                        "title": "Tem Analyst"
                    }
                ],
                "vanityTitles": [
                    {
                        "title": "Tem Analyst"
                    }
                ],
                "managementResponsibilities": [
                    {
                        "mrcCode": "E9FZ"
                    }
                ],
                "dataFreshnessScore": 18,
                "confidenceLevel": "32",
                "verifiedDate": "2019-03-29",
                "matchQualityInformation": {
                    "confidenceCode": 10,
                    "matchGrade": "AZAAZZAAFFA",
                    "matchDataProfile": 0
                }
            }
        },
        {
            "displaySequence": 8,
            "contact": {
                "id": "000436626177",
                "givenName": "Mark",
                "familyName": "Bellingham",
                "namePrefix": "Mr.",
                "titleAccuracy": {
                    "accuracyScore": 76
                },
                "organization": {
                    "duns": "804735132"
                },
                "isSocialVerified": true,
                "jobTitles": [
                    {
                        "title": "Professional Services Director"
                    }
                ],
                "vanityTitles": [
                    {
                        "title": "Professional Services Director"
                    }
                ],
                "managementResponsibilities": [
                    {
                        "mrcCode": "Z699"
                    }
                ],
                "dataFreshnessScore": 16,
                "confidenceLevel": "50",
                "verifiedDate": "2019-07-07",
                "matchQualityInformation": {
                    "confidenceCode": 9,
                    "matchGrade": "AZAAZZZAFFA",
                    "matchDataProfile": 0
                }
            }
        },
        {
            "displaySequence": 9,
            "contact": {
                "id": "000348121310",
                "givenName": "Mark",
                "familyName": "Simmonds",
                "namePrefix": "Mr.",
                "titleAccuracy": {
                    "accuracyScore": 0
                },
                "organization": {
                    "duns": "804735132"
                },
                "isSocialVerified": true,
                "jobTitles": [
                    {
                        "title": "Vp Research & Development"
                    }
                ],
                "vanityTitles": [
                    {
                        "title": "Vp Research and Development"
                    }
                ],
                "managementResponsibilities": [
                    {
                        "mrcCode": "A5D8"
                    }
                ],
                "dataFreshnessScore": 16,
                "confidenceLevel": "50",
                "verifiedDate": "2019-07-07",
                "matchQualityInformation": {
                    "confidenceCode": 10,
                    "matchGrade": "AZAAZZAAFFZ",
                    "matchDataProfile": 2
                }
            }
        },
        {
            "displaySequence": 10,
            "contact": {
                "id": "000526536284",
                "givenName": "Michael",
                "familyName": "Anderson",
                "namePrefix": "Mr.",
                "additionalName": "Mike",
                "titleAccuracy": {
                    "accuracyScore": 24
                },
                "organization": {
                    "duns": "804735132"
                },
                "isSocialVerified": true,
                "jobTitles": [
                    {
                        "title": "Senior Business Analyst, Team Lead"
                    }
                ],
                "vanityTitles": [
                    {
                        "title": "Senior Business Analyst, Team Lead"
                    }
                ],
                "dataFreshnessScore": 14,
                "confidenceLevel": "50",
                "verifiedDate": "2019-07-07",
                "matchQualityInformation": {
                    "confidenceCode": 9,
                    "matchGrade": "AZAAZZFAFFA",
                    "matchDataProfile": 0
                }
            }
        },
        {
            "displaySequence": 11,
            "contact": {
                "id": "000512699207",
                "givenName": "Neal",
                "familyName": "Carter",
                "namePrefix": "Mr.",
                "titleAccuracy": {
                    "accuracyScore": 74
                },
                "organization": {
                    "duns": "804735132"
                },
                "isSocialVerified": true,
                "jobTitles": [
                    {
                        "title": "Development Manager"
                    }
                ],
                "vanityTitles": [
                    {
                        "title": "Development Manager"
                    }
                ],
                "managementResponsibilities": [
                    {
                        "mrcCode": "D7EZ"
                    }
                ],
                "dataFreshnessScore": 14,
                "confidenceLevel": "50",
                "verifiedDate": "2019-07-07",
                "matchQualityInformation": {
                    "confidenceCode": 10,
                    "matchGrade": "AZAAZZAAFFA",
                    "matchDataProfile": 0
                }
            }
        },
        {
            "displaySequence": 12,
            "contact": {
                "id": "000656211684",
                "givenName": "Nick",
                "familyName": "Kennett",
                "namePrefix": "Mr.",
                "additionalName": "Nicholas",
                "titleAccuracy": {
                    "accuracyScore": 56
                },
                "organization": {
                    "duns": "804735132"
                },
                "jobTitles": [
                    {
                        "title": "Senior Business Analyst"
                    }
                ],
                "vanityTitles": [
                    {
                        "title": "Senior Business Analyst"
                    }
                ],
                "managementResponsibilities": [
                    {
                        "mrcCode": "X1Z8"
                    }
                ],
                "dataFreshnessScore": 16,
                "confidenceLevel": "52",
                "verifiedDate": "2019-05-16",
                "matchQualityInformation": {
                    "confidenceCode": 10,
                    "matchGrade": "AZAAZZAAFFA",
                    "matchDataProfile": 0
                }
            }
        },
        {
            "displaySequence": 13,
            "contact": {
                "id": "000389813255",
                "givenName": "Paule",
                "familyName": "Landi",
                "namePrefix": "Ms.",
                "titleAccuracy": {
                    "accuracyScore": 72
                },
                "organization": {
                    "duns": "804735132"
                },
                "jobTitles": [
                    {
                        "title": "Senior Consultant"
                    }
                ],
                "vanityTitles": [
                    {
                        "title": "Senior Consultant"
                    }
                ],
                "managementResponsibilities": [
                    {
                        "mrcCode": "X8X9"
                    }
                ],
                "dataFreshnessScore": 24,
                "confidenceLevel": "41",
                "verifiedDate": "2018-11-02",
                "matchQualityInformation": {
                    "confidenceCode": 10,
                    "matchGrade": "AZAAZZAAFFZ",
                    "matchDataProfile": 2
                }
            }
        },
        {
            "displaySequence": 14,
            "contact": {
                "id": "000512854707",
                "givenName": "Pavan",
                "familyName": "Sangha",
                "namePrefix": "Mr.",
                "titleAccuracy": {
                    "accuracyScore": 70
                },
                "organization": {
                    "duns": "804735132"
                },
                "jobTitles": [
                    {
                        "title": "Invoice Analyst"
                    }
                ],
                "vanityTitles": [
                    {
                        "title": "Invoice Analyst"
                    }
                ],
                "managementResponsibilities": [
                    {
                        "mrcCode": "E9FZ"
                    }
                ],
                "dataFreshnessScore": 22,
                "confidenceLevel": "34",
                "verifiedDate": "2018-11-02",
                "matchQualityInformation": {
                    "confidenceCode": 10,
                    "matchGrade": "AZAAZZAAFFA",
                    "matchDataProfile": 0
                }
            }
        },
        {
            "displaySequence": 15,
            "contact": {
                "id": "000512952265",
                "givenName": "Richard",
                "familyName": "Flisik",
                "namePrefix": "Mr.",
                "additionalName": "Rich",
                "titleAccuracy": {
                    "accuracyScore": 80
                },
                "organization": {
                    "duns": "804735132"
                },
                "isSocialVerified": true,
                "jobTitles": [
                    {
                        "title": "Analyst"
                    }
                ],
                "vanityTitles": [
                    {
                        "title": "Analyst"
                    }
                ],
                "managementResponsibilities": [
                    {
                        "mrcCode": "E9FZ"
                    }
                ],
                "dataFreshnessScore": 20,
                "confidenceLevel": "38",
                "verifiedDate": "2019-05-17",
                "matchQualityInformation": {
                    "confidenceCode": 10,
                    "matchGrade": "AZAAZZAAFFA",
                    "matchDataProfile": 0
                }
            }
        },
        {
            "displaySequence": 16,
            "contact": {
                "id": "000512770317",
                "givenName": "Robert",
                "familyName": "Noble",
                "namePrefix": "Mr.",
                "additionalName": "Rob",
                "titleAccuracy": {
                    "accuracyScore": 78
                },
                "organization": {
                    "duns": "804735132"
                },
                "isSocialVerified": true,
                "jobTitles": [
                    {
                        "title": "New Business Manager"
                    }
                ],
                "vanityTitles": [
                    {
                        "title": "New Business Manager"
                    }
                ],
                "managementResponsibilities": [
                    {
                        "mrcCode": "E7K4"
                    }
                ],
                "dataFreshnessScore": 18,
                "confidenceLevel": "50",
                "verifiedDate": "2019-07-07",
                "matchQualityInformation": {
                    "confidenceCode": 10,
                    "matchGrade": "AZAAZZAAFFA",
                    "matchDataProfile": 0
                }
            }
        },
        {
            "displaySequence": 17,
            "contact": {
                "id": "000512492210",
                "givenName": "Robin",
                "familyName": "Cook",
                "namePrefix": "Ms.",
                "additionalName": "Rob",
                "titleAccuracy": {
                    "accuracyScore": 74
                },
                "organization": {
                    "duns": "804735132"
                },
                "isSocialVerified": true,
                "jobTitles": [
                    {
                        "title": "Infrastructure Engineer"
                    }
                ],
                "vanityTitles": [
                    {
                        "title": "Infrastructure Engineer"
                    }
                ],
                "managementResponsibilities": [
                    {
                        "mrcCode": "D9FA"
                    }
                ],
                "dataFreshnessScore": 14,
                "confidenceLevel": "58",
                "verifiedDate": "2019-03-29",
                "matchQualityInformation": {
                    "confidenceCode": 10,
                    "matchGrade": "AZAAZZAAFFA",
                    "matchDataProfile": 0
                }
            }
        },
        {
            "displaySequence": 18,
            "contact": {
                "id": "000512323087",
                "givenName": "Sam",
                "familyName": "Rushton",
                "namePrefix": "Mr.",
                "additionalName": "Samuel",
                "titleAccuracy": {
                    "accuracyScore": 24
                },
                "organization": {
                    "duns": "804735132"
                },
                "isSocialVerified": true,
                "jobTitles": [
                    {
                        "title": "Senior Business Analyst / Product Specialist"
                    }
                ],
                "vanityTitles": [
                    {
                        "title": "Senior Business Analyst Product Specialist"
                    }
                ],
                "dataFreshnessScore": 14,
                "confidenceLevel": "4",
                "verifiedDate": "2018-08-06",
                "matchQualityInformation": {
                    "confidenceCode": 10,
                    "matchGrade": "AZAAZZAAFFA",
                    "matchDataProfile": 0
                }
            }
        },
        {
            "displaySequence": 19,
            "contact": {
                "id": "000512473423",
                "givenName": "Sean",
                "familyName": "Brierley",
                "namePrefix": "Mr.",
                "titleAccuracy": {
                    "accuracyScore": 76
                },
                "organization": {
                    "duns": "804735132"
                },
                "isSocialVerified": true,
                "jobTitles": [
                    {
                        "title": "Workflow Business Analyst"
                    }
                ],
                "vanityTitles": [
                    {
                        "title": "Workflow Business Analyst"
                    }
                ],
                "managementResponsibilities": [
                    {
                        "mrcCode": "C9B5"
                    }
                ],
                "dataFreshnessScore": 16,
                "confidenceLevel": "4",
                "verifiedDate": "2018-08-06",
                "matchQualityInformation": {
                    "confidenceCode": 10,
                    "matchGrade": "AZAAZZAAFFA",
                    "matchDataProfile": 0
                }
            }
        },
        {
            "displaySequence": 20,
            "contact": {
                "id": "000125038197",
                "givenName": "Stephen",
                "familyName": "Smith",
                "namePrefix": "Mr.",
                "additionalName": "Steve",
                "titleAccuracy": {
                    "accuracyScore": 74
                },
                "organization": {
                    "duns": "804735132"
                },
                "isSocialVerified": true,
                "jobTitles": [
                    {
                        "title": "Global Risk And Security Manager (Interim It Ops Manager)"
                    }
                ],
                "vanityTitles": [
                    {
                        "title": "Global Risk And Security Manager (Interim It Ops Manager)"
                    }
                ],
                "managementResponsibilities": [
                    {
                        "mrcCode": "Z799"
                    }
                ],
                "dataFreshnessScore": 14,
                "confidenceLevel": "50",
                "verifiedDate": "2019-07-07",
                "matchQualityInformation": {
                    "confidenceCode": 10,
                    "matchGrade": "AZAAZZAAFFZ",
                    "matchDataProfile": 2
                }
            }
        }
    ],
    "links": {
        "next": "https://tst.plus.dnb.com/v1/search/contact?duns=804735132&searchType=duns&page%5Bnumber%5D=3&page%5Bsize%5D=20",
        "last": "https://tst.plus.dnb.com/v1/search/contact?duns=804735132&searchType=duns&page%5Bnumber%5D=3&page%5Bsize%5D=20",
        "prev": "https://tst.plus.dnb.com/v1/search/contact?duns=804735132&searchType=duns&page%5Bnumber%5D=1&page%5Bsize%5D=20",
        "self": "https://tst.plus.dnb.com/v1/search/contact?duns=804735132&searchType=duns&page%5Bnumber%5D=2&page%5Bsize%5D=20",
        "first": "https://tst.plus.dnb.com/v1/search/contact?duns=804735132&searchType=duns&page%5Bnumber%5D=1&page%5Bsize%5D=20"
    }
}

Contact Search: ContactID/Email (GET)

GET Request

GET https://plus.dnb.com/v1/search/contact?contactEmail=joe.bloggs@company.com
Authorization: Bearer 

Request

GET https://plus.dnb.com/v1/search/competitors?duns=804735132&maxResults=10&customerReference=customer%20reference%20text
Authorization: Bearer 

Response

{
    "transactionDetail": {
        "transactionID": "rrt-06b7e098ce92aec40-c-ea-4777-72391145-6",
        "transactionTimestamp": "2018-11-26T19:53:32.469Z",
        "inLanguage": "en-US",
        "serviceVersion": "1"
    },
    "inquiryDetail": {
        "duns": "804735132",
        "maxResults": "10",
        "customerReference": "BILLING CUSTOMER"
    },
    "candidatesReturnedQuantity": 5,
    "competitors": [
        {
           "duns": "884114609",
            "primaryName": "The Dun & Bradstreet Corporation",
            "isTopCompetitor": true,
            "primaryAddress": {
                "addressCountry": {
                    "isoAlpha2Code": "US",
                    "name": "United States"
                },
                "addressLocality": {
                    "name": "Short Hills"
                }
            },
            "consolidatedEmployeeCount": 20000,
            "salesRevenue": 36765478000,
            "issuedShareCapitalAmount": 100000,
            "corporateLinkage": {
                "globalUltimate": {
                    "duns": "884114609"
                }
            }
        },
        {
            "duns": "087654321",
            "primaryName": "Dun Corporation",
            "isTopCompetitor": true,
            "primaryAddress": {
                "addressCountry": {
                    "isoAlpha2Code": "US",
                    "name": "United States"
                },
                "addressLocality": {
                    "name": "SEATTLE"
                },
                "addressRegion": {
                    "name": "Washington",
                    "abbreviatedName": "WA"
                }
            },
            "consolidatedEmployeeCount": 135000,
            "salesRevenue": 110360000000,
            "issuedShareCapitalAmount": 862357.41,
            "corporateLinkage": {
                "globalUltimate": {
                    "duns": "087654321"
                }
            }
        },
        {
            "duns": "07987654",
            "primaryName": "ENTERPRISE COMPANY",
            "isTopCompetitor": true,
            "primaryAddress": {
                "addressCountry": {
                    "isoAlpha2Code": "US",
                    "name": "United States"
                },
                "addressLocality": {
                    "name": "PALO ALTO"
                },
                "addressRegion": {
                    "name": "California",
                    "abbreviatedName": "CA"
                }
            },
            "consolidatedEmployeeCount": 66000,
            "salesRevenue": 28871000000,
            "issuedShareCapitalAmount": 25025.7753,
            "corporateLinkage": {
                "globalUltimate": {
                    "duns": "07987654"
                }
            }
        },
        {
            "duns": "123456789",
            "primaryName": "R&R COMPANY,LTD.",
            "isTopCompetitor": false,
            "primaryAddress": {
                "addressCountry": {
                    "isoAlpha2Code": "JP",
                    "name": "Japan"
                },
                "addressLocality": {
                    "name": "OTA-KU"
                },
                "addressRegion": {
                    "name": "TOKYO",
                    "abbreviatedName": "TKY"
                }
            },
            "consolidatedEmployeeCount": 105613,
            "salesRevenue": 19366725118,
            "issuedShareCapitalAmount": 7409.4475,
            "corporateLinkage": {
                "globalUltimate": {
                    "duns": "123456789"
                }
            }
        },
        {
            "duns": "543219876",
            "primaryName": "Technology Corporation",
            "isTopCompetitor": false,
            "primaryAddress": {
                "addressCountry": {
                    "isoAlpha2Code": "US",
                    "name": "United States"
                },
                "addressLocality": {
                    "name": "TEANECK"
                },
                "addressRegion": {
                    "name": "New Jersey",
                    "abbreviatedName": "NJ"
                }
            },
            "consolidatedEmployeeCount": 80,
            "salesRevenue": 14810000000,
            "issuedShareCapitalAmount": 45952.0586,
            "corporateLinkage": {
                "globalUltimate": {
                    "duns": "543219876"
                }
            }
        }
    ]
}