Getting started

The Qriton API is a JSON over HTTPS interface at https://api.qriton.com/v1. It has four parts, each with its own reference: the Verification API, the Memory API, the Spatial Memory API and the Signals API.

1. Create an account and a key

Sign in at https://api.qriton.com/console with your e-mail address and the code we send. New accounts start on the Free plan. In the console, create an API key; it is shown once, so store it in your secret manager.

2. Make a first call

curl https://api.qriton.com/v1/account -H "Authorization: Bearer $QRITON_API_KEY"

The answer names your plan, the APIs it includes and the allowance left in the current window.

3. Verify a receipt chain

The Verification API is included in every plan. Download the sample chain from the open verifiers page and send it:

curl https://api.qriton.com/v1/verify/receipts \
  -H "Authorization: Bearer $QRITON_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonl": "<contents of receipts.jsonl>", "expected_head": "<head you hold>"}'

Conventions

  • Requests and responses are JSON (UTF-8) unless an operation states otherwise. Times are ISO 8601 in UTC.
  • Every response carries X-Request-Id. Quote it when you contact us about a request.
  • Request bodies are limited to 10 MB.
  • The version is part of the path. Changes within /v1 only add fields or operations; anything else gets a new version and notice in Changes.