Shovels

Data Dictionary

Complete field definitions for Shovels datasets including permits, contractors, residents, decisions, and enhanced property data.

Field Description Type Source
ADDITIONTRUE if the permit adds new square feetBooleanCreated by Shovels
ADDRESS_IDThe Shovels geo_ID of the addressStringCreated by Shovels
ADUTRUE if the permit is a secondary unit, cottage, in-law suite, or accessory dwelling unitBooleanCreated by Shovels
APNParcel numberStringEnhanced by Shovels
APPLICANT_CITYContact info for the applicantStringProvided by jurisdiction
APPLICANT_EMAILContact info for the applicantStringProvided by jurisdiction
APPLICANT_NAMEContact info for the applicantStringProvided by jurisdiction
APPLICANT_PHONEContact info for the applicantStringProvided by jurisdiction
APPLICANT_STATEContact info for the applicantStringProvided by jurisdiction
APPLICANT_STREETContact info for the applicantStringProvided by jurisdiction
APPLICANT_ZIPCODEContact info for the applicantStringProvided by jurisdiction
APPROVAL_DURATIONThe number of days between the file date and the issue dateIntegerCreated by Shovels
BATHROOMTRUE if the permit involved a bathroomBooleanCreated by Shovels
BATTERYTRUE if the permit involved a batteryBooleanCreated by Shovels
CBSAThe CBSA value (also known as MSA)StringEnhanced by Shovels
CBSA_FIPSThe CBSA FIPS codeStringEnhanced by Shovels
CITYThe city nameStringEnhanced by Shovels
CITY_IDThe geo_ID of the cityStringCreated by Shovels
CONSTRUCTION_DURATIONThe number of days between the issue date and the final dateIntegerCreated by Shovels
CONTRACTOR_GROUP_IDThe higher level group ID of the contractorStringCreated by Shovels
CONTRACTOR_IDThe Shovels ID of the individual contractorStringCreated by Shovels
COUNTYThe county nameStringEnhanced by Shovels
COUNTY_FIPSThe county FIPS codeStringEnhanced by Shovels
COUNTY_IDThe geo_ID of the countyStringCreated by Shovels
DEMOLITIONTRUE if the permit involved any demolitionBooleanCreated by Shovels
DESCRIPTIONThe long-form description of the permit according to the jurisdictionStringProvided by jurisdiction
DESCRIPTION_DERIVEDPlain-English summary of each permit's raw descriptionStringCreated by Shovels
ELECTRIC_METERTRUE if the permit involved an electrical meterBooleanCreated by Shovels
ELECTRICALTRUE if any of the work on the permit was electricalBooleanCreated by Shovels
END_DATEThe latest date on the permitDateCreated by Shovels
EV_CHARGERTRUE if the permit involved an EV chargerBooleanCreated by Shovels
FEESThe permit fees collected by the jurisdictionIntegerProvided by jurisdiction
FILE_DATEThe date the permit application was filedDateEnhanced by Shovels
FINAL_DATEThe date the permit was completedDateEnhanced by Shovels
FIRE_SPRINKLERTRUE if the permit involved a fire sprinklerBooleanCreated by Shovels
GASTRUE if the permit involved gasBooleanCreated by Shovels
GENERATORTRUE if the permit involved a generatorBooleanCreated by Shovels
GRADINGTRUE if the permit involved gradingBooleanCreated by Shovels
HEAT_PUMPTRUE if the permit involved a mini-split, heat pump, or related technologyBooleanCreated by Shovels
HVACTRUE if the permit involved heating, ventilation, or air conditioningBooleanCreated by Shovels
IDThe Shovels ID of the permitStringCreated by Shovels
INSPECTION_PASS_RATEThe ratio of the passed inspections to the total inspections on the permitFloatCreated by Shovels
INSPECTION_PASSEDTRUE if any inspections passed on the permitBooleanCreated by Shovels
ISSUE_DATEThe date the permit application was approvedDateEnhanced by Shovels
JOB_VALUEThe job value reported on the permitIntegerProvided by jurisdiction
JURISDICTIONThe name of the permit jurisdictionStringEnhanced by Shovels
JURISDICTION_IDThe geo_ID of the permit jurisdictionStringCreated by Shovels
KITCHENTRUE if the permit involved a kitchenBooleanCreated by Shovels
LATThe latitude of the permit addressIntegerEnhanced by Shovels
LONGThe longitude of the permit addressIntegerEnhanced by Shovels
NEW_CONSTRUCTIONTRUE if the permit included any new constructionBooleanCreated by Shovels
OWNER_CITYContact info for the owner according to the permitStringProvided by jurisdiction
OWNER_EMAILContact info for the owner according to the permitStringProvided by jurisdiction
OWNER_NAMEContact info for the owner according to the permitStringProvided by jurisdiction
OWNER_PHONEContact info for the owner according to the permitStringProvided by jurisdiction
OWNER_STATEContact info for the owner according to the permitStringProvided by jurisdiction
OWNER_STREETContact info for the owner according to the permitStringProvided by jurisdiction
OWNER_ZIPCODEContact info for the owner according to the permitStringProvided by jurisdiction
PERMIT_NUMBERThe jurisdiction permit number. Note, this is pass-through by the jurisdiction, so it is theoretically possible that one jurisdiction has the same permit number as another jurisdiction even if they are referencing different permits. We recommend using the Shovels ID to differentiate between unique permitsStringProvided by jurisdiction
PLUMBINGTRUE if the permit involved any type of plumbingBooleanCreated by Shovels
POOL_AND_HOT_TUBTRUE if the permit involved a pool or hot tubBooleanCreated by Shovels
PROPERTY_ASSESS_MARKET_VALUEThe market value of the propertyIntegerEnhanced by Shovels (third party)
PROPERTY_BUILDING_AREAThe total building area in square feetIntegerEnhanced by Shovels (third party)
PROPERTY_CENSUS_TRACTThe census tract numberStringEnhanced by Shovels (third party)
PROPERTY_CONGRESSIONAL_DISTRICTThe number of the congressional districtStringEnhanced by Shovels (third party)
PROPERTY_LEGAL_OWNERThe owner according to the tax assessorStringEnhanced by Shovels (third party)
PROPERTY_LOT_SIZEThe total lot size in square feetIntegerEnhanced by Shovels (third party)
PROPERTY_OWNER_TYPEThe type of entity the owner is according to the tax assessorStringEnhanced by Shovels (third party)
PROPERTY_STORY_COUNTThe number of stories on the propertyIntegerEnhanced by Shovels (third party)
PROPERTY_TYPEThe type of property according to the tax assessorStringEnhanced by Shovels (third party)
PROPERTY_TYPE_DETAILThe subtype of property according to the tax assessorStringEnhanced by Shovels (third party)
PROPERTY_UNIT_COUNTThe number of units on the propertyIntegerEnhanced by Shovels (third party)
PROPERTY_YEAR_BUILTThe year the property was constructedIntegerEnhanced by Shovels (third party)
REMODELTRUE if the permit involved a remodelBooleanCreated by Shovels
ROOFINGTRUE if the permit involved roofingBooleanCreated by Shovels
SOLARTRUE if the permit involved solarBooleanCreated by Shovels
START_DATEThe earliest date on the permitDateCreated by Shovels
STATEThe two-character state abbreviationStringEnhanced by Shovels
STATE_FIPSThe state FIPS codeStringEnhanced by Shovels
STATUSThe permit status (final, in_review, in_active, or active)StringEnhanced by Shovels
STREETThe street nameStringEnhanced by Shovels
STREET_NOThe street numberStringEnhanced by Shovels
SUBTYPEThe subtype of the permit according to the jurisdictionStringProvided by jurisdiction
TAGSList of permit categories (tags) associated with the permitArrayEnhanced by Shovels
TOTAL_DURATIONThe number of days between the start date and the end dateIntegerCreated by Shovels
TYPEThe type of the permit according to the jurisdictionStringProvided by jurisdiction
WATER_HEATERTRUE if the permit involved a water heaterBooleanCreated by Shovels
WINDOW_DOORTRUE if the permit involved windows or doorsBooleanCreated by Shovels
ZIPCODEThe five-digit ZIP codeStringEnhanced by Shovels
ZIPCODE_EXTThe four-digit ZIP code extensionStringEnhanced by Shovels