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

# Listar documentos

> Enumera todos los documentos almacenados en una base de conocimiento específica de Famulor mediante la API. Inspecciona nombres de archivo, tamaños y estado de indexación usados por los asistentes de voz de IA.

<Warning>
  **API de Famulor 1.0 (legado).** Esta página se aplica únicamente a Famulor 1.0 (`app.famulor.de`) y se conserva por compatibilidad. Para la plataforma actual, usa la [referencia de la API de Famulor 2.0](/es/api-reference/introduction).
</Warning>

Este endpoint devuelve una lista de todos los documentos de una base de conocimiento específica.

### Parámetros de ruta

<ParamField path="knowledgebaseId" type="integer" required>
  El identificador único de la base de conocimiento
</ParamField>

### Campos de respuesta

<ResponseField name="data" type="array">
  Array de objetos de documento

  <Expandable title="Propiedades del documento">
    <ResponseField name="id" type="integer">
      El identificador único del documento
    </ResponseField>

    <ResponseField name="name" type="string">
      El nombre del documento
    </ResponseField>

    <ResponseField name="description" type="string">
      Descripción opcional del documento
    </ResponseField>

    <ResponseField name="type" type="string">
      Tipo de documento: `website`, `pdf`, `txt` o `docx`
    </ResponseField>

    <ResponseField name="type_label" type="string">
      Etiqueta de tipo legible para humanos
    </ResponseField>

    <ResponseField name="status" type="string">
      Estado de procesamiento: `processing`, `active` o `failed`
    </ResponseField>

    <ResponseField name="status_label" type="string">
      Etiqueta de estado legible para humanos
    </ResponseField>

    <ResponseField name="created_at" type="string">
      Marca de tiempo ISO 8601 de creación
    </ResponseField>

    <ResponseField name="updated_at" type="string">
      Marca de tiempo ISO 8601 de la última actualización
    </ResponseField>
  </Expandable>
</ResponseField>

### Estado del documento

| Estado       | Descripción                                                                 |
| ------------ | --------------------------------------------------------------------------- |
| `processing` | El documento se está analizando e incorporando a la base de datos vectorial |
| `active`     | El documento se ha procesado y está listo para usarse                       |
| `failed`     | El procesamiento del documento falló                                        |

<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>
  Páginas relacionadas: [Introducción](/es/api-v1/introduction) y [Guía de autenticación](/es/api-v1/authentication), y [Ejemplos de integración de la API](/es/api-v1/introduction).
</Tip>