Listar negocios

Lista merchants con paginación por offset. Del más reciente al más antiguo según el orden del servidor.

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

per_page acepta un entero 1–100 o el literal all para traer todos en una sola página (total_pages = 1).

Query

page

integeropcional

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

per_page

integer | allopcional

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

q

stringopcional

Busca por razón social, nombre comercial o RUC (coincidencia parcial).

Language

Credentials

Header

Authorization

Secret key de developer · ejemplos con librerías estándar (aún sin SDK)

cURL Request

curl -s 'https://api.kuti.pe/v1/merchants?page=1&per_page=25&q=Andina' \
  -H 'Authorization: Bearer kuti_live_…'

Librería estándar · sin SDK propio

Response

Elige un ejemplo de respuesta:

application/json

200OK

{
  "success": true,
  "data": [
    {
      "id": "mer_01J8Z3K4M5N6P7Q8R9S0T1U2V3",
      "legal_name": "Cafetería Andina S.A.C.",
      "trade_name": "Café Andina",
      "tax_id": {
        "country": "PE",
        "type": "RUC",
        "value": "20123456789"
      },
      "country": "PE",
      "default_currency": "PEN",
      "email": "pagos@cafeandina.pe",
      "phone": "+51999999999",
      "status": "ACTIVE",
      "created_at": "2026-09-04T10:48:59.556906Z"
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 25,
    "total": 1,
    "total_pages": 1,
    "has_more": false
  }
}