How do I get resident or homeowner email contact information from Shovels?

Email contact information can be a bit nuanced, because there are several sources where the contact information will come from, so you'll have to take a look across all of them to see what you can find:

• APPLICANT_EMAIL from PERMITS table:  If there's an email of the applicant, we will include it here. Sometimes it's the homeowner email, sometimes it's a builder or their contractor (depends on who is applying) - this is EDL only, not in the API
• OWNER_EMAIL from the PERMITS table: same, this comes from the permit; if it's there, we will include it if someone filled it out (note: if filled, this is the owner email at time of permit submission, so it could have changed depending on how old the permit is) - this is EDL only, not in the API
• PERSONAL_EMAILS and BUSINESS_EMAIL from the RESIDENTS table. You'll also have to filter for HOMEOWNER = Y on these. If we have data on the residents (aka homeowners') emails, we''ll include in these fields. - this is both EDL and API

For API users, to get the contact info from the RESIDENTS table/endpoint, you need to pass the address_id from the permit object into the residents endpoint. This endpoint will give contact info like name, phone, and email on occupants associated with the address.