# City list

> Query cities or administrative divisions under a specified region.

```yaml
openapi: 3.1.0
info:
  title: City list
  version: 1.0.0
  description: Query cities or administrative divisions under a specified region.
paths:
  /api/v1/merchant/common/cityList:
    post:
      summary: City list
      description: Query cities or administrative divisions under a specified region.
      parameters:
        - name: ApiKey
          in: header
          required: true
          description: Issuing API key request header assigned by Onerway.
          schema:
            type: string
            description: Issuing API key request header assigned by Onerway.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                regionCode:
                  type: string
                  description: Region or country code.
                parentCode:
                  type: string
                  description: Parent administrative division code for cascading queries.
              required:
                - regionCode
            examples:
              default:
                summary: City list
                value:
                  parentCode: GD
                  regionCode: CN
      responses:
        "200":
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  respCode:
                    type: string
                    description: Business response code. `20000` means success.
                  respMsg:
                    type: string
                    description: Response message.
                  data:
                    type: array
                    description: City or administrative division list.
                    items:
                      type: object
                      properties:
                        regionCode:
                          type: string
                          description: Parent region or country code.
                        parentCode:
                          type: string
                          description: Parent administrative division code.
                        cityCode:
                          type: string
                          description: City code.
                        cityName:
                          type: string
                          description: City name.
                    x-onerway-value:
                      empty: true
                      when:
                        en: Returned as an empty array when no city is available.
                        zh: 无可用城市时返回空数组。
              examples:
                success:
                  summary: Success
                  value:
                    respCode: "20000"
                    respMsg: success
                    data:
                      - regionCode: CN
                        parentCode: GD
                        cityCode: SZ
                        cityName: Shenzhen
                      - regionCode: CN
                        parentCode: GD
                        cityCode: GZ
                        cityName: Guangzhou
```