---
title: "query products"
method: GET
path: "/products/"
tags: ["product"]
---

# query products

`GET /products/`

query products

## Query parameters

- `productIDs` string[]

## Response `200`

OK

- object
  - `code` integer
  - `data` object
    - `products` StructsProductConfigInfo[]
      - `components` StructsProductComponentPropertyWithZones[]
        - `availableZones` StructsComponentInstanceZoneWithSpecs[] — Information on the specifications of the resources online for the running of product components,organized by different Zone
          - `specs` StructsComponentInstanceResourceSpec[]
            - `cpu` integer
            - `diskType` string — eg: NVMeSSD/SSD/SATA
            - `id` string — ID of the instance resource specification
            - `memory` integer — The amount of memory occupied by the instance, in GiB
            - `name` string — Name of the instance resource specification,eg: TiDB.c1.large
            - `zoneId` string
            - `zoneName` string
          - `zoneId` string
          - `zoneName` string
        - `endPort` integer
        - `id` string — ID of the product component, globally unique
        - `maxInstance` integer — Maximum number of instances when the product component is running, e.g. PD can run up to 7 instances, other components have no upper limit
        - `maxPort` integer
        - `minInstance` integer — Minimum number of instances of product components at runtime, e.g. at least 1 instance of PD, at least 3 instances of TiKV
        - `name` string — Name of the product component, globally unique
        - `purposeType` string — The type of resources required by the product component at runtime, e.g. storage class
        - `startPort` integer
        - `suggestedInstancesCount` integer[]
      - `productId` string
      - `productName` string
      - `versions` StructsSpecificVersionProduct[]
        - `arch` string
        - `productId` string
        - `version` string
  - `message` string

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `500` — Internal Server Error

---

[API](https://skmtc.net/pingcap/apis/em-ui-api.md) · [All operations](https://skmtc.net/pingcap/apis/em-ui-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pingcap/em-ui-api/revisions/631e4b26b7e8/schema)
