Diagnosticar una petición

Qué pasó con una llamada: método, ruta, status, código de error, duración y lo que causó (eventos y el resultado de cada webhook). El id es el request_id del error o el header X-Request-Id.

GEThttps://api.kuti.pe/v1/diagnostics/requests/{id}

Permiso diagnostics:read. Solo peticiones de tu negocio y del modo de la clave (prueba o producción). Se guardan 30 días en prueba y 90 en producción.

Path

Campo

Descripción

id

stringrequerido

request_id de la petición.Ej: req_01J8Z3K4M5N6P7Q8R9S0T1U2V3

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.diagnostics.getRequest("req_01J8Z3K4M5N6P7Q8R9S0T1U2V3");
console.log(result.request, result.events);

SDK oficial · guía en /sdks

Response

Elige un ejemplo de respuesta:

application/json

200OK

{
  "success": true,
  "data": {
    "request": {
      "id": "req_01J8Z3K4M5N6P7Q8R9S0T1U2V3",
      "correlation_id": "pedido-1042",
      "livemode": false,
      "source": "API",
      "api_key_id": "ak_01J8Z3K4M5N6P7Q8R9S0T1U2V3",
      "method": "POST",
      "path": "/payment-intents",
      "route": "/payment-intents",
      "resource_id": null,
      "status": 201,
      "error_code": null,
      "duration_ms": 84,
      "idempotency_key": "pedido-1042",
      "created_at": "2026-09-29T15:10:02Z"
    },
    "events": [
      {
        "id": "evt_01J8Z3K4M5N6P7Q8R9S0T1U2V4",
        "type": "payment.created",
        "created_at": "2026-09-29T15:10:02Z",
        "webhook_deliveries": [
          {
            "id": "whd_01J8Z3K4M5N6P7Q8R9S0T1U2V5",
            "status": "DEAD",
            "attempts": 6,
            "last_http_status": 502,
            "last_error": "HTTP 502",
            "endpoint_url": "https://mi-tienda.pe/webhooks/kuti",
            "last_attempt_at": "2026-09-29T21:12:40Z"
          }
        ]
      }
    ]
  }
}