# Start Deduplication Job

Starts a Deduplication Job for the given storage.

Endpoint: POST /v2/deduplicationjobs
Version: 2
Security: apiKey

## Request fields (application/json):

  - `storageId` (string)
    Unique identifier of the Storage.
    Example: "72d6900fce6b326088f5d9d91049e3e6"

  - `countryShortNames` (array)
    If set, only the records that belong to the countries identified by these short names are processed. By default, all records of the storage (means from all countries) are processed (considering other filters).
    Example: ["CH"]

  - `dataSourceIds` (array)
    If set, only the records that belong to the data sources identified by these IDs are processed. By default, all records of the storage (means from all data sources) are processed (considering other filters).
    Example: ["648824a691d8d2503d65103e"]

  - `decisionLogIds` (array)
    If set, feedback from listed Matching Decision Logs will be considered.
    Example: ["65dcb1d68f01e37c2cf9bbb2"]

  - `dataMatchingDefinitionId` (string)
    Id of the data matching definition.
    Example: "6461e6113b1865304b3038b6"

  - `reportsRequest` (object)
    Parameters for reports generation for the Deduplication Job.

  - `reportsRequest.reportsConfiguration` (object)
    Configuration for reports generation for the Deduplication Job.

  - `reportsRequest.reportsConfiguration.duplicateMatching` (object)
    Generates a data matching report that doesn't include artificial golden records on top of each matching group. Optionally IncludeSingles feature can be set to true.

  - `reportsRequest.reportsConfiguration.duplicateMatching.build` (boolean)
    Enable to generate this report.
    Example: "false"

  - `reportsRequest.reportsConfiguration.duplicateMatching.includeSingles` (boolean)
    Enables singles (non duplicated records) for the duplicate matching report.
    Example: "false"

  - `reportsRequest.reportsConfiguration.duplicateConsolidation` (object)
    Generates a data matching report that includes artificial golden records on top of each matching group. Optionally IncludeSingles feature can be set to true.

  - `reportsRequest.reportsConfiguration.duplicateConsolidation.includeSingles` (boolean)
    Enables singles (non duplicated records) for the duplicate consolidation report.
    Example: "false"

## Response 200 fields (application/json):

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

  - `storageId` (string)
    Unique identifier of the Storage.
    Example: "72d6900fce6b326088f5d9d91049e3e6"

  - `dataMatchingDefinitionId` (string)
    Id of the data matching definition.
    Example: "6461e6113b1865304b3038b6"

  - `dataSourceIds` (array)
    List of Data Source IDs.
    Example: ["648824a691d8d2503d65103e"]

  - `decisionLogIds` (array)
    If set, feedback from listed Matching Decision Logs will be considered.
    Example: ["65dcb1d68f01e37c2cf9bbb2"]

  - `countryShortNames` (array)
    List of country short names.
    Example: ["CH"]

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

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

  - `status` (string)
    Curation Job execution status.
    Enum: "ARCHIVED", "UNKNOWN", "CREATED", "PERSISTED", "SCHEDULED", "WAITING", "COULDNT_START", "RUNNING", "FINISHED", "DIED", "CANCELED", "FAILED"

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