post:
  operationId: listStationSuppliers
  summary: List active suppliers for Create Station
  description: |
    Returns a paginated list of active providers for the Supplier dropdown.
    `supplier_id` is the provider code expected by `CreateStationRequest.provider_code`.
  tags: [Station]
  requestBody:
    required: false
    content:
      application/json:
        schema:
          $ref: "../../components.yaml#/components/schemas/ListStationSuppliersRequest"
        example:
          page: 1
          limit: 20
  responses:
    "200":
      description: Active suppliers returned directly.
      content:
        application/json:
          schema:
            $ref: "../../components.yaml#/components/schemas/ListStationSuppliersResponse"
          example:
            data:
              - supplier_id: "growatt"
                supplier_name: "Growatt"
                status: "active"
            pagination:
              page: 1
              limit: 20
              total_items: 1
              total_pages: 1
    "400":
      $ref: "../../components.yaml#/components/responses/Failure"