bills

Get Bill Evidence

A citable evidence packet for one bill.

This is the endpoint the MCP tool's permalink and download_url point at, so a packet quoted in a report resolves for a human reader instead of being a UUID stranded in an agent transcript.

The snapshot_id is computed by billcommons_shared.evidence, the same module the MCP tool uses. That sharing is the point: if the two surfaces computed it independently they would eventually disagree about whether a bill had changed, which is worse than not offering the id at all.

The retained official comparison uses the same bounded reader as MCP. Its capture times describe retained evidence, not current freshness, and an unavailable comparison does not establish that the records match.

Returned as a raw JSONResponse rather than through a response_model so the payload the caller downloads is byte-identical to the one that was hashed.

get/api/v1/bills/{bill_id}/evidence

Request

  • Base URL: https://api.billcommons.org
  • URL: https://api.billcommons.org/api/v1/bills/{bill_id}/evidence
  • Auth: none declared

Path parameters

bill_idstring uuid required

Query parameters

downloadboolean

Serve as a file attachment named after the bill and snapshot.

questionstring nullable

What this packet was assembled to answer; echoed back into the artifact.

Response

Successful Response

unknown required

Changes

No recorded changes to this operation across all 1 revision of this API.