Skip to main content
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) 
    • Example: 2024-05-01
  • 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