DocumentationAPI v1
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 ratesobservations- individual parsed cells with archivedcontentSha256digestsrates- open (valid_to IS NULL) Witness periodsevents- published curated and detected market eventsprovider-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.)fromandto- ISO dates (YYYY-MM-DD)after- non-negative integer cursor fromnextCursororX-Vitna-Next-Cursorlimit- page size (1..5000, default500)format-json(default),jsonl, orcsv
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"{
"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"
}
}