vitna.ai/docs/api/v1/prices/exports Machine view
Raw .md llms.txt
> Source: https://vitna.ai/docs/api/v1/prices/exports
> Raw Markdown: https://vitna.ai/docs/api/v1/prices/exports.md
> Corpus index: https://vitna.ai/llms.txt

# Historical data exports

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

```
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"
  }
}
```
Human Machine Shift+M