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

# GET Lister les contacts

> Liste les contacts de votre compte avec pagination par curseur et recherche optionnelle.

## Endpoint

```txt theme={null}
GET /api/v1/contacts
```

## Paramètres query

| Champ    | Type    | Requis | Description                                                              |
| -------- | ------- | ------ | ------------------------------------------------------------------------ |
| `limit`  | integer | non    | Taille de page, défaut `50`, max `100`                                   |
| `cursor` | string  | non    | Curseur opaque retourné par la page précédente                           |
| `search` | string  | non    | Recherche insensible à la casse sur `name` ou `phone` (1-100 caractères) |
| `sort`   | string  | non    | `createdAt_desc` (défaut) ou `name_asc`                                  |

## Réponse succès `200`

```json theme={null}
{
  "data": {
    "contacts": [
      {
        "id": "cnt_uuid",
        "name": "Awa Doe",
        "phone": "+33612345000",
        "tags": ["vip"],
        "temperature": null,
        "createdAt": "2026-04-01T10:00:00.000Z",
        "updatedAt": "2026-04-01T10:00:00.000Z"
      }
    ],
    "total": 240,
    "limit": 50,
    "sort": "createdAt_desc",
    "nextCursor": "MjAyNi0wNC0wMVQxMDowMDowMC4wMDBafGNudF91dWlk",
    "hasMore": true
  }
}
```

## Notes

* Repassez la valeur de `nextCursor` comme `cursor` pour récupérer la page suivante. Arrêtez quand `hasMore` est `false` ou `nextCursor` vaut `null`.
* Le curseur encode le tuple de tri (`createdAt|id` ou `name|id`). Ne mélangez pas les tris entre les pages.