Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.shovels.ai/llms.txt

Use this file to discover all available pages before exploring further.

Resident and homeowner email contact information is available through multiple fields in EDL data.

Where to Find Contact Information

PERMITS Table

FieldDescription
APPLICANT_EMAILEmail of the permit applicant (may be homeowner, builder, or contractor depending on who applied)
OWNER_EMAILProperty owner email at time of permit submission
Note: Owner email reflects ownership at the time of permit submission, which may have changed if the permit is old.

RESIDENTS Table

FieldDescription
PERSONAL_EMAILSPersonal email addresses for residents
BUSINESS_EMAILBusiness email addresses
HOMEOWNERFilter for HOMEOWNER = Y to get homeowner contacts

Identifying Homeowners

To get homeowner-specific contact information:
SELECT personal_emails, business_email, name, phone
FROM residents
WHERE homeowner = 'Y'

API Access

For API users, access resident contact info by:
  1. Get the address_id from a permit object
  2. Pass it to the residents endpoint
GET /v2/addresses/{address_id}/residents
This returns contact info including name, phone, and email for occupants associated with the address.

EDL vs API Differences

Data PointEDLAPI
Applicant emailYesNo
Owner emailYesNo
Personal emailsYesYes
Business emailYesYes