---
title: "Get a comparison"
method: GET
path: "/comparisons/{comparisonId}"
---

# Get a comparison

`GET /comparisons/{comparisonId}`

## Request

- Base URL: `https://api.agentsky.dev/v1`
- URL: `https://api.agentsky.dev/v1/comparisons/{comparisonId}`
- Auth: HTTP bearer

One comparison: its task, each agent's column and session, status, and the verdict once the person has picked a winner. Columns in a blind Arena match return masked agent/model fields until the pick is recorded.

## Path parameters

- `comparisonId` string, required

## Response `200`

OK

- object
  - `id` string, required
  - `title` string
  - `openerText` string, nullable
  - `createdAt` string, date-time
  - `updatedAt` string, date-time
  - `columns` object[], required
    - `columnId` string
    - `sessionId` string
    - `agentType` string: Harness id (e.g. "dsh"), as POST /comparisons takes it; "unknown" while the match hides identities.
    - `llm` string: Model id; empty while the match hides identities.
    - `name` string, nullable: Display label, e.g. "DeepSeek Harness · DeepSeek V4.1 Flash"; null while identities are hidden.
    - `podStatus` string, nullable
  - `arena` object, nullable: Present when this comparison has an associated Arena match.
    - `kind` string: "comparison" for named side-by-side; other values are blind Arena.
    - `status` string
    - `hidden` boolean: Identities are hidden while the match is pending.
    - `pending` boolean
  - `vote` object, nullable
    - `outcome` string
    - `winnerSessionId` string, nullable
    - `sealed` boolean
    - `why` string[]

## Other responses

- `401`: Error — { error: { code, message } }
- `404`: Error — { error: { code, message } }
- `default`: Error — { error: { code, message, request_id } }

## Changes

- **2026-11-02** `e5e8f0229a99`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/agentsky/apis/agentsky-developer-api/changes/comparisons/:comparisonId/get.md)

---

[API](https://skmtc.dev/agentsky/apis/agentsky-developer-api.md) - [All operations](https://skmtc.dev/agentsky/apis/agentsky-developer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/agentsky/apis/agentsky-developer-api/revisions/8280a065ef6a?raw)