BixelDocs
API reference

Get a fact's proof bundle

GET
/v1/companies/{company}/facts/{key}/proof

Get the cryptographic proof bundle for one fact: the capture behind it (content-addressed sha256), its merkle inclusion path in a hash-chained manifest, and the OpenTimestamps proof anchoring the batch in the Bitcoin blockchain. Verify offline with bixel-verify — zero trust in Bixel required. Attests observation-at-time, never extraction correctness.

Path Parameters

company*string

Apex domain (canonical, e.g. pinecone.io). Bare values are resolved as legacy slugs. Unknown names: resolve via /v1/search first.

key*string

The fact key, e.g. pricing.tier.standard.monthly_usd.

Query Parameters

provenance?string

Selects between provenance twins of the same key; default prefers observed.

Value in

  • "observed"
  • "company_stated"

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X GET "https://example.com/v1/companies/pinecone.io/facts/string/proof"
{  "data": {    "fact": {      "dimension": "pricing",      "extractor_version": "string"    },    "capture": {      "kind": "page_capture",      "id": "string",      "captured_at": "2019-08-24T14:15:22Z",      "source_url": "string",      "sha256": "string",      "raw": {        "key": "string",        "hash_rule": "string"      }    },    "inclusion_proof": {      "merkle_spec": "string",      "manifest_key": "string",      "manifest_sha256": "string",      "leaf": "string",      "leaf_index": 0,      "path": [        {          "sibling": "string",          "side": "left"        }      ],      "merkle_root": "string"    },    "anchor": {      "meta_key": "string",      "meta_b64": "string",      "ots_key": "string",      "ots_b64": "string",      "anchored_at": "2019-08-24T14:15:22Z",      "previous_meta_key": "string"    },    "attests": "string",    "verify_with": "http://example.com"  },  "meta": {    "generated_at": "2019-08-24T14:15:22Z",    "count": 0,    "total": 0,    "next_cursor": "string",    "notice": "string"  }}
{  "type": "http://example.com",  "title": "string",  "status": 0,  "code": "company_not_found",  "detail": "string",  "hint": "string",  "docs_url": "http://example.com"}
{  "type": "http://example.com",  "title": "string",  "status": 0,  "code": "company_not_found",  "detail": "string",  "hint": "string",  "docs_url": "http://example.com"}
{  "type": "http://example.com",  "title": "string",  "status": 0,  "code": "company_not_found",  "detail": "string",  "hint": "string",  "docs_url": "http://example.com"}
{  "type": "http://example.com",  "title": "string",  "status": 0,  "code": "company_not_found",  "detail": "string",  "hint": "string",  "docs_url": "http://example.com"}