post:
  operationId: listStationClients
  summary: List active clients for Create Station
  description: |
    Returns a cursor-paginated, searchable list of active clients for the
    Client dropdown in the Create Station form. Send `last_object_id` from
    the last item of the previous response to fetch the next page.
  tags: [Station]
  security:
    - bearerAuth: []
  requestBody:
    required: false
    content:
      application/json:
        schema:
          $ref: "../../components.yaml#/components/schemas/ListStationClientsRequest"
        example:
          search: "Acme"
          limit: 20
  responses:
    "200":
      description: Active clients returned directly.
      content:
        application/json:
          schema:
            $ref: "../../components.yaml#/components/schemas/ListStationClientsResponse"
          example:
            items:
              - client_id: "6656c2b3f1a2b3c4d5e6f701"
                full_name: "Acme Solar Corp"
                status: "active"
                station_count: 3
            total: 8
            offset: 0
            limit: 20
    "400":
      $ref: "../../components.yaml#/components/responses/Failure"