Locus Environmental Records Screen

{
  "caveats": [
    "This is the government-records step of a Phase I, not a Phase I. Historical-use sources, interviews, and the site reconnaissance are outside Locus.",
    "State lists vary in completeness; a list marked empty means the queried source returned no record, not that no contamination exists.",
    "Records within the search distance are counted, never scored. Distances are from the resolved point, not the parcel boundary.",
    "For SBA loans, this can inform the Environmental Questionnaire and Records Search with Risk Assessment inputs; the environmental professional decides the next step."
  ],
  "gaps": [],
  "kind": "environmental_records_screen",
  "lists": [
    {
      "description": "EPA National Priorities List sites",
      "list": "NPL / Superfund",
      "nearestMeters": null,
      "recordsReturned": 0,
      "recordsWithinSearchDistance": null,
      "searchDistanceMiles": 1,
      "sourceTool": "locus_cleanup_sites",
      "status": "empty"
    },
    {
      "description": "Federal and state cleanup and brownfield sites",
      "list": "CERCLIS / SEMS and state cleanup sites",
      "nearestMeters": 190,
      "recordsReturned": 11,
      "recordsWithinSearchDistance": 5,
      "searchDistanceMiles": 0.5,
      "sourceTool": "locus_cleanup_sites",
      "status": "ok"
    },
    {
      "description": "Regulated facilities with EPA ECHO compliance records",
      "list": "RCRA CORRACTS and TSD facilities",
      "nearestMeters": null,
      "recordsReturned": 25,
      "recordsWithinSearchDistance": null,
      "searchDistanceMiles": 1,
      "sourceTool": "locus_regulated_facility_compliance",
      "status": "ok"
    },
    {
      "description": "Hazardous-waste generators and handlers",
      "list": "RCRA generators",
      "nearestMeters": null,
      "recordsReturned": 1000,
      "recordsWithinSearchDistance": null,
      "searchDistanceMiles": 0.25,
      "sourceTool": "locus_rcra_handlers",
      "status": "ok"
    },
    {
      "description": "UST facilities and reported releases",
      "list": "Registered and leaking underground storage tanks (UST / LUST)",
      "nearestMeters": 276,
      "recordsReturned": 25,
      "recordsWithinSearchDistance": 24,
      "searchDistanceMiles": 0.5,
      "sourceTool": "locus_underground_storage_tanks",
      "status": "ok"
    },
    {
      "description": "Facilities reporting chemical releases",
      "list": "Toxic Release Inventory",
      "nearestMeters": null,
      "recordsReturned": 94,
      "recordsWithinSearchDistance": null,
      "searchDistanceMiles": 0.5,
      "sourceTool": "locus_toxic_releases",
      "status": "ok"
    }
  ],
  "lists_reference": [
    {
      "list": "NPL / Superfund",
      "searchDistanceMiles": 1
    },
    {
      "list": "CERCLIS / SEMS and state cleanup sites",
      "searchDistanceMiles": 0.5
    },
    {
      "list": "RCRA CORRACTS and TSD facilities",
      "searchDistanceMiles": 1
    },
    {
      "list": "RCRA generators",
      "searchDistanceMiles": 0.25
    },
    {
      "list": "Registered and leaking underground storage tanks (UST / LUST)",
      "searchDistanceMiles": 0.5
    },
    {
      "list": "Toxic Release Inventory",
      "searchDistanceMiles": 0.5
    }
  ],
  "note": "Awareness/diagnostic only. Full briefs are x402-paid. Agents can discover live free tools at https://api.locus.report/tools/list and paid tools, prices, and manifests at https://api.locus.report/.well-known/ai-tool/index.json.",
  "ok": true,
  "point": {
    "latitude": 35.780418000003195,
    "longitude": -78.63910200000142
  },
  "standard": "ASTM E1527-21 government records review (approximate minimum search distances)"
}

# bash or zsh: see the payment challenge. Nothing is charged.
curl -sS -g -i -X POST 'https://api.locus.report/api/locus-environmental-records-screen' \
  -H 'content-type: application/json' \
  --data-raw '{"address":"1 E Edenton St, Raleigh, NC 27601"}'

# x402 v2 sends the challenge base64-encoded in the PAYMENT-REQUIRED header (v1 sends it in the body).
# To read the header:
curl -sS -g -o /dev/null -D - -X POST 'https://api.locus.report/api/locus-environmental-records-screen' \
  -H 'content-type: application/json' \
  --data-raw '{"address":"1 E Edenton St, Raleigh, NC 27601"}' \
  | grep -i '^payment-required:' | cut -d' ' -f2 | tr -d '\r' | base64 --decode

// npm i @x402/fetch @x402/evm viem
import { wrapFetchWithPayment, x402Client } from "@x402/fetch";
import { registerExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";

// Pays at most $0.05 per call.
const client = new x402Client().setSpendControls({ maxAmountPerPayment: "$0.05" });
registerExactEvmScheme(client, { signer: privateKeyToAccount(process.env.EVM_PRIVATE_KEY) });
const pay = wrapFetchWithPayment(fetch, client);

// Not sure it's safe to pay? ToolVet checks it first for $0.005. Pay for that from a separate
// client: this one is capped at $0.05 per payment. GET https://toolvet.app/api/v1/check?url=https%3A%2F%2Fapi.locus.report%2Fapi%2Flocus-environmental-records-screen&method=POST
const res = await pay("https://api.locus.report/api/locus-environmental-records-screen", {
  method: "POST",
  headers: { "content-type": "application/json" },
  body: JSON.stringify({
    "address": "1 E Edenton St, Raleigh, NC 27601"
  }),
});
console.log(res.status, await res.text());

# pip install "x402[requests,evm]"
import os
from eth_account import Account
from x402 import x402ClientSync
from x402.http.clients import x402_requests
from x402.mechanisms.evm import EthAccountSigner
from x402.mechanisms.evm.exact.register import register_exact_evm_client

# Pays at most $0.05 per call.
client = x402ClientSync().set_spend_controls({"max_amount_per_payment": "$0.05"})
register_exact_evm_client(client, EthAccountSigner(Account.from_key(os.environ["EVM_PRIVATE_KEY"])))

with x402_requests(client) as session:
    res = session.post(
        "https://api.locus.report/api/locus-environmental-records-screen",
        json={
            "address": "1 E Edenton St, Raleigh, NC 27601",
        },
    )
    print(res.status_code, res.text)