# Lister les liens

`GET https://api.payiz.app/v1/payment_links`

Demande une clé secrète qui porte le geste « Liens · lire ».

Filtrable par lien ouvert ou fermé.

## Ce qu'on met dans l'adresse

| Champ | Type | Requis | Ce que c'est |
| --- | --- | --- | --- |
| `active` | « true » · « false » | — | Les liens ouverts, ou fermés. |
| `limit` | entier | — | De 1 à 100. Par défaut 20. |
| `starting_after` | texte | — | L’identifiant de la dernière ligne lue : la page suivante commence après. |

## Ce qu'on reçoit

`200` · une liste d’objets `payment_link`

| Champ | Type | Requis | Ce que c'est |
| --- | --- | --- | --- |
| `object` | « list » | — | Le genre de l’objet rendu : il ne change jamais. |
| `data` | liste d’objets payment_link | — | Les liens de la page, du plus récent au plus ancien. |
| `has_more` | vrai ou faux | — | Vrai : il en reste. Rappelez avec starting_after sur la dernière ligne lue. |
| `url` | texte | — | L’adresse qui a servi, sans les filtres. |

## La demande

```bash
curl -G https://api.payiz.app/v1/payment_links \
  -H "Authorization: Bearer sk_test_…" \
  -d active=true
```

## La réponse

```json
{
  "object": "list",
  "url": "/v1/payment_links",
  "has_more": false,
  "data": [
    {
      "object": "payment_link",
      "id": "lnk_01j9xc4qv2n8ywd3hs6m",
      "url": "https://pay.payiz.app/l/robe-wax-brodee",
      "title": "Robe wax brodée",
      "description": "Taille unique, livraison sous 48 h.",
      "type": "fixed",
      "amount": 12500,
      "min_amount": null,
      "max_amount": null,
      "currency": "XOF",
      "reusable": true,
      "fees_paid_by": "merchant",
      "collect": [
        "email",
        "name"
      ],
      "active": true,
      "payments_count": 2,
      "amount_collected": 25000,
      "expires_at": null,
      "created": 1789998092,
      "livemode": false
    }
  ]
}
```