US Parcel Boundary Data
Contents
- Parcel Data: Versioning (year, month, version)
- Parcel Data: State or country specifier
- Parcel Data: File Type
- Output field definitions
Parcel data: Versioning (year, month, version)
The US Parcel Data product is updated quarterly. The following versioning fields allow control over which version of a file is downloaded
| Year | The year field specifies the year the file was generated and should be formatted as YYYY, such as “2023.” |
| Month | The month field also specifies a version referring to the month the file was generated. Numbers should be formatted with a leading zero if between 1 and 9, in MM format, like “07”. If a month is requested that does not align with a quarterly update, an HTTP 429 error will be returned. Please note: only the values 01, 04, 07, and 10 are valid, as they correspond to the first month of a quarter. |
| File version | The newest version of the file is automatically retrieved when the version is set to “latest”. In some cases, a manual version can be specified to retrieve a specific file version, as parcel data is sometimes generated multiple times within a quarterly period. If a specific version of a file is desired, the format will appear as “2023.07.B/”, where the final character is incremented by version, starting at ‘A’. |
Parcel data download format
curl -vL "https://download.api.smarty.com/parcel-data/usa-co/2026/01/gpkg/latest?auth-id=YOUR+AUTH-ID+HERE&auth-token=YOUR+AUTH-TOKEN+HERE" -o CO_Parcel_Data.zip
Sample URLs for quarterly updates
Note that the month fields are 01, 04, 07 or 10.
"https://download.api.smarty.com/parcel-data/usa-al/2026/01/gpkg/latest?auth-id=YOUR+AUTH-ID+HERE&auth-token=YOUR+AUTH-TOKEN+HERE"
"https://download.api.smarty.com/parcel-data/usa-ak/2026/04/gpkg/latest?auth-id=YOUR+AUTH-ID+HERE&auth-token=YOUR+AUTH-TOKEN+HERE"
"https://download.api.smarty.com/parcel-data/usa-az/2026/07/gpkg/latest?auth-id=YOUR+AUTH-ID+HERE&auth-token=YOUR+AUTH-TOKEN+HERE"
"https://download.api.smarty.com/parcel-data/usa-ar/2026/10/gpkg/latest?auth-id=YOUR+AUTH-ID+HERE&auth-token=YOUR+AUTH-TOKEN+HERE"
Parcel data: State or country specifier
Here, the state or the entire country is specified according to the purchased plan. The following are valid options. Note that some territories are included and the ISO-2 is lowercase:
usa-al | usa-ak | usa-az | usa-ar | usa-ca | usa-co | usa-ct | usa-de | usa-dc | usa-fl | usa-ga | usa-gu | usa-hi | usa-id | usa-il | usa-in | usa-ia | usa-ks |
usa-ky | usa-la | usa-me | usa-md | usa-ma | usa-mi | usa-mn | usa-ms | usa-mo | usa-mt | usa-ne | usa-nv | usa-nh | usa-nj | usa-nm | usa-ny | usa-nc | usa-nd |
usa-mp | usa-oh | usa-ok | usa-or | usa-pa | usa-pr | usa-ri | usa-sc | usa-sd | usa-tn | usa-tx | usa-ut | usa-vt | usa-va | usa-wa | usa-wv | usa-wi | usa-wy |
usa-national | |||||||||||||||||
Sample URLs for state/national requests
Wyoming sample request
"https://download.api.smarty.com/parcel-data/usa-wy/2026/04/gpkg/latest?auth-id=YOUR+AUTH-ID+HERE&auth-token=YOUR+AUTH-TOKEN+HERE"
National sample request (Must be in the Parquet format)
"https://download.api.smarty.com/parcel-data/usa-national/2026/04/parquet/latest?auth-id=YOUR+AUTH-ID+HERE&auth-token=YOUR+AUTH-TOKEN+HERE"
Parcel data: File type
Smarty offers Parcel Data in several different file formats. You can choose among these by specifying the desired format directly after the month in the file path. The possible file types and examples of their usage are below:
.gpkg
"https://download.api.smarty.com/parcel-data/usa-co/2026/04/gpkg/latest?auth-id=YOUR+AUTH-ID+HERE&auth-token=YOUR+AUTH-TOKEN+HERE"
.parquet
"https://download.api.smarty.com/parcel-data/usa-co/2026/04/parquet/latest?auth-id=YOUR+AUTH-ID+HERE&auth-token=YOUR+AUTH-TOKEN+HERE"
.geojson
"https://download.api.smarty.com/parcel-data/usa-co/2026/04/geojson/latest?auth-id=YOUR+AUTH-ID+HERE&auth-token=YOUR+AUTH-TOKEN+HERE"
.csv
"https://download.api.smarty.com/parcel-data/usa-co/2026/04/csv/latest?auth-id=YOUR+AUTH-ID+HERE&auth-token=YOUR+AUTH-TOKEN+HERE"
Important Note: ONLY the Parquet file type can be specified when requesting the "national" parcel data
Output field definitions
| Shapefile Column name | Field Column Name | Description | Data Type |
|---|---|---|---|
| smartykey | smartykey | Smarty's unique identifier for an address. | bigint |
| cnty_fips | county_fips | The 5-digit county FIPS (Federal Information Processing Standards) code. It is a combination of a 2-digit state FIPS code and a 3-digit county FIPS code. | varchar |
| par_num_fm | parcel_number_formatted | The parcel ID or parcel number | varchar |
| parcel_num | parcel_number | The parcel ID or parcel number with all non-A-Z and 0-9 characters removed | varchar |
| par_num_st | parcel_number_state | The statewide parcel ID number | varchar |
| acc_num | account_number | The assessor or tax collector's account ID number for a property | varchar |
| tax_id | tax_id | The assessor or tax collector's tax ID number for a property | varchar |
| alt_parc_1 | parcel_number_alternate_1 | A parcel ID number provided by the county that is not considered to be the primary parcel ID number used by the county. These could be previously used parcel ID numbers or alternate ID numbers. | varchar |
| alt_parc_2 | parcel_number_alternate_2 | A parcel ID number provided by the county that is not considered to be the primary parcel ID number used by the county. These could be previously used parcel ID numbers or alternate ID numbers. | varchar |
| alt_parc_3 | parcel_number_alternate_3 | A parcel ID number provided by the county that is not considered to be the primary parcel ID number used by the county. These could be previously used parcel ID numbers or alternate ID numbers. | varchar |
| use_code | use_code | The parcel use code | varchar |
| use_desc | use_desc | The parcel use description | varchar |
| zoning | zoning | The governing municipality's zoning code | varchar |
| zon_desc | zoning_desc | The governing municipality's zoning code description | varchar |
| zon_type | zoning_type | A standardized zoning type | varchar |
| zon_subtp | zoning_subtype | A standardized zoning subtype | varchar |
| structure | structure | Indicates if there’s a structure on the parcel | varchar |
| num_struct | num_structures | The number of structures on the parcel | integer |
| parvaltype | parcel_value_type | The parcel value type. This field describes the type or method used by the Assessor to determine the parcel values listed in MARKET_VALUE and AGRICULTURAL_VALUE. | varchar |
| mkt_val | market_value | The total parcel value (in USD) from the Assessor's data | double |
| agr_val | agricultural_value | The agricultural value (in USD) from the Assessor's data | double |
| hmstd_exem | homestead_exemption | A county-provided indicator that the parcel qualifies for homeowner or homestead tax exemptions | varchar |
| mail_smtky | mailing_smartykey | Smarty's unique identifier for a mailing address. | bigint |
| mail_dlv_1 | mailing_delivery_line_1 | The parcel mailing address. This is where communications from the tax and other assessors are sent. Contains the first delivery line (usually the street address). This can include any of the following: mailing urbanization (Puerto Rico only), mailing primary number, mailing street predirection, mailing street name, mailing street suffix, mailing street postdirection, mailing secondary | varchar |
| mail_dlv_2 | mailing_delivery_line_2 | The second delivery line of the parcel mailing address (if needed). It's common for this field to remain empty. | varchar |
| mail_prim | mailing_primary_number | The house, PO Box, or building number of the parcel mailing address | varchar |
| mail_pred | mailing_street_predirection | Directional information before a parcel mailing address street name (N, SW, etc.) | varchar |
| mail_str | mailing_street_name | The name of the parcel mailing address street | varchar |
| mail_st_sf | mailing_street_suffix | Abbreviated value describing the parcel mailing address street (St, Ave, Blvd, etc.) | varchar |
| mail_postd | mailing_street_postdirection | Directional information after a parcel mailing address street name (N, SW, etc.) | varchar |
| mail_scndy | mailing_secondary | Describes location within a complex/building (Ste, Apt, etc.) and its correlated unit number and/or letter (if any) of the parcel mailing address | varchar |
| mail_city | mailing_city_name | The parcel mailing address city name | varchar |
| mail_state | mailing_state_abbreviation | The two-letter state abbreviation of the parcel mailing address | varchar |
| mail_zip | mailing_zipcode | The parcel mailing address ZIP Code | varchar |
| mail_cntry | mailing_country | The parcel mailing address country | varchar |
| mail_urban | mailing_urbanization | The neighborhood, or city subdivision of the parcel mailing address; used with Puerto Rican addresses | varchar |
| dlv_line_1 | delivery_line_1 | The physical street address for the parcel - the address of the parcel itself. Not every parcel has a street address, especially in agricultural areas, or for larger parcels. Also called the "situs address" or "site address". Contains the first delivery line (usually the street address). This can include any of the following: urbanization (Puerto Rico only), primary number, street predirection, street name, street suffix, street postdirection, secondary | varchar |
| dlv_line_2 | delivery_line_2 | The second delivery line of the parcel address (if needed). It is common for this field to remain empty. | varchar |
| prim_num | primary_number | The house, PO Box, or building number of the parcel address | varchar |
| pre_dir | street_predirection | Directional information before a parcel address street name (N, SW, etc.) | varchar |
| str_name | street_name | The name of the parcel address street | varchar |
| str_sfx | street_suffix | Abbreviated value describing the parcel address street (St, Ave, Blvd, etc.) | varchar |
| post_dir | street_postdirection | Directional information after a parcel address street name (N, SW, etc.) | varchar |
| secondary | secondary | Describes location within a complex/building (Ste, Apt, etc.) and its correlated unit number and/or letter (if any) of the parcel address | varchar |
| city_name | city_name | The parcel address city name | varchar |
| cnty_sbdvn | census_county_subdivision | The US Census County Subdivision. Used for organizational purposes. Refer to CITY_NAME for the city associated with the site address. | varchar |
| county | county | The parcel address county | varchar |
| state | state_abbreviation | The two-letter state abbreviation of the parcel address | varchar |
| plus4_code | plus4_code | The 4-digit add-on code of the parcel address (more specific than 5-digit ZIP) | varchar |
| zipcode | zipcode | The 5-digit ZIP Code of the parcel address | varchar |
| site_urban | site_urbanization | The neighborhood, or city subdivision of the parcel address; used with Puerto Rican addresses | varchar |
| unit_count | unit_count | A count of all known addresses on the parcel | integer |
| location_name | name | The name associated with the parcel | varchar |
| legal_desc | legal_description | The legal description | varchar |
| plat | plat | The plat number the parcel is recorded on | varchar |
| book | book | The book/liber the parcel is recorded in | varchar |
| page | page | The page/folio on which the parcel is recorded | varchar |
| block | block | The parcel block | varchar |
| lot | lot | The parcel lot | varchar |
| nbhd_name | neighborhood_name | The neighborhood name | varchar |
| nbhd_code | neighborhood_code | An alphanumeric neighborhood code | varchar |
| subdvsn | subdivision | The subdivision of the parcel | varchar |
| qual_op_zn | us_federal_qualified _opportunity_zone | Indicates whether this parcel is in a US Federal Qualified Opportunity Zone | varchar |
| elem_schl | elementary_school_district | Elementary School District. Census defined "elementary" school districts provide education for children ages 5-17. If local authorities divide students by age, younger students fall under "elementary" school districts, while older students fall under "secondary" school districts. | varchar |
| sec_schl | secondary_school_district | Secondary School District. Census defined "secondary" school districts provide education for children aged 5-17 that are determined to be above a specified age by local authorities. | varchar |
| unif_schl | unified_school_district | Unified School District. Census-designated "unified" school districts provide education for all children ages 5-17. | varchar |
| last_refsh | date_of_last_refresh | The date the county source data was most recently refreshed | date |
| bldg_sqft | building_sqft | The Assessor's recorded structure square footage | integer |
| bldg_area | building_area | The total area (in square feet) of all of the structures on the property. This can include hallways, gyms, laundry rooms, mail rooms, pools, etc. | text |
| bldg_def | building_area_definition | Describes the area in the "BUILDING_AREA" field | text |
| deed_acres | deed_acres | The acres listed as "deeded acres" by the county. Often different from the acreage calculated by GIS. | double |
| acres | acres | The acres value | double |
| sqft | sqft | The parcel square footage value | double |
| acres_calc | acres_calculated | The parcel acres value, as calculated from county parcel geometry | double |
| sqft_calc | sqft_calculated | The parcel square footage, as calculated from supplied parcel geometry | bigint |
| bldg_fp_sq | building_footprint_sqft | The total building footprint (in square feet) | integer |
| num_bldgs | number_of_buildings _on_parcel | The total number of buildings on the parcel | integer |
| cdl_raw | cropland_data_layer_raw | An array of 2-member arrays with the Cropland Data Layer (CDL) values in position 1, and the percentage of the parcel area covered by that value in position 2. The term "value" is a USDA term for the numeric code that corresponds to a particular crop or land cover type. | varchar |
| cdl_m_cat | cropland_data_layer _majority_category | The human-readable category for the majority CDL value | varchar |
| cdl_m_perc | cropland_data_layer _majority_percent | The percentage of the parcel that the "CROPLAND_DATA_LAYER_MAJORITY_CATEGORY" covers | double |
| cdl_date | cropland_data_layer_date | The Cropland Data Layer (CDL) date, usually released annually in February for the previous year | varchar |
| plss_twnsh | public_land_survey _system_township | The Public Land Survey System township the parcel is located in (based on the centroid of the parcel). Derived from BLM designated polygons. | varchar |
| plss_sectn | public_land_survey _system_section | The Public Land Survey System section the parcel is located in (based on the centroid of the parcel). Derived from BLM designated polygons. | varchar |
| plss_range | public_land_survey _system_range | The Public Land Survey System range the parcel is located in (based on the centroid of the parcel). Derived from BLM designated polygons. | varchar |
| last_rev | date_of_last_revision | The last date of the last revision as provided by the county assessor's office (if available) | date |
| row_parcel | right_of_way | Indicates a right-of-way parcel or similar function parcel | varchar |
| time_updte | time_of_last_update | The timestamp of the most recent change of any kind to this row in the table (internal record changes and/or county updates). "DATE_OF_LAST_REFRESH" should be used for the date of the parcel data. | timestamp with time zone |
| usgs_padus | usgs_protected _areas_database_us | United States Geological Survey Protected Areas Database of the United States Public Access designation | varchar |
| lbcs_act | land_based_classification _standards_activity | Numeric code indicating the use of land (farming, shopping, manufacturing, etc.) | double |
| lbcs_actde | land_based_classification _standards_activity_desc | Description of the LBCS activity numeric code | varchar |
| lbcs_fun | land_based_classification _standards_function | Numeric code indicating the economic function or type of establishment (agricultural, commercial, industrial, etc.) | double |
| lbcs_funde | land_based_classification _standards_function_desc | Description of the LBCS function numeric code | varchar |
| lbcs_strct | land_based_classification _standards_structure | Numeric code indicating the type of structure or building (single-family house, office building, warehouse, etc.) | double |
| lbcs_strde | land_based_classification _standards_structure_desc | Description of the LBCS structure numeric code | varchar |
| lbcs_site | land_based_classification _standards_site | Numeric code indicating what is on the land (national monument, wilderness parks, national preserve, etc.) | double |
| lbcs_sitde | land_based_classification _standards_site_desc | Description of the LBCS site numeric code | varchar |
| lbcs_own | land_based_classification _standards_ownership | Numeric code indicating the ownership structure (federal government, state government, public restrictions, etc.) | double |
| lbcs_ownde | land_based_classification _standards_ownership_desc | Description of the LBCS ownership numeric code | varchar |
| hs_aff_ind | housing_affordability_index | The Housing Affordability Index (HAI), which measures the ability of a typical resident to purchase a home within the geographic area | double |
| popden_mi2 | population_density_per_sqmi | An estimate of the population density (per square mile) in the geographic area | double |
| popgrow_p5 | population_growth _past_5_years | The population Compound Annual Growth Rate (CAGR) for the previous 5 year period | double |
| popgrow_n5 | population_growth _next_5_years | The five-year forecast for population growth (Compound Annual Growth Rate) | double |
| hu_grow_p5 | housing_units_growth _past_5_years | The housing units Compound Annual Growth Rate (CAGR) for the previous 5 year period | double |
| hu_grow_n5 | housing_units_growth _next_5_years | The five-year forecast for the housing units (Compound Annual Growth Rate) | double |
| hi_grow_n5 | median_household_income_ growth_next_5_years | The five-year forecast for the median household income (Compound Annual Growth Rate) | double |
| m_hs_in_p1 | median_household_income _past_1_year | An estimate of the median household income in the geographic area for the previous year | double |
| tline_dist | distance_to_nearest _transmission_line | The distance (in meters) between the parcel boundary and the nearest relatively high voltage (69kv - 765kv) electric transmission line as available within the Homeland Infrastructure Foundation-Level Data (HIFLD) Transmission Line dataset | double |
| dem_var | elevation_variability | The amount of elevation variability within a parcel. Calculated per parcel from Digital Elevation Model (DEM). 0 = a level terrain surface 1 = a nearly level terrain surface 2 = a slightly rugged terrain surface 3 = an intermediately rugged terrain surface 4 = a moderately rugged terrain surface 5 = a highly rugged terrain surface 6 = an extremely rugged terrain surface | double |
| hi_elev_m | highest_elevation | The highest elevation value (in meters) within the parcel | double |
| low_elev_m | lowest_elevation | The lowest elevation value (in meters) within the parcel | double |
| parcel | The geometry of the parcel boundary | wkt, wkb, embedded |