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

# Uso de un Segmento

> Consulta qué campañas y subagentes usan un segmento

Devuelve dónde se usa un [segmento](/api-reference/segments/overview): las campañas que todavía pueden enviar a su audiencia y los subagentes cuya activación depende de él. Es útil para revisar el impacto antes de editar o eliminar un segmento.

<Warning>
  Cambiar las reglas de un segmento dinámico, o quitar miembros de uno estático, afecta de inmediato a las campañas y subagentes que aparecen aquí.
</Warning>

***

## Path Parameters

<ParamField path="id" type="string" required>
  UUID del segmento
</ParamField>

***

## Respuesta

<ResponseField name="data.broadcasts" type="array">
  Campañas **vivas** que usan el segmento como origen de destinatarios. Solo se incluyen las que están en estado `draft`, `scheduled`, `sending` o `paused`; las terminadas o fallidas no cuentan. Más recientes primero.

  <Expandable title="propiedades">
    <ResponseField name="id" type="string">UUID de la campaña</ResponseField>
    <ResponseField name="name" type="string">Nombre de la campaña</ResponseField>
    <ResponseField name="status" type="string">Estado actual</ResponseField>
    <ResponseField name="scheduledAt" type="string | null">Próxima tanda o inicio programado del envío (ISO 8601); `null` si no hay fecha</ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="data.subagents" type="array">
  Subagentes del negocio con una regla de activación por este segmento, ordenados por nombre.

  <Expandable title="propiedades">
    <ResponseField name="id" type="string">UUID del subagente</ResponseField>
    <ResponseField name="name" type="string">Nombre del subagente</ResponseField>
    <ResponseField name="isActive" type="boolean">Si el subagente está activo</ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "data": {
      "broadcasts": [
        {
          "id": "0b8f3c0e-8c1a-4a77-9b0e-6f1f4f0a1111",
          "name": "Promo de octubre",
          "status": "scheduled",
          "scheduledAt": "2026-10-20T15:00:00.000Z"
        }
      ],
      "subagents": [
        {
          "id": "5d2c9a52-3b1e-4f6a-8d7c-2a9e4c0b2222",
          "name": "Ventas VIP",
          "isActive": true
        }
      ]
    }
  }
  ```
</ResponseExample>

***

## Errores

| Código | Causa |
| - | - |
| `404` | El `id` no es un UUID válido, o el segmento no existe o no es de tu negocio |
| `500` | Error interno al consultar el uso |

***

## Ejemplo

<RequestExample>
  ```bash cURL theme={null}
  curl https://api.whaapy.com/segments/7c9e6679-7425-40de-944b-e07fc1f90ae7/usage \
    -H "Authorization: Bearer wha_TU_API_KEY"
  ```

  ```javascript Node.js theme={null}
  const response = await fetch(
    'https://api.whaapy.com/segments/7c9e6679-7425-40de-944b-e07fc1f90ae7/usage',
    { headers: { 'Authorization': 'Bearer wha_TU_API_KEY' } }
  );
  const { data } = await response.json();
  console.log(data.broadcasts.length, data.subagents.length);
  ```
</RequestExample>


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