Listar suscripciones

Las suscripciones del negocio, de la más reciente a la más antigua.

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

El modo (test/live) lo define tu API key.

Query

Campo

Descripción

status

stringopcional

INCOMPLETE, ACTIVE, PAST_DUE, PAUSED, CANCELLED o COMPLETED.

customer_id

stringopcional

Solo las de este cliente (cus_…).

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.subscriptions.list({ status: "PAST_DUE" });
console.log(result.data);

SDK oficial · guía en /sdks

Response

Elige un ejemplo de respuesta:

application/json

200OK

{
  "success": true,
  "data": [
    {
      "id": "sub_01J8Z3K4M5N6P7Q8R9S0T1U2V3",
      "merchant_id": "mer_01J8Z3K4M5N6P7Q8R9S0T1U2V3",
      "livemode": false,
      "customer": {
        "id": "cus_01J8Z3K4M5N6P7Q8R9S0T1U2V3",
        "name": "María López",
        "email": "maria@example.pe",
        "phone": "+51987654567"
      },
      "description": "Plan Pro",
      "billing_mode": "fixed",
      "amount": {
        "amount": "99.00",
        "currency": "PEN"
      },
      "setup_url": null,
      "items": [
        {
          "description": "Plan Pro",
          "unit_amount": "99.00",
          "quantity": 1,
          "amount": "99.00"
        }
      ],
      "frequency": "MONTHLY",
      "interval": 1,
      "day_of_month": 5,
      "last_day_of_month": false,
      "day_of_week": null,
      "start_date": "2026-10-05",
      "end_date": null,
      "charge_time": "09:00",
      "next_charge_at": "2026-11-05T14:00:00.000Z",
      "status": "ACTIVE",
      "payment_method": {
        "id": "pm_01J8Z3K4M5N6P7Q8R9S0T1U2V3",
        "type": "YAPE",
        "phone_last4": "4567",
        "status": "ACTIVE"
      },
      "retry_policy": {
        "interval_days": [
          1,
          3,
          5
        ],
        "on_exhausted": "past_due"
      },
      "latest_cycle": {
        "id": "subc_01J8Z3K4M5N6P7Q8R9S0T1U2V3",
        "billing_period": "2026-10",
        "due_date": "2026-10-05",
        "amount": {
          "amount": "99.00",
          "currency": "PEN"
        },
        "status": "PAID",
        "attempts": 1,
        "last_failure_code": null,
        "next_attempt_at": null,
        "payment_intent_id": "pi_01J8Z3K4M5N6P7Q8R9S0T1U2V5",
        "checkout_url": null,
        "paid_at": "2026-10-05T14:00:03.000Z"
      },
      "external_reference": "cliente-4821",
      "metadata": {},
      "cancelled_at": null,
      "created_at": "2026-10-05T14:00:00.000Z",
      "updated_at": "2026-10-05T14:00:03.000Z"
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 25,
    "total": 1,
    "total_pages": 1,
    "has_more": false
  }
}