---
title: "Docks"
method: GET
path: "/v1/accessories/docks"
---

# Docks

`GET /v1/accessories/docks`

## Request

- Base URL: `https://specjoin.com/api`
- URL: `https://specjoin.com/api/v1/accessories/docks`
- Auth: HTTP bearer

## Query parameters

- `computer_id` string, required
- `dock_id` string, nullable
- `offset` integer
- `limit` integer

## Response `200`

Successful Response

- DockPage
  - `accessories_version` 2
  - `schema_version` '0.5.0'
  - `rule_version` string
  - `data_version` string, required
  - `data_sha256` string, required
  - `release_status` 'evaluation' | 'commercial', required
  - `computer` ProductIdentity, required
    - `id` string, required
    - `manufacturer` string, required
    - `model` string, required
    - `manufacturer_part_number` string, nullable, required
    - `identity_scope` 'family' | 'part', required
    - `notes` string[], required
    - `source_ids` string[], required
  - `operating_system` 'windows' | 'macos' | 'linux' | 'chromeos', required
  - `offset` integer, required
  - `limit` integer, required
  - `total` integer, required
  - `next_offset` integer, nullable, required
  - `sources` Source[], required
    - `id` string, required
    - `title` string, required
    - `url` string, required
    - `locator` string, required
    - `checked_on` string, required
    - `review_status` 'reviewed' | 'needs_review' | 'withdrawn'
    - `review_after_days` integer
    - `permission` 'evaluation_only' | 'commercial_cleared'
    - `permission_basis` string, required
    - `sha256` string, nullable
  - `scope` string, required
  - `items` DockMatch[], required
    - `dock` ProductIdentity, required
      - `id` string, required
      - `manufacturer` string, required
      - `model` string, required
      - `manufacturer_part_number` string, nullable, required
      - `identity_scope` 'family' | 'part', required
      - `notes` string[], required
      - `source_ids` string[], required
    - `connection` Finding, required
      - `status` 'supported' | 'conditional' | 'unsupported' | 'unknown' | 'not_requested', required
      - `code` string, required
      - `explanation` string, required
      - `source_ids` string[]
      - `rule_ids` string[]
      - `missing` string[]
      - `conditions` string[]
      - `dock_delivery_ceiling_w` integer, nullable
    - `screen_options` ScreenOption[], required
      - `host_connector` 'usb_c' | 'usb_a', required
      - `host_cable` string, required
      - `supply` SupplySelection, required
        - `kind` 'unknown' | 'none' | 'original' | 'product'
        - `product_id` string, nullable
      - `charging_requested` boolean, required
      - `monitors` MonitorNeed[], required
        - `input` 'hdmi' | 'mini_hdmi' | 'displayport' | 'mini_displayport' | 'dvi' | 'vga' | 'usb_c', required
        - `mode` '1080p60' | '1440p60' | '4k30' | '4k60' | '1920x1200_60' | '1680x1050_60' | '1600x900_60' | '1440x900_60' | '1280x1024_60', required
      - `software_allowed` boolean, nullable, required
      - `use` string, required
      - `status` 'supported' | 'conditional' | 'unsupported' | 'unknown' | 'not_requested', required
      - `display` Finding, required
        - `status` 'supported' | 'conditional' | 'unsupported' | 'unknown' | 'not_requested', required
        - `code` string, required
        - `explanation` string, required
        - `source_ids` string[]
        - `rule_ids` string[]
        - `missing` string[]
        - `conditions` string[]
        - `dock_delivery_ceiling_w` integer, nullable
      - `connection` Finding, required
        - `status` 'supported' | 'conditional' | 'unsupported' | 'unknown' | 'not_requested', required
        - `code` string, required
        - `explanation` string, required
        - `source_ids` string[]
        - `rule_ids` string[]
        - `missing` string[]
        - `conditions` string[]
        - `dock_delivery_ceiling_w` integer, nullable
      - `restrictions` Finding[], required
        - `status` 'supported' | 'conditional' | 'unsupported' | 'unknown' | 'not_requested', required
        - `code` string, required
        - `explanation` string, required
        - `source_ids` string[]
        - `rule_ids` string[]
        - `missing` string[]
        - `conditions` string[]
        - `dock_delivery_ceiling_w` integer, nullable
      - `plan` CandidatePlan, required
        - `status` 'supported' | 'conditional' | 'unsupported' | 'unknown' | 'not_requested', required
        - `completeness` 'requirements_only' | 'all_requirements_have_candidates' | 'unresolved', required
        - `connections` Connection[]
          - `monitor_index` integer, required
          - `output_group` string, required
          - `dock_output` 'hdmi' | 'mini_hdmi' | 'displayport' | 'mini_displayport' | 'dvi' | 'vga' | 'usb_c', required
          - `monitor_input` 'hdmi' | 'mini_hdmi' | 'displayport' | 'mini_displayport' | 'dvi' | 'vga' | 'usb_c', required
          - `mode` '1080p60' | '1440p60' | '4k30' | '4k60' | '1920x1200_60' | '1680x1050_60' | '1600x900_60' | '1440x900_60' | '1280x1024_60', required
          - `adapter_id` string, nullable
          - `cable_id` string, nullable
          - `description` string, required
        - `parts` CandidatePart[], required
          - `id` string, required
          - `kind` 'dock' | 'host_cable' | 'display_cable' | 'adapter' | 'power_supply' | 'auxiliary_power', required
          - `description` string, required
          - `quantity` integer, required
          - `quantity_owned` integer
          - `included_in_selected_product` boolean
          - `quantity_to_obtain` integer, required
          - `compatible_product_ids` string[]
          - `source_ids` string[]
          - `candidate_products` ProductIdentity[], required
            - `id` string, required
            - `manufacturer` string, required
            - `model` string, required
            - `manufacturer_part_number` string, nullable, required
            - `identity_scope` 'family' | 'part', required
            - `notes` string[], required
            - `source_ids` string[], required
        - `missing` string[]
        - `note` string
      - `scope` string, required
    - `charging_options` ChargingOption[], required
      - `host_connector` 'usb_c' | 'usb_a', required
      - `supply` SupplySelection, required
        - `kind` 'unknown' | 'none' | 'original' | 'product'
        - `product_id` string, nullable
      - `host_cable` 'original'
      - `finding` Finding, required
        - `status` 'supported' | 'conditional' | 'unsupported' | 'unknown' | 'not_requested', required
        - `code` string, required
        - `explanation` string, required
        - `source_ids` string[]
        - `rule_ids` string[]
        - `missing` string[]
        - `conditions` string[]
        - `dock_delivery_ceiling_w` integer, nullable
      - `supply_product` ProductIdentity, required
        - `id` string, required
        - `manufacturer` string, required
        - `model` string, required
        - `manufacturer_part_number` string, nullable, required
        - `identity_scope` 'family' | 'part', required
        - `notes` string[], required
        - `source_ids` string[], required
    - `requirements` Finding[], required
      - `status` 'supported' | 'conditional' | 'unsupported' | 'unknown' | 'not_requested', required
      - `code` string, required
      - `explanation` string, required
      - `source_ids` string[]
      - `rule_ids` string[]
      - `missing` string[]
      - `conditions` string[]
      - `dock_delivery_ceiling_w` integer, nullable
    - `scope` string, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/specjoin/apis/compatibility-data-api.md) · [All operations](https://skmtc.dev/specjoin/apis/compatibility-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/specjoin/apis/compatibility-data-api/revisions/75215ad869cd?raw)