# Locus: Property Scan – Local Fiscal Context

> Locus: Property Scan – Local Fiscal Context 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-14).

Scans public municipal and parcel records to surface local government fiscal health indicators, budget trends, and zoning/parcel rules for a given place.

## Facts

- Endpoint: POST https://api.locus.report/api/locus-local-fiscal-context
- Price: $0.05/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-local-fiscal-context-81cac5f9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_zcV8tENsTdtJz4JTJ3AxE

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-local-fiscal-context-81cac5f9 -d '<json body>'
```

Example prompt: Can you run a Locus property scan on Raleigh, NC to pull local fiscal context — look back 3 years and include parcel context and consequences?

## When to prefer this

Use this endpoint when you need a free-tier scan of local government fiscal health and parcel rules for a named municipality, especially as part of real estate due diligence, investment research, or civic data analysis. Prefer this over the full address-level bundle when you only need jurisdiction-level fiscal context rather than parcel-specific environmental or flood data. It complements sibling endpoints (capital projects, EPA, flood zone) by providing the financial and governance layer.

## Known failure modes

- Place name cannot be resolved to a known jurisdiction — returns unresolved or ambiguous jurisdiction
- No public audit records available for the requested lookback period — observations array may be empty
- lookbackYears outside allowed range (2–5) — validation error
- place string too short or too long — schema validation error
- Partial data: some fiscal indicators answered, others remain open (flagged in caveats)
- Timeout or upstream record source unavailable — may return partial snapshot

## How this service works

Research one property or compare a shortlist before a showing, offer, project, or tax appeal. Run free public-record checks, then buy deeper x402 reports with ready-to-run next steps.

## Output

Returns a structured brief containing: resolved jurisdiction info, fiscal year operating margin and other indicators sourced from official audit records, audit coverage status, budget change events, lookback trends, policy actions, peer comparisons, and parcel-linked context. Also includes source artifact metadata with SHA256 hashes, source URLs, authority verification status, and caveats about data completeness.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "place": {
   "type": "string",
   "maxLength": 200,
   "minLength": 2
  },
  "lookbackYears": {
   "type": "integer",
   "maximum": 5,
   "minimum": 2
  },
  "includeParcelContext": {
   "type": "boolean"
  },
  "includeParcelConsequences": {
   "type": "boolean"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "kind": "local_fiscal_context_brief",
  "brief": {
   "kind": "local_fiscal_context",
   "caveats": [
    "Example artifact; not live data."
   ],
   "fiscalYears": [
    "2024-06-30",
    "2025-06-30"
   ],
   "generatedAt": "2026-01-15T00:00:00.000Z",
   "jurisdiction": {
    "displayName": "Raleigh, NC",
    "jurisdictionId": "us-nc-raleigh"
   },
   "observations": [
    {
     "unit": "percent",
     "label": "Operating margin",
     "value": -1.5,
     "sources": [
      {
       "recordId": "audit-2025",
       "fetchedAt": "2026-01-15T00:00:00.000Z",
       "sourceUrl": "https://www.nctreasurer.com/divisions/state-and-local-government-finance-division/local-government-commission/annual-audit-reports",
       "artifactId": "primary",
       "sourceName": "North Carolina Local Government Commission annual audit reports",
       "sourceClass": "unit_acfr",
       "snapshotSha256": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
      }
     ],
     "indicator": "operating_margin",
     "definition": "(governmental revenue - governmental expenditures) / governmental revenue",
     "fiscalYearEnd": "2025-06-30"
    }
   ],
   "auditCoverage": [],
   "budgetChanges": [],
   "lookbackTrend": [],
   "policyActions": [],
   "peerComparisons": [],
   "parcelLinkedContext": []
  },
  "resolved": {
   "resolution": "city",
   "displayName": "Raleigh, NC",
   "jurisdictionId": "us-nc-raleigh"
  },
  "snapshot": {
   "artifacts": [
    {
     "rawSha256": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
     "sourceUrl": "https://www.nctreasurer.com/divisions/state-and-local-government-finance-division/local-government-commission/annual-audit-reports",
     "artifactId": "primary",
     "sourceName": "North Carolina Local Government Commission annual audit reports",
     "sourceClass": "unit_acfr",
     "sourceEntityId": "audit-2025",
     "sourceRecordId": "audit-2025",
     "sourceRegistryId": "nc-lgc-audit-reports",
     "authorityVerification": "reviewer_exception",
     "subjectJurisdictionId": "us-nc-raleigh"
    }
   ],
   "rawSha256": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
   "sourceUrl": "https://www.nctreasurer.com/divisions/state-and-local-government-finance-division/local-government-commission/annual-audit-reports",
   "ingestedAt": "2026-01-15T00:00:00.000Z",
   "snapshotId": "fiscal_example",
   "sourceName": "North Carolina Local Gov
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/locus-property-scan-local-fiscal-context-81cac5f9/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)