Devuelve los clientes de la empresa, ordenados por nombre. Los clientes eliminados no se incluyen.

```
v1/customers/get_list.php
```

## Parámetros

| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| limit | int | No | Tamaño de página, de 1 a 1000 |
| offset | int | No | Cuántos registros omitir |

Sin limit se devuelve toda la lista. Consulta la paginación en [Reglas generales](https://developers.controlata.com/hc/api-docs/articles/api-rules-es).

## Respuesta

Un array customers con los campos del cliente. El campo total contiene el número total de clientes.

| Campo | Tipo | Descripción |
|---|---|---|
| id | int | ID del cliente |
| name | string | Nombre |
| email | string | Correo electrónico |
| phone | string | Teléfono |
| address_legal | string | Dirección fiscal |
| address_real | string | Dirección de entrega |
| agreement | string | Acuerdo |
| manager_name | string | Responsable |
| manager_post | string | Puesto del responsable |
| notes | string | Notas |

## Ejemplo de solicitud

```
{
    "limit": 100,
    "offset": 0
}
```

## Ejemplo de respuesta

```
{
    "success": true,
    "customers": [
        {
            "id": 513,
            "name": "Ana García",
            "email": "anna@example.com",
            "phone": "+34 600 123 456",
            "address_legal": "",
            "address_real": "C/ Bauman 20, Valencia",
            "agreement": "",
            "manager_name": "",
            "manager_post": "",
            "notes": ""
        },
        {
            "id": 512,
            "name": "Patio del Mueble",
            "email": "pedidos@patiomueble.com",
            "phone": "+34 912 345 678",
            "address_legal": "C/ Mayor 5, Madrid",
            "address_real": "C/ Almacén 12, Madrid",
            "agreement": "N.º 15 del 10/01/2026",
            "manager_name": "Pedro Gómez",
            "manager_post": "Director general",
            "notes": ""
        }
    ],
    "total": 2
}
```

## Errores

| Error | Motivo |
|---|---|
| Invalid limit value. Must be between 1 and 1000 | limit no válido |
| Invalid offset value. Must be 0 or greater | offset no válido |
| Offset requires limit | se envió offset sin limit |
