> 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"
}
}
```