Get started

Historical data exports

Source

Paginated bulk export of Witness first-party datasets (price-periods, observations, rates, events, and provider-terms) in JSON, JSONL (application/x-ndjson), or CSV (text/csv) for Deploy and Enterprise organisations.

Export a dataset

text
GET /api/v1/exports/{dataset}

Requires Authorization: Bearer vitna_push_... (or vitna_key_...) for an organisation with Deploy or Enterprise entitlement.

Supported {dataset} values:

  • price-periods - historical and current stretches of unchanged SKU rates
  • observations - individual parsed cells with archived contentSha256 digests
  • rates - open (valid_to IS NULL) Witness periods
  • events - published curated and detected market events
  • provider-terms - append-only curated provider retention, training, region, and BYOK terms

Query parameters:

  • class - filter by component class (model, gpu, retrieval, speech, tool, image, video, music)
  • provider - filter by provider id (openai, anthropic, etc.)
  • from and to - ISO dates (YYYY-MM-DD)
  • after - non-negative integer cursor from nextCursor or X-Vitna-Next-Cursor
  • limit - page size (1..5000, default 500)
  • format - json (default), jsonl, or csv
bash
curl -H "Authorization: Bearer $VITNA_PUSH_KEY" \
  "https://vitna.ai/api/v1/exports/price-periods?class=model&from=2026-01-01&format=jsonl&limit=1000"
json
{
  "dataset": "price-periods",
  "rows": [
    {
      "id": 412,
      "skuId": "gpt-5.4",
      "skuSlug": "gpt-5.4",
      "classId": "model",
      "providerId": "openai",
      "dimensionId": "input_per_mtok",
      "unit": "USD per 1M tokens",
      "amountUsd": 2.5,
      "bandFromTokens": 0,
      "bandToTokens": null,
      "validFrom": "2026-06-01T00:00:00.000Z",
      "validTo": null,
      "confirmed": true,
      "flap": false,
      "firstObservationId": 1204,
      "lastObservationId": 8840
    }
  ],
  "nextCursor": "412",
  "meta": {
    "generatedAt": "2026-11-02T00:00:00.000Z",
    "source": "postgres",
    "orgId": "convexity",
    "count": 1,
    "limit": 500,
    "nextCursor": "412"
  }
}