Listar clientes

Lista customers del merchant autenticado, con búsqueda y paginación.

GEThttps://api.kuti.pe/v1/customers

per_page acepta un entero 1–100 o el literal all. q busca en nombre, razón social, correo, documento o external_id.

Query

Campo

Descripción

q

stringopcional

Búsqueda por nombre, razón social, correo, documento o external_id.

page

integeropcional

Página (1-based).Ej: 1

per_page

integer | allopcional

Elementos por página (1–100) o all.Ej: 25

Language

Credentials

Header

Authorization

Secret key de developer · ejemplos con SDK oficial

API Request

$ npm install @kuti-pe/node

import { KutiClient } from "@kuti-pe/node";

const kuti = new KutiClient({ secretKey: process.env.KUTI_SECRET_KEY! });

const result = await kuti.customers.list({ q: "ana", page: 1 });
console.log(result.data);

SDK oficial · guía en /sdks

Response

Elige un ejemplo de respuesta:

application/json

200OK

{
  "success": true,
  "data": [
    {
      "id": "cus_01J8Z3K4M5N6P7Q8R9S0T1U2V3",
      "merchant_id": "mer_01J8Z3K4M5N6P7Q8R9S0T1U2V3",
      "external_id": "cust_erp_4821",
      "type": "INDIVIDUAL",
      "first_name": "María",
      "last_name": "López",
      "document": {
        "type": "DNI",
        "number": "45678912",
        "country": "PE"
      },
      "email": "maria@example.com",
      "phone": "+51987654321",
      "created_at": "2026-09-04T10:48:59.556906Z"
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 25,
    "total": 1,
    "total_pages": 1,
    "has_more": false
  }
}