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

# Historial de conexiones

> La línea de tiempo de cuándo cada número fue vinculado y desvinculado de una instancia

Esta página documenta el **historial de conexiones**, una línea de tiempo auditable de cuándo cada número de WhatsApp fue vinculado (conectado) y desvinculado (desconectado) de una instancia. Sirve para que siga y compruebe qué número estuvo conectado en cada momento, útil al revisar un período facturado con transparencia, con el registro a mano.

## Consultar el historial

**`GET /api/account/connections?number=<jid>&instance=<id>&from=<rfc3339>&to=<rfc3339>&limit=<n>`**

Devuelve los eventos de vínculo y desvínculo de la cuenta, más recientes primero. Autentique con el **TokenAccount** de la cuenta, o con el token global pasando `?account=<nombre-de-la-cuenta>`. Todos los filtros son opcionales: sin ninguno, recibe los eventos más recientes de la cuenta.

<ParamField query="number" type="string">
  Filtra por un número específico. Use el JID exacto, ej. `5511999998888@s.whatsapp.net`.
</ParamField>

<ParamField query="instance" type="string">
  Filtra por una instancia específica. Use el `instanceId` que aparece en los propios eventos.
</ParamField>

<ParamField query="from" type="string">
  Inicio de la ventana, en RFC3339. Sin él, no hay límite inferior.
</ParamField>

<ParamField query="to" type="string">
  Fin de la ventana, en RFC3339. Sin él, no hay límite superior.
</ParamField>

<ParamField query="limit" type="integer">
  Máximo de eventos a devolver. Predeterminado `200`. Valores fuera del rango de `1` a `1000` también usan `200`.
</ParamField>

<ParamField query="account" type="string">
  Nombre de la cuenta. Obligatorio solo cuando usa el token global.
</ParamField>

<CodeGroup>
  ```bash cURL theme={null}
  curl "https://ryzeapi.cloud/api/account/connections?number=5511999998888@s.whatsapp.net&limit=50" \
    -H "token: $Token_Account"
  ```

  ```javascript JavaScript theme={null}
  const params = new URLSearchParams({
    number: "5511999998888@s.whatsapp.net",
    limit: "50"
  });

  await fetch(`https://ryzeapi.cloud/api/account/connections?${params}`, {
    headers: { "token": process.env.Token_Account }
  });
  ```

  ```python Python theme={null}
  import os, requests

  requests.get(
      "https://ryzeapi.cloud/api/account/connections",
      headers={"token": os.environ["Token_Account"]},
      params={"number": "5511999998888@s.whatsapp.net", "limit": 50}
  )
  ```
</CodeGroup>

```json 200 OK theme={null}
{
  "events": [
    {
      "instanceId": "9f1c2b3a-7d4e-4a1b-9c2d-3e4f5a6b7c8d",
      "instanceName": "cliente-acme",
      "numberJid": "5511999998888@s.whatsapp.net",
      "event": "unlinked",
      "at": "2026-08-20T09:05:00Z"
    },
    {
      "instanceId": "9f1c2b3a-7d4e-4a1b-9c2d-3e4f5a6b7c8d",
      "instanceName": "cliente-acme",
      "numberJid": "5511999998888@s.whatsapp.net",
      "event": "linked",
      "at": "2026-08-01T12:30:00Z"
    }
  ]
}
```

## Campos de la respuesta

<ResponseField name="events" type="array">
  Los eventos de conexión, más recientes primero. Una instancia eliminada conserva sus eventos, con el nombre y el número que tenía, porque el registro sobrevive a la eliminación.

  <Expandable title="campos de cada evento">
    <ResponseField name="instanceId" type="string">
      Identificador de la instancia. Use este valor en el filtro `instance`.
    </ResponseField>

    <ResponseField name="instanceName" type="string">
      Nombre de la instancia en el momento del evento.
    </ResponseField>

    <ResponseField name="numberJid" type="string">
      El número de WhatsApp (JID) involucrado en el evento.
    </ResponseField>

    <ResponseField name="event" type="string">
      `linked` cuando el número fue vinculado (conexión) o `unlinked` cuando fue desvinculado (desconexión).
    </ResponseField>

    <ResponseField name="at" type="string">
      Cuándo ocurrió el evento, en RFC3339 (UTC).
    </ResponseField>
  </Expandable>
</ResponseField>

## Siguiente

<CardGroup cols={2}>
  <Card title="Extracto de uso" icon="receipt" href="/es/enterprise/statement">
    La factura con detalle del período, instancia por instancia.
  </Card>

  <Card title="Webhooks Enterprise" icon="webhook" href="/es/enterprise/webhooks">
    Reaccione a cada cambio de estado por evento.
  </Card>
</CardGroup>