Skip to main content
This page documents the full nested v3 parcel record — the shape shipped in bulk full-record exports. Fields with no value for a parcel are omitted rather than returned as null. Persist realieParcelId as your property key: API responses in the v3 shape carry no _id at all, and the _id values in bulk files and flat responses are regenerated on each data load — never a stable reference. Normalized coded fields store values from the Realie code system (XX#### codes plus integer ordinal/band scales); every such code decodes with the Property Feature Field Key, which also documents the system’s three representation classes and its append-only guarantee. The deliberate exception is the jurisdiction-issued fields documented below (stateLandUseCode, countyLandUseCode, taxDistrictCode, zoningInfo.zoningCode) — those carry each jurisdiction’s own value verbatim, with no national decode table.
API endpoints return this nested record for accounts with the v3 response shape enabled — the default for new accounts; existing accounts enable it from the dashboard’s Usage page (one-way, see the migration FAQ). Accounts that haven’t switched receive the same data in the v2-compatible flat layout documented in the legacy tab; the migration guide includes a field-by-field mapping between the two shapes. Two current exceptions return the flat layout even on v3-enabled accounts — records resolved through legacy coverage fallbacks, and searches using foreclosure filters (see the migration FAQ).

Identity & location

string
Primary parcel identifier (Assessor’s Parcel Number / tax map parcel ID) as recorded by the county assessor. Example: “0314- -0009”
string
Stable Realie parcel identifier, persistent across data releases — persist this as your property key. Format: 5-digit county FIPS + the parcel ID with spaces escaped as ~. Example: “11001-0314-~-0009”
string
Two-letter USPS state abbreviation for the parcel. Example: “DC”
string
Street number and street name of the property, promoted from propertyLocation.address. Example: “1217 12TH ST NW”
string
Property use code, promoted from propertyClassification.propertyUseCode. Coded value — decode with the Property Feature Field Key. Example: “1110”
string
5-digit ZIP code of the property, promoted from propertyLocation.zipCode. Example: “20005”
string
5-digit FIPS code (state + county) of the parcel’s county, promoted from propertyLocation.fipsCode. Example: “11001”
number
Latitude of the parcel centroid in decimal degrees (mirrors coordinates.latitude). Omitted when the parcel has no valid geocode. Example: 38.906297
number
Longitude of the parcel centroid in decimal degrees (mirrors coordinates.longitude). Omitted when the parcel has no valid geocode. Example: -77.027766
object
GeoJSON Point at the parcel centroid, suitable for geospatial indexing and queries. Coordinates are [longitude, latitude] per the GeoJSON spec. Omitted when the parcel has no valid geocode. Example: { "type": "Point", "coordinates": [-77.027766, 38.906297] }
object
Geographic coordinates of the parcel centroid.
object
Parcel boundary as a GeoJSON MultiPolygon (single-polygon boundaries are wrapped to MultiPolygon). Omitted when no boundary was matched for the parcel — see geometrySource.
string
Provenance of the parcel boundary in geometry: “apn_match” (boundary matched by parcel number), “point_in_parcel” (boundary matched by the parcel’s geocoded point falling inside a polygon), or “none” (no boundary matched; geometry is omitted). Example: “apn_match”
object
Tax jurisdiction identifiers, parcel IDs, and current ownership.
object
Physical (situs) address of the parcel. The owner mailing address lives in propertyIdentification.currentOwner.

Classification, utilities & rooms

object
Property type, use codes, and administrative district assignments from county assessor records. The parcel’s zoning designation lives in the top-level zoningInfo object.
object
Property-level counts (buildings, mobile homes, units).
object
Utility connections for the parcel, as Realie codes. Heating and cooling systems are documented in the top-level heating and cooling objects and per building under buildingInformation.buildings.
object
Property-level room totals across all buildings. Per-building room counts are in buildingInformation.buildings (totalBedrooms, totalBathrooms, etc.).
array
Accessory structures and yard improvements recorded as simple line items in county assessor records (sheds, fences, decks, pools, detached carports). Structures with detailed characteristics (year built, rooms, construction type) appear in buildingInformation.buildings instead.

Buildings

object
Coded characteristics of the parcel’s primary building, promoted to the top level. Every coded member stores a Realie code — decode with the Property Feature Field Key. The same member set appears per building under buildingInformation.buildings[].characteristics.
object
Heating system of the primary building, described by five independent facets — counties record different aspects of the same system, so any subset may be present. All facets are Realie codes; decode with the Property Feature Field Key. Per-building heating is under buildingInformation.buildings[].heating.
object
Cooling system of the primary building. Per-building cooling is under buildingInformation.buildings[].cooling.
object
Container for all improved structures on the parcel. Covers main dwellings, guest houses, detached garages, barns — any building carrying detailed assessor characteristics (year built, construction, rooms, square footage). Simple accessory structures and yard improvements with only a type/description/area/value are listed under outbuildingsYardItems instead.
object
Aggregate land measurements, lot dimensions, and land classification for the parcel.
object
Assessor valuation figures and tax exemptions for the parcel.
object
Tax amounts, districts, and historical tax records for the parcel.
Recorded legal description, subdivision/plat identifiers, and Public Land Survey System references.

Sales history

array
Chronological list of recorded sale and transfer events for the parcel, from county recorder records — each entry carries the price, dates, deed references, and parties. In the v2-legacy flat shape these events are exposed as transfers[], where saleCode corresponds to qualification here.

Mortgages, liens & foreclosures

array of objects
Mortgages and deeds of trust recorded against the property — purchase-money loans and refinances, sourced from county recorder records and sorted newest-first. Each entry carries the lender, loan terms, lien position, a link to the sale it financed (if any), and the loan’s own post-origination custody chain (assignments and releases). A key is absent when the source record has no value.
example
array of objects
Involuntary liens and judgments recorded against the property — tax liens, judgments, mechanic’s liens, UCC filings — sourced from county recorder records. A key is absent when the source record has no value.
array of objects
Pre-foreclosure and foreclosure events recorded against the property — notices of default, notices of sale, lis pendens, and auctions — sourced from county recorder records. A key is absent when the source record has no value.

Histories, valuation model & extensions

array
Historical appraised values by year from county assessor records — one entry per appraisal year, with land, building, and total market components.
array
Historical assessed values by year from county assessor records — one entry per assessment year, with land, building, total, and market components.
array
Building and construction permits associated with the property, sourced from the issuing jurisdiction’s permit records.
object
Electricity utility and rate information for the property’s service area.
object
The parcel’s zoning designation with provenance — the record’s one zoning surface. matchMethod says which of the two provenance tiers produced it.
object
Availability flags and links for supplementary property resources — building sketches, property card PDFs, photos, and GIS maps.
URLs to external property resources hosted by the county or its mapping providers.
string
Catch-all for additional source data that does not fit the structured sections, serialized as a JSON string. Structure varies by county.
object
Realie’s own automated valuation (AVM): two independent estimators that cross-check each other — a machine-learning estimate with universal coverage (ml) and a comparable-sales estimate where enough nearby comps exist (comp).
object
Modeled debt/equity analytics carried over from the legacy v2 pipeline. These are modeled estimates (open-lien rollups, current-LTV/equity models), not recorded facts — recorded mortgages and liens live in their own history arrays and are never derived from this object. Present only on parcels uniquely matched to a legacy v2 record. Excluded from API responses; available in bulk data only.
object
Ownership-tenure analytics carried over from the legacy v2 pipeline. Keyed to the v2-era owner of record and may lag the current owner in propertyIdentification.currentOwner. Present only on parcels uniquely matched to a legacy v2 record. Excluded from API responses; available in bulk data only.