Skip to content

Referencedata API (3)

This API provides services to search and read reference data

Download OpenAPI description
api-v3.json
api-v3.yaml
Languages
Servers
Mock server

https://developer.cdq.com/_mock/apis/referencedata-api/api-v3/

Production

https://api.cdq.com/referencedata/rest/

Business Partners

Everything about Business Partners

Operations

Addresses

Everything about Addresses

Analytics

Everything about reference data analytics

Configurations

Operations

Configuration

Operations

Processing Logs

Operations

Batch Lookup

Operations

Read DNB Lookup Job results

Request

Reads the results of a DNB lookup job by job ID.

Security
apiKey
Path
idstringrequired

ID of the lookup job.

Example: cbed7ac6-a97d-4c23-9060-2a88fa660957
Query
businessPartnerIdArray of strings(BusinessPartnerId)

Business Partner IDs which should be filtered.

Example: businessPartnerId=63e635235c06b7396330fe40
startAfterstring

Only records with an ID greater than this ID will be fetched.

Default "0"
Example: startAfter=5712566172571652
limitinteger(int32)[ 1 .. 100 ]

Number of results that should be fetched. Maximum 100 results can be returned in one page.

Default 100
Example: limit=50
curl -i -X GET \
  https://developer.cdq.com/_mock/apis/referencedata-api/api-v3/dnb/lookupjobs/cbed7ac6-a97d-4c23-9060-2a88fa660957/results \
  -H 'X-API-KEY: YOUR_API_KEY_HERE'

Responses

OK

Bodyapplication/json
startAfterstring(StartAfter)

The ID which is used to read the page.

Example: "5712566172571652"
nextStartAfterstring(NextStartAfter)

Provides a value to be used as a startAfter in next page request.

Example: "5712566172571652"
limitinteger(Limit)

Number of items per page.

Example: "100"
totalinteger(PageTotal)

Total number of items which can be paged.

Example: "67"
valuesArray of objects(DnbLookupJobItemResult)

List of DNB Lookup Job results.

Response
application/json
{
  "startAfter": "5712566172571652",
  "nextStartAfter": "5712566172571652",
  "limit": "100",
  "total": "67",
  "values": [
    { … }
  ]
}

Start DNB Lookup Job

Request

Initialisation of a DNB lookup job. The job will be executed asynchronously. The response contains the job ID which can be used to poll for the status of the job.

Security
apiKey
Bodyapplication/jsonrequired

cmd

storageIdstring(BusinessPartnerStorageId)

Unique identifier of the Storage.

Example: "72d6900fce6b326088f5d9d91049e3e6"
dnbUserstring

Optional if credentials are available in user or organization settings.

Example: "myDnbUser"
dnbPasswordstring

Optional if credentials are available in user or organization settings.

Example: "myDnbPassword"
modestring

MATCH contains just the match results while EXTENDED_MATCH also includes D&B products (attention increased costs)

Enum"EXTENDED_MATCH""MATCH"
Example: "EXTENDED_MATCH"
featuresOnArray of strings(DnbLookupJobFeature)

List of features to be activated in the lookup.

Items Enum ValueDescription
INCREMENT

Continue processing after the last processed result with a goal to run on newly created business partners from a storage.

ENABLE_PARTIAL_QUOTA_CONSUMPTION

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

ACTIVATE_MASTER_DATA_EXTENDED

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

SKIP_DNB_IMPORT

If it is not used, all DUNS will be fetched from DNB. Should be used in combination with ENRICH_COMMERCIAL_ULTIMATE to only load what is needed for commercial ultimate calculation.

ENRICH_COMMERCIAL_ULTIMATE

Calculate commercial ultimate for each business partner in storage.

Example: ["INCREMENT"]
featuresOffArray of strings(DnbLookupJobFeature)

List of features to be deactivated in the lookup.

Items Enum ValueDescription
INCREMENT

Continue processing after the last processed result with a goal to run on newly created business partners from a storage.

ENABLE_PARTIAL_QUOTA_CONSUMPTION

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

ACTIVATE_MASTER_DATA_EXTENDED

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

SKIP_DNB_IMPORT

If it is not used, all DUNS will be fetched from DNB. Should be used in combination with ENRICH_COMMERCIAL_ULTIMATE to only load what is needed for commercial ultimate calculation.

ENRICH_COMMERCIAL_ULTIMATE

Calculate commercial ultimate for each business partner in storage.

Example: ["INCREMENT"]
dnbDataSourcestring

D&B name of the product to be used in the job.

Default "DNB"
Enum ValueDescription
DNB

D&B Master Data

DNB_MASTER_DATA_BASIC

D&B Master Data Basic

DNB_MASTER_DATA_PLUS_MGMT

D&B Master Data Plus Management

DNB_MASTER_DATA_PLUS_LINKAGE

D&B Master Data Plus Linkage

DNB_MASTER_DATA_EXTENDED

D&B Master Data Extended

DNB_LINKAGE_LNKELI

D&B Linkage LNKELI

Example: "DNB_MASTER_DATA_EXTENDED"
dataSourcesArray of strings(DataSources)

IDs of Data Sources in specified Data Mirror to be included during lookup. Leave empty to include all Data Dources.

Example: ["648824a691d8d2503d65103e"]
curl -i -X POST \
  https://developer.cdq.com/_mock/apis/referencedata-api/api-v3/dnb/lookupjobs \
  -H 'Content-Type: application/json' \
  -H 'X-API-KEY: YOUR_API_KEY_HERE' \
  -d '{
    "storageId": "72d6900fce6b326088f5d9d91049e3e6",
    "dnbUser": "myDnbUser",
    "dnbPassword": "myDnbPassword",
    "mode": "EXTENDED_MATCH",
    "featuresOn": [
      "INCREMENT"
    ],
    "featuresOff": [
      "INCREMENT"
    ],
    "dnbDataSource": "DNB_MASTER_DATA_EXTENDED",
    "dataSources": [
      "648824a691d8d2503d65103e"
    ]
  }'

Responses

OK

Bodyapplication/json
idstring(JobId)

Unique identifier of a job.

Example: "35f23c03-1c22-45fe-9484-3ffe769325de"
storageIdstring(BusinessPartnerStorageId)

Unique identifier of the Storage.

Example: "72d6900fce6b326088f5d9d91049e3e6"
statusstring(JobStatus)

Job execution status.

Enum ValueDescription
UNKNOWN

Job becomes in unknown status.

CREATED

Job has been created.

PERSISTED

Job metadata has been persisted.

SCHEDULED

Job has been scheduled for execution.

WAITING

Job is waiting for being scheduled.

COULDNT_START

Job could not be started.

RUNNING

Job is being executed.

FINISHED

Job has finished.

DIED

Job has died due to unhandled exceptions.

CANCELED

Job has been canceled due to invalid input configuration.

Example: "RUNNING"
createdAtstring(CreatedAt)

Date of creation (ISO 8601-compliant).

Example: "2025-09-12T14:57:59Z"
createdBystring(CreatedBy)

Creator of a resource.

Example: "76248934691294444"
progressinteger(JobProgress)[ 0 .. 100 ]

Progress (%) of the job.

Example: "77"
resultobject(DnbLookupJobResult)

Lookup Job result for D&B data.

modifiedAtstring(ModifiedAt)

Date of modification (ISO 8601-compliant).

Example: "2025-09-12T14:57:59Z"
statusMessagestring(JobStatusMessage)

Additional information to explain the status.

Example: "The job failed because storage is empty."
Response
application/json
{
  "id": "35f23c03-1c22-45fe-9484-3ffe769325de",
  "storageId": "72d6900fce6b326088f5d9d91049e3e6",
  "status": "RUNNING",
  "createdAt": "2025-09-12T14:57:59Z",
  "createdBy": "76248934691294444",
  "progress": "77",
  "result": {
    "statistics": { … }
  },
  "modifiedAt": "2025-09-12T14:57:59Z",
  "statusMessage": "The job failed because storage is empty."
}

Poll DNB Lookup Job

Request

After you have started a curation job, you will receive a job id in the response: { 'id' : '' } Use this ID to poll for the status of the job using this endpoint. Once the status is FINISHED, you can download the results.

Security
apiKey
Path
idstringrequired

ID of the DNB lookup job.

Example: cbed7ac6-a97d-4c23-9060-2a88fa660957
curl -i -X GET \
  https://developer.cdq.com/_mock/apis/referencedata-api/api-v3/dnb/lookupjobs/cbed7ac6-a97d-4c23-9060-2a88fa660957 \
  -H 'X-API-KEY: YOUR_API_KEY_HERE'

Responses

OK

Bodyapplication/json
idstring(JobId)

Unique identifier of a job.

Example: "35f23c03-1c22-45fe-9484-3ffe769325de"
storageIdstring(BusinessPartnerStorageId)

Unique identifier of the Storage.

Example: "72d6900fce6b326088f5d9d91049e3e6"
statusstring(JobStatus)

Job execution status.

Enum ValueDescription
UNKNOWN

Job becomes in unknown status.

CREATED

Job has been created.

PERSISTED

Job metadata has been persisted.

SCHEDULED

Job has been scheduled for execution.

WAITING

Job is waiting for being scheduled.

COULDNT_START

Job could not be started.

RUNNING

Job is being executed.

FINISHED

Job has finished.

DIED

Job has died due to unhandled exceptions.

CANCELED

Job has been canceled due to invalid input configuration.

Example: "RUNNING"
createdAtstring(CreatedAt)

Date of creation (ISO 8601-compliant).

Example: "2025-09-12T14:57:59Z"
createdBystring(CreatedBy)

Creator of a resource.

Example: "76248934691294444"
progressinteger(JobProgress)[ 0 .. 100 ]

Progress (%) of the job.

Example: "77"
resultobject(DnbLookupJobResult)

Lookup Job result for D&B data.

modifiedAtstring(ModifiedAt)

Date of modification (ISO 8601-compliant).

Example: "2025-09-12T14:57:59Z"
statusMessagestring(JobStatusMessage)

Additional information to explain the status.

Example: "The job failed because storage is empty."
Response
application/json
{
  "id": "35f23c03-1c22-45fe-9484-3ffe769325de",
  "storageId": "72d6900fce6b326088f5d9d91049e3e6",
  "status": "RUNNING",
  "createdAt": "2025-09-12T14:57:59Z",
  "createdBy": "76248934691294444",
  "progress": "77",
  "result": {
    "statistics": { … }
  },
  "modifiedAt": "2025-09-12T14:57:59Z",
  "statusMessage": "The job failed because storage is empty."
}