---
title: "Build a structured Bitcoin evidence pack for a known research target"
method: POST
path: "/api/agent/v1/evidence-pack"
---

# Build a structured Bitcoin evidence pack for a known research target

`POST /api/agent/v1/evidence-pack`

## Request

- Base URL: `https://californiabitcoin.org`
- URL: `https://californiabitcoin.org/api/agent/v1/evidence-pack`
- Auth: none declared

Build a focused Bitcoin evidence package when the agent already knows what it is researching and primarily needs compact source material, atomic claims, conflicts, source authority, exact-locator precision, caveats, provenance, and temporal scope.

## Request body

- object
  - `query` string, required

## Response `200`

Structured deterministic California Bitcoin knowledge result

- object
  - `operation` string, required
  - `productId` string, nullable
  - `access` 'free' | 'paid', required
  - `price` object, required
    - `currency` string
    - `amountCents` integer
  - `result` object, required
  - `paymentReceipt` object

## Other responses

- `400`: Invalid input
- `402`: Payment Required. MPP uses WWW-Authenticate; x402 v2 HTTP uses PAYMENT-REQUIRED. Retry with the matching payment credential or proof.
- `503`: Payment or knowledge provider temporarily unavailable

---

[API](https://skmtc.dev/californiabitcoin/apis/california-bitcoin-agent-commerce-api.md) · [All operations](https://skmtc.dev/californiabitcoin/apis/california-bitcoin-agent-commerce-api/llms.txt) · [OpenAPI document](https://skmtc.dev/californiabitcoin/apis/california-bitcoin-agent-commerce-api/revisions/13683fe699bc?raw)
