post:
  operationId: getMasterData
  summary: Get master data
  description: |
    Returns master data needed by the web client in a single call: active
    providers, phone prefixes, and nested country / state / city address
    data.
  tags: [masterData]
  responses:
    "200":
      description: Master data returned directly.
      content:
        application/json:
          schema:
            $ref: "../../components.yaml#/components/schemas/StationMasterDataResponse"
          example:
            providers:
              - supplier_id: "growatt"
                supplier_name: "Growatt"
                status: "active"
            phonePrefixes:
              - code: "MX"
                phonePrefix: "+52"
            countries:
              - country_id: "MX"
                country_name: "Mexico"
                states:
                  - state_id: "MX-JAL"
                    state_name: "Jalisco"
                    cities:
                      - city_id: "MX-JAL-GDL"
                        city_name: "Guadalajara"
    "400":
      $ref: "../../components.yaml#/components/responses/Failure"