# Uso

> Contadores diarios de tráfico de una zona en el borde, peticiones, peticiones bloqueadas, bytes y consultas DNS.

Contadores diarios de uso de una zona, tal y como los cuenta el borde.

| Operación | Ruta |
|---|---|
| [Ver el uso de la zona](https://developers.openwaf.dev/es/api/usage/#get-zone-usage) | `GET /v1/orgs/{org}/zones/{zone}/usage` |

## Ver el uso de la zona

```http
GET /v1/orgs/{org}/zones/{zone}/usage
```

Devuelve los contadores de uso diarios de la zona, peticiones, peticiones bloqueadas, bytes y consultas DNS, por defecto de los últimos 30 días.

**Rol necesario:** `readonly` o superior.

#### Parámetros

| Nombre | En | Tipo | Obligatorio | Descripción |
|---|---|---|---|---|
| `org` | ruta | string (uuid) | Sí | Id de la organización. Cada ruta comprueba que es la del token (si no, `404`). |
| `zone` | ruta | string (uuid) | Sí | Id de la zona (consulta [Listar zonas](https://developers.openwaf.dev/es/api/zones/#list-zones)). |
| `from` | consulta | string (date) | No | Primer día (UTC). Por defecto, hace 30 días. |
| `to` | consulta | string (date) | No | Último día (UTC). Por defecto, hoy. |

#### Respuesta

- `200`: Devuelve `items`, un array de [Usage](https://developers.openwaf.dev/es/api/schemas/#usage).

| Campo | Tipo | Descripción |
|---|---|---|
| `items[].zone_id` | string (uuid) | Id de la zona. |
| `items[].day` | string (date) | Día (UTC). |
| `items[].requests` | integer | Peticiones. |
| `items[].bytes_in` | integer | Bytes recibidos de los visitantes. |
| `items[].bytes_out` | integer | Bytes enviados a los visitantes. |
| `items[].blocked_requests` | integer | Peticiones bloqueadas. |
| `items[].dns_queries` | integer | Consultas DNS respondidas. |

#### Ejemplo

**curl**


```sh
curl "https://dash.openwaf.dev/v1/orgs/$OPENWAF_ORG/zones/6f1d2c3b-8a4e-4b7d-9c21-5e3f7a8b9c0d/usage?from=2026-10-01&to=2026-10-27" \
  -H "Authorization: Bearer $OPENWAF_TOKEN"
```

**TypeScript**


```ts
import { OpenWAF } from "./openwaf";

const owf = new OpenWAF({ baseUrl: "https://dash.openwaf.dev" }); // token de OPENWAF_TOKEN
const result = await owf.getZoneUsage({
  zone: "6f1d2c3b-8a4e-4b7d-9c21-5e3f7a8b9c0d",
  from: "2026-10-01",
  to: "2026-10-27"
});
```

**Python**


```py
from openwaf import OpenWAF

owf = OpenWAF(base_url="https://dash.openwaf.dev")  # token de OPENWAF_TOKEN
result = owf.get_zone_usage(
    zone="6f1d2c3b-8a4e-4b7d-9c21-5e3f7a8b9c0d",
    from_="2026-10-01",
    to="2026-10-27",
)
```



```json
{
  "items": [
    {
      "zone_id": "6f1d2c3b-8a4e-4b7d-9c21-5e3f7a8b9c0d",
      "day": "2026-10-26",
      "requests": 182340,
      "bytes_in": 41230512,
      "bytes_out": 2318823104,
      "blocked_requests": 1204,
      "dns_queries": 95210
    }
  ]
}
```