---
title: "Live"
method: GET
path: "/sites/{site}/live"
tags: ["Analytics"]
---

# Live

`GET /sites/{site}/live`

## Request

- Base URL: `https://api.onelence.com/v1`
- URL: `https://api.onelence.com/v1/sites/{site}/live`
- Auth: one of:
  - OAuth 2 (authorization code, authorization URL `https://api.onelence.com/oauth/authorize`, token URL `https://api.onelence.com/oauth/token`, scopes: `analytics:read`)
  - HTTP bearer

Active visitors, events and conversions in the last few minutes. complete is false when the window held more activity than one snapshot reads, so the counts are lower bounds.

## Path parameters

- `site` string, required

## Query parameters

- `minutes` integer

## Response `200`

Success.

- object
  - `object` 'live', required
  - `note` string, required
  - `site` object, required
    - `id` string, required
    - `domain` string, required
  - `window_minutes` number, required
  - `active_visitors` number, nullable, required
  - `events` number, nullable, required
  - `conversions` number, nullable, required
  - `complete` boolean, required

## Other responses

- `400`: Invalid input; `error.param` names the field.
- `401`: Missing, expired or revoked token. WWW-Authenticate points to the resource metadata.
- `402`: subscription_required or upgrade_required; the error carries billing_url.
- `403`: insufficient_scope or admin_required.
- `404`: Unknown endpoint, site, source or record.
- `429`: Rate limited. Retry after Retry-After seconds.
- `500`: OneLence could not complete the request.

---

[API](https://skmtc.dev/onelence/apis/onelence-api.md) · [All operations](https://skmtc.dev/onelence/apis/onelence-api/llms.txt) · [OpenAPI document](https://skmtc.dev/onelence/apis/onelence-api/revisions/971c72fe9a42?raw)