> ## Documentation Index
> Fetch the complete documentation index at: https://docs.taap.it/llms.txt
> Use this file to discover all available pages before exploring further.

# Lister les liens

> Récupérer une liste de tous les liens dans un espace de travail

Récupérer tous les liens avec des options de pagination et de filtrage.

**Requête :**

```bash cURL theme={null}
curl -X GET 'https://api.taap.it/v1/links?archived=false&sort_by=created_at&sort_order=desc&page=1&page_size=20&cursor=eyJpZCI6ImxpbmtfOTg3NjU0MzIxIn0=' \
  -H 'Authorization: Bearer taapit_your_api_key_here'
```

**Réponse :**

```json theme={null}
{
  "items": [
    {
      "id": "link_987654321",
      "original_url": "https://example.com/very-long-url-that-needs-shortening",
      "short_url": "https://taapit.com/my-custom-link",
      "code": "my-custom-link",
      "created_at": "2024-01-15T10:30:00Z",
      "click_count": 42,
      "is_active": true,
      "is_archived": false
    }
  ],
  "page": 1,
  "page_size": 10,
  "has_next": true,
  "has_prev": false,
  "next_cursor": "eyJpZCI6ImxpbmtfOTg3NjU0MzIxIn0=",
  "prev_cursor": null
}
```

## Autorisation

<ParamField header="Authorization" type="string" required>
  Token Bearer pour l'authentification API. Format : `Bearer YOUR_API_KEY`
</ParamField>

## Paramètres de requête

### Paramètres de pagination

<ParamField query="cursor" type="string">
  Curseur pour la pagination (utiliser pour une pagination efficace)
</ParamField>

<ParamField query="page" type="integer" default="1">
  Numéro de page (commence à 1)
</ParamField>

<ParamField query="page_size" type="integer" default="20">
  Nombre d'éléments par page (maximum 100)
</ParamField>

### Paramètres de tri

<ParamField query="sort_by" type="string">
  Champ de tri (e.g., "created\_at", "updated\_at", "clicks", "code")
</ParamField>

<ParamField query="sort_order" type="string" default="desc">
  Ordre de tri: "asc" pour croissant ou "desc" pour décroissant
</ParamField>

### Paramètres de filtrage

<ParamField query="archived" type="boolean">
  Filtrer par statut d'archivage (true pour les liens archivés, false pour les liens actifs)
</ParamField>