# API · List recurring plans

> Listing of the integration's recurring plans.

- kind: api-operation
- status: stable
- api_version: v1
- last_verified: 2026-10-20
- url: https://tilopay.com/en/developers/api/recurrentes/planes/get-plans

```http
POST /api/v1/getPlansRepeat
```

## What it does [#que-hace]

Returns the merchant's recurring plans.

## Authentication [#autenticacion]

Requires the API bearer token in the `Authorization` header — see [authentication](/en/developers/api/autenticacion).

## Parameters [#parametros]

<Param id="get-plans-parametro-key" name="key" type="string" required>
Tilopay integration key.
</Param>

## Request example [#request]

The `<...>` values are placeholders: replace them with your own credentials and data.

```json
{
  "key": "<api_key>"
}
```

## Response [#respuesta]

```json
{
  "type": "200",
  "message": "Success",
  "data": [
    {
      "id": 276,
      "title": "Plan test 1",
      "description": "Plan",
      "frequency": 1,
      "currency": "USD",
      "first_amount": "0.00",
      "trial": 0,
      "trial_days": 0,
      "attempts": 1,
      "status": 1,
      "thanks_url": "",
      "return_url": null,
      "webhook_subscribe": "",
      "webhook_payment": "",
      "webhook_rejected": "",
      "webhook_unsubscribe": "",
      "webhook_reactive": "",
      "modality": [
        {
          "id": 131,
          "title": "Basic",
          "amount": "10.00"
        }
      ],
      "end_at": "2022-10-25"
    }
  ]
}
```

To interpret a response that is not a success, see [how to read an error response](/en/developers/api/procesos-operativos/errors).