Skip to content

DNB API (1)

This API provides services to access records from DNB and calculate their Commercial Ultimates.

Overview
URL

https://www.cdq.ch/team

Michał Dunat

michal.dunat@cdq.com

Languages
Servers
Mock server

https://idp.cdq.com/_mock/apis/dnb-api/api-v1/

Production SOAP

https://api.corporate-data-league.ch/dnb/soap/v1/

Production

https://api.corporate-data-league.ch/dnb/

Registrations

Operations

Identification

Operations

Identity Resolution

Request

Performs Identity Resolution.

Bodyapplication/jsonrequired

cmd

dunsstring(Duns)

DUNS number.

Example: "123456789"
identifierRequestsArray of objects(IdentifierRequests)

Identifier requests.

companyNamesArray of strings(CompanyNames)

Company names.

Example: ["C.M.O.T Dibbler."]
userstring(User)

User name.

Example: "john"
countrystring(CountryValue)

Country name (ISO 3166-1 alpha-2).

Example: "Switzerland"
postalCodestring(PostCodeValue)

Effective post code.

Example: "9000"
localitystring(LocalityValue)

Name of the Locality.

Example: "Sankt Gallen"
thoroughfarestring(ThoroughfareValue)

Comprehensive designation of the Thoroughfare including the thoroughfare type such as Street, or Rue.

Example: "Lukasstraße 4"
registrationNumberstring(RegistrationNumber)

Registration number.

Example: "123456789"
sourceIdentifierstring(SourceIdentifier)

Source identifier of dnb source which credentials should be used in lookup.

Enum ValueDescription
DNB.MASTER.DATA.BASIC

Use credentials for DNB Master Data Basic.

DNB.MASTER.DATA.EXTENDED

Use credentials for DNB Master Data Extended.

DNB.MASTER.DATA.MGMT

Use credentials for DNB Master Data Management.

DNB.MASTER.DATA.LNKG

Use credentials for DNB Master Data Linkage.

DNB.LINKAGE.LNKELI

Use credentials for DNB Linkage LNKELI.

DNB

Use credentials for CMPLEK.

Example: "DNB.MASTER.DATA.EXTENDED"
curl -i -X POST \
  https://idp.cdq.com/_mock/apis/dnb-api/api-v1/dnb/lookup \
  -H 'Content-Type: application/json' \
  -d '{
    "duns": "123456789",
    "identifierRequests": [
      {
        "type": "DUNS",
        "value": "1234",
        "issuingBodyTechnicalKey": "Amtsgericht Aachen",
        "issuingBodyName": "Amtsgericht Aachen"
      }
    ],
    "companyNames": [
      "C.M.O.T Dibbler."
    ],
    "user": "john",
    "country": "Switzerland",
    "postalCode": "9000",
    "locality": "Sankt Gallen",
    "thoroughfare": "Lukasstraße 4",
    "registrationNumber": "123456789",
    "sourceIdentifier": "DNB.MASTER.DATA.EXTENDED"
  }'

Responses

OK

Bodyapplication/json
responsesArray of objects(IdentityResolutionResponses)

Identity Resolution output.

Response
application/json
{
  "responses": [
    { … }
  ]
}

Setup

Operations

Data Retrieval

Operations

Configurations

Operations

Configuration

Operations