> ## Documentation Index
> Fetch the complete documentation index at: https://docs.raul.ugps.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Obtener todos los clientes

> Retorna el listado completo de clientes en formato snake_case para compatibilidad con el frontend legacy. Permite filtrar por presencia de suscripciones activas.



## OpenAPI

````yaml /generated/specs/clients.json get /api/v1/client/all
openapi: 3.0.0
info:
  title: Raul API - Clientes
  description: Clientes, clientes padre, direcciones, contactos y activos asociados.
  version: 2.0.0
  contact: {}
servers:
  - url: https://api.raul.ugps.io
    description: Production
security: []
tags:
  - name: Clients
    description: Gestion de clientes
paths:
  /api/v1/client/all:
    get:
      tags:
        - Clients
      summary: Obtener todos los clientes
      description: >-
        Retorna el listado completo de clientes en formato snake_case para
        compatibilidad con el frontend legacy. Permite filtrar por presencia de
        suscripciones activas.
      operationId: ClientsController_getAllClients
      parameters:
        - name: has_subscription
          required: false
          in: query
          description: Filtrar solo clientes con suscripciones activas
          schema:
            type: boolean
      responses:
        '200':
          description: Lista de clientes obtenida exitosamente
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ClientListResponseDto'
      security:
        - bearerAuth: []
components:
  schemas:
    ClientListResponseDto:
      type: object
      properties:
        data:
          description: Lista de clientes
          type: array
          items:
            $ref: '#/components/schemas/ClientListItemDto'
      required:
        - data
    ClientListItemDto:
      type: object
      properties:
        clientId:
          type: string
          description: ID del cliente
        clientName:
          type: object
          description: Nombre del cliente
        fantasyName:
          type: object
          description: Nombre de fantasía
        rut:
          type: object
          description: RUT formateado
        typeOfContract:
          type: object
          description: Tipo de contrato
        idNavixy:
          type: object
          description: ID de Navixy
        idWialon:
          type: object
          description: ID de Wialon
        rubroId:
          type: object
          description: ID del rubro
        classification:
          type: object
          description: Clasificación
        integration:
          type: object
          description: Integración activa
        gpsCount:
          type: number
          description: Cantidad de GPS activos
        idFather:
          type: object
          description: ID del cliente padre
        cityName:
          type: object
          description: Nombre de la ciudad
        regionName:
          type: object
          description: Nombre de la región
      required:
        - clientId
        - gpsCount
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: Bearer token authentication

````