# Listar links de pagamento
`GET /v1/checkouts`
**Área:** Links de pagamento

**Scopes necessários:** `checkouts/read`

Lista todas as páginas de pagamento (checkouts) criadas, com seus status e configurações. Suporta paginação e filtros por status e busca textual.

### Query parameters

| Campo | Obrigatório | Descrição |
|---|---|---|
| `lastKey` | **sim** | base64 - optional |
| `status` | **sim** | Filtra por status do checkout - optional |
| `search` | **sim** | Busca por texto - optional |
| `limit` | não | Quantidade de itens por página (default 15) - optional |

### Resposta 200 — 200

```json
{
  "items": [
    {
      "id": "pl_xxx",
      "url": "https://app.validapay.com.br/pagamento/pl_xxx"
    }
  ],
  "pagination": {
    "total": 5,
    "hasMore": false
  }
}
```

---
Página: https://docs.validapay.com.br/documentacao-validapay2/get-listar-links-de-pagamento
Contrato OpenAPI: https://docs.validapay.com.br/openapi.json