# API · Listar links de pago

> Listado paginado de los links de pago del comercio.

- kind: api-operation
- status: stable
- api_version: v1
- last_verified: 2026-08-29
- url: https://www.tilopay.com/developers/api/links-de-pago/payment-item-list

```http
GET /api/v1/getLinkPaymentList/{api_key}/{limit}
```

## Qué hace [#que-hace]

Devuelve la lista paginada de links de pago del comercio. No lleva cuerpo: los datos van en la ruta.

## Autenticación [#autenticacion]

Requiere el token bearer del API en el header `Authorization` — ver [autenticación](/developers/api/autenticacion).

## Parámetros [#parametros]

Parámetros de ruta, en el orden en que aparecen en la URL:

<Param id="payment-item-list-parametro-api-key" name="api_key" type="string · path" required>
Api Key del comercio.
</Param>

<Param id="payment-item-list-parametro-limit" name="limit" type="string · path" required>
Cantidad de registros por página.
</Param>

## Respuesta [#respuesta]

```json
{
  "type": "200",
  "message": "Success",
  "data": {
    "current_page": 1,
    "first_page_url": "http://app.tilopay.com/api/v1/getLinkPaymentList/<api_key>/10?page=1",
    "from": 1,
    "last_page": 2,
    "last_page_url": "http://app.tilopay.com/api/v1/getLinkPaymentList/<api_key>/10?page=2",
    "next_page_url": "http://app.tilopay.com/api/v1/getLinkPaymentList/<api_key>/10?page=2",
    "path": "http://app.tilopay.com/api/v1/getLinkPaymentList/<api_key>/10",
    "per_page": 10,
    "prev_page_url": null,
    "to": 10,
    "total": 16,
    "payment_link": [
      {
        "id": 1,
        "amount": "45.00",
        "currency": "USD",
        "reference": "Producto de prueba 1 TP-Shop",
        "url": "https://admin.tilopay.com/link/3dNjE2MA3sdd==",
        "callback_url": null,
        "description": "Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.",
        "times_used": null,
        "picture": "https://storage.googleapis.com/tilo-uploads/items/51087219_.png",
        "create": "2022-10-24 08:45:14"
      },
      {
        "id": 2,
        "amount": "35.00",
        "currency": "USD",
        "reference": "Producto de prueba 2",
        "url": "https://admin.tilopay.com/link/dwNjE2see3MA==",
        "callback_url": null,
        "description": "Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.",
        "times_used": null,
        "picture": "https://storage.googleapis.com/tilo-uploads/items/64156766_.png",
        "create": "2022-10-24 08:45:14"
      },
      {
        "id": 3,
        "amount": "45.00",
        "currency": "USD",
        "reference": "Producto de prueba 3",
        "url": "https://admin.tilopay.com/link/f4NjE2MwsdA==",
        "callback_url": null,
        "description": "Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.",
        "times_used": null,
        "picture": "https://storage.googleapis.com/tilo-uploads/items/88435879_.png",
        "create": "2022-10-24 08:45:14"
      },
      {
        "id": 4,
        "amount": "45.00",
        "currency": "USD",
        "reference": "test",
        "url": "https://admin.tilopay.com/link/ceNjE2sxw2MA==",
        "callback_url": null,
        "description": "ddd",
        "times_used": null,
        "picture": "https://storage.googleapis.com/tilo-uploads/items/37716065_.png",
        "create": "2022-10-24 08:45:14"
      },
      {
        "id": 5,
        "amount": "45.00",
        "currency": "USD",
        "reference": "test",
        "url": "https://admin.tilopay.com/link/cweNjE2Mfd5A==",
        "callback_url": null,
        "description": "ddd",
        "times_used": null,
        "picture": "https://storage.googleapis.com/tilo-uploads/items/37716065_.png",
        "create": "2022-10-24 08:45:14"
      },
      {
        "id": 6,
        "amount": "45.00",
        "currency": "USD",
        "reference": "test",
        "url": "https://admin.tilopay.com/link/ce3NjE2fg5eMA==",
        "callback_url": null,
        "description": "ddd",
        "times_used": null,
        "picture": "https://storage.googleapis.com/tilo-uploads/items/37716065_.png",
        "create": "2022-10-24 08:45:14"
      },
      {
        "id": 7,
        "amount": "45.00",
        "currency": "USD",
        "reference": "test",
        "url": "https://admin.tilopay.com/link/dsNjE2MAd32==",
        "callback_url": null,
        "description": "ddd",
        "times_used": null,
        "picture": "https://storage.googleapis.com/tilo-uploads/items/37716065_.png",
        "create": "2022-10-24 08:45:14"
      },
      {
        "id": 8,
        "amount": "45.00",
        "currency": "USD",
        "reference": "test",
        "url": "https://admin.tilopay.com/link/NjE2sd32MA==",
        "callback_url": null,
        "description": "ddd",
        "times_used": null,
        "picture": "https://storage.googleapis.com/tilo-uploads/items/37716065_.png",
        "create": "2022-10-24 08:45:14"
      },
      {
        "id": 9,
        "amount": "45.00",
        "currency": "USD",
        "reference": "test",
        "url": "https://admin.tilopay.com/link/sd3NjE2MA==",
        "callback_url": null,
        "description": "ddd",
        "times_used": null,
        "picture": "https://storage.googleapis.com/tilo-uploads/items/37716065_.png",
        "create": "2022-10-24 08:45:14"
      },
      {
        "id": 10,
        "amount": "45.00",
        "currency": "USD",
        "reference": "test",
        "url": "https://admin.tilopay.com/link/d3dNjE2MA==",
        "callback_url": null,
        "description": "ddd",
        "times_used": null,
        "picture": "https://storage.googleapis.com/tilo-uploads/items/37716065_.png",
        "create": "2022-10-24 08:45:14"
      }
    ]
  }
}
```

Para interpretar una respuesta que no es de éxito, ver [cómo leer una respuesta de error](/developers/api/procesos-operativos/errors).