Currently, the import focuses on recorded sales and thus must contain recorder document numbers (see below for reference).
Required fields
- assessor_parcel_number (String) - Parcel ID (APN, PIN, etc.); the county assessor parcel id for the parcel
- county_geoid (String) - 5-digit County FIPs (ANSI) code for the county; the first 2 are the state FIPS code and the last 3 are the county identifier
- sale_date (Date - YYYY-MM-DD)
- sale_price (Decimal)
- sale_type (String) - One of ‘listing’, ‘private_sale’, ‘other’, ‘auction’
Though each document field is optional by itself, at least one of document_book_number, document_page_number, or document_number must be provided.
- document_book_number (String) - County recorder document book number (if applicable)
- document_page_number (String) - County recorder document page number (if applicable)
- document_number (String) - County recorder document number (if applicable)
Optional fields
- external_id (String) - Unique identifier for the transaction
- improvements (Boolean) - Valid values are true or false; indicates whether or not a parcel has improvements
- legal_description (String) - Legal Description of parcel
- mls_number (String) - MLS Listing #
- comments (String) - Any comments associated with this sale
- Buyers (1-4)
- buyer_1_full_name - (String) - Buyer one full name
- buyer_1_address - (String) - Buyer one address, if not broken down by address components
- Example: 220 N Smith St., Palatine, IL 60067
- buyer_1_address_line_1
- buyer_1_address_line_2
- buyer_1_address_city
- buyer_1_address_state
- buyer_1_address_zipcode
- Sellers (1-4)
- seller_1_full_name - (String) - Seller one full name
- seller_1_address - (String) - Seller one address, if not broken down by address components
- Example: 220 N Smith St., Palatine, IL 60067
- seller_1_address_line_1
- seller_1_address_line_2
- seller_1_address_city
- seller_1_address_state
- seller_1_address_zipcode
- Acreage - all default to 0 unless otherwise provided; each is a decimal value. If none of these are provided as granular acreage, the parcel boundary acreage will be used
- crp_acres
- dryland_acres
- irrigated_acres
- non_production_acres
- pasture_acres
- site_acres
- wetland_acres
- woodland_acres
- wrp_acres
There are two sample files attached below for reference. One is a blank CSV that can be used as a template, containing all possible CSV headers supported by the import. Another shows an example of a single multi-parcel transaction and a sample of headers that might be included representing a subset of all.
Last modified on May 22, 2026
