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

# Récupérer l’historique d’une conversation

Permet de récupérer l'historique complet (questions/réponses) d'une conversation entre un client et un agent, au format JSON.

## Paramètres de requête (query string)

<ParamField query="companyIdentifier" type="string" required>
  Identifiant du client (même valeur que pour [`/customers`](/clients/creer)).
</ParamField>

<ParamField query="agentUUID" type="string" required>
  UUID de l’agent (assistant) dont on veut l’historique.
</ParamField>

## Réponses

| Code | Corps JSON |
| - | - |
| 200 | `{ "messages": [ { "uuid": "…", "message": "…", "buttons": ["Option 1"], "message_type": "Answer", "created_at": "…", "review": "up" }, ... ] }` |
| 400 | `{ "error": "Missing parameters" }` |
| 401 | `{ "error": "Unauthorized: Unknown token" }` |
| 404 | `{ "error": "Unauthorized: Assistant not found for your company" }` ou `Customer not found` |
| 500 | `{ "error": "Internal Server Error" }` |

## Format des messages

Chaque message du tableau contient :

* `uuid` : identifiant du message (celui d’une réponse sert à la [noter](/conversations/noter))
* `message` : texte de la question ou réponse
* `buttons` : tableau d’options (si présent)
* `message_type` : "Question" ou "Answer"
* `created_at` : date ISO
* `review` *(réponses uniquement)* : `"up"`, `"down"` ou `null`, que la note vienne de l’API ou du pouce du chatbot
* `attachments` *(questions uniquement)* : fichiers joints à la question, chacun `{ "kind": "image" | "document", "name", "type", "size", "url" }`. `url` est un lien de téléchargement temporaire (valable 1 heure) ; il vaut `null` si le fichier n’a pas pu être conservé. Rappelez l’historique pour obtenir des liens neufs.

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET 'https://api.moustacheai.com/api/v1/responses?companyIdentifier=CLIENT_123&agentUUID=28ce3b2d-5791-4905-8d66-123456789abc' \
    -H "Authorization: Bearer MON_API_TOKEN"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "messages": [
      {
        "uuid": "5d0c9a2e-1f3b-4c7d-8e9f-0a1b2c3d4e5f",
        "message": "Que dit ce devis sur les délais ?",
        "message_type": "Question",
        "created_at": "2026-10-05T12:34:56.000Z",
        "attachments": [
          {
            "kind": "document",
            "name": "devis.pdf",
            "type": "application/pdf",
            "size": 48213,
            "url": "https://…/devis.pdf?X-Amz-Expires=3600&…"
          }
        ]
      },
      {
        "uuid": "9b2f6c1e-4a8d-4f3e-9c1a-2d5e7f8a9b0c",
        "message": "Le devis prévoit une livraison sous 3 semaines.",
        "buttons": null,
        "message_type": "Answer",
        "created_at": "2026-10-05T12:35:10.000Z",
        "review": null
      }
    ]
  }
  ```
</ResponseExample>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.