---
title: "List all IDCs"
method: GET
path: "/idcs"
tags: ["idcs"]
---

# List all IDCs

`GET /idcs`

Retrieves a list of IDC information that are not marked as hidden.

## Response `200`

Successfully retrieved the list of IDCs.

- ListIDCsResponse
  - `idcs` IdcInfo[], required — A list of IDCs.
    - `idcId` string, required — The unique identifier for the IDC
    - `name` string, required — The IDC name.
    - `country` string, required — The country where the IDC is located, represented by the ISO 3166-1 alpha-2 country code.
    - `countrySubdivision` string, required — The subdivision of the country where the IDC is located, represented by the ISO 3166-2 code.
    - `status` 'available' | 'full' | 'maintenance', required — The IDC status.

## Other responses

- `500` — - [group:**idc**, code:**1201**]: Get IDC list encountered DB error.

---

[API](https://skmtc.net/gmicloud/apis/cluster-engine-api.md) · [All operations](https://skmtc.net/gmicloud/apis/cluster-engine-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gmicloud/cluster-engine-api/versions/bcbab016469f/schema)