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

# Historique

> Historique des messages sortants enregistrés en base

Pour suivre le statut d'un message programmé, utilisez cet endpoint avec le filtre `?status=PENDING`. Une fois traité, le statut passe à `SENT` ou `FAILED`.


## OpenAPI

````yaml api-reference/openapi.json GET /sessions/{sessionId}/messages
openapi: 3.1.0
info:
  title: WaaConnect API
  description: >-
    API WhatsApp multi-sessions de WaaConnect. Toutes les routes de messagerie
    sont préfixées par /sessions/:sessionId/ et nécessitent le header x-api-key.
  version: 1.0.0
servers:
  - url: https://api.waaconnect.com/v1
security:
  - apiKey: []
paths:
  /sessions/{sessionId}/messages:
    get:
      tags:
        - Messages
      summary: Historique des messages sortants
      parameters:
        - name: sessionId
          in: path
          required: true
          schema:
            type: string
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            default: 50
            minimum: 1
            maximum: 200
        - name: status
          in: query
          required: false
          schema:
            type: string
            enum:
              - PENDING
              - SENT
              - FAILED
        - name: to
          in: query
          required: false
          schema:
            type: string
          description: Filtre par destinataire exact (JID)
      responses:
        '200':
          description: Liste des messages
          content:
            application/json:
              schema:
                type: object
                properties:
                  count:
                    type: integer
                  items:
                    type: array
                    items:
                      type: object
              example:
                count: 2
                items:
                  - id: uuid-message-451
                    sessionId: uuid-session-12
                    toNumber: 22997000000@s.whatsapp.net
                    content: Bonjour, votre commande est prête.
                    status: SENT
                    sentAt: '2026-03-26T16:30:10.000Z'
                    createdAt: '2026-03-26T16:30:08.000Z'
components:
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: x-api-key

````