> ## 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 messages

> Liste les messages avec pagination par curseur.

## Endpoint

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

## Paramètres query

| Nom          | Type    | Requis | Description           |
| ------------ | ------- | ------ | --------------------- |
| `limit`      | integer | non    | Taille de page        |
| `cursor`     | string  | non    | Curseur de pagination |
| `instanceId` | UUID    | non    | Filtre par instance   |
| `status`     | string  | non    | Filtre par statut     |

## Exemple de requête

```bash theme={null}
curl "https://srv.msgflash.com/api/v1/messages?limit=20&status=delivered" \
  -H "x-api-key: msgf_live_your_api_key_here"
```

## Réponse succès `200`

```json theme={null}
{
  "data": {
    "messages": [
      {
        "id": "msg_uuid",
        "userId": "user_uuid",
        "instanceId": "inst_uuid",
        "contactId": null,
        "campaignId": null,
        "direction": "outbound",
        "type": "text",
        "from": null,
        "to": "+33612345678",
        "body": "Bonjour",
        "mediaUrl": null,
        "status": "delivered",
        "error": null,
        "meta": {},
        "providerMessageId": "BAE5D1A2B3C4D5E6",
        "createdAt": "2026-04-01T10:00:00.000Z",
        "updatedAt": "2026-04-01T10:01:10.000Z"
      }
    ],
    "nextCursor": null,
    "hasMore": false
  }
}
```

## Erreurs courantes

| HTTP  | Code           | Quand        |
| ----- | -------------- | ------------ |
| `401` | `UNAUTHORIZED` | Clé invalide |