docs / 04

Records

Each county's source is normalized into one shared parcel schema. Every record served consumes exactly one credit.

Field dictionary

Field	Type	Description
id	string	Deterministic id: <county_fips>:<apn>, or the source feature id when there is no APN.
county_fips	string	Five-digit county FIPS. References the tracked county row.
apn	string \| null	Assessor's parcel number from the county source.
address	string \| null	Site address, when the source provides one.
owner	string \| null	Owner name, when the source provides one.
land_use	string \| null	Land-use or property-class label from the source.
area_acres	number \| null	Area derived from the geometry, in acres.
area_sqft	number \| null	Area derived from the geometry, in square feet.
lat	number \| null	Centroid latitude (WGS84).
lon	number \| null	Centroid longitude (WGS84).
bbox_min_lon	number \| null	Geometry envelope, west edge.
bbox_min_lat	number \| null	Geometry envelope, south edge.
bbox_max_lon	number \| null	Geometry envelope, east edge.
bbox_max_lat	number \| null	Geometry envelope, north edge.
geometry	object \| null	GeoJSON geometry when it fits in-row; otherwise null.
geometry_r2_key	string \| null	R2 object key when the geometry was offloaded; otherwise null.
source_url	string \| null	County source URL the row was ingested from.
source_format	string \| null	Source format, such as esri_json or geojson.
source_srid	number \| null	Native spatial reference id of the source geometry.
source_feature_id	string \| null	The source's own feature id.
source_fetched_at	string \| null	When the source page was fetched (ISO 8601).
ingested_at	string	When the row was written (ISO 8601).

Geometry is stored in-row when it fits; large geometries are written to R2 and referenced by geometry_r2_key. Exactly one of geometry or geometry_r2_key is set for a covered parcel.

Example response

GET /api/parcels returns up to limit records, optionally scoped to one county with county_fips. Each record served consumes one credit.

curl "https://parcel.reeeally.ai/api/parcels?county_fips=06037&limit=100" \
  -H "Authorization: Bearer $PARCEL_TOKEN"

{
  "parcels": [
    {
      "id": "06037:APN-1",
      "county_fips": "06037",
      "apn": "APN-1",
      "address": "123 Main St",
      "owner": "Example Owner",
      "land_use": "Single Family Residential",
      "area_acres": 0.23,
      "area_sqft": 10018.8,
      "lat": 34.05,
      "lon": -118.24,
      "bbox_min_lon": -118.241,
      "bbox_min_lat": 34.049,
      "bbox_max_lon": -118.239,
      "bbox_max_lat": 34.051,
      "geometry": { "type": "Polygon", "coordinates": [ [ [ -118.241, 34.049 ], [ -118.239, 34.051 ], [ -118.241, 34.049 ] ] ] },
      "geometry_r2_key": null,
      "source_url": "https://example.gov/parcels",
      "source_format": "esri_json",
      "source_srid": 4326,
      "source_feature_id": "1",
      "source_fetched_at": "2026-10-01T12:00:00.000Z",
      "ingested_at": "2026-10-01T12:00:05.000Z"
    }
  ],
  "count": 1,
  "metering": {
    "plan": "trial",
    "credits_remaining": 49,
    "overage_records": 0,
    "overage_amount_cents": 0
  }
}

Re-running a county upserts by id, so a parcel keeps a stable identity across ingests.