---
title: "Export Votes"
method: GET
path: "/preference/experiments/{experiment_id}/votes"
tags: ["preference"]
---

# Export Votes

`GET /preference/experiments/{experiment_id}/votes`

## Request

- Base URL: `https://api.os3robotics.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.os3robotics.com/preference/experiments/{experiment_id}/votes`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

## Path parameters

- `experiment_id` string, uuid, required

## Response `200`

Successful Response

- Export
  - `experiment` Experiment, required
    - `id` string, uuid, required
    - `workspace_id` string, uuid, required
    - `name` string, required
    - `question` string, required
    - `kind` string, required
    - `upstream_id` string, uuid, nullable, required
    - `model` string, nullable, required
    - `candidate_ref` string, required
    - `percent` integer, required
    - `user_daily_cap` integer, nullable, required
    - `evaluation_percent` integer, nullable, required
    - `created_by_kind` string, required
    - `created_by` string, required
    - `created_at` string, date-time, required
    - `disabled_at` string, date-time, nullable, required
    - `assigned` integer, required
    - `compared` integer, required
    - `end_user_votes` integer, required
    - `team_votes` integer, required
    - `ai_votes` integer, required
    - `mine` integer, required
  - `votes` VoteExport[], required
    - `id` integer, required
    - `comparison_id` string, uuid, required
    - `outcome` string, required
    - `reason` string, nullable, required
    - `correction` string, nullable, required
    - `note` string, nullable, required
    - `actor_kind` string, required
    - `actor_id` string, required
    - `actor_name` string, nullable, required
    - `created_at` string, date-time, required
    - `source` string, required
    - `labeler` object, nullable, required
    - `request_id` string, nullable, required
    - `use` string, required
    - `incumbent` union, required
      - Branch
        - `role` string, required
        - `model` string, required
        - `request_id` string, required
        - `trace_id` string, nullable, required
      - ClipBranch
        - `role` string, required
        - `policy_ref` string, required
        - `dataset_version_id` string, required
        - `episode_index` integer, required
    - `candidate` union, required
      - Branch
        - `role` string, required
        - `model` string, required
        - `request_id` string, required
        - `trace_id` string, nullable, required
      - ClipBranch
        - `role` string, required
        - `policy_ref` string, required
        - `dataset_version_id` string, required
        - `episode_index` integer, required
    - `chosen` union, required
      - Branch
        - `role` string, required
        - `model` string, required
        - `request_id` string, required
        - `trace_id` string, nullable, required
      - ClipBranch
        - `role` string, required
        - `policy_ref` string, required
        - `dataset_version_id` string, required
        - `episode_index` integer, required
    - `rejected` union, required
      - Branch
        - `role` string, required
        - `model` string, required
        - `request_id` string, required
        - `trace_id` string, nullable, required
      - ClipBranch
        - `role` string, required
        - `policy_ref` string, required
        - `dataset_version_id` string, required
        - `episode_index` integer, required
    - `candidate_position` string, required
    - `p_compare` number, required
    - `p_candidate_a` number, required
    - `denials` string[], required
    - `reserve` boolean, required
    - `quarantined` boolean, required
  - `pairs` PairOutput[], required
    - `comparison_id` string, uuid, required
    - `chosen` string, required
    - `rejected` string, required
    - `votes` integer, required
  - `evaluation` PairOutput[], required
    - `comparison_id` string, uuid, required
    - `chosen` string, required
    - `rejected` string, required
    - `votes` integer, required
  - `clip_pairs` ClipPair[], required
    - `comparison_id` string, uuid, required
    - `chosen` ClipBranch, required
      - `role` string, required
      - `policy_ref` string, required
      - `dataset_version_id` string, required
      - `episode_index` integer, required
    - `rejected` ClipBranch, required
      - `role` string, required
      - `policy_ref` string, required
      - `dataset_version_id` string, required
      - `episode_index` integer, required
    - `votes` integer, required
  - `excluded` Excluded[], required
    - `comparison_id` string, uuid, required
    - `reason` string, required
  - `quarantines` Quarantine[], required
    - `id` string, uuid, required
    - `user_refs` string[], nullable, required
    - `key_id` string, uuid, nullable, required
    - `reason` string, required
    - `created_by_kind` string, required
    - `created_by` string, required
    - `created_at` string, date-time, required
  - `end_users` EndUser[], required
    - `user_ref` string, nullable, required
    - `key_id` string, uuid, nullable, required
    - `votes` integer, required
    - `a_share` number, nullable, required
    - `team_votes` integer, required
    - `team_agreement` number, nullable, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/os3robotics/apis/os3-api.md) - [All operations](https://skmtc.dev/os3robotics/apis/os3-api/llms.txt) - [OpenAPI document](https://skmtc.dev/os3robotics/apis/os3-api/revisions/0278b5810d1d?raw)