AnswerReceipt
Signed record of one paid answer computation. Present only on HTTP 200 when the request body set receipt:true. kind is answer_receipt. This object is not a series certified extract: GET /v1/certified/{country}/{series} returns a different artifact (value, citation, archived-source fingerprint, verification chain) at its own price. An answer receipt is included in the answer's existing price — no extra charge. It is not legal advice. It only covers the computation over the cited series as of each series' last_confirmed. Signing: build the object without signature, set receipt_id from the sha256 of that canonical JSON (first 24 hex chars, same pattern as extract_id), re-canonicalize including receipt_id, then sign. Verify with the free key at /certified/public-key — the same key and the same canonicalization rule as series certified extracts, not a second key.
Properties
| Name | Type | Description |
|---|---|---|
| kind | string | |
| receipt_id | string | First 24 hex characters of sha256 over the canonical JSON of this object before signature is attached. Same pattern as certified extract_id. The signature covers the object including receipt_id. |
| answer | string | Route or tool name of the paid answer, e.g. vat, wage-check, working-days, settlement-date, income-tax, statutory-interest, payroll, employment-cost. |
| request | object | Sanitized inputs echoed from the request. Properties are route-specific. |
| result | object | Compact summary of the answer status and workings already returned on this 200. Properties are route-specific. |
| cited_series | array | Series the computation cited. Empty only when the answer cited none. |
| issued_at | string | ISO8601 timestamp when the receipt was issued. |
| limitations | array | Always populated. States that this receipt is not a series certified extract and is not legal advice, and that it only covers the computation over the cited series as of each series' last_confirmed. |
| signature | object | Ed25519 signature over the canonical JSON of this receipt with the signature field omitted. Same key_id and same canonicalization rule as series certified extracts, published at /certified/public-key. |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://artifacts.apis.io/mearef-dev/json-schema/mearef-dev-answer-receipt-schema.json",
"title": "AnswerReceipt",
"description": "Signed record of one paid answer computation. Present only on HTTP 200 when the request body set receipt:true. kind is answer_receipt. This object is not a series certified extract: GET /v1/certified/{country}/{series} returns a different artifact (value, citation, archived-source fingerprint, verification chain) at its own price. An answer receipt is included in the answer's existing price — no extra charge. It is not legal advice. It only covers the computation over the cited series as of each series' last_confirmed. Signing: build the object without signature, set receipt_id from the sha256 of that canonical JSON (first 24 hex chars, same pattern as extract_id), re-canonicalize including receipt_id, then sign. Verify with the free key at /certified/public-key — the same key and the same canonicalization rule as series certified extracts, not a second key.",
"x-generated": "2026-11-18",
"x-method": "derived",
"x-generator": "derive-json-schema.py",
"x-source": "openapi/mearef-dev-openapi.json#/components/schemas/AnswerReceipt",
"type": "object",
"properties": {
"kind": {
"type": "string",
"const": "answer_receipt"
},
"receipt_id": {
"type": "string",
"pattern": "^[0-9a-f]{24}$",
"description": "First 24 hex characters of sha256 over the canonical JSON of this object before signature is attached. Same pattern as certified extract_id. The signature covers the object including receipt_id."
},
"answer": {
"type": "string",
"description": "Route or tool name of the paid answer, e.g. vat, wage-check, working-days, settlement-date, income-tax, statutory-interest, payroll, employment-cost."
},
"request": {
"type": "object",
"additionalProperties": true,
"description": "Sanitized inputs echoed from the request. Properties are route-specific."
},
"result": {
"type": "object",
"additionalProperties": true,
"description": "Compact summary of the answer status and workings already returned on this 200. Properties are route-specific."
},
"cited_series": {
"type": "array",
"description": "Series the computation cited. Empty only when the answer cited none.",
"items": {
"type": "object",
"properties": {
"country": {
"type": "string"
},
"series_id": {
"type": "string"
},
"value": {
"type": [
"number",
"string",
"null"
],
"description": "Cited series value as held. Number, string, or null."
},
"last_confirmed": {
"type": [
"string",
"null"
],
"format": "date",
"description": "ISO date the cited series was last confirmed, or null."
},
"source_url": {
"type": [
"string",
"null"
]
},
"source_sha256": {
"type": [
"string",
"null"
],
"description": "Hex fingerprint from provenance when available, otherwise null."
}
},
"required": [
"country",
"series_id",
"value",
"last_confirmed",
"source_url",
"source_sha256"
]
}
},
"issued_at": {
"type": "string",
"format": "date-time",
"description": "ISO8601 timestamp when the receipt was issued."
},
"limitations": {
"type": "array",
"items": {
"type": "string"
},
"description": "Always populated. States that this receipt is not a series certified extract and is not legal advice, and that it only covers the computation over the cited series as of each series' last_confirmed."
},
"signature": {
"type": "object",
"description": "Ed25519 signature over the canonical JSON of this receipt with the signature field omitted. Same key_id and same canonicalization rule as series certified extracts, published at /certified/public-key. Not a second production key.",
"properties": {
"alg": {
"type": "string",
"const": "Ed25519"
},
"key_id": {
"type": "string",
"description": "Same key_id as GET /certified/public-key and as series certified extracts."
},
"public_key": {
"type": "string",
"description": "Absolute URL of GET /certified/public-key."
},
"signed_payload": {
"type": "string",
"description": "canonical JSON of answer_receipt: keys sorted recursively, no whitespace (see /certified/public-key)"
},
"value": {
"type": "string",
"description": "Base64 Ed25519 signature."
}
},
"required": [
"alg",
"key_id",
"public_key",
"signed_payload",
"value"
]
}
},
"required": [
"kind",
"receipt_id",
"answer",
"request",
"result",
"cited_series",
"issued_at",
"limitations",
"signature"
]
}
Work with this as data
Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for schemas
4 MCP tools reach this
find_json_schemasBrowse and filter every JSON Schema in the catalog.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
curl "https://apis.io/api/v1/json-schemas/mearef-dev-answer-receipt"
curl "https://apis.io/api/v1/json-schemas?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.