{ "version": "1.0.0", "updated": "2026-08-30", "description": "Field-level reference for documented Acren product concepts and explicitly unavailable capabilities. These keys describe UI and source-specific records, not a flat public API response contract or a promise that every field is offered in every jurisdiction. Documented means the concept exists in the product; source_dependent means qualified evidence and access vary; not_offered means the stated capability is not promised. See current coverage and source limitations before evaluating a record.", "identifierNotes": [ "Property card IDs, source parcel references, legal registrations and canonical entities are separate identity namespaces. Preserve the identifier's type and source; changing a display name does not justify treating different entities as one.", "A parcel number requires county, state and source context. Do not publish raw supplier dataset keys or assume a parcel number is globally unique.", "No universal public loan, transaction or owner identifier lifecycle is promised by this documentation. A mortgage event sequence or source document number is not a globally stable loan identifier.", "Source record counts are not measured unique commercial property counts. A large raw inventory, including a 57 million row source inventory, must not be advertised as that many distinct commercial properties without a documented deduplication and classification measurement.", "Unknown and unavailable values remain null or explicitly unobserved. Empty evidence lists are not proof that a property has no liens, permits, debt or other events." ], "license": { "name": "Creative Commons Attribution 4.0 International", "url": "https://creativecommons.org/licenses/by/4.0/", "scope": "This license covers only this documentation and the entirely synthetic example, with attribution to Acren. It does not license production records, third-party source data, customer records, logos or source documents." }, "fields": [ { "key": "property_id", "label": "Property ID", "group": "Property and parcel", "type": "string", "definition": "Identifier for a materialized Acren property card.", "availability": "documented", "source": "Acren property record and property snapshots.", "limitations": "A property card ID is not a universal parcel identifier. Documentation examples use a separate sample- namespace; no public ID lifecycle or API guarantee is implied." }, { "key": "parcel_id", "label": "Parcel or APN", "group": "Property and parcel", "type": "string | null", "definition": "Parcel number or assessor parcel number reported by the source.", "availability": "source_dependent", "source": "County assessor or licensed parcel source; raw and normalized snapshot values.", "limitations": "Not globally unique. Keep the state, county and source namespace; punctuation and leading zeros can matter. Parcel splits and consolidations require record review." }, { "key": "county_fips", "label": "County FIPS", "group": "Property and parcel", "type": "string | null", "definition": "Five-digit county identifier used to scope property and county records.", "availability": "documented", "source": "Canonical county catalog and parcel source county identity.", "limitations": "Preserve all five digits including leading zeros. A county match is not a property match; missing county identity must not be guessed from a display name." }, { "key": "state_code", "label": "State code", "group": "Property and parcel", "type": "string | null", "definition": "Two-letter state or District of Columbia code attached to the property observation.", "availability": "documented", "source": "Parcel source and canonical geographic catalog.", "limitations": "Geographic identity is separate from customer access and source availability. A metro can span more than one state." }, { "key": "property_address", "label": "Property address", "group": "Property and parcel", "type": "string | null", "definition": "Recorded situs or property address associated with a parcel observation.", "availability": "source_dependent", "source": "Parcel and assessment source records; property snapshots.", "limitations": "An address can be absent, shared or changed. It is neither a guaranteed deliverable mailing address nor a globally unique property identifier." }, { "key": "asset_class", "label": "Asset classification", "group": "Property and parcel", "type": "string | null", "definition": "Normalized research classification derived from recorded use, class and other qualified property attributes.", "availability": "source_dependent", "source": "Parcel use codes and Acren classification result.", "limitations": "Source labels and normalized classifications are distinct. Unknown or unverified classes remain uncertain; raw source-row counts are not a measured count of unique commercial properties." }, { "key": "building_area", "label": "Building area", "group": "Property and parcel", "type": "number | null", "definition": "Building area recorded in the property snapshot, expressed in square feet when supplied in that unit.", "availability": "source_dependent", "source": "Parcel and assessment source building-area fields.", "limitations": "Coverage and area definition vary by jurisdiction. Do not substitute lot area, rentable area or an unverified unit conversion." }, { "key": "acreage", "label": "Land acreage", "group": "Property and parcel", "type": "number | null", "definition": "Recorded parcel land area expressed in acres.", "availability": "source_dependent", "source": "Parcel and assessment source acreage fields.", "limitations": "Not building floor area. Missing, zero or conflicting values require source review rather than an assumed parcel size." }, { "key": "unit_count", "label": "Unit count", "group": "Property and parcel", "type": "integer | null", "definition": "Number of units recorded for the property.", "availability": "source_dependent", "source": "Parcel source and normalized property snapshot.", "limitations": "A recorded unit count is not current occupancy, a rent roll or a confirmed rentable-unit count." }, { "key": "year_built", "label": "Year built", "group": "Property and parcel", "type": "integer | null", "definition": "Construction year provided by the property source.", "availability": "source_dependent", "source": "Parcel and assessment source construction fields.", "limitations": "May be missing or reflect an assessor convention. It does not establish renovation dates or building condition." }, { "key": "zoning", "label": "Zoning", "group": "Zoning and environment", "type": "string | null", "definition": "Zoning designation present in an available assessor or property record.", "availability": "source_dependent", "source": "Local assessor or property source zoning field.", "limitations": "Not a current zoning determination, entitlement opinion or confirmation of permitted use. Verify the official local zoning authority." }, { "key": "owner_of_record", "label": "Recorded owner name", "group": "Owner and entity", "type": "string | null", "definition": "Owner name as observed in the underlying property record, kept separate from a company match.", "availability": "source_dependent", "source": "Property owner observation; parcel or assessor record.", "limitations": "An observation has a source date. It does not prove current ownership, beneficial ownership, seller intent or that a same-name registration is the owner." }, { "key": "owner_entity_id", "label": "Matched entity identifier", "group": "Owner and entity", "type": "string | null", "definition": "Identifier for the legal-entity registration or canonical entity supported by the applicable ownership-resolution contract.", "availability": "source_dependent", "source": "Ownership resolution and entity graph registration references.", "limitations": "Registration IDs and canonical entity IDs have separate namespaces; preserve which one is returned. A candidate is not a confirmed relationship and not evidence of beneficial ownership." }, { "key": "entity_registration_number", "label": "Entity registration number", "group": "Owner and entity", "type": "string | null", "definition": "Registration or filing number supplied by the business registry.", "availability": "source_dependent", "source": "Official company registry record or licensed registry source.", "limitations": "Unique only within the issuing registry's namespace. Preserve the registration state and source; do not merge entities solely by number or name." }, { "key": "entity_registration_state", "label": "Registration state", "group": "Owner and entity", "type": "string | null", "definition": "Jurisdiction of the business registration linked or considered in entity research.", "availability": "source_dependent", "source": "Entity registration record.", "limitations": "A foreign registration is not necessarily the state of formation. The entity's registry state can differ from the property's state." }, { "key": "entity_status", "label": "Entity status", "group": "Owner and entity", "type": "string | null", "definition": "Source-reported or normalized registration status.", "availability": "source_dependent", "source": "Business registry observation.", "limitations": "A status is time-specific and is not a legal opinion about ownership, authority to transact or present good standing." }, { "key": "registered_agent_name", "label": "Registered agent", "group": "Owner and entity", "type": "string | null", "definition": "Agent name included in an available business registration.", "availability": "source_dependent", "source": "Official registry filing or normalized entity profile.", "limitations": "A registered agent is not necessarily an owner or decision-maker. Agent overlap alone must not be presented as definitive common ownership." }, { "key": "beneficial_ownership", "label": "Verified beneficial ownership", "group": "Unavailable capabilities", "type": "null", "definition": "A definitive identification of the natural persons who ultimately own or control a property.", "availability": "not_offered", "source": "No universal verified beneficial-ownership product contract.", "limitations": "Disclosed registry parties and source-backed relationship evidence may be shown, but do not establish undisclosed beneficial owners or justify an inferred person-level ownership claim." }, { "key": "related_ownership", "label": "Related entity evidence", "group": "Owner and entity", "type": "array | null", "definition": "Source-backed or explicitly labeled candidate relationships between registrations, entities and properties.", "availability": "source_dependent", "source": "Entity graph edges and official relationship evidence.", "limitations": "Preserve relationship type, status, reasons and provenance. Shared names, agents or addresses do not by themselves prove one owner controls multiple properties." }, { "key": "sale_date", "label": "Recorded transfer date", "group": "Sales", "type": "date | null", "definition": "Most recent valid transfer or recording date available in the property record, or a date on a linked sale document.", "availability": "source_dependent", "source": "Parcel transfer summary or normalized recorded document.", "limitations": "Transfer and recording dates are distinct. This documentation key does not collapse multiple sale events into a complete transaction history." }, { "key": "sale_price", "label": "Recorded sale consideration", "group": "Sales", "type": "number | null", "definition": "Consideration or sale amount stated by the available property or recording source.", "availability": "source_dependent", "source": "Parcel sale summary or recorded-document consideration amount.", "limitations": "May be unavailable in nondisclosure jurisdictions or refer to a multi-parcel transfer. It is not an appraisal, market-value estimate or verified arm's-length price." }, { "key": "mortgage_amount", "label": "Recorded mortgage amount", "group": "Mortgages", "type": "number | null", "definition": "Amount on a historical mortgage line item or normalized recorded instrument.", "availability": "source_dependent", "source": "Parcel-linked mortgage history or recorded mortgage document.", "limitations": "Not the current outstanding balance. Preserve amount scope: a value may describe a parcel-linked record, portfolio or entity facility, or unverified scope." }, { "key": "lender_name", "label": "Recorded lender", "group": "Mortgages", "type": "string | null", "definition": "Lender or mortgagee name present on the available mortgage record.", "availability": "source_dependent", "source": "Mortgage-history line item or normalized recorded instrument.", "limitations": "Not necessarily the current holder, servicer or a verified contact. Assignments and releases can change the relationship." }, { "key": "mortgage_recording_date", "label": "Mortgage recording date", "group": "Mortgages", "type": "date | null", "definition": "Recording date reported for a historical mortgage document.", "availability": "source_dependent", "source": "Mortgage history or recorded-document date.", "limitations": "Not necessarily loan origination, funding or execution date. Preserve the source document and any distinct execution date." }, { "key": "loan_maturity_date", "label": "Loan maturity date", "group": "Mortgages", "type": "date | null", "definition": "Stated due date or explicitly derived maturity in mortgage history; some federal housing records also provide a stated loan maturity.", "availability": "source_dependent", "source": "Mortgage-history due date, recording date and term; qualified federal housing record.", "limitations": "Keep stated and derived maturity separate using maturity_basis. A derived date is not a recorded date; neither establishes current unpaid debt, default or an unreleased lien." }, { "key": "lien_records", "label": "Lien records", "group": "Liens and distress", "type": "array | null", "definition": "Linked lien filings or source-reported historical lien observations when available.", "availability": "source_dependent", "source": "Recorded documents, qualified lien evidence and property history summaries.", "limitations": "History counters are not normalized document evidence. A lien observation does not prove an enforceable or currently unsatisfied lien; inspect releases, parties and dates." }, { "key": "tax_delinquency", "label": "Tax delinquency evidence", "group": "Liens and distress", "type": "object | null", "definition": "Source-reported delinquency status, tax year or amount attached to qualified property evidence.", "availability": "source_dependent", "source": "Local tax authority records and normalized tax-distress evidence.", "limitations": "Not nationwide complete or a current payoff quote. Missing records do not mean taxes are current; verify the authority and effective date." }, { "key": "foreclosure_records", "label": "Foreclosure or distress notices", "group": "Liens and distress", "type": "array | null", "definition": "Recorded foreclosure-related notices or qualified distress observations.", "availability": "source_dependent", "source": "Official recorded documents, court or notice sources, and parcel history summaries.", "limitations": "A notice or historical count is not proof of an active case, scheduled sale or seller motivation. Case disposition and property linkage require verification." }, { "key": "permit_records", "label": "Permit records", "group": "Permits and code", "type": "array | null", "definition": "Property-linked permits with available status, issue dates, descriptions and source links.", "availability": "source_dependent", "source": "Local permit authorities and normalized permit context.", "limitations": "Coverage is jurisdiction-specific and may require additional access. Aggregate residential permit counts are market context, not parcel-level permit evidence; a permit does not prove work completion." }, { "key": "code_violations", "label": "Code cases", "group": "Permits and code", "type": "array | null", "definition": "Qualified local code-enforcement case observations linked to a property.", "availability": "source_dependent", "source": "Local code-enforcement records and resolved public-record signals.", "limitations": "Not a universal inspection history. Allegations, open cases, resolutions and administrative dates must remain distinct; no record is not proof of compliance." }, { "key": "fema_environmental_context", "label": "FEMA and environmental context", "group": "Zoning and environment", "type": "array | null", "definition": "Available disaster, hazard, environmental or geographic risk context associated with the property or its area.", "availability": "source_dependent", "source": "FEMA and other identified public environmental or geographic sources.", "limitations": "County or area context is not a parcel-specific flood-zone determination, environmental assessment, insurance decision or evidence of damage. Preserve geographic resolution and source date." }, { "key": "tenant_information", "label": "Verified tenant roster", "group": "Unavailable capabilities", "type": "null", "definition": "A comprehensive current tenant roster, lease roll or tenant-contact dataset for a property.", "availability": "not_offered", "source": "No comprehensive tenant or lease-roll product contract.", "limitations": "Property, occupancy or federal housing program context does not establish named current tenants, private lease terms or a rent roll." }, { "key": "contact_information", "label": "Verified owner contact enrichment", "group": "Unavailable capabilities", "type": "null", "definition": "A verified outreach dataset of owner phone numbers and email addresses.", "availability": "not_offered", "source": "No universal verified owner-contact enrichment contract.", "limitations": "Source-specific public program or management contacts can appear in qualified records; they are not necessarily owners, current decision-makers or permission to contact anyone." }, { "key": "current_noi", "label": "Verified current NOI", "group": "Unavailable capabilities", "type": "null", "definition": "Verified current net operating income for an individual property.", "availability": "not_offered", "source": "No verified property financial-statement contract.", "limitations": "Recorded values, program rents and public housing expense fields cannot substitute for current operating statements or a verified NOI calculation." }, { "key": "seller_intent", "label": "Seller intent or sale probability", "group": "Unavailable capabilities", "type": "null", "definition": "A conclusion that an owner intends to sell or a probability that a property will sell.", "availability": "not_offered", "source": "No seller-intent or sale-probability contract.", "limitations": "Research priority is evidence-based triage within a buy box, not a prediction of personal intent, transaction probability or investment performance." }, { "key": "off_record_debt", "label": "Off-record debt", "group": "Unavailable capabilities", "type": "null", "definition": "Debt or obligations not disclosed by the available underlying records.", "availability": "not_offered", "source": "No off-record debt discovery contract.", "limitations": "The absence of a recorded mortgage or lien cannot establish that a property is debt-free; private obligations and unrecorded changes may be unknown." }, { "key": "source_record_id", "label": "Source record reference", "group": "Provenance and confidence", "type": "string | null", "definition": "Reference to the underlying record supporting a field, event or relationship within its source namespace.", "availability": "source_dependent", "source": "Property snapshot source references, normalized source rows and graph source-document references.", "limitations": "Not interchangeable with a property, loan or transaction ID. Public documentation uses synthetic references; raw vendor keys, private storage paths and customer identifiers are not public sample content." }, { "key": "source_document_url", "label": "Source document or portal URL", "group": "Provenance and confidence", "type": "string | null", "definition": "Permitted link to a supporting document or official research portal.", "availability": "source_dependent", "source": "Recorded-document, permit, graph or official-source link metadata.", "limitations": "A portal URL may require a manual search, fee or login and is not a document permalink. Link availability does not establish loaded record coverage or republication rights." }, { "key": "source_date", "label": "Source observation or effective date", "group": "Provenance and confidence", "type": "date | date-time | null", "definition": "Date attached to the source observation or explicitly identified effective record.", "availability": "source_dependent", "source": "Source-observed, source-as-of or effective-date metadata on the relevant record.", "limitations": "Keep event, recording, effective and observation dates distinct. A snapshot creation date or this dictionary's update date must not be presented as the underlying record's freshness." }, { "key": "retrieved_at", "label": "Record retrieval time", "group": "Provenance and confidence", "type": "date-time | null", "definition": "Timestamp when an underlying normalized source record was retrieved, where retained and exposed.", "availability": "source_dependent", "source": "Normalized source record retrieval metadata.", "limitations": "Not the legal effective date. Graph transaction time is not necessarily retrieval time; do not backfill retrieval from a documentation build or an unrelated record." }, { "key": "value_origin", "label": "Recorded, normalized or derived value", "group": "Provenance and confidence", "type": "string | null", "definition": "Documentation concept distinguishing a source observation from normalization or an explicitly derived research value.", "availability": "documented", "source": "Existing normalizer, classifier, maturity-basis and graph provenance metadata.", "limitations": "Not a single guaranteed wire field.\nPreserve the relevant basis and version; \"derived\" does not mean independently verified. Public examples use \"synthetic\" rather than implying source evidence." }, { "key": "match_status", "label": "Relationship decision status", "group": "Provenance and confidence", "type": "string | null", "definition": "The resolver's decision, such as confirmed, review, not_found, not_eligible or not_evaluated.", "availability": "source_dependent", "source": "Ownership-resolution decision and relationship context.", "limitations": "An unreviewed candidate is not a confirmed owner. The UI's Confident match, Likely match and No match labels summarize statuses; absence of a match is not proof of no relationship." }, { "key": "match_confidence", "label": "Match confidence", "group": "Provenance and confidence", "type": "number | null", "definition": "Contract-specific score accompanying a property-to-record or owner-to-registration match.", "availability": "source_dependent", "source": "Ownership resolution, graph edges and qualified source-link matching.", "limitations": "Not an empirical probability or published accuracy guarantee. Scales and methods differ between contracts; use the stated method, status, reason codes and version rather than comparing numbers across sources." }, { "key": "resolution_method", "label": "Resolution method and reasons", "group": "Provenance and confidence", "type": "string | array | null", "definition": "Match method, reason codes and conflict evidence explaining how a link was accepted, held for review or rejected.", "availability": "source_dependent", "source": "Ownership reason codes, graph match tiers and source-link match methods.", "limitations": "A name match alone is not definitive ownership. Reasons describe the particular link; conflicting evidence and review status must not be hidden." }, { "key": "methodology_version", "label": "Methodology version", "group": "Provenance and confidence", "type": "string | null", "definition": "Normalizer, matcher or model version responsible for the documented result.", "availability": "source_dependent", "source": "Snapshot normalizer_version, ownership algorithm_version and graph matcher_version.", "limitations": "There is no single version shared by every field. Preserve the component version and observation time; the dictionary version is documentation versioning, not a model or data refresh." } ] }