Ticket Schema

Ticket Schema is an open JSON Schema standard for digital documents that replace physical paper: receipts, payment notes, delivery notes, warranties, loan notes, service records, reservations, and related transaction records.

Status

Draft v0.1.

Core idea

A Ticket Schema document is:

• portable;
• machine-readable;
• profile-based;
• event-aware;
• non-fiscal by default;
• extensible for local legal/fiscal requirements.

Minimal document

{
  "$schema": "https://ticketschema.org/schema/v0.1/core.json",
  "ticketSchemaVersion": "0.1",
  "id": "ts_01HX0000000000000000000000",
  "documentType": "payment_receipt",
  "status": "issued",
  "issuedAt": "2026-05-22T10:00:00-06:00",
  "parties": [],
  "events": []
}

Compatibility language

Apps should say:

• Ticket Schema-compatible
• Validated by Ticket Schema

Validator

CLI:

python3 tools/ticket_schema_validator.py validate examples/v0.1/retail-receipt-mx.json

Web UI:

https://ticketschema.org/validator/

REST API:

curl -X POST https://ticketschema.org/api/validate \
  -H 'content-type: application/json' \
  --data @examples/v0.1/retail-receipt-mx.json

Examples:

https://ticketschema.org/examples/

Render:

https://ticketschema.org/render/?src=/examples/v0.1/retail-receipt-mx.json

Repository layout

schema/v0.1/core.schema.json
schema/v0.1/profiles/*.schema.json
examples/v0.1/*.json
docs/*.md
tools/ticket_schema_validator.py
tests/*.py

License

MIT for code. CC-BY-4.0 for specification text.