post:
  operationId: listStationStates
  summary: List states for a country
  description: |
    Returns the list of states for a given country, used by the State
    dropdown in the Create Station form.
  tags: [masterData]
  requestBody:
    required: true
    content:
      application/json:
        schema:
          $ref: "../../components.yaml#/components/schemas/ListStationStatesRequest"
        example:
          country_id: "MX"
  responses:
    "200":
      description: States returned directly.
      content:
        application/json:
          schema:
            $ref: "../../components.yaml#/components/schemas/ListStationStatesResponse"
          example:
            items:
              - state_id: "MX-JAL"
                state_name: "Jalisco"
              - state_id: "MX-CDMX"
                state_name: "Ciudad de México"
    "400":
      $ref: "../../components.yaml#/components/responses/Failure"