Obtener la lista de clientes

Maxim

Maxim

Última actualización el Oct 8, 2026

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.

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