Decision Log

Clear Decisions

Deletes decisions of a given type. Deletes all if type not provided.

SecurityapiKey

Request

path Parameters

storageId

required

string

Request Body schema: application/json
required

	Array of objects (DecisionClearDataSourceParam)
	object (DecisionLogType)

Responses

200

400

Bad Request

post/storages/{storageId}/decisions/clear

Request samples

Payload
curl
Python
Java
Node.js

application/json

{"type": {"technicalKey": "CURATIONS"
},
"dataSources": [{"id": "648824a691d8d2503d65103e"
}
]
}

Response samples

application/json

{"numberOfDeleted": 0
}

Delete Decisions

Deletes decisions of a given ids.

SecurityapiKey

Request

path Parameters

storageId

required

string

Request Body schema: application/json
required

required

Array of objects (DecisionDelete) non-empty

Responses

200

400

Bad Request

post/storages/{storageId}/decisions/delete

Request samples

Payload
curl
Python
Java
Node.js

application/json

{"decisions": [{"id": "string",
"businessPartnerId": "string"
}
]
}

Response samples

application/json

{"numberOfDeleted": 0
}

Poll Curation Decision Import Job

Poll curation decision import job.

SecurityapiKey

Request

path Parameters

jobId

required

string

Responses

200

400

Bad Request

get/jobs/curationdecisionimportjobs/{jobId}

Request samples

curl
Python
Java
Node.js

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.",
"status": "RUNNING",
"statusMessage": "The job failed because storage is empty.",
"createdAt": "2020-08-31T16:47+00:00",
"user": "742429-234242-4343-232323",
"progress": "The job failed because storage is empty.",
"attachments": [{"url": "customer-upload/user/file.xlsx",
"tags": ["Reporting"
]
}
]
}

Read Decisions

Read decisions from given storage.

SecurityapiKey

Request

path Parameters

storageId

required

string

query Parameters

businessPartnerIds	Array of strings (DecisionLogBusinessPartnerId) <= 500 items Only show decisions for listed business partner IDs.
limit	integer <int32> >= 1 Default: 500 Number of items to be returned on the page.
startAfter	string Start after the provided pagination ID. Leave empty for the first query. The response will contain a property nextStartAfter which need to be used for any subsequent queries until nextStartAfter is empty. See CDQ - Developer Guidelines.
type	string (DecisionLogTypeTechnicalKeyParam) Enum: "CURATIONS" "NATURAL_PERSONS" "DUPLICATES"

Responses

200

400

Bad Request

get/storages/{storageId}/decisions

Request samples

curl
Python
Java
Node.js

Response samples

application/json

{"values": [{"id": "string",
"type": {"technicalKey": "CURATIONS"
},
"businessPartnerId": "string",
"dataSourceId": "648824a691d8d2503d65103e",
"externalId": "The ID managed in the customer's SAP systems.",
"lastUpdatedAt": "string",
"lastUpdatedBy": "string",
"updateDecisions": [{"context": {"createdBy": "string",
"createdAt": "string",
"scope": {"dataSourceIds": [null
],
"countryShortNames": [null
],
"curationSimilarity": 0
}
},
"proposal": {"externalIds": [{"externalId": null,
"dataSourceId": null,
"id": null,
"concept": null,
"language": null,
"characterSet": null,
"type": null
}
],
"property": {"parentConcept": {"name": null,
"technicalKey": null
},
"name": "Minority Indicator Value",
"technicalKey": "MINORITY_INDICATOR_VALUE",
"contentSelector": "string",
"instanceSelectors": [null
]
},
"newContent": "AAB",
"previousContent": "AAB",
"provenance": {"name": "VIES",
"url": "https://meta.cdq.com/index.php?title=Property:Has_prefix&limit=500&offset=0&from=&until=&filter=",
"technicalKey": "VIES",
"cdqId": "VIES:PL8660001429",
"subscribers": 7,
"subscribed": true,
"lastUpdatedAt": "20230111",
"lastSyncAt": "20230113"
},
"changeType": "MODIFIED",
"changeClassification": "MAJOR",
"confidenceScore": "0.0",
"maxConfidenceScore": "1.0",
"matchingScores": {"overall": 0,
"businessPartner": 0,
"address": 0
}
},
"status": "ACCEPTED",
"reliability": "UNKNOWN"
}
],
"validationDecisions": [{"context": {"createdBy": "string",
"createdAt": "string"
},
"dataDefect": {"businessRule": {"url": "https://meta.cdq.com/Identifier_unknown_(European_value_added_tax_identifier_(The_Netherlands))"
},
"properties": [{"parentConcept": null,
"content": null,
"url": null,
"instanceSelectors": [ ]
}
]
},
"status": "ACCEPTED"
}
]
}
],
"limit": "100",
"startAfter": "5712566172571652",
"nextStartAfter": "5712566172571652",
"total": "67"
}

Start Curation Decision Import Job

Starts curation decision import job

SecurityapiKey

Request

Request Body schema: application/json
required

dataSourceId	string
onlyNotReviewed	boolean Default: false
required	object (CurationDecisionImportJobScope)
storageId required	string

Responses

200

400

Bad Request

post/jobs/curationdecisionimportjobs

Request samples

Payload
curl
Python
Java
Node.js

application/json

{"storageId": "string",
"dataSourceId": "string",
"onlyNotReviewed": false,
"scope": {"accepted": {"identifiers": [{"technicalKey": "string",
"changeTypes": ["string"
],
"countryShortNames": ["string"
],
"thresholds": {"businessPartnerRequestSimilarity": 0,
"addressRequestSimilarity": 0,
"businessPartnerMatchingScore": 0,
"addressMatchingScore": 0
}
}
]
},
"rejected": {"identifiers": [{"technicalKey": "string",
"changeTypes": ["string"
],
"countryShortNames": ["string"
],
"thresholds": {"businessPartnerRequestSimilarity": 0,
"addressRequestSimilarity": 0,
"businessPartnerMatchingScore": 0,
"addressMatchingScore": 0
}
}
]
}
}
}

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.",
"status": "RUNNING",
"statusMessage": "The job failed because storage is empty.",
"createdAt": "2020-08-31T16:47+00:00",
"user": "742429-234242-4343-232323",
"progress": "The job failed because storage is empty.",
"attachments": [{"url": "customer-upload/user/file.xlsx",
"tags": ["Reporting"
]
}
]
}

Upsert Decisions

Upsert decisions for given storage. Decisions are distinguished by business partner id and type. Already existing decision will be replaced.

SecurityapiKey

Request

path Parameters

storageId

required

string

Request Body schema: application/json
required

required

Array of objects (DecisionsUpsertEntry) non-empty

Responses

200

400

Bad Request

post/storages/{storageId}/decisions

Request samples

Payload
curl
Python
Java
Node.js

application/json

{"decisions": [{"type": {"technicalKey": "CURATIONS"
},
"businessPartnerId": "string",
"dataSourceId": "648824a691d8d2503d65103e",
"externalId": "string",
"updateDecisions": [{"context": {"createdBy": "string",
"createdAt": "string",
"scope": {"dataSourceIds": [null
],
"countryShortNames": [null
],
"curationSimilarity": 0
}
},
"proposal": {"externalIds": [{"externalId": null,
"dataSourceId": null,
"id": null,
"concept": null,
"language": null,
"characterSet": null,
"type": null
}
],
"property": {"parentConcept": {"name": null,
"technicalKey": null
},
"name": "Minority Indicator Value",
"technicalKey": "MINORITY_INDICATOR_VALUE",
"contentSelector": "string",
"instanceSelectors": [null
]
},
"newContent": "AAB",
"previousContent": "AAB",
"provenance": {"name": "VIES",
"url": "https://meta.cdq.com/index.php?title=Property:Has_prefix&limit=500&offset=0&from=&until=&filter=",
"technicalKey": "VIES",
"cdqId": "VIES:PL8660001429",
"subscribers": 7,
"subscribed": true,
"lastUpdatedAt": "20230111",
"lastSyncAt": "20230113"
},
"changeType": "MODIFIED",
"changeClassification": "MAJOR",
"confidenceScore": "0.0",
"maxConfidenceScore": "1.0",
"matchingScores": {"overall": 0,
"businessPartner": 0,
"address": 0
}
},
"status": "ACCEPTED",
"reliability": "UNKNOWN"
}
],
"validationDecisions": [{"context": {"createdBy": "string",
"createdAt": "string"
},
"dataDefect": {"businessRule": {"url": "https://meta.cdq.com/Identifier_unknown_(European_value_added_tax_identifier_(The_Netherlands))"
},
"properties": [{"parentConcept": null,
"content": null,
"url": null,
"instanceSelectors": [ ]
}
]
},
"status": "ACCEPTED"
}
]
}
]
}

Response samples

application/json

{"numberOfProvidedDecisions": 0,
"numberOfInserts": 0,
"numberOfUpdates": 0
}

Decision Log

Clear Decisions

path Parameters

Request Body schema: application/jsonrequired

Delete Decisions

path Parameters

Request Body schema: application/jsonrequired

Poll Curation Decision Import Job

path Parameters

Read Decisions

path Parameters

query Parameters

Start Curation Decision Import Job

Request Body schema: application/jsonrequired

Upsert Decisions

path Parameters

Request Body schema: application/jsonrequired

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required