---
title: "Read a comparison: proposed pairs, alternatives, conflicts, missing values and sources"
method: GET
path: "/v1/reconciliation/comparisons/{comparison_id}"
---

# Read a comparison: proposed pairs, alternatives, conflicts, missing values and sources

`GET /v1/reconciliation/comparisons/{comparison_id}`

## Request

- Base URL: `https://api.specstream.ai`
- URL: `https://api.specstream.ai/v1/reconciliation/comparisons/{comparison_id}`
- Auth: API key in header `Authorization`

## Path parameters

- `comparison_id` string, required

## Response `200`

Read a comparison: proposed pairs, alternatives, conflicts, missing values and sources

- object
  - `data` ReconciliationView, required
    - `comparison_id` string, required
    - `comparison_hash` string, required
    - `name` string, required
    - `project_id` string, nullable, required
    - `request` ReconciliationPrepare, required
      - `request_id` string, required
      - `name` string, required
      - `project_id` string, nullable
      - `left` ReconciliationScope, required
        - `collection_id` string, required
        - `record_ids` string[], nullable
      - `right` ReconciliationScope, required
        - `collection_id` string, required
        - `record_ids` string[], nullable
      - `groups` ReconciliationGroup[], required
        - `rules` ReconciliationRule[], required
          - `left_field` string, required
          - `right_field` string, required
          - `mode` 'exact' | 'edit'
          - `threshold_bps` integer
          - `normalization` 'literal' | 'nfkc_casefold_space'
      - `vetoes` ReconciliationVeto[]
        - `left_field` string, required
        - `right_field` string, required
        - `normalization` 'literal' | 'nfkc_casefold_space'
      - `fill` ReconciliationFill[], required
        - `right_field` string, required
        - `output_field` string, required
      - `assignment` 'one_to_one' | 'many_to_one'
      - `include_private_fields` boolean
    - `created_at` string, required
    - `scopes` object, required
    - `summary` object, required
    - `metrics` object, required
    - `rows` ReconciliationRow[], required
      - `left_record_id` string, required
      - `name` string, required
      - `left_values` object, required
      - `references` object, required
      - `status` 'one_candidate' | 'ambiguous' | 'needs_fields' | 'no_candidate', required
      - `candidates` ReconciliationCandidate[], required
        - `right_record_id` string, required
        - `right_name` string, required
        - `score_bps` integer, required
        - `groups` ReconciliationEvidenceGroup[], required
          - `group` integer, required
          - `comparisons` ReconciliationAgreement[], required
            - `left_field` string, required
            - `right_field` string, required
            - `mode` 'exact' | 'edit', required
            - `normalization` 'literal' | 'nfkc_casefold_space', required
            - `minimum_bps` integer, required
            - `score_bps` integer, required
            - `edits` integer, required
        - `right_values` object, required
        - `references` object, required
        - `unknown_guards` ReconciliationGuard[], required
          - `left_field` string, required
          - `right_field` string, required
        - `reference_candidate_for` integer, required
      - `incomplete_groups` ReconciliationIncomplete[], required
        - `group` integer, required
        - `fields` string[], required
      - `blocked_candidates` ReconciliationBlocked[], required
        - `right_record_id` string, required
        - `right_name` string, required
        - `contradictions` ReconciliationContradiction[], required
          - `left_field` string, required
          - `right_field` string, required
          - `left_value` unknown, required
          - `right_value` unknown, required
      - `candidate_count` integer, required
    - `qualification_authority` false
    - `metric` 'normalized_levenshtein_v1'

## Other responses

- `default`: Error envelope

---

[API](https://skmtc.dev/specstream/apis/specstream-api.md) · [All operations](https://skmtc.dev/specstream/apis/specstream-api/llms.txt) · [OpenAPI document](https://skmtc.dev/specstream/apis/specstream-api/revisions/5a9f51143a13?raw)