Unify and manage your data

Get Match Mapping

Learn about the endpoint to get D&B match mappings.

Request

GET: {dnbConnectorUrl}/config/profiles/{profile}/mappings/match
Table 1. Parameters
Parameter Name RequiredDescription
HeadersContent-TypeYesShould be Content-Type:application/json
HeadersAuthorizationYesReltio access token in the form Bearer: <<token>>, see Authentication API.
PathProfileYesProfile Name.
QueryPlusNo Use Direct+ mapping. Default value: true

Response

HTTP CODE:
Success: 200
 [
  {
    "operation": "shift",
    "spec": {
      "data": {
        "GetCleanseMatchResponse": {
          "GetCleanseMatchResponseDetail": {
            "MatchResponseDetail": {
              "MatchCandidate": {
                "*": {
                  "@(6,context.goldenId)": [
                    "[&1].crosswalks[0].goldenId",
                    "[&1].attributes.entityURI[].value"
                  ],
                  "@(6,context.dtssCustomerTenantId)": "[&1].attributes.DtssCustomerTenantId[].value",
                  "@(6,context.entityType)": "[&1].type",
                  "#DnB": "[&1].attributes.DnBType[].value",
                  "#Real Time": "[&1].attributes.DnBSource[].value",
                  "DUNSNumber": [
                    "[&1].attributes.DUNSNumber[].value",
                    "[&1].crosswalks[0].dunsvalue"
                  ],
                  "OrganizationPrimaryName": {
                    "OrganizationName": {
                      "\\$": "[&3].attributes.Name[].value"
                    }
                  },
                  "PrimaryAddress": {
                    "StreetAddressLine": {
                      "0": {
                        "LineText": "[&4].attributes.Address[0].value.AddressLine1[].value"
                      },
                      "1": {
                        "LineText": "[&4].attributes.Address[0].value.AddressLine2[].value"
                      },
                      "@(1,PrimaryTownName)": "[&3].attributes.Address[0].value.City[].value",
                      "@(1,CountryISOAlpha2Code)": "[&3].attributes.Address[0].value.Country[].value",
                      "@(1,PostalCode)": "[&3].attributes.Address[0].value.Zip[].value.PostalCode[].value",
                      "@(1,TerritoryAbbreviatedName)": "[&3].attributes.Address[0].value.StateProvince[].value",
                      "#Shipping": "[&3].attributes.Address[0].value.AddressType[].value",
                      "#true": "[&3].attributes.Address[0].value.Primary[].value"
                    }
                  },
                  "MailingAddress": {
                    "StreetAddressLine": {
                      "0": {
                        "LineText": "[&4].attributes.Address[1].value.AddressLine1[].value"
                      },
                      "1": {
                        "LineText": "[&4].attributes.Address[1].value.AddressLine2[].value"
                      },
                      "@(1,PrimaryTownName)": "[&3].attributes.Address[1].value.City[].value",
                      "@(1,CountryISOAlpha2Code)": "[&3].attributes.Address[1].value.Country[].value",
                      "@(1,PostalCode)": "[&3].attributes.Address[1].value.Zip[].value.PostalCode[].value",
                      "@(1,TerritoryAbbreviatedName)": "[&3].attributes.Address[1].value.StateProvince[].value",
                      "#Mailing": "[&3].attributes.Address[1].value.AddressType[].value"
                    }
                  },
                  "OperatingStatusText": {
                    "\\$": "[&2].attributes.OrganizationDetail[0].value.OperatingStatus[].value"
                  },
                  "FamilyTreeMemberRole": {
                    "*": {
                      "FamilyTreeMemberRoleText": {
                        "\\$": "[&4].attributes.OrganizationDetail[0].value.MemberRole[].value"
                      }
                    }
                  },
                  "StandaloneOrganizationIndicator": "[&1].attributes.IsStandaloneOrganization[].value",
                  "MatchQualityInformation": {
                    "ConfidenceCodeValue": {
                      "10|9": {
                        "$": "[&4].attributes.MatchQuality[0].value.ConfidenceCode[].value",
                        "@(3,OperatingStatusText)": {
                          "\\$": {
                            "Active": {
                              "#true": "[&7].attributes.AutoMatchFlag[].value"
                            },
                            "*": {
                              "#true": "[&7].attributes.SuspectMatchFlag[].value"
                            }
                          }
                        }
                      },
                      "8|7|6|5": {
                        "#true": "[&4].attributes.SuspectMatchFlag[].value",
                        "$": "[&4].attributes.MatchQuality[0].value.ConfidenceCode[].value"
                      },
                      "*": {
                        "$": "[&4].attributes.MatchQuality[0].value.ConfidenceCode[].value"
                      }
                    },
                    "MatchGradeText": "[&2].attributes.MatchQuality[0].value.MatchGradeText[].value",
                    "MatchDataProfileText": "[&2].attributes.MatchQuality[0].value.MatchDataProfileText[].value"
                  },
                  "TelephoneNumber": {
                    "TelecommunicationNumber": "[&2].attributes.Phone[0].value.Number[].value",
                    "#Phone": "[&2].attributes.Phone[0].value.Type[].value",
                    "#true": "[&2].attributes.Phone[0].value.PrimaryPhoneFlag[].value"
                    // no available in contract
                    //,"UnreachableIndicator": "[&2].attributes.Phone[&1].value.Unreachable[].value"
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  {
    "operation": "modify-default-beta",
    "spec": {
      "*": {
        "crosswalks": {
          "*": {
            "type": "configuration/sources/DnB",
            "value": "=concat(@(3,attributes.DUNSNumber[0].value),'-',@(1,goldenId))"
          }
        }
      }
    }
  },
  {
    "operation": "remove",
    "spec": {
      "*": {
        "crosswalks": {
          "*": {
            "goldenId": "",
            "dunsvalue": ""
          }
        }
      }
    }
  }
]

Errors

400 Bad Request
500 Internal Server Error