/source/ · Markdown + JSON Schema · CC-BY-4.0

spec

v1.0.0

The normative specification source. Markdown plus the JSON Schema and canonical test vectors referenced from the appendices. CC-BY-4.0.

published March 2026

About this artefact

spec contains the source for the OpenReceipt normative specification — the same document rendered at /spec/. The published page currently has sections §1–§6 (with §4a). The CC-BY-4.0 licence makes the spec freely quotable, forkable, and translatable; only the trademark SignedReceipts compatible badge is reserved.

No JSON Schema file and no canonicalisation vector set are published yet. The /spec/ page is maintained as static HTML; it is not generated by a reproducible build, and there is no automated diff against a previous release.

Manifest

No tarball or file manifest is published yet. When a release is published, its file list and SHA-256 fingerprints will be computed from the published files and listed here.

Quick start

shell

# The downloadable spec source tarball is being prepared and is not
# yet published. The normative text is browsable at /spec/ in the
# meantime.

shell

# Validate a receipt against the normative schema
ajv validate -s schema/openreceipt-1.0.schema.json -d ./my-receipt.json

# Render the spec locally (Pandoc 3+)
pandoc spec.md -o spec.html --metadata title='OpenReceipt'

Issues / questions

Bug reports, patches, and security advisories all go to the CloakAPI open-source inbox.

open-source@cloakapi.io

Back to /source/ · related: spec · conformance · implementations