---
title: "query vendors"
method: GET
path: "/vendors/"
tags: ["vendor"]
---

# query vendors

`GET /vendors/`

query vendors

## Query parameters

- `vendorIDs` string[]

## Response `200`

OK

- object
  - `code` integer
  - `data` object
    - `vendors` StructsVendorConfigInfo[]
      - `id` string — The value of the VendorID is similar to AWS
      - `name` string — The value of the Name is similar to AWS
      - `regions` StructsRegionConfigInfo[]
        - `id` string
        - `name` string
        - `zones` StructsZoneInfo[]
          - `comment` string
          - `zoneId` string — The value of the ZoneID is similar to CN-HANGZHOU-H
          - `zoneName` string — The value of the Name is similar to Hangzhou(H)
      - `specs` StructsSpecInfo[]
        - `cpu` integer
        - `diskType` string — eg: NVMeSSD/SSD/SATA
        - `id` string — ID of the resource specification
        - `memory` integer — The amount of memory occupied by the instance, in GiB
        - `name` string — Name of the resource specification,eg: TiDB.c1.large
        - `purposeType` string — eg:Compute/Storage/Schedule
  - `message` string

## Other responses

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

## Changes

> 50 revisions in range; 1 could not be searched.

- **2022-03-15** `b80b68fc9b84` — 1 info
  - endpoint added
- **2022-03-15** `640249faed6d` — 1 breaking
  - api path removed without deprecation
- **2022-03-14** `93b5f9e04bf4` — 1 info
  - endpoint added
- **2022-03-14** `b233b39afe9d` — 1 breaking
  - api path removed without deprecation
- **2022-03-11** `a1097ecc22a7` — 1 info
  - endpoint added

[Full history](https://skmtc.dev/pingcap/apis/em-ui-api/changes/vendors/get.md)

---

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