# Matching Decision Import

To start importing an Identity Linkage Decision import file, use the following request.



With using output file from duplication or linkage job.
Please remember not to remove the mandatory columns when modifying this file: No Match Feedback, Matching Group, Storage ID, Data Source ID, Record ID.

The response is shown below. Use the returned  to poll the import job status.



This import leads to the following link in the MatchingDecisionLog.




Endpoint: POST /matchingdecisionjobs
Version: 2
Security: apiKey

## Request fields (multipart/form-data):

  - `file` (string, required)
    XLSX or CSV file to be uploaded (SOAP currently only supports CSV).
    Example: "file.xlsx"

  - `decisionLogId` (string, required)
    Target MatchingDecisionLog ID for this import.
    Example: "5e60dfdbd5fa2d000166ab4a"

## Response 200 fields (application/json):

  - `id` (string)
    Unique identifier of a job.
    Example: "35f23c03-1c22-45fe-9484-3ffe769325de"

  - `domain` (string)
    The actual company website URL.
    Example: "https://cdq.com"

  - `createdBy` (string)
    Creator of a resource.
    Example: "76248934691294444"

  - `createdAt` (string)
    Date of creation (ISO 8601-compliant).
    Example: "2025-08-29T09:46:53Z"

  - `modifiedAt` (string)
    Date of modification (ISO 8601-compliant).
    Example: "2025-08-29T09:46:53Z"

  - `progress` (integer)
    Progress (%) of the job.
    Example: "77"

  - `status` (string)
    Job execution status.
    Example: "RUNNING"

  - `statusMessage` (string)
    Additional information to explain the status.
    Example: "The job failed because storage is empty."

  - `decisionLogId` (string)
    ID of the decision log.
    Example: "65dcb1d68f01e37c2cf9bbb2"

  - `result` (object)
    Result of the matching decision import job.

  - `result.statistics` (object)
    Statistics of the matching decision import job.

  - `result.statistics.numberOfInserts` (integer)
    Number of inserted matching decisions.
    Example: "100"

  - `result.statistics.numberOfFailed` (integer)
    Number of failed matching decisions.
    Example: "0"

## Response 400 fields (application/json):

  - `path` (string)
    Requested path which caused this error.
    Example: "/v2/businesspartners/lookup"

  - `status` (integer)
    RFC 7231 status code for this error.
    Example: "400"

  - `timestamp` (string)
    ISO 8601 representation of the timestamp.
    Example: "2025-08-29T09:46:53Z"

  - `error` (string)
    RFC 7231 error which belongs to the status code.
    Example: "BAD_REQUEST"

  - `message` (string)
    Details about the error.
    Example: "This user is not allowed to access this service."