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

> Enumera las etiquetas 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 etiquetas son marcas que puedes aplicar a los asistentes. A diferencia de las carpetas, un asistente puede tener varias etiquetas, y una etiqueta puede aplicarse a muchos asistentes. Las etiquetas son privadas de tu cuenta.

Este endpoint devuelve tus etiquetas (paginadas), cada una con el número de asistentes a los que se aplica.

### Parámetros de consulta

<ParamField query="per_page" type="integer">
  Número de etiquetas 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 etiqueta</ResponseField>
    <ResponseField name="name" type="string">El nombre de la etiqueta</ResponseField>
    <ResponseField name="color" type="string">El color de la etiqueta (o `null`)</ResponseField>
    <ResponseField name="assistants_count" type="integer">Número de asistentes a los que se aplica esta etiqueta</ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json 200 Success Response theme={null} theme={null}
  {
    "data": [
      { "id": 3, "name": "Inbound", "color": "green", "assistants_count": 7 },
      { "id": 5, "name": "Outbound", "color": "blue", "assistants_count": 2 }
    ],
    "current_page": 1,
    "per_page": 15,
    "total": 2
  }
  ```
</ResponseExample>