# Locus Property Soil Context Scan

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

Runs an early property scan returning local records, parcel rules, and risk signals for a given US address or ZIP code.

## Facts

- Endpoint: POST https://api.locus.report/api/locus-soil-context
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/locus-property-soil-context-scan-bfb0497d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap__tsYc5yMBWVyk1HvRJYly

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-soil-context-scan-bfb0497d -d '<json body>'
```

Example prompt: Can you run a Locus property scan on 742 Evergreen Terrace, Springfield, IL 62704 and tell me what local records, zoning rules, or risk signals might affect its use or value?

## When to prefer this

Use this endpoint when an agent needs a lightweight, early-stage property intelligence scan covering local records, parcel rules, and risk signals for a US address or ZIP code — especially useful for pre-purchase due diligence, investment screening, or flagging regulatory concerns before deeper research.

## Known failure modes

- Missing both address and zip — returns validation error
- Invalid or unrecognized US address — may return empty records array
- Non-US address provided — not supported
- Payment failure (x402) — request rejected before processing
- Malformed ZIP code — schema validation error

## How this service works

USDA soil suitability at an address. Perfect for: 'soil type for a property', 'is the soil good for a septic system / foundation / drainage', 'USDA SSURGO soil at an address', 'soil context for a parcel'. Returns dominant soil component suitability ratings (septic, foundation, drainage) at the point via USDA Soil Data Access, with caveats. National. Not an engineering or perc-test determination. Charge-free when soil is out of coverage or the source is unavailable.

## Output

A JSON object containing a scan ID, list of local records, parcel rule data, and risk signals relevant to the queried property or ZIP code, along with a generation timestamp and any data caveats.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "address": {
   "type": "string",
   "maxLength": 200,
   "minLength": 5
  },
  "latitude": {
   "type": "number",
   "maximum": 90,
   "minimum": -90
  },
  "longitude": {
   "type": "number",
   "maximum": 180,
   "minimum": -180
  }
 }
}
```

## 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-soil-context-scan-bfb0497d/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)