Comp pack (paid, priced per pack) — with a FREE preview
The Machine Storefront's comp pack: a subject valuation INDICATED BY comparable sales, wrapped with the comps that prove it. Answers the underwriting question "what is this worth, and which sales prove it?".
The comps are the SAME precomputed comparable_sales the free GET /api/v1/parcels/{id}/comps route serves, with the same read-time similarity_score (0–100) and similarity_components on every comp, plus similarity_basis, similarity_method and comp_set_quality; the subject's valuation fields come from parcels_serving. The indicated value is derived transparently (median comp $/sqft x subject sqft when both are known, else the median comp sale price) with an interquartile range, and is reconstructable from the comps in the same payload -- never a black-box AVM.
PRICE: per pack = clamp($2 x V(subject value) x Q(comp support), $1, $20). Q ramps on the comp count only: the similarity score is served but never priced (decoupled 2026-10-10, prices unchanged). A subject with ZERO precomputed comps has no evidence to support a number and is returned free, never charged. The exact price is advertised in the 402's accepts[0].maxAmountRequired (USDC atomic units, 6 decimals).
FREE PREVIEW: add preview=true for the subject summary, the comp count + median similarity, the exact price, and up to three MASKED comps (parcel/APN withheld, sale price rounded, date to the year). The precise indicated value and the unmasked comps are the paid product.
PAID ACCESS (preview omitted) requires ONE of: (a) x402 pay-per-call via a base64 signed x402 PaymentPayload in the X-PAYMENT header (receipt in X-PAYMENT-RESPONSE); (b) a genuine PAID PropRaven subscription entitlement; (c) anything else -> HTTP 402 whose accepts carries the exact requirements.
Request
- Base URL: https://propraven.com
- URL: https://propraven.com/api/v1/parcels/{id}/comp-pack
- Auth: one of:
- HTTP bearer
- none
Path parameters
Parcel id: canonical state:county:parcel, 5-digit-county:parcel, or a parcel UUID.
Query parameters
How many comps back the pack.
Optional post-filter: keep only precomputed comps within this many miles.
FREE try-before-buy: subject summary, comp count, exact price and three masked comps. No payment.
Headers
Base64-encoded x402 PaymentPayload (EIP-3009 signed). Present it to pay per call for the full pack.
Response
The comp pack (paid or entitled), or — with preview=true — the free masked preview, or a free $0 result when the subject has no comps.
Changes
No recorded changes to this operation across all 1 revision of this API.