Mearef · Schema

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.

CompanyDataGovernmentMiddle East

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.
View JSON Schema on GitHub

JSON Schema

mearef-dev-answer-receipt-schema.json Raw ↑
{
  "$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.
All 92 tools →

Call it yourself

curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/mearef-dev-answer-receipt"
All schemas
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.