Skip to content

Data Matching API (2)

This API provides services for maintaining matching definitions used as configuration for matching jobs, as well as services for matching data with a job.

Overview
URL

https://www.cdq.ch/team

Sebastian Kaczmarski

sebastian.kaczmarski@cdq.ch

Languages
Servers
Mock server

https://idp.cdq.com/_mock/apis/data-matching-api/api-v2/

Production SOAP

https://api.corporate-data-league.ch/data-matching/soap/v2/

Production

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

Business Partner

Provides functionalities for managing business partners. These endpoints support matching business partners against data matching definitions, ensuring comprehensive analytics for data matching activities.

Operations

Analytics

Provides functionalities for generating and polling data matching reports. These endpoints support creating reports and checking their status, ensuring comprehensive analytics for data matching activities.

Operations

Data Matching

Provides functionalities for managing Data Matching Definitions, which are configurations for matching jobs to identify duplicates or link records across data sources. These endpoints support creating, reading, updating, and deleting these configurations.

Operations

Duplicate Matching

Provides functionalities for managing duplications within a single data source. These endpoints support creating Deduplication Job and checking the Deduplication Job Status.

Operations

Entity Matching

Provides functionalities for matching business partners. These endpoints support matching business partners against data matching definitions, ensuring comprehensive analytics for data matching activities.

Operations

Identity Resolution

Provides functionalities for managing identity resolution configurations and operations.

Operations

Get BusinessPartner's Attribute Paths

Request

Get all attribute paths of BusinessPartner.

Security
basicAuth
Headers
X-Credential-Usernamestringrequired

Parameter used for passing the username. The header can take form of:

  • username (e.g. "lukaszmichta")
  • user id (e.g. "87b1bdb1-ba87-4522-b363-c5a0e6e917b3")
Example: 87b1bdb1-ba87-4522-b363-c5a0e6e917b3
curl -i -X GET \
  -u <username>:<password> \
  https://idp.cdq.com/_mock/apis/data-matching-api/api-v2/entityresolution/attributepaths \
  -H 'X-Credential-Username: 87b1bdb1-ba87-4522-b363-c5a0e6e917b3'

Responses

A list of attribute paths

Bodyapplication/json
pathsArray of strings

List of attribute paths.

Example: ["businessPartner.addresses[].country.shortName"]
statusobject(Status)

Details about status or error of a service

Response
application/json
{
  "paths": [
    "businessPartner.addresses[].country.shortName"
  ],
  "status": {
    "code": "200",
    "technicalKey": "OK",
    "details": [ … ],
    "path": "/v2/businesspartners/lookup",
    "timestamp": "2019-08-31T16:47+00:00"
  }
}

List Available Cleaners

Request

List all available cleaners for identity resolution.

Security
basicAuth
Headers
X-Credential-Usernamestringrequired

Parameter used for passing the username. The header can take form of:

  • username (e.g. "lukaszmichta")
  • user id (e.g. "87b1bdb1-ba87-4522-b363-c5a0e6e917b3")
Example: 87b1bdb1-ba87-4522-b363-c5a0e6e917b3
curl -i -X GET \
  -u <username>:<password> \
  https://idp.cdq.com/_mock/apis/data-matching-api/api-v2/entityresolution/cleaners \
  -H 'X-Credential-Username: 87b1bdb1-ba87-4522-b363-c5a0e6e917b3'

Responses

Successful operation

Bodyapplication/json
cleanersArray of objects(Cleaner)

List of cleaners.

statusobject(Status)

Details about status or error of a service

Response
application/json
{
  "cleaners": [
    { … },
    { … }
  ],
  "status": {
    "code": 200,
    "technicalkey": "ok",
    "details": [ … ]
  }
}

List Available Comparators

Request

List all available comparators for identity resolution.

Security
basicAuth
Headers
X-Credential-Usernamestringrequired

Parameter used for passing the username. The header can take form of:

  • username (e.g. "lukaszmichta")
  • user id (e.g. "87b1bdb1-ba87-4522-b363-c5a0e6e917b3")
Example: 87b1bdb1-ba87-4522-b363-c5a0e6e917b3
curl -i -X GET \
  -u <username>:<password> \
  https://idp.cdq.com/_mock/apis/data-matching-api/api-v2/entityresolution/comparators \
  -H 'X-Credential-Username: 87b1bdb1-ba87-4522-b363-c5a0e6e917b3'

Responses

Successful operation

Bodyapplication/json
comparatorsArray of objects(Comparator)

List of comparators.

statusobject(Status)

Details about status or error of a service

Response
application/json
{
  "comparators": [
    { … }
  ],
  "status": {
    "code": "200",
    "technicalKey": "OK",
    "details": [ … ],
    "path": "/v2/businesspartners/lookup",
    "timestamp": "2019-08-31T16:47+00:00"
  }
}

Get Available Paths

Request

Get all available paths for search in index-api.

Security
basicAuth
Headers
X-Credential-Usernamestringrequired

Parameter used for passing the username. The header can take form of:

  • username (e.g. "lukaszmichta")
  • user id (e.g. "87b1bdb1-ba87-4522-b363-c5a0e6e917b3")
Example: 87b1bdb1-ba87-4522-b363-c5a0e6e917b3
curl -i -X GET \
  -u <username>:<password> \
  https://idp.cdq.com/_mock/apis/data-matching-api/api-v2/entityresolution/searchattributepaths \
  -H 'X-Credential-Username: 87b1bdb1-ba87-4522-b363-c5a0e6e917b3'

Responses

A list of search attributes

Bodyapplication/json
searchAttributesArray of strings

List of search attributes.

Example: ["$.names[].type.technicalKey"]
statusobject(Status)

Details about status or error of a service

Response
application/json
{
  "searchAttributes": [
    "$.names[].type.technicalKey"
  ],
  "status": {
    "code": "200",
    "technicalKey": "OK",
    "details": [ … ],
    "path": "/v2/businesspartners/lookup",
    "timestamp": "2019-08-31T16:47+00:00"
  }
}

Linkage Matching

Provides functionalities for managing linkages across multiple data sources. These endpoints support creating Linkage Job and checking the Linkage Job Status.

Operations

Public

Provides functionalities for polling the Matching Reports.

Operations

User Feedback

Provides functionalities for managing user feedback related to data matching decisions.

Operations

Configurations

Operations