---
title: "Analytics definitions"
method: GET
path: "/analytics/meta"
tags: ["Analytics"]
---

# Analytics definitions

`GET /analytics/meta`

## Request

- Base URL: `https://api.varg.ai/v2`
- URL: `https://api.varg.ai/v2/analytics/meta`
- Auth: HTTP bearer

Metric definitions and time bases, dimensions, filters, limits, and the earliest charge on the account
(`available_from`). Use it to discover what the other analytics endpoints accept.

## Response `200`

Result envelope

- AnalyticsMetaResponse
  - `data` AnalyticsMetaData, required
    - `available_from` string, date-time, nullable: Time of the account's earliest charge.
    - `metrics` object[]
      - `key` string
      - `unit` string
      - `time_basis` string
      - `description` string
    - `dimensions` object[]
      - `key` 'tool' | 'model' | 'workspace' | 'api_key' | 'member' | 'creator' | 'source' | 'status': A dimension spend can be grouped or filtered by.
      - `label` string
      - `filter_param` string
      - `description` string
      - `values` object: Allowed values and labels (source and status only).
    - `special_keys` object
    - `bucket_widths` string[]
    - `limits` object
    - `range` string
  - `meta` AnalyticsMeta, required: Metadata describing how the numbers were computed.
    - `definition_version` string, required: Changes whenever a metric's meaning changes.
    - `from` string, date-time: Resolved range start (inclusive).
    - `to` string, date-time: Resolved range end (exclusive).
    - `timezone` string
    - `compare` object, nullable: The comparison period, or null when none.
      - `from` string, date-time
      - `to` string, date-time
    - `filters` object: Filters applied, keyed by query parameter name.
    - `data_as_of` string, date-time, required
    - `money_unit` 'cent', required: Amounts are whole credits, in fields ending in `_cents`.
    - `time_basis` 'posted_at' | 'lifetime' | 'created_at', required: `posted_at` = when the ledger charge was posted; `created_at` = when a file was made.
    - `attribution_scope` 'full' | 'self', required: `self` means identity dimensions show only the caller's own values.

## Other responses

- `401`: Missing or invalid API key / JWT
- `503`: Analytics is temporarily unavailable (`analytics_unavailable`)

## Changes

- **2026-10-20** `43bcf5ea398d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/varg/apis/varg-api/changes/analytics/meta/get.md)

---

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