replay_hospital_price

What it answers

1. 1Replay a hospital price-proof receipt by re-running its recorded tool inputs and comparing response hash, Iceberg snapshot, plan hash, row count, status, and raw-byte source descriptor.

Inputs (1)

Call it

# MCP (https://mcp.vladahealth.com/mcp): the tool by name
replay_hospital_price(receipt={"receipt_version":"hospital_price_proof_receipt.v0","substrate":"hospital","proof_kind":"hospital_price_proof","proof_id":"hospitalprice_19f06a3112497ebd","tool_name":"prove_hospital_price","tool_version":"1.5.0","source_table":"fact_hospital_chargemaster","source_descriptor":{"table":"fact_hospital_chargemaster","snapshot_id":"4789942790573672775","raw_s3_keys":["raw_archive/hospital/ccn=070005/9a33aa0b5c67cc2a3c5cee0115ffa2bcf15f6ad5dd0dc69044111bdfdc1064fc.csv"],"content_sha256":["9a33aa0b5c67cc2a3c5cee0115ffa2bcf15f6ad5dd0dc69044111bdfdc1064fc"],"mrf_version_ids":["d9385d8c-2051-4955-9ae4-ff855c3ce334"],"source_urls":["https://vlada-platform-raw.s3.amazonaws.com/raw_archive/hospital/ccn%3D070005/9a33aa0b5c67cc2a3c5cee0115ffa2bcf15f6ad5dd0dc69044111bdfdc1064fc.csv"],"parser_artifact_hashes":["78df2514944e674eabf04d07f17a93ea1ab6255c6fff2bd4b3ec79d314e4a2b9"],"s3_version_ids":[]},"read_snapshot_set":{"fact_hospital_chargemaster":"4789942790573672775"},"filters":{"hospital_ccn":"070005","billing_code":"70450","current_only":true},"guardrails":{"max_rows":60,"max_planned_files":500,"max_planned_bytes":268435456,"current_only":true,"require_byte_provenance":true,"raw_parquet_glob_reads":"disabled","shared_mrf_expansion":"not_performed_mvp"},"plan":{"planned_file_count":1,"planned_bytes":93233000,"planned_record_count":1908186,"planned_delete_file_count":0,"plan_manifest_hash":"432b007b75d09646abed67f2ed3107945c3e9902b0518a03d1cffbceaa5b8abb","planned_files_sample":["data/_VXeSg/hospital_state=CT/hospital_ccn=070005/20261002_010134_00448_k6qzf-35fcae15-3a2d-46e0-8d5d-644da8afbb0b.parquet"]},"evidence":{"plan":{"planned_file_count":1,"planned_bytes":93233000,"planned_record_count":1908186,"planned_delete_file_count":0,"plan_manifest_hash":"432b007b75d09646abed67f2ed3107945c3e9902b0518a03d1cffbceaa5b8abb","planned_files_sample":["data/_VXeSg/hospital_state=CT/hospital_ccn=070005/20261002_010134_00448_k6qzf-35fcae15-3a2d-46e0-8d5d-644da8afbb0b.parquet"]},"audit_chain":{"row_count":52,"raw_s3_key_count":1,"content_sha256_count":1,"mrf_version_id_count":1,"parser_artifact_hash_count":1,"all_rows_have_byte_provenance":true}},"row_count":52,"status":"ok","caveats":["billing_class_may_be_mixed","current_rows_only_version_not_pinned_by_input","hospital_price_proof_mvp_no_provider_group_expansion","hospital_rates_are_chargemaster_mrf_rates_not_claims","no_utilization_weighting_applied","payer_name_may_be_mixed","plan_name_may_be_mixed","rows_on_other_bases_listed_separately_in_rates_by_basis","summary_on_one_basis_fee_schedule"],"input_hash":"19f06a3112497ebd900630484cb76a0e89bb4b90d5ea1d95921773b8d76fb688","response_hash":"52caf8290716e14507686956574934dc7f25ba8404cb5784cf1caaddab47d113","replay_pointer":{"tool":"prove_hospital_price","inputs":{"hospital_ccn":"070005","billing_code":"70450","current_only":true,"require_byte_provenance":true,"max_rows":60,"max_planned_files":500,"max_planned_bytes":268435456},"receipt_id":"hpr_52caf8290716e14507686956"},"receipt_id":"hpr_52caf8290716e14507686956"})

curl -X POST https://api.vladahealth.com/v1/tools/replay_hospital_price \
  -H "Authorization: Bearer $VLADA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"receipt":{"receipt_version":"hospital_price_proof_receipt.v0","substrate":"hospital","proof_kind":"hospital_price_proof","proof_id":"hospitalprice_19f06a3112497ebd","tool_name":"prove_hospital_price","tool_version":"1.5.0","source_table":"fact_hospital_chargemaster","source_descriptor":{"table":"fact_hospital_chargemaster","snapshot_id":"4789942790573672775","raw_s3_keys":["raw_archive/hospital/ccn=070005/9a33aa0b5c67cc2a3c5cee0115ffa2bcf15f6ad5dd0dc69044111bdfdc1064fc.csv"],"content_sha256":["9a33aa0b5c67cc2a3c5cee0115ffa2bcf15f6ad5dd0dc69044111bdfdc1064fc"],"mrf_version_ids":["d9385d8c-2051-4955-9ae4-ff855c3ce334"],"source_urls":["https://vlada-platform-raw.s3.amazonaws.com/raw_archive/hospital/ccn%3D070005/9a33aa0b5c67cc2a3c5cee0115ffa2bcf15f6ad5dd0dc69044111bdfdc1064fc.csv"],"parser_artifact_hashes":["78df2514944e674eabf04d07f17a93ea1ab6255c6fff2bd4b3ec79d314e4a2b9"],"s3_version_ids":[]},"read_snapshot_set":{"fact_hospital_chargemaster":"4789942790573672775"},"filters":{"hospital_ccn":"070005","billing_code":"70450","current_only":true},"guardrails":{"max_rows":60,"max_planned_files":500,"max_planned_bytes":268435456,"current_only":true,"require_byte_provenance":true,"raw_parquet_glob_reads":"disabled","shared_mrf_expansion":"not_performed_mvp"},"plan":{"planned_file_count":1,"planned_bytes":93233000,"planned_record_count":1908186,"planned_delete_file_count":0,"plan_manifest_hash":"432b007b75d09646abed67f2ed3107945c3e9902b0518a03d1cffbceaa5b8abb","planned_files_sample":["data/_VXeSg/hospital_state=CT/hospital_ccn=070005/20261002_010134_00448_k6qzf-35fcae15-3a2d-46e0-8d5d-644da8afbb0b.parquet"]},"evidence":{"plan":{"planned_file_count":1,"planned_bytes":93233000,"planned_record_count":1908186,"planned_delete_file_count":0,"plan_manifest_hash":"432b007b75d09646abed67f2ed3107945c3e9902b0518a03d1cffbceaa5b8abb","planned_files_sample":["data/_VXeSg/hospital_state=CT/hospital_ccn=070005/20261002_010134_00448_k6qzf-35fcae15-3a2d-46e0-8d5d-644da8afbb0b.parquet"]},"audit_chain":{"row_count":52,"raw_s3_key_count":1,"content_sha256_count":1,"mrf_version_id_count":1,"parser_artifact_hash_count":1,"all_rows_have_byte_provenance":true}},"row_count":52,"status":"ok","caveats":["billing_class_may_be_mixed","current_rows_only_version_not_pinned_by_input","hospital_price_proof_mvp_no_provider_group_expansion","hospital_rates_are_chargemaster_mrf_rates_not_claims","no_utilization_weighting_applied","payer_name_may_be_mixed","plan_name_may_be_mixed","rows_on_other_bases_listed_separately_in_rates_by_basis","summary_on_one_basis_fee_schedule"],"input_hash":"19f06a3112497ebd900630484cb76a0e89bb4b90d5ea1d95921773b8d76fb688","response_hash":"52caf8290716e14507686956574934dc7f25ba8404cb5784cf1caaddab47d113","replay_pointer":{"tool":"prove_hospital_price","inputs":{"hospital_ccn":"070005","billing_code":"70450","current_only":true,"require_byte_provenance":true,"max_rows":60,"max_planned_files":500,"max_planned_bytes":268435456},"receipt_id":"hpr_52caf8290716e14507686956"},"receipt_id":"hpr_52caf8290716e14507686956"}}'

# the schema, no key
curl https://api.vladahealth.com/v1/tools/replay_hospital_price/schema

A real answer

{
 "value": {
  "replay_kind": "hospital_price_proof_replay",
  "receipt_id": "hpr_52caf8290716e14507686956",
  "proof_id": "hospitalprice_19f06a3112497ebd",
  "tool_name": "prove_hospital_price",
  "matches": true,
  "checks": {
   "response_hash": true,
   "plan_manifest_hash": true,
   "row_count": true,
   "status": true,
   "source_descriptor": true
  },
  "failed_checks": [],
  "checks_not_comparable": [],
  "source_descriptor_fields_differing": [],
  "source_descriptor_fields_not_in_receipt": [],
  "expected_response_hash": "52caf8290716e14507686956574934dc7f25ba8404cb5784cf1caaddab47d113",
  "actual_response_hash": "52caf8290716e14507686956574934dc7f25ba8404cb5784cf1caaddab47d113",
  "expected_plan_manifest_hash": "432b007b75d09646abed67f2ed3107945c3e9902b0518a03d1cffbceaa5b8abb",
  "actual_plan_manifest_hash": "432b007b75d09646abed67f2ed3107945c3e9902b0518a03d1cffbceaa5b8abb",
  "expected_row_count": 52,
  "actual_row_count": 52,
  "expected_status": "ok",
  "actual_status": "ok",
  "verdict": "match"
 },
 "unit": null,
 "vintage": null,
 "methodology": null,
 "caveats": [],
 "response_hash": "00c6019e589b617f63b1cb52b3f3bf99d6bdcb4de8bcf89b338ba92887a90828",
 "semantic_version": 1,
 "tool_version": "replay_hospital_price@1.5.0",
 "explanation": null,
 "status": "complete",
 "replay_id": "replay_a3174ea79ad5083a",
 "audience": "customer",
 "answer": {
  "value_ref": "value",
  "scope": {
   "tool": "replay_hospital_price"
  }
 },
 "method": "Computed over the filters shown in this answer's scope, from the sources listed in its evidence. Nothing outside those filters was included.",
 "evidence": {
  "response_hash": "00c6019e589b617f63b1cb52b3f3bf99d6bdcb4de8bcf89b338ba92887a90828"
 },
 "freshness": {
  "state": "unknown",
  "why": "This tool does not report an edition for its answer, and the door could not derive one from what the answer reads. Treat the result as current to no stated date."
 }
}

What comes back

{
 "$defs": {
  "Quality": {
   "description": "Row-level quality signal. All flags precomputed at build time\n(stored on the gold mart) and passed through here.",
   "properties": {
    "is_outlier": {
     "default": false,
     "title": "Is Outlier",
     "type": "boolean"
    },
    "is_ghost_candidate": {
     "default": false,
     "title": "Is Ghost Candidate",
     "type": "boolean"
    },
    "n_similar_rates": {
     "default": 0,
     "title": "N Similar Rates",
     "type": "integer"
    },
    "confidence": {
     "default": 1,
     "title": "Confidence",
     "type": "number"
    }
   },
   "title": "Quality",
   "type": "object"
  },
  "Source": {
   "description": "Cell-level provenance. Every served value traces back here.\n\n`snapshot_id` is the Iceberg snapshot the tool read from. Two calls\nat the same snapshot MUST produce byte-identical responses —\nthat's the content-addressed caching guarantee.",
   "properties": {
    "table": {
     "title": "Table",
     "type": "string"
    },
    "rate_id": {
     "anyOf": [
      {
       "type": "string"
      },
      {
       "type": "null"
      }
     ],
     "default": null,
     "title": "Rate Id"
    },
    "source_files": {
     "items": {
      "type": "string"
     },
     "title": "Source Files",
     "type": "array"
    },
    "snapshot_id": {
     "anyOf": [
      {
       "type": "integer"
      },
      {
       "type": "null"
      }
     ],
     "default": null,
     "title": "Snapshot Id"
    }
   },
   "required": [
    "table"
   ],
   "title": "Source",
   "type": "object"
  }
 },
 "properties": {
  "value": {
   "default": null,
   "title": "Value"
  },
  "unit": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "null"
    }
   ],
   "default": null,
   "title": "Unit"
  },
  "vintage": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "null"
    }
   ],
   "default": null,
   "title": "Vintage"
  },
  "source": {
   "$ref": "#/$defs/Source"
  },
  "methodology": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "null"
    }
   ],
   "default": null,
   "title": "Methodology"
  },
  "quality": {
   "$ref": "#/$defs/Quality"
  },
  "invariants_applied": {
   "items": {
    "type": "string"
   },
   "title": "Invariants Applied",
   "type": "array"
  },
  "caveats": {
   "items": {
    "type": "string"
   },
   "title": "Caveats",
   "type": "array"
  },
  "response_hash": {
   "default": "",
   "title": "Response Hash",
   "type": "string"
  },
  "semantic_version": {
   "default": 1,
   "title": "Semantic Version",
   "type": "integer"
  },
  "tool_version": {
   "default": "unknown",
   "title": "Tool Version",
   "type": "string"
  },
  "explanation": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "null"
    }
   ],
   "default": null,
   "title": "Explanation"
  },
  "status": {
   "default": "match",
   "enum": [
    "match",
    "mismatch"
   ],
   "title": "Status",
   "type": "string"
  },
  "refusal": {
   "anyOf": [
    {
     "additionalProperties": true,
     "type": "object"
    },
    {
     "type": "null"
    }
   ],
   "default": null,
   "title": "Refusal"
  },
  "failure": {
   "anyOf": [
    {
     "additionalProperties": true,
     "type": "object"
    },
    {
     "type": "null"
    }
   ],
   "default": null,
   "title": "Failure"
  },
  "as_of": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "null"
    }
   ],
   "default": null,
   "title": "As Of"
  },
  "freshness_state": {
   "default": "unknown",
   "title": "Freshness State",
   "type": "string"
  },
  "replay_id": {
   "default": "",
   "title": "Replay Id",
   "type": "string"
  }
 },
 "title": "HospitalPriceReplayResponse",
 "type": "object"
}

Sources

Known limits (0)