Identity Resolution

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

Identity Resolution

Match & Append

Match & Append (Data Blocks)

Identity Resolution

Request: DUNS

GET https://plus.dnb.com/v1/match/cleanseMatch?duns=457413500
Authorization: Bearer yourToken

Request: Registration Number

GET https://plus.dnb.com/v1/match/cleanseMatch?countryISOAlpha2Code=BR&registrationNumberType=1340&registrationNumber=11514917000120
Authorization: Bearer yourToken 

Request: Name & Address

GET https://plus.dnb.com/v1/match/cleanseMatch?name=Gorman Manufacturing&streetAddressLine1=492 KOLLER STREET&countryISOAlpha2Code=US&addressLocality=SAN FRANCISCO&addressRegion=CA
Authorization: Bearer yourToken

Request: Name

GET https://plus.dnb.com/v1/match/cleanseMatch?name=Gorman Manufacturing&countryISOAlpha2Code=US
Authorization: Bearer yourToken

Request: Address

GET https://plus.dnb.com/v1/match/cleanseMatch?streetAddressLine1=103 JFK Parkway&countryISOAlpha2Code=US&addressLocality=Short Hills&addressRegion=NJ
Authorization: Bearer yourToken

Request: Postal Code

GET https://plus.dnb.com/v1/match/cleanseMatch?countryISOAlpha2Code=GB&postalCode=ME5 209TX
Authorization: Bearer yourToken

Request: Telephone

GET https://plus.dnb.com/v1/match/cleanseMatch?telephoneNumber=6505550000&countryISOAlpha2Code=US
Authorization: Bearer yourToken

Request: URL

GET https://plus.dnb.com/v1/match/cleanseMatch?url=dnb.com
Authorization: Bearer yourToken

Request: Email

GET https://plus.dnb.com/v1/match/cleanseMatch?email=jsmith@dnb.com
Authorization: Bearer yourToken

Request inLanguage: Chinese

GET https://plus.dnb.com/v1/match/cleanseMatch?countryISOAlpha2Code=CN&name=%E5%8D%97%E4%BA%AC%E9%9C%81%E6%A1%90%E6%9C%BA%E6%A2%B0%E8%AE%BE%E5%A4%87%E5%88%B6%E9%80%A0%E6%9C%89%E9%99%90%E8%B4%A3%E4%BB%BB%E5%85%AC%E5%8F%B8&streetAddressLine1=%E6%B1%9F%E8%8B%8F%E7%9C%81%E5%8D%97%E4%BA%AC%E5%B8%82%E9%9B%A8%E8%8A%B1%E5%8F%B0%E5%8C%BA%E5%AE%89%E5%BE%B7%E9%97%A8104%E5%8F%B7&inLanguage=zh%2Dhans%2DCN
Authorization: Bearer yourToken

Request inLanguage: Japanese

GET https://plus.dnb.com/v1/match/cleanseMatch?countryISOAlpha2Code=JP&name=%E3%88%B2%E6%98%AD%E5%92%8C%E9%8D%8D%E9%87%91%E5%B7%A5%E6%A5%AD%E6%89%80&streetAddressLine1=%E5%B7%9D%E5%B4%8E%E5%8C%BA%E7%94%B0%E7%94%BA%EF%BC%92%EF%BC%8D%EF%BC%94%EF%BC%8D%EF%BC%92&inLanguage=ja%2DJP
Authorization: Bearer yourToken

Request inLanguage: Korean

GET https://plus.dnb.com/v1/match/cleanseMatch?countryISOAlpha2Code=KR&name=%EF%BC%88%EC%A3%BC%EF%BC%89%EC%9D%BC%ED%9D%A5&streetAddressLine1=%EA%B2%BD%EA%B8%B0%EB%8F%84%E3%80%80%ED%8F%AC%EC%B2%9C%EC%8B%9C%E3%80%80%ED%99%94%ED%95%A9%EB%A1%9C%E3%80%80%EF%BC%92%EF%BC%94%EF%BC%92%E3%80%80%EF%BC%88%EB%8F%99%EA%B5%90%EB%8F%99%EF%BC%89&inLanguage=ko%2Dhang%2DKR
Authorization: Bearer yourToken

Request inLanguage: Taiwanese

GET https://plus.dnb.com/v1/match/cleanseMatch?countryISOAlpha2Code=TW&name=%E5%82%B3%E4%BD%B3%E5%BB%BA%E8%A8%AD%E8%82%A1%E4%BB%BD%E6%9C%89%E9%99%90%E5%85%AC%E5%8F%B8&streetAddressLine1=%E6%96%B0%E5%8C%97%E5%B8%82%E4%BA%94%E8%82%A1%E5%8D%80%E6%88%90%E6%B3%B0%E8%B7%AF%EF%BC%91%E6%AE%B5%EF%BC%92%E8%99%9F%EF%BC%94%E6%A8%93&inLanguage=zh%2Dhant%2DTW
Authorization: Bearer yourToken

Response

Note: Inquiry detail only includes elements that were included in request. In this case, it was a Name & Address request. This response was modified from actual to show 2 matches.

{ 
   "transactionDetail":{ 
      "transactionID":"rrt06eudn_BTnEP8ok_RouterProxy-4-189102_2",
      "transactionTimestamp":"2015-08-12T08:25:16.327Z",
      "inLanguage":"en-US",
      "serviceVersion":"1.0"
   },
   "inquiryDetail":{ 
      "inLanguage":"en-US",
      "name":"Gorman Manufacturing",
      "address":{ 
         "countryISOAlpha2Code":"US",
         "addressLocality":"SAN FRANCISCO",
         "addressRegion":"CA",
         "postalCode":"94110",
         "streetAddressLine":{ 
            "line1":"492 KOLLER STREET"
         }
      },
      "isCleanseAndStandardizeInformationRequired":true
   },
   "candidatesMatchedQuantity":2,
   "matchDataCriteria":"Name and Address Lookup",
   "matchCandidates":[ 
      { 
         "displaySequence":1,
         "organization":{ 
            "duns":"999888999",
            "websiteAddress":[ 
               { 
                  "url":"http://www.gorman.com",
                  "domainName":"gorman.com"
               }
            ],
            "dunsControlStatus":{ 
               "operatingStatus":{ 
                  "description":"Active",
                  "dnbCode":9074
               },
               "isMailUndeliverable":false
            },
            "primaryName":"GORMAN MANUFACTURING COMPANY, INC.",
            "tradeStyleNames":[ 
               { 
                  "name":"GORMAN MANUFACTURE",
                  "priority":"1"
               }
            ],
            "telephone":[ 
               { 
                  "telephoneNumber":"6505550000",
                  "isUnreachable":false
               }
            ],
            "primaryAddress":{ 
               "addressCountry":{ 
                  "isoAlpha2Code":"US",
                  "name":"UNITED STATES"
               },
               "addressLocality":{ 
                  "name":"SAN FRANCISCO"
               },
               "addressRegion":{ 
                  "name":null,
                  "abbreviatedName":"CA"
               },
               "postalCode":"94110",
               "postalCodeExtension":null,
               "streetAddress":{ 
                  "line1":"492 KOLLER STREET",
                  "line2":null
               }
            },
            "mailingAddress":{ 
               "addressCountry":{ 
                  "isoAlpha2Code":"US",
                  "name":"UNITED STATES"
               },
               "addressLocality":{ 
                  "name":"SAN FRANCISCO"
               },
               "addressRegion":{ 
                  "name":null,
                  "abbreviatedName":"CA"
               },
               "postalCode":"94110",
               "postalCodeExtension":null,
               "streetAddress":{ 
                  "line1":"492 KOLLER STREET",
                  "line2":null
               }
            },
            "registrationNumbers":[ 
               { 
                  "registrationNumber":"12-3456789",
                  "typeDescription":"Federal Taxpayer Identification Number (US)",
                  "dnbTypeCode":6963
               }
            ],
            "mostSeniorPrincipals":[ 
               { 
                  "fullName":"LESLIE  SMITH"
               }
            ],
            "isStandalone":false,
            "corporateLinkage":{ 
               "familytreeRolesPlayed":[ 
                  { 
                     "description":"Parent / Headquarters",
                     "dnbCode":9141
                  }
               ]
            }
         },
         "matchQualityInformation":{ 
            "confidenceCode":10,
            "matchGrade":"AAAAAZZAFFZ",
            "matchGradeComponentsCount":11,
            "matchGradeComponents":[ 
               { 
                  "componentType":"Name",
                  "componentRating":"A"
               },
               { 
                  "componentType":"Street Number",
                  "componentRating":"A"
               },
               { 
                  "componentType":"Street Name",
                  "componentRating":"A"
               },
               { 
                  "componentType":"City",
                  "componentRating":"A"
               },
               { 
                  "componentType":"State",
                  "componentRating":"A"
               },
               { 
                  "componentType":"PO Box",
                  "componentRating":"Z"
               },
               { 
                  "componentType":"Phone",
                  "componentRating":"Z"
               },
               { 
                  "componentType":"Postal Code",
                  "componentRating":"A"
               },
               { 
                  "componentType":"Density",
                  "componentRating":"F"
               },
               { 
                  "componentType":"Uniqueness",
                  "componentRating":"F"
               },
               { 
                  "componentType":"Sic",
                  "componentRating":"Z"
               }
            ],
            "matchDataProfile":"0000000000989800000000009898",
            "matchDataProfileComponentsCount":14,
            "matchDataProfileComponents":[ 
               { 
                  "componentType":"Name",
                  "componentValue":"00"
               },
               { 
                  "componentType":"Street Number",
                  "componentValue":"00"
               },
               { 
                  "componentType":"Street Name",
                  "componentValue":"00"
               },
               { 
                  "componentType":"City",
                  "componentValue":"00"
               },
               { 
                  "componentType":"State",
                  "componentValue":"00"
               },
               { 
                  "componentType":"PO Box",
                  "componentValue":"98"
               },
               { 
                  "componentType":"Phone",
                  "componentValue":"98"
               },
               { 
                  "componentType":"Postal Code",
                  "componentValue":"00"
               },
               { 
                  "componentType":"DUNS",
                  "componentValue":"00"
               },
               { 
                  "componentType":"SIC",
                  "componentValue":"00"
               },
               { 
                  "componentType":"Density",
                  "componentValue":"00"
               },
               { 
                  "componentType":"Uniqueness",
                  "componentValue":"00"
               },
               { 
                  "componentType":"National ID",
                  "componentValue":"98"
               },
               { 
                  "componentType":"URL",
                  "componentValue":"98"
               }
            ],
            "nameMatchScore":85.123456
         }
      },
      { 
         "displaySequence":2,
         "organization":{ 
            "duns":"038732116",
            "websiteAddress":[ 
               { 
                  "url":"http://www.gorman.com",
                  "domainName":"gorman.com"
               }
            ],
            "dunsControlStatus":{ 
               "operatingStatus":{ 
                  "description":"Active",
                  "dnbCode":9074
               },
               "isMailUndeliverable":false
            },
            "primaryName":"GORMAN MANUFACTURING COMPANY, INC.",
            "tradeStyleNames":[ 
               { 
                  "name":"GORMAN MANUFACTURE",
                  "priority":"1"
               }
            ],
            "telephone":[ 
               { 
                  "telephoneNumber":"6505550000",
                  "isUnreachable":false
               }
            ],
            "primaryAddress":{ 
               "addressCountry":{ 
                  "isoAlpha2Code":"US",
                  "name":"UNITED STATES"
               },
               "addressLocality":{ 
                  "name":"LOS ANGELES"
               },
               "addressRegion":{ 
                  "name":null,
                  "abbreviatedName":"CA"
               },
               "postalCode":"90023",
               "postalCodeExtension":"1246",
               "streetAddress":{ 
                  "line1":"1073 S BOYLE AVE",
                  "line2":null
               }
            },
            "mailingAddress":{ 
               "addressCountry":{ 
                  "isoAlpha2Code":"US",
                  "name":"UNITED STATES"
               },
               "addressLocality":{ 
                  "name":"LOS ANGELES"
               },
               "addressRegion":{ 
                  "name":null,
                  "abbreviatedName":"CA"
               },
               "postalCode":"90023",
               "postalCodeExtension":"1246",
               "streetAddress":{ 
                  "line1":"1073 S BOYLE AVE",
                  "line2":null
               }
            },
            "registrationNumbers":[ 
               { 
                  "registrationNumber":"1249-98889",
                  "typeDescription":"Federal Taxpayer Identification Number (US)",
                  "dnbTypeCode":6963
               }
            ],
            "mostSeniorPrincipals":[ 
               { 
                  "fullName":"NICK  LAFOND"
               }
            ],
            "isStandalone":false,
            "corporateLinkage":{ 
               "familytreeRolesPlayed":[ 
                  { 
                     "description":"Branch / Division",
                     "dnbCode":9140
                  }
               ]
            }
         },
         "matchQualityInformation":{ 
            "confidenceCode":4,
            "matchGrade":"AFFFAZZFFFZ",
            "matchGradeComponentsCount":11,
            "matchGradeComponents":[ 
               { 
                  "componentType":"Name",
                  "componentRating":"A"
               },
               { 
                  "componentType":"Street Number",
                  "componentRating":"F"
               },
               { 
                  "componentType":"Street Name",
                  "componentRating":"F"
               },
               { 
                  "componentType":"City",
                  "componentRating":"F"
               },
               { 
                  "componentType":"State",
                  "componentRating":"A"
               },
               { 
                  "componentType":"PO Box",
                  "componentRating":"Z"
               },
               { 
                  "componentType":"Phone",
                  "componentRating":"Z"
               },
               { 
                  "componentType":"Postal Code",
                  "componentRating":"F"
               },
               { 
                  "componentType":"Density",
                  "componentRating":"F"
               },
               { 
                  "componentType":"Uniqueness",
                  "componentRating":"F"
               },
               { 
                  "componentType":"Sic",
                  "componentRating":"Z"
               }
            ],
            "matchDataProfile":"0000000000989800000000009898",
            "matchDataProfileComponentsCount":14,
            "matchDataProfileComponents":[ 
               { 
                  "componentType":"Name",
                  "componentValue":"00"
               },
               { 
                  "componentType":"Street Number",
                  "componentValue":"00"
               },
               { 
                  "componentType":"Street Name",
                  "componentValue":"00"
               },
               { 
                  "componentType":"City",
                  "componentValue":"00"
               },
               { 
                  "componentType":"State",
                  "componentValue":"00"
               },
               { 
                  "componentType":"PO Box",
                  "componentValue":"98"
               },
               { 
                  "componentType":"Phone",
                  "componentValue":"98"
               },
               { 
                  "componentType":"Postal Code",
                  "componentValue":"00"
               },
               { 
                  "componentType":"DUNS",
                  "componentValue":"00"
               },
               { 
                  "componentType":"SIC",
                  "componentValue":"00"
               },
               { 
                  "componentType":"Density",
                  "componentValue":"00"
               },
               { 
                  "componentType":"Uniqueness",
                  "componentValue":"00"
               },
               { 
                  "componentType":"National ID",
                  "componentValue":"98"
               },
               { 
                  "componentType":"URL",
                  "componentValue":"98"
               }
            ],
            "nameMatchScore":85
         }
      }
   ],
   "cleanseAndStandardizeInformation":{ 
      "standardizedName":"GORMAN MANUFACTURING",
      "standardizedAddress":{ 
         "addressCountry":{ 
            "isoAlpha2Code":"US",
            "name":"UNITED STATES"
         },
         "addressLocality":{ 
            "name":"San Francisco"
         },
         "addressRegion":{ 
            "name":"California",
            "abbreviatedName":"CA"
         },
         "addressCounty":{ 
            "name":"San Francisco"
         },
         "postalCode":"94110",
         "postalCodeExtension":null,
         "streetAddress":{ 
            "line1":"492 Koller Street",
            "line2":null
         },
         "deliveryPointValidationStatus":null,
         "deliveryPointValidationCMRAValue":null,
         "isInexactAddress":false,
         "addressType":"Unknown"
      }
   }
}

Match & Append

Request

The Match & Append request has the same options as Identity Resolution. Only the name and address variation is included here.

GET 
https://plus.dnb.com/v1/match/extendedMatch?productId=cmpelk&versionId=v2&name=Gorman Manufacturing&streetAddressLine1=492 KOLLER STREET&countryISOAlpha2Code=US&addressLocality=SAN FRANCISCO&addressRegion=CA
Authorization: Bearer yourToken

Response

The specified attributes in the embeddedProduct object depend on the requested product. For JSON examples, see the Data Product area of this site.

{
  "transactionDetail": {
    "transactionID": "rrt-f4ede2e2-d-ea-31685-305074-1",
    "transactionTimestamp": "2017-05-12T22:02:59.156Z",
    "inLanguage": "en-US",
    "serviceVersion": "1"
  },
  "inquiryDetail": {
    "inLanguage": "en-US",
    "name": "Gorman Manufacturing",
    "address": {
      "countryISOAlpha2Code": "US",
      "addressLocality": "SAN FRANCISCO",
      "addressRegion": "CA",
      "streetAddressLine": {
        "line1": "492 KOLLER STREET"
      }
    },
    "productID": "cmpelk",
    "productVersion": "v2"
  },
  "candidatesMatchedQuantity": 1,
  "matchDataCriteria": "Name and Address Lookup",
  "matchCandidates": [
    {
      "displaySequence": 1,
      "organization": {
        "duns": "999888999",
        "websiteAddress": [
          {
            "url": "http://www.gorman.com",
            "domainName": "gorman.com"
          }
        ],
        "dunsControlStatus": {
          "operatingStatus": {
            "description": "Active",
            "dnbCode": 9074
          },
          "isMailUndeliverable": false
        },
        "primaryName": "GORMAN MANUFACTURING COMPANY, INC.",
        "tradeStyleNames": [
          {
            "name": "GORMAN MANUFACTURE",
            "priority": 1
          },
		  {
            "name": "GORMAN US",
            "priority": 2
		  }
        ],
        "telephone": [
          {
            "telephoneNumber": "6505550000",
            "isUnreachable": false
          }
        ],
        "primaryAddress": {
          "addressCountry": {
            "isoAlpha2Code": "US",
            "name": "UNITED STATES"
          },
          "addressLocality": {
            "name": "SAN FRANCISCO"
          },
          "addressRegion": {
            "name": null,
            "abbreviatedName": "CA"
          },
          "postalCode": "94110",
          "postalCodeExtension": null,
          "streetAddress": {
            "line1": "492 KOLLER ST",
            "line2": null
          }
        },
        "mailingAddress": {
          "addressCountry": {
            "isoAlpha2Code": "US",
            "name": "UNITED STATES"
          },
          "addressLocality": {
            "name": "SAN FRANCISCO"
          },
          "addressRegion": {
            "name": null,
            "abbreviatedName": "CA"
          },
          "postalCode": "94110",
          "postalCodeExtension": null,
          "streetAddress": {
            "line1": "492 KOLLER STREET",
            "line2": null
          }
        },
        "registrationNumbers": [
          {
            "registrationNumber": "12-3456789",
            "typeDescription": "Federal Taxpayer Identification Number (US)",
            "dnbTypeCode": 6963
          }
        ],
        "mostSeniorPrincipals": [
          {
            "fullName": "JOHN GEORGE DOE"
          }
        ],
        "isStandalone": false,
        "corporateLinkage": {
          "familytreeRolesPlayed": [
            {
              "description": "Parent / Headquarters",
              "dnbCode": 9141
            }
          ]
        }
      },
      "matchQualityInformation": {
        "confidenceCode": 10,
        "matchGrade": "AAAAAZZZFFZ",
        "matchGradeComponentsCount": 11,
        "matchGradeComponents": [
          {
            "componentType": "Name",
            "componentRating": "A"
          },
          {
            "componentType": "Street Number",
            "componentRating": "A"
          },
          {
            "componentType": "Street Name",
            "componentRating": "A"
          },
          {
            "componentType": "City",
            "componentRating": "A"
          },
          {
            "componentType": "State",
            "componentRating": "A"
          },
          {
            "componentType": "PO Box",
            "componentRating": "Z"
          },
          {
            "componentType": "Phone",
            "componentRating": "Z"
          },
          {
            "componentType": "Postal Code",
            "componentRating": "Z"
          },
          {
            "componentType": "Density",
            "componentRating": "F"
          },
          {
            "componentType": "Uniqueness",
            "componentRating": "F"
          },
          {
            "componentType": "Sic",
            "componentRating": "Z"
          }
        ],
        "matchDataProfile": "0000000000989899000000009898",
        "matchDataProfileComponentsCount": 14,
        "matchDataProfileComponents": [
          {
            "componentType": "Name",
            "componentValue": "00"
          },
          {
            "componentType": "Street Number",
            "componentValue": "00"
          },
          {
            "componentType": "Street Name",
            "componentValue": "00"
          },
          {
            "componentType": "City",
            "componentValue": "00"
          },
          {
            "componentType": "State",
            "componentValue": "00"
          },
          {
            "componentType": "PO Box",
            "componentValue": "98"
          },
          {
            "componentType": "Phone",
            "componentValue": "98"
          },
          {
            "componentType": "Postal Code",
            "componentValue": "99"
          },
          {
            "componentType": "DUNS",
            "componentValue": "00"
          },
          {
            "componentType": "SIC",
            "componentValue": "00"
          },
          {
            "componentType": "Density",
            "componentValue": "00"
          },
          {
            "componentType": "Uniqueness",
            "componentValue": "00"
          },
          {
            "componentType": "National ID",
            "componentValue": "98"
          },
          {
            "componentType": "URL",
            "componentValue": "98"
          }
        ],
        "nameMatchScore": 100
      }
    }
  ],
  "cleanseAndStandardizeInformation": {
    "standardizedName": "GORMAN MANUFACTURING",
    "standardizedAddress": {
      "addressCountry": {
        "isoAlpha2Code": "US",
        "name": "UNITED STATES"
      },
      "addressLocality": {
        "name": "San Francisco"
      },
      "addressRegion": {
        "name": "California",
        "abbreviatedName": "CA"
      },
      "addressCounty": {
        "name": "San Francisco"
      },
      "postalCode": "94110",
      "postalCodeExtension": null,
      "streetAddress": {
        "line1": "492 Koller Street",
        "line2": null
      },
      "deliveryPointValidationStatus": null,
      "deliveryPointValidationCMRAValue": null,
      "isInexactAddress": false,
      "addressType": "Unknown"
    }
  },
  "embeddedProduct": {
    "productVersion": "2",
    "productID": "cmpelk",
    "organization": {
      "businessEntityType": {
        "description": "Non Profit Organisation",
        "dnbCode": 457
      },
      "duns": "999888999",
      "controlOwnershipType": {
        "description": "Privately owned",
        "dnbCode": 9058
      },
      "primaryAddress": {
        "language": {
          "description": "English",
          "dnbCode": 39
        },
        "addressCountry": {
          "name": "United States",
          "isoAlpha2Code": "US",
          "fipsCode": "US"
        },
        "continentalRegion": {
          "name": "North America"
        },
        "addressLocality": {
          "name": "SAN FRANCISCO"
        },
        "minorTownName": null,
        "addressRegion": {
          "name": "California",
          "abbreviatedName": "CA",
          "fipsCode": "06"
        },
        "addressCounty": {
          "name": "SAN FRANCISCO",
          "fipsCode": "075"
        },
        "postalCode": "94110",
        "postalCodePosition": {
          "description": "Post Code presented after Town/City name",
          "dnbcode": 1011
        },
        "streetNumber": "492",
        "streetName": "Koller Street",
        "streetAddress": {
          "line1": "492 Koller Street",
          "line2": null
        },
        "postOfficeBox": {
          "postOfficeBoxNumber": "99",
          "typeDescription": "Post Office Box (Supplied by public Post Office authority.)",
          "typeDnBCode": 120
        },
        "latitude": 37.777709,
        "longitude": -122.404624,
        "geographicalPrecision": {
          "description": "Postal Code Centroid",
          "dnbCode": 30258
        },
        "isRegisteredAddress": true,
        "isResidentialAddress": true,
        "statisticalArea": {
          "cbsaName": "San Francisco-Oakland-Hayward CA",
          "cbsaCode": "41860",
          "economicAreaOfInfluenceCode": "146",
          "populationRank": {
            "rankNumber": "9",
            "rankDnBCode": 10961,
            "rankDescription": "500,000 +"
          }
        },
        "locationOwnership": {
          "description": "Rents",
          "dnbCode": 1129
        },
        "premisesArea": {
          "measurement": 123000.5,
          "unitDescription": "Square Foot",
          "unitDnBCode": 3848,
          "reliabilityDescription": "Actual",
          "reliabilityDnBCode": 9092
        },
        "isManufacturingLocation": false
      },
      "primaryName": "Gorman Manufacturing Company, Inc.",
      "dnbAssessment": {
        "marketingRiskClass": {
          "description": "Low",
          "dnbCode": "10925"
        }
      },
      "socioEconomicInformation": {
        "isMinorityOwned": null,
        "isSmallBusiness": true
      },
      "startDate": 1801,
      "registrationNumbers": [
        {
          "registrationNumber": "12-3456789",
          "typeDescription": "Federal Taxpayer Identification Number (US)",
          "typeDnBCode": 6863
        }
      ],
      "controlOwnershipDate": 1841,
      "isStandalone": true,
      "dunsControlStatus": {
        "operatingStatus": {
          "description": "Active",
          "dnbCode": 9074
        },
        "isMarketable": true,
        "isMailUndeliverable": false,
        "isTelephoneDisconnected": false,
        "isDelisted": false,
        "subjectHandlingDetails": [
          {
            "description": "Do not fax",
            "dnbCode": 7972
          },
          {
            "description": "Do not send information requests",
            "dnbCode": 7821
          }
        ],
        "fullReportDate": "2014-04-08"
      },
      "telephone": [
        {
          "telephoneNumber": "6505550000",
          "isdCode": "1",
          "isUnreachable": false
        }
      ],
      "fax": [],
      "financials": [
        {
          "financialStatementToDate": "2015-12-31",
          "financialStatementDuration": null,
          "informationScopeDescription": "Individual",
          "informationScopeDnBCode": 9066,
          "reliabilityDescription": "Actual",
          "reliabilityDnBCode": 9092,
          "unitCode": "Single Units",
          "accountantName": "PricewaterhouseCoopers LLP, New York, NY",
          "yearlyRevenue": [
            {
              "value": 1703700000,
              "currency": "USD",
              "trend": [
                {
                  "timePeriod": {
                    "description": "1-5 years",
                    "dnbCode": 13721
                  },
                  "growthRate": -2
                },
                {
                  "timePeriod": {
                    "description": "1-3 years",
                    "dnbCode": 13711
                  },
                  "growthRate": -1
                }
              ]
            }
          ]
        }
      ],
      "corporateLinkage": {
        "familytreeRolesPlayed": [
          {
            "description": "Global Ultimate",
            "dnbCode": 12775
          },
          {
            "description": "Domestic Ultimate",
            "dnbCode": 12774
          },
          {
            "description": "Parent/Headquarters",
            "dnbCode": 9141
          }
        ],
        "hierarchyLevel": 1,
        "globalUltimateFamilyTreeMembersCount": 9,
        "globalUltimate": {
          "duns": "999888999",
          "primaryName": "Gorman Manufacturing Company, Inc.",
          "primaryAddress": {
            "addressCountry": {
              "name": "United States",
              "isoAlpha2Code": "US",
              "fipsCode": "US"
            },
            "continentalRegion": {
              "name": "North America"
            },
            "addressLocality": {
              "name": "SAN FRANCISCO"
            },
            "addressRegion": {
              "name": "California",
              "abbreviatedName": "CA"
            },
            "postalCode": "94110",
            "streetAddress": {
              "line1": "492 KOLLER ST",
              "line2": null
            }
          }
        },
        "domesticUltimate": {
          "duns": "804735132",
          "primaryName": "Gorman Manufacturing Company, Inc.",
          "primaryAddress": {
            "addressCountry": {
              "name": "United States",
              "isoAlpha2Code": "US",
              "fipsCode": "US"
            },
            "continentalRegion": {
              "name": "North America"
            },
            "addressLocality": {
              "name": "SAN FRANCISCO"
            },
            "addressRegion": {
              "name": "California",
              "abbreviatedName": "CA"
            },
            "postalCode": "94110",
            "streetAddress": {
              "line1": "492 KOLLER ST",
              "line2": null
            }
          }
        },
        "parent": {},
        "headQuarter": {}
      },
      "isAgent": null,
      "isImporter": null,
      "thirdPartyAssessment": [
        {
          "description": "Fortune 500 Revenue Rank",
          "dnbCode": 23290,
          "assessmentDate": "2017",
          "value": "31"
        },
        {
          "description": "Fortune 1000 Revenue Rank",
          "dnbCode": 21230,
          "assessmentDate": "2016",
          "value": "1"
        }
      ],
      "isExporter": null,
      "numberOfEmployees": [
        {
          "value": 153,
          "informationScopeDescription": "Consolidated",
          "informationScopeDnBCode": 9067,
          "reliabilityDescription": "Actual",
          "reliabilityDnBCode": 9092,
          "employeeCategories": [],
          "trend": []
        },
        {
          "value": 120,
          "informationScopeDescription": "Individual",
          "informationScopeDnBCode": 9066,
          "reliabilityDescription": "Actual",
          "reliabilityDnBCode": 9092,
          "employeeCategories": [],
          "trend": []
        }
      ],
      "stockExchanges": [
        {
          "tickerName": "NYSE:ABC",
          "exchangeName": {
            "description": "NYSE"
          },
          "exchangeCountry": {
            "isoAlpha2Code": "US"
          },
          "isPrimary": true
        },
        {
          "tickerName": "Berlin:ABC",
          "exchangeName": {
            "description": "Berlin"
          },
          "exchangeCountry": {
            "isoAlpha2Code": "DE"
          },
          "isPrimary": null
        },
        {
          "tickerName": "German:ABC",
          "exchangeName": {
            "description": "German"
          },
          "exchangeCountry": {
            "isoAlpha2Code": "DE"
          },
          "isPrimary": false
        }
      ],
      "mostSeniorPrincipals": [
        {
          "givenName": "John",
          "familyName": "Doe",
          "fullName": "John George Doe",
          "namePrefix": "Dr.",
          "nameSuffix": "PhD",
          "gender": "Male",
          "jobTitles": [
            {
              "title": "Director"
            }
          ],
          "managementResponsibilities": [
            {
              "description": "Director",
              "mrcCode": "Z699"
            }
          ]
        }
      ],
      "currentPrincipals": [
        {
          "givenName": "Jane",
          "familyName": "Miller",
          "fullName": "Jane Miller",
          "namePrefix": "Dr.",
          "nameSuffix": "PhD",
          "gender": "Female",
          "jobTitles": [
            {
              "title": "Director"
            }
          ],
          "managementResponsibilities": [
            {
              "description": "Director",
              "mrcCode": "Z699"
            }
          ]
        }
      ],
      "tradeStyleNames": [
        {
          "name": "GORMAN MANUFACTURE",
          "priority": 1
        },
		{
          "name": "GORMAN US",
          "priority": 2
		}
      ],
      "mailingAddress": {
        "language": {
          "description": "English",
          "dnbCode": 39
        },
        "addressCountry": {
          "name": "United States",
          "isoAlpha2Code": "US",
          "fipsCode": "US"
        },
        "continentalRegion": {
          "name": "North America"
        },
        "addressLocality": {
          "name": "SAN FRANCISCO"
        },
        "minorTownName": null,
        "addressRegion": {
          "name": "California",
          "abbreviatedName": "CA",
          "fipsCode": "06"
        },
        "addressCounty": {
          "name": "SAN FRANCISCO",
          "fipsCode": "075"
        },
        "postalCode": "94110",
        "postalCodePosition": {
          "description": "Post Code presented after Town/City name",
          "dnbcode": 1011
        },
        "streetNumber": "492",
        "streetName": "Koller Street",
        "streetAddress": {
          "line1": "492 Koller Street",
          "line2": null
        },
        "postOfficeBox": {
          "postOfficeBoxNumber": "99",
          "typeDescription": "Post Office Box (Supplied by public Post Office authority.)",
          "typeDnBCode": 120
        },
        "latitude": 37.777709,
        "longitude": -122.404624,
        "geographicalPrecision": {
          "description": "Postal Code Centroid",
          "dnbCode": 30258
        }
      },
      "registeredAddress": {
        "language": {
          "description": "English",
          "dnbCode": 39
        },
        "addressCountry": {
          "name": "United States",
          "isoAlpha2Code": "US",
          "fipsCode": "US"
        },
        "continentalRegion": {
          "name": "North America"
        },
        "addressLocality": {
          "name": "SAN FRANCISCO"
        },
        "minorTownName": null,
        "addressRegion": {
          "name": "California",
          "abbreviatedName": "CA",
          "fipsCode": "06"
        },
        "addressCounty": {
          "name": "SAN FRANCISCO",
          "fipsCode": "075"
        },
        "postalCode": "94110",
        "postalCodePosition": {
          "description": "Post Code presented after Town/City name",
          "dnbcode": 1011
        },
        "streetNumber": "492",
        "streetName": "Koller Street",
        "streetAddress": {
          "line1": "492 Koller Street",
          "line2": null
        },
        "postOfficeBox": {
          "postOfficeBoxNumber": "99",
          "typeDescription": "Post Office Box (Supplied by public Post Office authority.)",
          "typeDnBCode": 120
        },
        "latitude": 37.777709,
        "longitude": -122.404624,
        "geographicalPrecision": {
          "description": "Postal Code Centroid",
          "dnbCode": 30258
        }
      },
      "websiteAddress": [
        {
          "url": "www.abclimited.com",
          "domainName": "abclimited.com"
        }
      ],
      "industryCodes": [
        {
          "code": "561499",
          "description": "All Other Business Support Services",
          "typeDescription": "North American Industry Classification System 2012",
          "typeDnBCode": 24664,
          "priority": 2
        },
        {
          "code": "67190000",
          "description": "Holding companies, nec",
          "typeDescription": "D&B Standard Industry Code",
          "typeDnBCode": 3599,
          "priority": 3
        },
        {
          "code": "445110",
          "description": "Supermarkets and Other Grocery (except Convenience) Stores",
          "typeDescription": "North American Industry Classification System 2012",
          "typeDnBCode": 24664,
          "priority": 1
        },
        {
          "code": "7389",
          "description": "Business services",
          "typeDescription": "US Standard Industry Code 1987 - 4 digit",
          "typeDnBCode": 399,
          "priority": 2
        },
        {
          "code": "47110",
          "description": "Retail sale in non-specialised stores with food, beverages or tobacco predominating",
          "typeDescription": "UK Standard Industry Code 2007",
          "typeDnBCode": 19295,
          "priority": 1
        },
        {
          "code": "73890000",
          "description": "Business services, nec",
          "typeDescription": "D&B Standard Industry Code",
          "typeDnBCode": 3599,
          "priority": 2
        },
        {
          "code": "1535",
          "description": "Grocery Stores & Supermarkets",
          "typeDescription": "D&B Hoovers Industry Code",
          "typeDnBCode": 25838,
          "priority": 1
        },
        {
          "code": "5411",
          "description": "Ret groceries",
          "typeDescription": "US Standard Industry Code 1987 - 4 digit",
          "typeDnBCode": 399,
          "priority": 2
        },
        {
          "code": "54110000",
          "description": "Grocery stores",
          "typeDescription": "D&B Standard Industry Code",
          "typeDnBCode": 3599,
          "priority": 3
        },
        {
          "code": "551112",
          "description": "Offices of Other Holding Companies",
          "typeDescription": "North American Industry Classification System 2012",
          "typeDnBCode": 24664,
          "priority": 3
        },
        {
          "code": "G",
          "description": "Retail Sale",
          "typeDescription": "D&B Standard Major Industry Code",
          "typeDnBCode": 24657,
          "priority": 1
        },
        {
          "code": "4711",
          "description": "Retail sale in non-specialised stores with food, beverages or tobacco predominating",
          "typeDescription": "NACE Revision 2",
          "typeDnBCode": 29104,
          "priority": 2
        },
        {
          "code": "6719",
          "description": "Holding company",
          "typeDescription": "US Standard Industry Code 1987 - 4 digit",
          "typeDnBCode": 399,
          "priority": 3
        }
      ],
      "inLanguage": "en-US"
    }
  }
}

Match & Append (Data Blocks)

Request

GET 
https://plus.dnb.com/v1/match/extendedMatch?countryISOAlpha2Code=US&name=gorman manufacturing&blockIDs=companyinfo_L1_v1,principalscontacts_L1_v1,hierarchyconnections_L1_v1
Authorization: Bearer yourToken

Response

{
	"transactionDetail": {
		"transactionID": "rrt-0a75e3331e9d4a100-b-se-31705-24679713-2",
		"transactionTimestamp": "2021-04-26T13:57:34.549Z",
		"inLanguage": "en-US",
		"serviceVersion": "1"
	},
	"inquiryDetail": {
		"name": "gorman manufacturing",
		"address": {
			"countryISOAlpha2Code": "US"
		},
		"blockIDs": [
			"companyinfo_L1_v1", "principalscontacts_L1_v1", "hierarchyconnections_L1_v1"
		]
	},
	"candidatesMatchedQuantity": 1,
	"matchDataCriteria": "Name and Address Lookup",
	"matchCandidates": [
		{
			"displaySequence": 1,
			"organization": {
				"duns": "804735132",
				"websiteAddress": [],
				"dunsControlStatus": {
					"operatingStatus": {
						"description": "Active",
						"dnbCode": 9074
					},
					"isMailUndeliverable": false
				},
				"primaryName": "GORMAN MANUFACTURING COMPANY, INC.",
				"tradeStyleNames": [],
				"telephone": [
					{
						"telephoneNumber": "6505550000",
						"isUnreachable": false
					}
				],
				"primaryAddress": {
					"addressCountry": {
						"isoAlpha2Code": "US",
						"name": "United States"
					},
					"addressLocality": {
						"name": "SAN FRANCISCO"
					},
					"addressRegion": {
						"name": null,
						"abbreviatedName": "CA"
					},
					"postalCode": "94110",
					"postalCodeExtension": null,
					"streetAddress": {
						"line1": "492 KOLLER ST",
						"line2": null
					}
				},
				"mailingAddress": {
					"addressCountry": {
						"isoAlpha2Code": "US",
						"name": "United States"
					},
					"addressLocality": {},
					"addressRegion": {},
					"postalCode": null,
					"postalCodeExtension": null,
					"streetAddress": {}
				},
				"registrationNumbers": [],
				"mostSeniorPrincipals": [
					{
						"fullName": "LESLIE  SMITH"
					}
				],
				"isStandalone": false,
				"corporateLinkage": {
					"familytreeRolesPlayed": [
						{
							"description": "Parent/Headquarters",
							"dnbCode": 9141
						}
					]
				}
			},
			"matchQualityInformation": {
				"confidenceCode": 6,
				"matchGrade": "AZZZZZZZFZZ",
				"matchGradeComponentsCount": 11,
				"matchGradeComponents": [
					{
						"componentType": "Name",
						"componentRating": "A"
					}, {
						"componentType": "Street Number",
						"componentRating": "Z"
					}, {
						"componentType": "Street Name",
						"componentRating": "Z"
					}, {
						"componentType": "City",
						"componentRating": "Z"
					}, {
						"componentType": "State",
						"componentRating": "Z"
					}, {
						"componentType": "PO Box",
						"componentRating": "Z"
					}, {
						"componentType": "Phone",
						"componentRating": "Z"
					}, {
						"componentType": "Postal Code",
						"componentRating": "Z"
					}, {
						"componentType": "Density",
						"componentRating": "F"
					}, {
						"componentType": "Uniqueness",
						"componentRating": "Z"
					}, {
						"componentType": "Sic",
						"componentRating": "Z"
					}
				],
				"matchDataProfile": "0099999999999999000000989998",
				"matchDataProfileComponentsCount": 14,
				"matchDataProfileComponents": [
					{
						"componentType": "Name",
						"componentValue": "00"
					}, {
						"componentType": "Street Number",
						"componentValue": "99"
					}, {
						"componentType": "Street Name",
						"componentValue": "99"
					}, {
						"componentType": "City",
						"componentValue": "99"
					}, {
						"componentType": "State",
						"componentValue": "99"
					}, {
						"componentType": "PO Box",
						"componentValue": "99"
					}, {
						"componentType": "Phone",
						"componentValue": "99"
					}, {
						"componentType": "Postal Code",
						"componentValue": "99"
					}, {
						"componentType": "DUNS",
						"componentValue": "00"
					}, {
						"componentType": "SIC",
						"componentValue": "00"
					}, {
						"componentType": "Density",
						"componentValue": "00"
					}, {
						"componentType": "Uniqueness",
						"componentValue": "98"
					}, {
						"componentType": "National ID",
						"componentValue": "99"
					}, {
						"componentType": "URL",
						"componentValue": "98"
					}
				],
				"nameMatchScore": 100.0
			}
		}
	],
	"cleanseAndStandardizeInformation": {},
	"embeddedProduct": {
		"organization": {
			"countryISOAlpha2Code": "US",
			"duns": "804735132",
			"dunsControlStatus": {
				"operatingStatus": {
					"description": "Active",
					"dnbCode": 9074
				},
				"isMarketable": false,
				"isMailUndeliverable": false,
				"isTelephoneDisconnected": false,
				"isDelisted": true,
				"subjectHandlingDetails": [
					{
						"description": "Do not fax",
						"dnbCode": 7972
					}, {
						"description": "Do not call",
						"dnbCode": 7974
					}, {
						"description": "Do not mail",
						"dnbCode": 7975
					}, {
						"description": "Do not e-mail",
						"dnbCode": 9051
					}, {
						"description": "Suppress from all marketing lists",
						"dnbCode": 9146
					}
				],
				"firstReportDate": "1993-05-25"
			},
			"multilingualTradestyleNames": [],
			"registrationNumbers": [],
			"mostSeniorPrincipals": [
				{
					"givenName": "Leslie",
					"middleName": null,
					"familyName": "Smith",
					"fullName": "Leslie Smith",
					"namePrefix": null,
					"nameSuffix": null,
					"gender": {},
					"jobTitles": [
						{
							"title": "President"
						}
					],
					"managementResponsibilities": [
						{
							"description": "President",
							"mrcCode": "A1A6"
						}
					],
					"idNumbers": []
				}
			],
			"telephone": [
				{
					"telephoneNumber": "6505550000",
					"isdCode": "1"
				}
			],
			"activities": [
				{
					"description": "Lithographic commercial printing",
					"language": {
						"description": null,
						"dnbCode": 331
					}
				}
			],
			"isNonClassifiedEstablishment": null,
			"primaryIndustryCode": {
				"usSicV4": "2752",
				"usSicV4Description": "Lithographic commercial printing"
			},
			"primaryName": "Gorman Manufacturing Company, Inc.",
			"defaultCurrency": "USD",
			"multilingualPrimaryName": [],
			"email": [],
			"unspscCodes": [
				{
					"code": "82151502",
					"description": "Lithographers services",
					"priority": 1
				}
			],
			"tradeStyleNames": [],
			"stockExchanges": [],
			"websiteAddress": [],
			"primaryAddress": {
				"language": {},
				"addressCountry": {
					"name": "United States",
					"isoAlpha2Code": "US"
				},
				"continentalRegion": {
					"name": "North America"
				},
				"addressLocality": {
					"name": "San Francisco"
				},
				"minorTownName": null,
				"addressRegion": {
					"name": "California",
					"abbreviatedName": "CA"
				},
				"addressCounty": {
					"name": "San Francisco"
				},
				"postalCode": "94110",
				"postalCodePosition": {},
				"streetNumber": null,
				"streetName": null,
				"streetAddress": {
					"line1": "492 Koller St",
					"line2": null
				},
				"postOfficeBox": {},
				"isRegisteredAddress": false
			},
			"multilingualPrimaryAddress": [],
			"corporateLinkage": {
				"familytreeRolesPlayed": [
					{
						"description": "Global Ultimate",
						"dnbCode": 12775
					}, {
						"description": "Domestic Ultimate",
						"dnbCode": 12774
					}, {
						"description": "Parent/Headquarters",
						"dnbCode": 9141
					}
				],
				"hierarchyLevel": 1,
				"globalUltimateFamilyTreeMembersCount": 7,
				"globalUltimate": {
					"duns": "804735132",
					"primaryName": "Gorman Manufacturing Company, Inc.",
					"primaryAddress": {
						"addressCountry": {
							"name": "United States",
							"isoAlpha2Code": "US"
						},
						"continentalRegion": {
							"name": "North America"
						},
						"addressLocality": {
							"name": "San Francisco"
						},
						"addressRegion": {
							"name": "California",
							"abbreviatedName": "CA"
						},
						"postalCode": "94110",
						"streetAddress": {
							"line1": "492 Koller St",
							"line2": null
						}
					}
				},
				"domesticUltimate": {
					"duns": "804735132",
					"primaryName": "Gorman Manufacturing Company, Inc.",
					"primaryAddress": {
						"addressCountry": {
							"name": "United States",
							"isoAlpha2Code": "US"
						},
						"continentalRegion": {
							"name": "North America"
						},
						"addressLocality": {
							"name": "San Francisco"
						},
						"addressRegion": {
							"name": "California",
							"abbreviatedName": "CA"
						},
						"postalCode": "94110",
						"streetAddress": {
							"line1": "492 Koller St",
							"line2": null
						}
					}
				},
				"parent": {},
				"headQuarter": {}
			}
		},
		"blockIDs": [
			"companyinfo_L1_v1", "principalscontacts_L1_v1", "hierarchyconnections_L1_v1"
		],
		"inLanguage": "en-US",
		"blockStatus": [
			{
				"blockID": "companyinfo_L1_v1",
				"status": "ok",
				"reason": null
			}, {
				"blockID": "principalscontacts_L1_v1",
				"status": "ok",
				"reason": null
			}, {
				"blockID": "hierarchyconnections_L1_v1",
				"status": "ok",
				"reason": null
			}, {
				"blockID": "baseinfo_L1_v1",
				"status": "ok",
				"reason": null
			}
		]
	}
}