# API · Subscriber payments

> Payment history of the subscribers of a recurring plan.

- kind: api-operation
- status: stable
- api_version: v1
- last_verified: 2026-10-20
- url: https://tilopay.com/en/developers/api/recurrentes/suscriptores/suscriptor-payments

```http
POST /api/v1/getSuscriptorPayments
```

## What it does [#que-hace]

Returns the payments of the subscribers of a recurring plan.

## Authentication [#autenticacion]

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

## Parameters [#parametros]

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

<Param id="suscriptor-payments-parametro-id" name="id" type="string" required>
Recurring plan id.
</Param>

## Request example [#request]

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

```json
{
  "key": "<api_key>",
  "id": "1"
}
```

## Response [#respuesta]

```json
{
  "type": "200",
  "message": "Success",
  "data": [
    {
      "id": 150,
      "commerce_id": 37,
      "suscriptor_id": 86,
      "reference": "0",
      "currency": "USD",
      "amount": "0.00",
      "status": 0,
      "data": "{\"first\":1,\"expire\":\"2024-12-28T19:05:29.572648Z\",\"amount\":0,\"activeAmount\":0,\"originalAmount\":0,\"key\":\"XXXX-XXXX-XXXX-XXXX-XXXX\"}",
      "create": "2024-12-13 13:05:06"
    }
  ]
}
```

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