Ground Basis exposes infrastructure audit data — 6-pillar scores, drift alerts, and the 1.4M-parcel corpus — through a REST API. This page is the public reference. To generate a key, accept the MDLA inside the authenticated developer portal.
All endpoints require a Bearer key issued from the Developer Portal. Keys are scoped (read-audits, write-watchlist, etc.) and tied to your MDLA acceptance.
curl https://api.basis.io/v1/audits/{id} \
-H "Authorization: Bearer bsk_live_..."| Method | Path | Returns |
|---|---|---|
| GET | /v1/audits/:id | Single audit (6-pillar + evidence) |
| GET | /v1/audits?status=verified | Filtered audit list |
| GET | /v1/drift?since=ISO | Drift alerts feed |
| GET | /v1/corpus?bbox=… | Corpus parcels in a bbox |
| POST | /v1/watchlist | Subscribe an audit to drift alerts |
{
"id": "a1b2c3d4-...",
"property_address": "10708 E Elliot Rd, Mesa, AZ",
"basis_score": 712,
"letter_grade": "B+",
"verification_status": "verified",
"certified_at": "2026-04-18T17:42:00Z",
"pillars": {
"grid": { "score": 78, "grade": "B+" },
"compliance": { "score": 71, "grade": "B" },
"resilience": { "score": 74, "grade": "B+" },
"water": { "score": 69, "grade": "B-" },
"zoning": { "score": 73, "grade": "B" },
"economics": { "score": 76, "grade": "B+" }
},
"evidence": {
"srp_deposit_usd": 3750000,
"mesa_docket": "ORD-5847"
}
}Snapshot tier · 60 req/min. Certified tier · 600 req/min. Institutional tier · 6,000 req/min + webhook drift fanout. 429 responses include Retry-After headers.