Citations
One observation in the three paste-ready citation forms /cite/{id} prints (reference, footnote, schedule), alongside the figure's provenance fields and signed-day status. See citing a figure for the permanence rules that govern these URLs.
GET /api/v1/citations/{id}curl https://vitna.ai/api/v1/citations/445935Take {id} from observationId on any tape row or period in SKU history.
Response
{
"observationId": "445935",
"url": "https://vitna.ai/cite/445935",
"proofUrl": "https://vitna.ai/api/v1/observations/445935/proof",
"promiseUrl": "https://vitna.ai/docs/citing-a-figure",
"verifyUrl": "https://vitna.ai/docs/verify-a-figure",
"headline": "OpenAI GPT-5.5, input price, $1.25 per 1M tokens",
"figure": {
"observationId": "445935",
"provider": "OpenAI",
"sku": "GPT-5.5",
"skuSlug": "gpt-5.5",
"skuStatus": "active",
"classId": "model",
"dimensionId": "input_per_mtok",
"dimension": "Input price",
"unit": "USD per 1M tokens",
"amountUsd": 1.25,
"band": null,
"readAt": "2026-09-12T00:00:00.000Z",
"fetchedAt": "2026-09-12T08:00:11.402Z",
"source": "openai-pricing-md",
"adapter": "openai-pricing",
"sourceUrl": "https://developers.openai.com/api/docs/pricing",
"evidenceSha256": "4f2a...",
"derived": false,
"derivation": null,
"locator": "table:row 0",
"parserVersion": 3
},
"signedDay": {
"state": "signed",
"day": "2026-09-12",
"label": "2026-09-12",
"attestation": {
"coversOn": "2026-09-12",
"root": "a9c1...",
"signature": "c2ln",
"publicKey": "a2V5",
"leafCount": 5,
"algorithm": "sha256-merkle-rfc6962",
"signedAt": "2026-09-13T04:00:00.000Z"
}
},
"forms": {
"reference": "OpenAI GPT-5.5, input price, $1.25 per 1M tokens...",
"footnote": "OpenAI GPT-5.5, input price: $1.25 per 1M tokens...",
"schedule": "Rate: $1.25 per 1M tokens..."
},
"formDescriptions": [
{
"id": "reference",
"label": "Short reference",
"note": "For a slide, a chart footer or anywhere the line has to fit under something else."
}
],
"proves": "Vitna recorded these observations on this UTC day and has not altered them since signing.",
"boundary": "No provider signs its own pricing page: the signature covers Vitna's record of the fetch and not the provider's page.",
"meta": {
"generatedAt": "2026-09-13T09:14:02.881Z",
"source": "database"
}
}Snapshot behaviour
Citations resolve strictly from the database because the committed JSON snapshot carries no observation IDs. On a snapshot checkout without DATABASE_URL, this route answers 503 no_record pointing to https://vitna.ai/api/v1/citations/{id}, matching observation proof.
An {id} that is not a positive integer or does not exist in witness.observation answers 404 unknown_observation.
Caching
public, max-age=60, stale-while-revalidate=3600.
