Verify

Verify facts (batch, paid per lookup) - FREE preview

Verify catalogued FACTS: one (parcel, field) assertion per lookup, batch (POST body { lookups: [{ parcel_id, fields }] }, up to 1000 parcels) or single (GET ?parcel_id&fields). Priced per lookup, bulk-discounted ($0.02/$0.012/$0.006), capped $20. Pay from a prepaid credit balance (X-CREDIT-TOKEN) or per call via x402. preview=true returns count+price free; empty/all-invalid is free. Fields whitelisted (is_sfha, flood_zone, nri_risk_score, owner_occupied, is_absentee, owner_name, assessed_value, market_value, building_sqft, year_built, property_type, zoning, lot_size_acres, last_sale_date/price, address/city/state/zip); unknown parcel -> found:false. owner_name is people data: it is verified for an account (API key or signed-in session), or for a caller without one once its x402 payment settles or its credit debit succeeds. An UNPAID caller without an account (no X-PAYMENT / X-CREDIT-TOKEN, or preview=true) that asks for owner_name is refused with HTTP 401 code: "account_required" before the quote; every other field is unaffected.

post/api/v1/verify

Request

  • Base URL: https://propraven.com
  • URL: https://propraven.com/api/v1/verify
  • Auth: HTTP bearer

Query parameters

previewstring

FREE count + price.

Headers

X-CREDIT-TOKENstring

Prepaid credit token to debit the batch.

X-PAYMENTstring

Base64 x402 PaymentPayload.

Request body

Example request

{
  "lookups": [
    {
      "parcel_id": "37:119:12104406",
      "fields": [
        "is_sfha",
        "year_built"
      ]
    }
  ]
}

Response

Verified facts, a free preview, or a free empty result.

lookup_countinteger required
parcel_countinteger required
previewboolean required
notestring required

Changes

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