Start DNB Import Job

To start a D&B Import Job use the following request

curl -X POST \
  --url 'https://api.corporate-data-league.ch/data-exchange/rest/jobs/dnbimportjobs?dnbUser=optional&dnbPassword=optional' \
  -u 'BasicAuthUserName:your_credentials'\
  -H 'Accept: application/json' \
  -F 'file=@your_file.csv'

with using this sample file:

DUNS
305211311
DNB:305211311

The file can be a csv or xlsx. The file should contain only one column with the DUNS number. In the first row should the header DUNS. The DUNS number can be in following forms:

  • As CDQ-ID. Example or DNB:305211311
  • as raw DUNS 305211311

The DUNS consist of 9 digits. When the input DUNS does not consist of 9 digits, leading zeros are added.

SecurityapiKey
Request
query Parameters
description
string (JobDescription)

Description of the job.

Example: description=I started this job to improve quality of our data.
dnbDataSource
string (DnbStorageTechnicalKeyParam)

D&B product that should be downloaded from D&B and put into specific D&B storage.

Enum: Description
DNB

Storage for D&B data product Company Profile, Linkage, and Executives (CMPELK)

DNB_MASTER_DATA_BASIC

Storage for D&B data product Master Data Basic

DNB_MASTER_DATA_MGMT

Storage for D&B data product Master Data Mgmt

DNB_MASTER_DATA_LNKG

Storage for D&B data product Master Data Lnkg

DNB_MASTER_DATA_EXTENDED

Storage for D&B data product Master Data Extended

DNB_LINKAGE_LNKELI

Storage for D&B data product Extended Linkage Insight

Example: dnbDataSource=DNB_MASTER_DATA_BASIC
dnbPassword
string

Optional, if credentials are available in user or organization settings.

Example: dnbPassword=password
dnbUser
string

Optional, if credentials are available in user or organization settings.

Example: dnbUser=username
featuresOn
Array of strings (DnbImportJobFeature)

Feature to be activated.

Items Enum: Description
ENRICH_COMMERCIAL_ULTIMATE

Enriches Commercial Ultimate.

ENABLE_PARTIAL_QUOTA_CONSUMPTION

Enables to run import job on a remaining quota when full quota not available.

SKIP_DNB_IMPORT

Skips requesting D&B data from D&B services. Can be used to enrich only Commercial Ultimate.

INCREMENT

Continue processing after the last processed result with a goal to run on newly created Business Partners from a Business Partner Storage.

ACTIVATE_MASTER_DATA_EXTENDED

Enables to use data blocks instead of cmplek when fetching data from DNB.

Example: featuresOn=ENRICH_COMMERCIAL_ULTIMATE
name
string (JobName)

Name of the job.

Example: name=Process vendor data.
Request Body schema: multipart/form-data
file
string <binary>

XLSX or CSV file to be uploaded, containing mandatory DUNS column (SOAP currently only supports CSV).

Example: "CH-import.csv"
Responses
200

OK

400

The sent request is malformed.

post/jobs/dnbimportjobs
Request samples 
Response samples 
application/json
{
  • "id": "35f23c03-1c22-45fe-9484-3ffe769325de",
  • "name": "Process vendor data.",
  • "description": "I started this job to improve quality of our data.",
  • "progress": "77",
  • "status": "RUNNING",
  • "statusMessage": "Job is running",
  • "createdBy": "76248934691294444",
  • "createdAt": "2025-04-25T09:09:11Z",
  • "modifiedAt": "2025-04-25T09:09:11Z",
  • "result": {
    }
}