Risk score (paid, priced per assessment) — with a FREE preview
The Machine Storefront's risk score: a multi-hazard risk assessment for one parcel, anchored on FEMA's National Risk Index COMPOSITE (nri_risk_score 0-100 + rating) with the flood / seismic / windstorm / wildfire / air-quality / crime breakdown that supports it. Answers "what could go wrong with this asset?". The headline is FEMA's own methodology, not an invented weighting.
Reuses the SAME panel the free GET /api/v1/parcels/{id}/risks route serves (getParcelRisksData) plus the NRI composite + flood detail from parcels_serving.
PRICE: per assessment = clamp($0.60 x V(asset value) x C(hazard coverage), $0.20, $20). C ramps on how many independent hazard layers resolved. A parcel with ZERO layers is returned free, never charged. The cheapest paid SKU. The exact price is in the 402's accepts[0].maxAmountRequired (USDC atomic units).
FREE PREVIEW: add preview=true for the subject, WHICH hazard layers resolved, and the exact price. The precise NRI score and the hazard breakdown are the paid product.
PAID ACCESS: (a) x402 via a base64 signed PaymentPayload in X-PAYMENT (receipt in X-PAYMENT-RESPONSE); (b) a genuine PAID subscription entitlement; (c) else HTTP 402 with the exact requirements.
Request
- Base URL: https://propraven.com
- URL: https://propraven.com/api/v1/parcels/{id}/risk-score
- Auth: one of:
- HTTP bearer
- none
Path parameters
Parcel id: canonical state:county:parcel, 5-digit-county:parcel, or a parcel UUID.
Query parameters
FREE try-before-buy: subject, resolved hazard layers, and the exact price. No payment.
Headers
Base64-encoded x402 PaymentPayload (EIP-3009 signed). Present it to pay per call.
Response
The risk assessment (paid or entitled), or — with preview=true — the free preview, or a free $0 result when no hazard layers resolved.
Changes
No recorded changes to this operation across all 1 revision of this API.