Fetch DNB RecordWSDLDeprecated

Fetch D&B record by CDQ-ID. It is possible to read:

  • legacy CMPELK data
  • Data Blocks defined here

Fetch CMPELK

To fetch the CMPELK object no features have to be activated.

POST /dnb/businesspartners/fetch
{
  "cdqId": "DNB:123456789"
}

Fetch Data Blocks

It is possible to read pre-defined Data Blocks

Fetch pre-defined Data Blocks

There are 2 features with pre-defined data blocks:

  • ACTIVATE_MASTER_DATA_BASIC uses following data blocks:
    • COMPANYINFO_L1_V1
  • ACTIVATE_MASTER_DATA_EXTENDED uses following data blocks:
    • COMPANYINFO_L1_V1
    • COMPANYINFO_L2_V1
    • HIERARCHYCONNECTIONS_L1_V1
    • PRINCIPALSCONTACTS_L2_V2
POST /dnb/businesspartners/fetch
{
  "cdqId": "DNB:123456789",
  "featuresOn": [
    "ACTIVATE_MASTER_DATA_BASIC"
  ]
}

Fetch LNKELI

It is possible to fetch LNKELI data:

POST /dnb/businesspartners/fetch
{
  "cdqId": "DNB:123456789",
  "featuresOn": [
    "ACTIVATE_LINKAGE_LNKELI"
  ]
}
SecurityapiKey
Request
header Parameters
X-DNB-PASSWORD
string

Dnb Consumer Secret.

Example: dnb_consumer_key
X-DNB-USER
string

Dnb Consumer Key.

Example: dnb_consumer_key
Request Body schema:
required
cdqId
string

Unique identifier for the Business Partner.

Example: "VIES:PL8660001429"
featuresOff
Array of strings (DnbFetchFeature)

List of features to be deactivated.

Items Enum: Description
ACTIVATE_MASTER_DATA_BASIC

Use basic set of datablocks to fetch data.

ACTIVATE_MASTER_DATA_EXTENDED

Use extended set of datablocks to fetch data.

ACTIVATE_MASTER_DATA_MGMT

Use management set of datablocks to fetch data.

ACTIVATE_MASTER_DATA_LNKG

Use linkage set of datablocks to fetch data.

ACTIVATE_LINKAGE_LNKELI

Fetch LNKELI data.

ACTIVATE_DATASOURCE_DNB_STORAGE

Checks storage and skips call to D&B if results were found.

ACTIVATE_DATASOURCE_DNB_STORAGE_ONLY

Skips call to D&B entirely and only checks storage for results.

ENRICH_COMMERCIAL_ULTIMATE

Uses additional cmpelk calls to load whole organization hierarchy and detect global ultimate.

ENABLE_SETTINGS

Apply rules stored in organizational settings during curation.

SHOW_CDQ_RECORD

Return also Dnb record mapped to cdq model.

DETECT_LEGAL_ENTITY

Finds out whether requested DUNS is a branch or headquarter.

ENRICH_DOMESTIC_COMMERCIAL_ULTIMATE

Calculates Domestic Ultimate hierarchy.

Example: ["ACTIVATE_MASTER_DATA_BASIC"]
featuresOn
Array of strings (DnbFetchFeature)

List of features to be activated.

Items Enum: Description
ACTIVATE_MASTER_DATA_BASIC

Use basic set of datablocks to fetch data.

ACTIVATE_MASTER_DATA_EXTENDED

Use extended set of datablocks to fetch data.

ACTIVATE_MASTER_DATA_MGMT

Use management set of datablocks to fetch data.

ACTIVATE_MASTER_DATA_LNKG

Use linkage set of datablocks to fetch data.

ACTIVATE_LINKAGE_LNKELI

Fetch LNKELI data.

ACTIVATE_DATASOURCE_DNB_STORAGE

Checks storage and skips call to D&B if results were found.

ACTIVATE_DATASOURCE_DNB_STORAGE_ONLY

Skips call to D&B entirely and only checks storage for results.

ENRICH_COMMERCIAL_ULTIMATE

Uses additional cmpelk calls to load whole organization hierarchy and detect global ultimate.

ENABLE_SETTINGS

Apply rules stored in organizational settings during curation.

SHOW_CDQ_RECORD

Return also Dnb record mapped to cdq model.

DETECT_LEGAL_ENTITY

Finds out whether requested DUNS is a branch or headquarter.

ENRICH_DOMESTIC_COMMERCIAL_ULTIMATE

Calculates Domestic Ultimate hierarchy.

Example: ["ACTIVATE_MASTER_DATA_BASIC"]
Responses
200

OK

201

Created

401

Unauthorized

403

Forbidden

404

Not Found

post/dnb/businesspartners/fetch
Request samples
{
  • "cdqId": "VIES:PL8660001429",
  • "featuresOn": [
    ],
  • "featuresOff": [
    ]
}
Response samples
{
  • "cmpelkV2": {
    },
  • "dataBlock": {
    },
  • "lnkeli": {
    },
  • "commercialUltimate": {
    },
  • "cdqRecord": {
    },
  • "cdqCommercialUltimate": {
    },
  • "legalEntity": {
    },
  • "status": "OK",
  • "message": "Service returned a correct response"
}