data
search
real-estate
property
property-research
due-diligence
public-records
x402
proposed-price
price-challenge
recorded-sales
parcel-facts
due-diligence
category:economics

Challenge a caller-supplied property price

Challenge a supplied price or assessment notice for one US address against cited sales, parcel, permit, tax, zoning, and same-roll uniformity records. Protest mode does not create or endorse a price or investment score. Charge-free below two substantive sections. npx @velinussage/locus-agent-skill add.

post/api/locus-valuation-challenge

Request

  • Base URL: https://api.locus.report
  • URL: https://api.locus.report/api/locus-valuation-challenge
  • Auth: one of:
    • API key in header PAYMENT-SIGNATURE
    • API key in header Authorization

Request body

addressstring required

US street address for the subject property.

proposedValuenumber required

The caller's own proposed price/figure in USD. Locus echoes it but never creates or endorses it.

source'zestimate' | 'appraisal' | 'bpo' | 'own' | 'assessment_notice' required

Caller-supplied origin for the proposed figure; use assessment_notice for an assessor or appraisal-district notice.

noticeYearinteger required

Tax year of the assessment notice; defaults to the current year.

purpose'purchase' | 'protest' required

Use protest to request the same-roll assessment-uniformity section; defaults to purchase.

radiusMetersinteger

Optional comps radius; default 1500m, max 1500m.

monthsBackinteger

Optional comps lookback; default 24 months, max 24.

Response

Successful paid artifact, or a free pre-charge diagnostic when the request is outside current coverage.

kind'proposed_price_challenge' required
generatedAtstring required
addressstring required
caveatsstring[] required
chargedfalse

Changes

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