---
title: "Product Record"
method: GET
path: "/v1/products/{product_id}"
---

# Product Record

`GET /v1/products/{product_id}`

## Request

- Base URL: `https://specjoin.com/api`
- URL: `https://specjoin.com/api/v1/products/{product_id}`
- Auth: HTTP bearer

## Path parameters

- `product_id` string, required

## Response `200`

Successful Response

- Product
  - `id` string, required
  - `kind` 'host' | 'dock' | 'adapter' | 'cable' | 'power_supply' | 'monitor', required
  - `manufacturer` string, required
  - `model` string, required
  - `manufacturer_part_number` string, nullable
  - `identity_scope` 'family' | 'part', required
  - `aliases` string[]
  - `ports` Port[]
    - `id` string, required
    - `connector` 'hdmi' | 'mini_hdmi' | 'displayport' | 'mini_displayport' | 'dvi' | 'vga' | 'usb_c' | 'usb_a' | 'dc_barrel' | 'lenovo_slim_tip' | 'surface_connect', required
    - `role` 'host' | 'display_output' | 'display_input' | 'data' | 'power_input', required
    - `count` integer
    - `features` string[]
    - `source_ids` string[], required
  - `attributes` Attribute[]
    - `name` string, required
    - `value` union, required
      - string
      - integer
      - boolean
    - `unit` string, nullable
    - `qualification` string, nullable
    - `source_ids` string[], required
  - `notes` string[]
  - `source_ids` string[], required
  - `host` Host
    - `video_classes` string[], required
    - `native_external_limit` integer, nullable
    - `usb_c_charging` boolean, nullable
    - `default_os` 'windows' | 'macos' | 'linux' | 'chromeos', required
    - `port_note` string, required
  - `dock` Dock
    - `technology` 'native' | 'displaylink', required
    - `output_groups` OutputGroup[], required
      - `id` string, required
      - `connectors` string[], required
      - `modes` string[], nullable
    - `max_external_screens` integer, required
    - `native_mac_mirroring` boolean
    - `host_cable_requirement` 'thunderbolt_40gbps' | 'usb_c_video' | 'usb_data' | 'attached', required
    - `host_connectors` string[]
    - `charge_requires_original_host_cable` boolean
    - `power_required_for_operation` boolean, required
    - `power_supply_description` string, required
    - `power_supply_candidates` string[]
    - `displaylink_source_ids` string[]
    - `host_cable_candidates` string[]
    - `additional_prerequisites` string[]
    - `power_button_support` 'not_documented' | 'same_brand_only'
    - `power_button_source_ids` string[]
  - `adapter` Adapter
    - `from_connector` 'hdmi' | 'mini_hdmi' | 'displayport' | 'mini_displayport' | 'dvi' | 'vga' | 'usb_c', required
    - `to_connector` 'hdmi' | 'mini_hdmi' | 'displayport' | 'mini_displayport' | 'dvi' | 'vga' | 'usb_c', required
    - `modes` string[], required
    - `active` boolean, required
    - `separate_display_cable` boolean, required
    - `auxiliary_usb_power` boolean, required
    - `direction_note` string, required
  - `cable` Cable
    - `cable_class` 'thunderbolt_40gbps' | 'usb_c_video' | 'hdmi' | 'displayport' | 'mixed_display', required
    - `modes` string[]
    - `power_ceiling_w` integer, nullable
    - `from_connector` 'hdmi' | 'mini_hdmi' | 'displayport' | 'mini_displayport' | 'dvi' | 'vga' | 'usb_c', nullable
    - `to_connector` 'hdmi' | 'mini_hdmi' | 'displayport' | 'mini_displayport' | 'dvi' | 'vga' | 'usb_c', nullable
  - `power_supply` Supply
    - `supply_class` string, required
    - `rated_output_w` integer, required
    - `connector` 'hdmi' | 'mini_hdmi' | 'displayport' | 'mini_displayport' | 'dvi' | 'vga' | 'usb_c' | 'usb_a' | 'dc_barrel' | 'lenovo_slim_tip' | 'surface_connect', required
  - `monitor` Monitor
    - `preferred_mode` '1080p60' | '1440p60' | '4k30' | '4k60' | '1920x1200_60' | '1680x1050_60' | '1600x900_60' | '1440x900_60' | '1280x1024_60', required
    - `inputs` MonitorPort[], required
      - `port_id` string, required
      - `connector` 'hdmi' | 'mini_hdmi' | 'displayport' | 'mini_displayport' | 'dvi' | 'vga' | 'usb_c', required
      - `modes` string[], required
      - `unsupported_modes` string[]
      - `source_ids` 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)