# Locus Property Scan

> Locus Property Scan is a paid API for AI agents from api.locus.report, paid per call via x402, $0.1/call, status unknown (last checked 2026-09-14).

Scans local records, parcel rules, and risk signals for a given property address to surface factors affecting use, cost, planning, or future value.

## Facts

- Endpoint: POST https://api.locus.report/api/locus-valuation-challenge
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/locus-property-scan-b872b607
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_bZenq2fgjEReUFSRxAgST

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability locus-property-scan-b872b607 -d '<json body>'
```

Example prompt: Run a Locus property scan on 742 Evergreen Terrace, Springfield, IL using my own valuation of $325,000, look back 12 months, and cover a 500-meter radius around the property.

## When to prefer this

Choose this endpoint when you need a quick, structured property intelligence report covering local records, parcel rules, and risk signals for a specific address — especially during pre-purchase research, investment evaluation, or renovation planning. It is particularly useful when you want to combine a specific valuation basis (Zestimate, appraisal, BPO, or your own estimate) with spatial and temporal filtering to scope the scan. Prefer it over generic public records searches when you need consolidated real estate risk signals in a machine-readable format.

## Known failure modes

- Address too short or malformed — minimum 5 characters required
- Proposed value must be greater than zero
- Radius out of range — must be between 100 and 1500 meters
- monthsBack out of range — must be between 1 and 24
- Invalid valuation source — must be one of: zestimate, appraisal, bpo, own
- Payment failure via x402 protocol — 402 response if USDC payment not attached
- No records found for address — returns empty records array with caveats

## How this service works

Stress-test a caller-supplied property price or assessment notice for one US address against cited recorded-sales, parcel, permit, hazard, tax, zoning, legislation, and same-roll assessment-uniformity evidence in protest mode; Locus never creates or endorses a price, ARV, deal judgment, or investment score, and the result is charge-free if under two substantive sections resolve. npx @velinussage/locus-agent-skill add.

## Output

A JSON report containing a scan ID, list of local records, parcel and zoning rules, risk signals relevant to the property, caveats about data limitations, and a timestamp indicating when the report was generated.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "source": {
   "enum": [
    "zestimate",
    "appraisal",
    "bpo",
    "own",
    "assessment_notice"
   ],
   "type": "string"
  },
  "address": {
   "type": "string",
   "maxLength": 200,
   "minLength": 5
  },
  "purpose": {
   "enum": [
    "purchase",
    "protest"
   ],
   "type": "string",
   "default": "purchase"
  },
  "monthsBack": {
   "type": "integer",
   "maximum": 24,
   "minimum": 1
  },
  "noticeYear": {
   "type": "integer",
   "default": 1970,
   "maximum": 9007199254740991,
   "minimum": -9007199254740991
  },
  "radiusMeters": {
   "type": "integer",
   "maximum": 1500,
   "minimum": 100
  },
  "proposedValue": {
   "type": "number",
   "exclusiveMinimum": 0
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "id": "locus_example",
  "caveats": [
   "Example artifact; not live data."
  ],
  "records": [],
  "generatedAt": "2026-01-01T00:00:00.000Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/locus-property-scan-b872b607/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.locus.report](https://www.zero.xyz/host/api.locus.report/llms.txt)