---
title: "Listar"
method: GET
path: "/subscriptions"
tags: ["Suscripciones"]
---

# Listar

`GET /subscriptions`

## Request

- Base URL: `https://api.ventipay.com/v1`
- URL: `https://api.ventipay.com/v1/subscriptions`
- Auth: HTTP bearer

Devuelve una lista de objetos `Subscription`. Los registros se devuelven en orden y los más recientes aparecen primero. Por defecto se devuelven los últimos 10 registros creados.

## Query parameters

- `customer_id` string
- `metadata` string, json
- `plan_id` string
- `status` string[]

---

[API](https://skmtc.dev/ventipay/apis/suscripciones.md) - [All operations](https://skmtc.dev/ventipay/apis/suscripciones/llms.txt) - [OpenAPI document](https://skmtc.dev/ventipay/apis/suscripciones/revisions/8189bbaa5f79?raw)