home

Developer resources

ReltioProductsDeveloper resourcesRolesApplicationsObjectives
ReltioProductsDeveloper resourcesRolesApplicationsObjectives

Unify and manage your data

Show Contents

thumbnailDeveloper resources

D&B Connector APIs

Save Batch Mapping

Learn about the operation to save batch mappings.

Request

POST: {dnbConnectorUrl}/config/profiles/{profile}/mappings/batch
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

BodyYes

Batch mapping JSON

Body

[ { "operation": "shift", "spec": { "embeddedProduct": { "organization": "organization" }, "matchCandidates": { "0": { "matchQualityInformation": { "confidenceCode": "confidenceCode" } } } } }, { "operation": "shift", "spec": { "confidenceCode": "[4].attributes.MatchQuality[0].value.ConfidenceCode[].value", "organization": { "#configuration/sources/DnB": "[4].crosswalks[0].type", "#Batch Plus": "[4].attributes.DnBSource[].value", "duns": ["[4].attributes.DUNSNumber[].value", "[4].crosswalks[0].value"], "dunsControlStatus": { "isMarketable": "[4].attributes.MarketabilityIndicator[].value", "lastUpdateDate": "[4].attributes.DnBLastUpdateDate[].value", "operatingStatus": { "description": ["[4].attributes.OrganizationDetail[0].value.OperatingStatusComment[].value", "[4].attributes.OrganizationDetail[0].value.OperatingStatus[].value"] } }, "primaryName": "[4].attributes.Name[].value", "tradeStyleNames": { "*": { "name": "[4].attributes.TradeStyleName[&1].value.OrganizationName[].value" } }, "telephone": { "*": { "telephoneNumber": "[5].sa.Phone[&1].value.Number[].value", "isUnreachable": "[5].sa.Phone[&1].value.Unreachable[].value", "isdCode": "[5].sa.Phone[&1].value.CountryCode[].value", "#Phone": "[5].sa.Phone[&1].value.Type[].value", "#true": "[5].sa.Phone[&1].value.PrimaryPhoneFlag[].value" } }, "fax": { "*": { "faxNumber": "[5].ma.Phone[&1].value.Number[].value", "isUnreachable": "[5].ma.Phone[&1].value.Unreachable[].value", "isdCode": "[5].ma.Phone[&1].value.CountryCode[].value", "#Fax": "[5].ma.Phone[&1].value.Type[].value", "#true": "[5].ma.Phone[&1].value.PrimaryPhoneFlag[].value" } }, "websiteAddress": { "*": { "url": "[4].attributes.WebsiteURL[].value" } }, "isStandalone": "[4].attributes.OrganizationDetail[0].value.Standalone[].value", "controlOwnershipDate": "[4].attributes.OrganizationDetail[0].value.OwnershipDate[].value", "controlOwnershipType": { "description": "[4].attributes.OrganizationDetail[0].value.OwnershipType[].value" }, "startDate": "[4].attributes.OrganizationDetail[0].value.StartYear[].value", "primaryAddress": { "streetAddress": { "line1": "[5].sa.Addresses[0].value.AddressLine1[].value", "line2": "[5].sa.Addresses[0].value.AddressLine2[].value", "#Shipping": "[5].sa.Addresses[0].value.AddressType[].value", "#true": "[5].sa.Addresses[0].value.Primary[].value", "@(1,postalCode)": "[5].sa.Addresses[0].value.PostalCode[].value", "@(1,addressLocality)": { "name": "[5].sa.Addresses[0].value.City[].value" }, //"@(1,TerritoryOfficialName)": "[5].sa.Addresses[&2].value.StateProvince[].value", "@(1,addressRegion)": { "name": "[5].sa.Addresses[0].value.StateProvince[].value" }, "@(1,latitude)": "[5].sa.Addresses[0].value.DnBLatitude[].value", "@(1,longitude)": "[5].sa.Addresses[0].value.DnBLongitude[].value", "@(1,isRegisteredAddress)": "[5].sa.Addresses[0].value.Registered[].value", "@(1,isResidentialAddress)": "[5].sa.Addresses[0].value.Residential[].value", //"@(1,CountryISOAlpha2Code)": "[5].sa.Addresses[&2].value.Country[].value", "@(1,addressCountry)": { "name": "[5].sa.Addresses[0].value.Country[].value" } } }, "mailingAddress": { "streetAddress": { "line1": "[5].ma.Addresses[0].value.AddressLine1[].value", "line2": "[5].ma.Addresses[0].value.AddressLine2[].value", "#Mailing": "[5].ma.Addresses[0].value.AddressType[].value", "@(1,postalCode)": "[5].ma.Addresses[0].value.PostalCode[].value", "@(1,addressLocality)": { "name": "[5].ma.Addresses[0].value.City[].value" }, "@(1,addressRegion)": { "name": "[5].ma.Addresses[0].value.StateProvince[].value" }, "@(1,latitude)": "[5].ma.Addresses[0].value.DnBLatitude[].value", "@(1,longitude)": "[5].ma.Addresses[0].value.DnBLongitude[].value", "@(1,isRegisteredAddress)": "[5].ma.Addresses[0].value.Registered[].value", "@(1,isResidentialAddress)": "[5].ma.Addresses[0].value.Residential[].value", "@(1,addressCountry)": { "name": "[5].ma.Addresses[0].value.Country[].value" } } }, "financials": { "*": { "financialStatementToDate": "[4].attributes.KeyFinancialFiguresOverview[&1].value.FinancialStatementToDate[].value", "financialStatementDuration": "[4].attributes.KeyFinancialFiguresOverview[&1].value.FinancialPeriodDuration[].value", "yearlyRevenue": { "*": { "value": "[4].attributes.KeyFinancialFiguresOverview[&3].value.SalesRevenueAmount[&1].value", "currency": "[4].attributes.KeyFinancialFiguresOverview[&3].value.SalesRevenueCurrencyCode[&1].value" } } } }, "industryCodes": { "*": { "code": "[4].attributes.IndustryCode[&1].value.IndustryCode[].value", "description": "[4].attributes.IndustryCode[&1].value.IndustryCodeDescription[].value", "typeDescription": "[4].attributes.IndustryCode[&1].value.Type[].value", "typeDnBCode": "[4].attributes.IndustryCode[&1].value.DNBCode[].value" } }, "isImporter": "[4].attributes.ActivitiesAndOperations[0].value.ImportIndicator[].value", "isExporter": "[4].attributes.ActivitiesAndOperations[0].value.ExportIndicator[].value", "isAgent": "[4].attributes.ActivitiesAndOperations[0].value.AgentIndicator[].value", "numberOfEmployees": { "*": { "value": "[4].attributes.EmployeeDetails[&1].value.IndividualTotalEmployeeQuantity[].value", "reliabilityDescription": "[4].attributes.EmployeeDetails[&1].value.IndividualReliabilityText[].value" } }, "businessEntityType": { "description": "[4].attributes.LegalStatusCode[].value" }, "registrationNumbers": { "*": { "registrationNumber": "[4].attributes.Identifiers[&1].value.ID[].value", "typeDescription": "[4].attributes.Identifiers[&1].value.Type[].value" } }, "corporateLinkage": { "familytreeRolesPlayed": { "*": { "description": "[4].attributes.OrganizationDetail[0].value.MemberRole[].value" } }, "globalUltimate": { "duns": { "@": [ "[0].attributes.DUNSNumber[].value", "[4].attributes.DUNSHierarchy[0].value.GlobalUltimateDUNS[].value", "[0].crosswalks[0].value" ], "#configuration/entityTypes/Organization": "[0].type", "#configuration/sources/DnB": "[0].crosswalks[0].type", "#DnB Linkage": "[0].attributes.VendorOrganizationType[].value", "#Batch Plus": "[0].attributes.DnBSource[].value", "@(1,primaryName)": ["[0].attributes.Name[0].value", "[4].attributes.DUNSHierarchy[0].value.GlobalUltimateOrganization[].value"], "@(1,primaryAddress)": { "streetAddress": { "line1": "[0].attributes.Addresses[0].value.AddressLine1[].value", "line2": "[0].attributes.Addresses[0].value.AddressLine2[].value", "#Shipping": "[0].attributes.Addresses[0].value.AddressType[].value", "#true": "[0].attributes.Addresses[0].value.Primary[].value", "@(1,postalCode)": "[0].attributes.Addresses[0].value.PostalCode[].value", "@(1,addressLocality)": { "name": "[0].attributes.Addresses[0].value.City[].value" }, "@(1,addressRegion)": { "name": "[0].attributes.Addresses[0].value.StateProvince[].value" }, "@(1,addressCountry)": { "name": "[0].attributes.Addresses[0].value.Country[].value" } } } } }, "domesticUltimate": { "duns": { "@": [ "[1].attributes.DUNSNumber[].value", "[4].attributes.DUNSHierarchy[0].value.DomesticUltimateDUNS[].value", "[1].crosswalks[0].value" ], "#configuration/entityTypes/Organization": "[1].type", "#configuration/sources/DnB": "[1].crosswalks[0].type", "#DnB Linkage": "[1].attributes.VendorOrganizationType[].value", "#Batch Plus": "[1].attributes.DnBSource[].value", "@(1,primaryName)": ["[1].attributes.Name[0].value", "[4].attributes.DUNSHierarchy[0].value.DomesticUltimateOrganization[].value"], "@(1,primaryAddress)": { "streetAddress": { "line1": "[1].attributes.Addresses[0].value.AddressLine1[].value", "line2": "[1].attributes.Addresses[0].value.AddressLine2[].value", "#Shipping": "[1].attributes.Addresses[0].value.AddressType[].value", "#true": "[1].attributes.Addresses[0].value.Primary[].value", "@(1,postalCode)": "[1].attributes.Addresses[0].value.PostalCode[].value", "@(1,addressLocality)": { "name": "[1].attributes.Addresses[0].value.City[].value" }, "@(1,addressRegion)": { "name": "[1].attributes.Addresses[0].value.StateProvince[].value" }, "@(1,addressCountry)": { "name": "[1].attributes.Addresses[0].value.Country[].value" } } } } }, "headQuarter": { "duns": { "@": [ "[2].attributes.DUNSNumber[].value", "[4].attributes.DUNSHierarchy[0].value.HeadquartersDUNS[].value", "[2].crosswalks[0].value" ], "#configuration/entityTypes/Organization": "[2].type", "#configuration/sources/DnB": "[2].crosswalks[0].type", "#DnB Linkage": "[2].attributes.VendorOrganizationType[].value", "#Batch Plus": "[2].attributes.DnBSource[].value", "@(1,primaryName)": ["[2].attributes.Name[0].value", "[4].attributes.DUNSHierarchy[0].value.HeadquartersOrganization[].value"], "@(1,primaryAddress)": { "streetAddress": { "line1": "[2].attributes.Addresses[0].value.AddressLine1[].value", "line2": "[2].attributes.Addresses[0].value.AddressLine2[].value", "#Shipping": "[2].attributes.Addresses[0].value.AddressType[].value", "#true": "[2].attributes.Addresses[0].value.Primary[].value", "@(1,postalCode)": "[2].attributes.Addresses[0].value.PostalCode[].value", "@(1,addressLocality)": { "name": "[2].attributes.Addresses[0].value.City[].value" }, "@(1,addressRegion)": { "name": "[2].attributes.Addresses[0].value.StateProvince[].value" }, "@(1,addressCountry)": { "name": "[2].attributes.Addresses[0].value.Country[].value" } } } } }, "parent": { "duns": { "@": [ "[3].attributes.DUNSNumber[].value", "[4].attributes.DUNSHierarchy[0].value.ParentDUNS[].value", "[3].crosswalks[0].value" ], "#configuration/entityTypes/Organization": "[3].type", "#configuration/sources/DnB": "[3].crosswalks[0].type", "#DnB Linkage": "[3].attributes.VendorOrganizationType[].value", "#Batch Plus": "[3].attributes.DnBSource[].value", "@(1,primaryName)": ["[3].attributes.Name[0].value", "[4].attributes.DUNSHierarchy[0].value.ParentOrganization[].value"], "@(1,primaryAddress)": { "streetAddress": { "line1": "[3].attributes.Addresses[0].value.AddressLine1[].value", "line2": "[3].attributes.Addresses[0].value.AddressLine2[].value", "#Shipping": "[3].attributes.Addresses[0].value.AddressType[].value", "#true": "[3].attributes.Addresses[0].value.Primary[].value", "@(1,postalCode)": "[3].attributes.Addresses[0].value.PostalCode[].value", "@(1,addressLocality)": { "name": "[3].attributes.Addresses[0].value.City[].value" }, "@(1,addressRegion)": { "name": "[3].attributes.Addresses[0].value.StateProvince[].value" }, "@(1,addressCountry)": { "name": "[3].attributes.Addresses[0].value.Country[].value" } } } } } } } } }, { "operation": "shift", "spec": { "0": { "type": "[0].type", "crosswalks": "[0].crosswalks", "attributes": "[0].attributes" }, "1": { "type": "[1].type", "crosswalks": "[1].crosswalks", "attributes": "[1].attributes" }, "2": { "type": "[2].type", "crosswalks": "[2].crosswalks", "attributes": "[2].attributes" }, "3": { "type": "[3].type", "crosswalks": "[3].crosswalks", "attributes": "[3].attributes" }, "4": { "type": "[4].type", "crosswalks": "[4].crosswalks", "attributes": "[4].attributes" }, "5": { "ma": { "Addresses": { "*": "[4].attributes.Addresses[]" }, "Phone": { "*": "[4].attributes.Phone[]" } }, "sa": { "Addresses": { "*": "[4].attributes.Addresses[]" }, "Phone": { "*": "[4].attributes.Phone[]" } } } } }, { "operation": "com.reltio.account360.connector.dnb.mappings.SetFinancialStatementToDate" }, // section below doesn't make useful actions - only replaces null to { "attributes": {}} - empty organization // why? - we need it in case when only one organization here and other are null - in this case last modifier will // create array[] instead of array[array[]] and crash conversion to List<List<>> { "operation": "modify-overwrite-beta", "spec": { "*": { "attributes": { "SomeValue": { "*": { "value": "&" } } } } } }, { "operation": "shift", "spec": { "*": "[0]" } } ]

Response

HTTP CODE: Success: 200 Errors: 400 Bad Request 404 Not Found 500 Internal Server Error

Updated on December 9, 2024

Footer

You've found your way to a temporary environment. Content is not complete or final. Looking for Reltio documentation? Go to docs.reltio.com.

Company

Leadership

Careers

Awards

Contact Us

Reltio Newsroom

Press Releases

Media Coverage

Media & Analyst Resources

Customer Support

Support

Reltio Learn

Community

Developer Portal

100 Marine Parkway, Suite 275

Redwood Shores, CA 94065

USA

North America: +1(855)360-3282

Europe: +44(800)368-7643

Email: sales@reltio.com

© 2025 The RELTIO® mark is a registered trademark of Reltio, Inc. in the United States and other countries; DataDriven and Reltio Data Cloud are trademarks of Reltio, Inc. Other names or marks are trademarks of their respective owners.

Terms, Privacy Policy, and