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

# Lister les documents

> Listez tous les documents stockés dans une base de connaissances Famulor spécifique via l'API. Inspectez les noms de fichiers, tailles et statuts d'indexation utilisés par les assistants vocaux IA.

<Warning>
  **API Famulor 1.0 (héritée).** Cette page concerne uniquement Famulor 1.0 (`app.famulor.de`) et est conservée pour la compatibilité. Pour la plateforme actuelle, consultez la [référence API Famulor 2.0](/fr/api-reference/introduction).
</Warning>

Ce point de terminaison renvoie la liste de tous les documents d'une base de connaissances spécifique.

### Paramètres de chemin

<ParamField path="knowledgebaseId" type="integer" required>
  L'identifiant unique de la base de connaissances
</ParamField>

### Champs de réponse

<ResponseField name="data" type="array">
  Tableau d'objets document

  <Expandable title="Propriétés du document">
    <ResponseField name="id" type="integer">
      L'identifiant unique du document
    </ResponseField>

    <ResponseField name="name" type="string">
      Le nom du document
    </ResponseField>

    <ResponseField name="description" type="string">
      Description facultative du document
    </ResponseField>

    <ResponseField name="type" type="string">
      Type de document : `website`, `pdf`, `txt` ou `docx`
    </ResponseField>

    <ResponseField name="type_label" type="string">
      Libellé de type lisible par un humain
    </ResponseField>

    <ResponseField name="status" type="string">
      Statut de traitement : `processing`, `active` ou `failed`
    </ResponseField>

    <ResponseField name="status_label" type="string">
      Libellé de statut lisible par un humain
    </ResponseField>

    <ResponseField name="created_at" type="string">
      Horodatage ISO 8601 de création
    </ResponseField>

    <ResponseField name="updated_at" type="string">
      Horodatage ISO 8601 de la dernière mise à jour
    </ResponseField>
  </Expandable>
</ResponseField>

### Statut du document

| Statut       | Description                                                                            |
| ------------ | -------------------------------------------------------------------------------------- |
| `processing` | Le document est en cours d'analyse et d'indexation dans la base de données vectorielle |
| `active`     | Le document a été traité et est prêt à l'emploi                                        |
| `failed`     | Le traitement du document a échoué                                                     |

<ResponseExample>
  ```json 200 Success theme={null}
  {
    "data": [
      {
        "id": 1,
        "name": "Product Handbook",
        "description": "Complete user manual for the product",
        "type": "pdf",
        "type_label": "PDF",
        "status": "active",
        "status_label": "Active",
        "created_at": "2025-01-05T10:30:00.000000Z",
        "updated_at": "2025-01-05T10:35:00.000000Z"
      },
      {
        "id": 2,
        "name": "Company Website",
        "description": "Main website content",
        "type": "website",
        "type_label": "Website",
        "status": "processing",
        "status_label": "Processing",
        "created_at": "2025-01-08T09:00:00.000000Z",
        "updated_at": "2025-01-08T09:00:00.000000Z"
      }
    ]
  }
  ```

  ```json 404 Knowledgebase Not Found theme={null}
  {
    "error": "Knowledgebase not found."
  }
  ```
</ResponseExample>

<Tip>
  Voir aussi : [Introduction](/fr/api-v1/introduction) et [Guide d'authentification](/fr/api-v1/authentication), et [Exemples d'intégration API](/fr/api-v1/introduction).
</Tip>