Listar eventos

Lista los eventos de tu negocio. Del más reciente al más antiguo. Mismo modo (test/live) que tu API key.

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

Filtra por type (p. ej. payment.succeeded). Útil para reconciliar o depurar entregas.

Query

Campo

Descripción

type

stringopcional

Tipo de evento.Ej: payment.succeeded

aggregate_id

stringopcional

Solo eventos de ese recurso (p. ej. pi_… o cus_…).Ej: pi_01J8Z3K4M5N6P7Q8R9S0T1U2V3

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 · HTTP directo; SDK oficial → /sdks

Fetch Request

$ # Node 18+ fetch · SDK oficial: npm i @kuti-pe/node

const response = await fetch("https://api.kuti.pe/v1/events?page=1&per_page=25&type=payment.succeeded", {
  method: "GET",
  headers: {
    "Authorization": "Bearer kuti_live_…"
  }
});

const data = await response.json();
console.log(data);

HTTP directo · este endpoint aún no está en el SDK v1 → /sdks

Response

Elige un ejemplo de respuesta:

application/json

200OK

{
  "success": true,
  "data": [
    {
      "id": "evt_01J8Z3K4M5N6P7Q8R9S0T1U2V3",
      "type": "payment.succeeded",
      "merchant_id": "mer_01J8Z3K4M5N6P7Q8R9S0T1U2V3",
      "created_at": "2026-09-04T10:48:59.556906Z",
      "data": {
        "payment_intent": {
          "id": "pi_01J8Z3K4M5N6P7Q8R9S0T1U2V3",
          "merchant_id": "mer_01J8Z3K4M5N6P7Q8R9S0T1U2V3",
          "amount": {
            "amount": "50.00",
            "currency": "PEN"
          },
          "status": "SUCCEEDED",
          "description": "Pedido #1042",
          "customer": {
            "id": "cus_01J8Z3K4M5N6P7Q8R9S0T1U2V3",
            "type": "INDIVIDUAL",
            "first_name": "María",
            "last_name": "López",
            "name": "María López",
            "document": {
              "type": "DNI",
              "number": "45678912",
              "country": "PE"
            },
            "email": "maria@example.com"
          }
        }
      }
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 25,
    "total": 1,
    "total_pages": 1,
    "has_more": false
  }
}