Filters
The dashboard offers visible positive selections, such as contacts with an email or phone. Leaving one unselected does not apply that filter. Direct API requests can send true or false for Boolean filters.
| Filter | Meaning |
|---|---|
state | Required two-letter state code. |
zip5 / zip | One five-digit ZIP or a comma-separated list of up to 100 ZIPs. |
renewal_month | One month or a comma-separated list of months from 1 through 12. |
homeowner | Whether contacts are marked as homeowners. |
has_email | Whether contacts have an email address. |
has_phone | Whether contacts have at least one phone number of any kind (landline, cell phone, or other). |
has_cell | Whether contacts have a cell phone number. |
reachable | Whether contacts have an email address or phone number. |
age_min | Minimum age, inclusive. |
age_max | Maximum age, inclusive. |
For example, direct API requests can use has_phone=true for contacts with a phone number or has_phone=false for contacts without one.
Use has_cell=true when you specifically need a cell phone number; has_phone=true also accepts people whose only number is a landline. The two can be combined, in which case both must hold.
When both age bounds are present, a contact at either boundary is included. age_min cannot be greater than age_max.
curl -H "X-API-Key: $MAVERICK_DATA_API_KEY" \
"https://api.themaverickdata.com/api/v1/contacts/count?state=TX&zip5=78701,78702&renewal_month=8&has_phone=true&age_min=35&age_max=65"