{"uid":"cap_pKxcHCS5Fa2rDUnew-MS2","slug":"locus-property-surrounding-area-report-52d3c60b","name":"Locus: Property Surrounding Area Report","description":"Run a free scan of local records and parcel rules. See which public-record questions are answered, what remains open, and what to verify next.","url":"https://api.locus.report/api/locus-surrounding-area-report","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"packetId":{"type":"string","pattern":"^sap_[a-f0-9]{48}$"},"packetAccessProof":{"type":"string","maxLength":8192,"minLength":32}}},"responseSchema":{"type":"json","example":{"kind":"surrounding_area_report","charged":true,"packetId":"sap_000000000000000000000000000000000000000000000000","reportId":"sar_111111111111111111111111111111111111111111111111","artifacts":{"pdf":{"url":"https://api.locus.report/api/surrounding-area-reports/sar_111111111111111111111111111111111111111111111111/pdf","sha256":"4444444444444444444444444444444444444444444444444444444444444444"},"html":{"url":"https://api.locus.report/api/surrounding-area-reports/sar_111111111111111111111111111111111111111111111111/html","sha256":"3333333333333333333333333333333333333333333333333333333333333333"}},"idempotent":false,"renderedAt":"2026-08-01T12:00:00.000Z","accessibility":{"note":"HTML is semantic; verify PDF tagging with the delivery environment.","htmlSemantic":true,"pdfTaggedStatus":"unverified"},"canonicalHash":"2222222222222222222222222222222222222222222222222222222222222222","renderTimingMs":42000,"reportExpiresAt":"2026-10-30T12:00:00.000Z","reportAccessProof":"sar1.<report-capability>"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.15","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.15/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.15","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.15","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_BuCUyLHsfyV7ELkjHP1-o","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.15","costPer":"request","priority":0,"asset":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Generates a surrounding-area public-records report for a property, surfacing answered and open parcel/local-record questions as a downloadable PDF and HTML artifact.","exampleAgentPrompt":"Run a Locus surrounding area scan on my property packet sap_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6 and give me the PDF and HTML report links showing which public-record questions are answered and what still needs verification.","exampleUseCases":[{"title":"Pre-purchase property due diligence","prompt":"I'm about to make an offer on a house — can you run a Locus surrounding area scan using my property packet sap_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6 and show me which public-record and parcel-rule questions are already answered and which ones I still need to dig into?"},{"title":"Investor parcel rule check","prompt":"Before we close on this commercial lot, run a Locus property scan on packet sap_b9c8d7e6f5a4b3c2d1e0f9a8b7c6d5e4f3a2b1c0d9e8f7a6 so we can see the full surrounding area report — PDF and HTML — and know exactly what local records gaps remain."},{"title":"Real estate agent client report","prompt":"My client needs a surrounding area public-records report for the property tied to packet sap_1a2b3c4d5e6f1a2b3c4d5e6f1a2b3c4d5e6f1a2b3c4d5e6f — can you generate the Locus scan and send them the download links for both the PDF and the HTML versions?"}],"resultDescription":"Returns a JSON object containing a reportId, links to a PDF and HTML version of the surrounding area report (each with a SHA-256 integrity hash), a reportAccessProof capability token, a canonicalHash, the render time in milliseconds, and a report expiry timestamp. The report itself details which public-record questions about the property and its surroundings are answered, which remain open, and what should be verified next.","failureModes":["Invalid or malformed packetId (not matching ^sap_[a-f0-9]{48}$) returns an error","Expired or invalid packetAccessProof causes authorization failure","Payment not completed (x402 flow not finished) results in 402 Payment Required","Report generation timeout if underlying public-record sources are slow","Report already generated for the same packet (non-idempotent — re-calling may produce a new charge and a new report)"],"whenToPreferThis":"Use this endpoint when you have already obtained a Locus property scan packet (packetId starting with sap_) and need the full surrounding-area public-records report rendered as PDF and HTML artifacts. This is the step after obtaining a packet — it actually runs the scan and produces the deliverable. Prefer it over generic property data APIs when you need a structured, downloadable report covering local records coverage gaps and parcel rules in one artifact, priced at $0.15 per call via x402 micropayment.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:49:25.196Z","isFirstParty":false}