API Reference
One keyed, Realie-compatible API across Earth Layer agents. A single base URL and key, with our data under Realie's field names, so a consumer swaps base URL plus key with no mapping change. The Land Agent property surface is live today; Water and Soil agents get their own surfaces next.
Authentication
Every request carries an Earth Layer API key. Pass it in X-API-Key, or Realie-style in Authorization (raw or as Bearer <key>). Keys are server-side secrets, so call from your backend rather than the browser. Request a key from the Anymal OS team.
curl "$BASE/public/land-agent/property/address-lookup?address=123+Main+St&state=ID" \ -H "X-API-Key: $EARTHLAYER_KEY"
A missing or invalid key returns 401. A key without the required scope returns 403.
Land Agent
Parcel-anchored property records across the supported states (about 40M parcels). Responses return a property object (or array) plus a metadata envelope. Each property carries identity, address, owner, acreage, assessor values, raw use code, and the Earth Layer landUseCategory classification of that code.
/public/land-agent/property/address-lookupResolve a street address to the single best-match property.
addressstring · requiredFree-form street address to resolve.statestringTwo-letter state to sharpen the match (e.g. ID, CO, TX).{ property, metadata }/public/land-agent/property/parcel-id-lookupResolve an assessor parcel number to a property.
parcelIdstring · requiredAssessor parcel number.statestringRecommended. Parcel numbers are not globally unique, so a state scope disambiguates.{ property, metadata }/public/land-agent/property/location-searchFind properties within a radius of a point, nearest first.
latitudenumber · requiredCenter latitude (WGS84).longitudenumber · requiredCenter longitude (WGS84).radiusnumberSearch radius in miles. Defaults to 1.useenumFilter by land-use category: agriculture, residential, commercial, industrial, vacant, mineral, utility_exempt.limitnumberMax results. Defaults to 25.{ properties[], metadata }/public/land-agent/property/owner-searchFind properties by owner name.
ownerstring · requiredOwner name to match.statestringTwo-letter state scope.useenumSame land-use category filter as location-search.limitnumberMax results. Defaults to 25.{ properties[], metadata }The metadata envelope returns limit, offset, count, and echoes any applied landUseFilter.
Water Agent
A water-right diligence surface (rights by location, by right number, and the parcels a right serves), built on the per-jurisdiction adapters (IDWR, CDSS, and more). Planned, on the same key and envelope.
Soil Agent
A national soil and forage surface (SSURGO map units, organic carbon, drainage, grazing capacity) keyed to the same parcel anchor. Planned, on the same key and envelope.