# Locus Record Batch Job

> Locus Record Batch Job is a paid API for AI agents from api.locus.report, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-13).

Runs an async batch job fetching up to 6 property record lane types (parcel, flood zone, zoning, etc.) across 2–25 US addresses in any jurisdiction, returning results keyed by address.

## Facts

- Endpoint: POST https://api.locus.report/api/locus-record-batch
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/locus-record-batch-job-aec5f7f2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_k9pCpXqLjcckbH6AQx2yc

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-record-batch-job-aec5f7f2 -d '<json body>'
```

Example prompt: Can you run a Locus batch records job on these 8 addresses and pull the flood zone and parcel facts for each one: 123 Main St Austin TX, 456 Oak Ave Denver CO, 789 Pine Rd Miami FL, 101 Elm St Chicago IL, 202 Maple Dr Seattle WA, 303 Cedar Ln Nashville TN, 404 Birch Blvd Phoenix AZ, 505 Walnut Way Portland OR?

## When to prefer this

Choose this endpoint when you need property records for multiple addresses (2–25) in a single job across any US jurisdiction, especially when mixing different record types like flood zone, parcel, and zoning in one call. Prefer it over single-address lookups when doing portfolio screening, due diligence on acquisitions, or any workflow requiring consistent multi-address property data. The flat per-job pricing and no-charge policy for unresolved addresses make it cost-efficient for batch screening tasks.

## Known failure modes

- Address not resolvable — address listed under unresolved, not charged
- Fewer than 2 or more than 25 addresses supplied — validation error
- More than 6 lanes requested — validation error
- Invalid lane name pattern (must match locus_[a-z_]+) — validation error
- Payment failure via x402 — job not created
- Job still processing — poll statusUrl until status changes to complete
- Jurisdiction not covered — address may appear as unresolved

## How this service works

One async job that runs up to 6 free Locus record lanes (parcel, flood zone, zoning, governing districts, or any free lane by name) across 2-25 addresses in ANY US jurisdiction, results keyed by address. Perfect for: 'check these 20 addresses for flood zone and parcel facts', 'portfolio screen', 'any-jurisdiction records job'. One flat toll per job; unresolved addresses are listed and never charged. Poll statusUrl until complete. npx @velinussage/locus-agent-skill add.

## Output

Returns a JSON object with a job ID, a statusUrl to poll until completion, address-keyed property records for each resolved address across the requested lanes (parcel facts, flood zone, zoning, governing districts, etc.), any caveats, a generatedAt timestamp, and a list of unresolved addresses that were not charged.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "lanes": {
   "type": "array",
   "items": {
    "type": "string",
    "pattern": "^locus_[a-z_]+$"
   },
   "maxItems": 6,
   "minItems": 1
  },
  "addresses": {
   "type": "array",
   "items": {
    "type": "string",
    "maxLength": 200,
    "minLength": 5
   },
   "maxItems": 25,
   "minItems": 2
  }
 }
}
```

## 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-record-batch-job-aec5f7f2/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)