vitna.ai/docs/api/v1/verification/citations Machine view
Raw .md llms.txt
> 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`.
Human Machine Shift+M