> Source: https://vitna.ai/docs/api/v1/verification/citations
> Raw Markdown: https://vitna.ai/docs/api/v1/verification/citations.md
> Corpus index: https://vitna.ai/llms.txt
# Citations
One [observation](../../../concepts/observation.md) 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](../../../citing-a-figure.md) for the permanence rules that govern these URLs.
```
GET /api/v1/citations/{id}
```
```bash
curl https://vitna.ai/api/v1/citations/445935
```
Take `{id}` from `observationId` on any [tape](../prices/tape.md) row or period in [SKU history](../prices/sku-history.md).
## Response
```json
{
"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](proof.md).
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`.