# Poll Matching Reports

Polls the status of the matching reports.

Endpoint: GET /matchingreports/{id}
Version: 2
Security: apiKey

## Path parameters:

  - `id` (string, required)
    ID of the matching report.
    Example: "65dcc3c60cecd503bcc88c92"

## Response 200 fields (application/json):

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

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

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

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

  - `finishedAt` (string)
    ISO 8601 representation of the timestamp when the Matching Report was finished.
    Example: "2025-08-29T09:46:53Z"

  - `user` (string)
    Unique ID of a user.
    Example: "johndoe"

  - `attachments` (array)
    List of attachments that are part of the report.

  - `attachments.name` (string)
    Name of the attachment.
    Example: "filename.xlsx"

  - `attachments.type` (string)
    Type of the attachment.
    Example: "REPORT_COLLECTION"

  - `attachments.url` (string)
    URL/path to the attachment.
    Example: "cdl-runtime-data/folder/filename.xlsx"

  - `attachments.tags` (array)
    List of tags
    Example: ["REPORT_FILE_12"]

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

  - `reportsConfiguration` (object)
    Configuration for generating matching reports.

  - `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.

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

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

  - `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.

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

  - `reportsConfiguration.linkage` (object)
    Generates a linkage report. Optionally IncludeSingles feature can be set to true.

  - `reportsConfiguration.linkage.includeSingles` (boolean)
    Enables singles (non linked records) for the linkage report.
    Example: "false"