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

# Listar carpetas

> Lista las carpetas de tu cuenta

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

Las carpetas te permiten agrupar asistentes (por ejemplo, por cliente o por marca). Cada asistente puede pertenecer a una única carpeta. Las carpetas son privadas de tu cuenta.

Este endpoint devuelve tus carpetas (paginadas), cada una con el número de asistentes que contiene.

### Parámetros de consulta

<ParamField query="per_page" type="integer">
  Número de carpetas por página (1-100, predeterminado: 15)
</ParamField>

<ParamField query="page" type="integer">
  Número de página (predeterminado: 1)
</ParamField>

### Campos de respuesta

<ResponseField name="data" type="array">
  <Expandable title="propiedades">
    <ResponseField name="id" type="integer">El identificador único de la carpeta</ResponseField>
    <ResponseField name="name" type="string">El nombre de la carpeta</ResponseField>
    <ResponseField name="color" type="string">El color de la carpeta (o `null`)</ResponseField>
    <ResponseField name="assistants_count" type="integer">Número de asistentes en esta carpeta</ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json 200 Success Response theme={null} theme={null}
  {
    "data": [
      { "id": 12, "name": "Acme Corp", "color": "blue", "assistants_count": 4 },
      { "id": 18, "name": "Globex", "color": "teal", "assistants_count": 0 }
    ],
    "current_page": 1,
    "per_page": 15,
    "total": 2
  }
  ```
</ResponseExample>
