Get started

Citations

Source

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.

text
GET /api/v1/citations/{id}
bash
curl https://vitna.ai/api/v1/citations/445935

Take {id} from observationId on any tape row or period in SKU history.

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.

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.