Filter by Age Range
Narrow person search results using minimum and maximum age filters
Use the min_age and max_age parameters to filter person search results by age range. This is useful when you need to find individuals within a specific age bracket.
Basic Usage
Add min_age and/or max_age to your request to filter results:
curl 'https://api.whitepages.com/v2/person?name=John%20Smith&min_age=25&max_age=45' \
--header 'X-Api-Key: YOUR_API_KEY'This returns only records for individuals between 25 and 45 years old.
Parameters
| Parameter | Type | Description |
|---|---|---|
min_age | integer | Minimum age (inclusive). Must be 18-65 |
max_age | integer | Maximum age (inclusive). Must be 18-65 |
Age Range Limits
Age filters are restricted to individuals between 18 and 65 years old. Values outside this range will return an error.
Examples
Filter by Minimum Age
Filter for individuals 21 years or older:
curl 'https://api.whitepages.com/v2/person?name=Jane%20Doe&city=Chicago&state_code=IL&min_age=21' \
--header 'X-Api-Key: YOUR_API_KEY'Filter by Maximum Age
Filter for individuals 40 or younger:
curl 'https://api.whitepages.com/v2/person?last_name=Johnson&state_code=FL&max_age=40' \
--header 'X-Api-Key: YOUR_API_KEY'Filter by Age Range
Filter for individuals between 25 and 55:
curl 'https://api.whitepages.com/v2/person?name=Michael%20Williams&zipcode=90210&min_age=25&max_age=55' \
--header 'X-Api-Key: YOUR_API_KEY'Combining with Other Filters
Age filters work alongside all other person search parameters:
curl 'https://api.whitepages.com/v2/person?first_name=Sarah&last_name=Miller&city=Seattle&state_code=WA&min_age=30&max_age=50' \
--header 'X-Api-Key: YOUR_API_KEY'Records Without Known DOB
Records for which no date of birth is on file are included in results when
min_age or max_age is set. The filter only excludes records whose known
DOB falls outside the requested range — so a strong name-and-address match
returns even when the person's age is unknown. The age field on such a
record is null.
Response
The response format remains the same as a standard person search. Age filters only affect which records are returned, not the structure of the response.
[
{
"id": "P1234567890",
"name": "John Smith",
"aliases": ["Johnny Smith"],
"is_dead": false,
"age": 33,
"date_of_birth": "1992-07-22",
"linkedin_url": "https://linkedin.com/in/jsmith",
"company_name": "Tech Solutions Inc",
"job_title": "Product Manager",
"match_score": 87,
"matched_by": ["first_name", "last_name"],
"phones": [{ "number": "(312) 555-0123", "type": "mobile", "score": 88 }],
"current_addresses": [
{ "id": "A9876543210", "address": "456 Oak Ave, Chicago, IL 60601" }
],
"historic_addresses": [
{ "id": "A1234567890", "address": "789 Pine St, Chicago, IL 60602" }
],
"owned_properties": [],
"emails": [{ "email": "jsmith@example.com", "score": 88 }],
"relatives": [{ "id": "P0987654321", "name": "Mary Smith" }],
"result_metadata": {
"details_url": "/v2/person/P1234567890",
"phones": { "displayed": 1, "additional": 0 },
"emails": { "displayed": 1, "additional": 0 },
"historic_addresses": { "displayed": 1, "additional": 0 },
"owned_properties": { "displayed": 0, "additional": 0 }
}
}
]Age vs. min_age/max_age
The age field on each result is derived from date_of_birth and reflects
the person's current age. The min_age / max_age request parameters filter
the search index by the same computed age. When only a birth year is on file,
age is a year-based approximation.
Related
Person Search
Look up individuals by name, phone, or address
Search for Person by Partial Name
Search for people using partial or incomplete name information
Search for a person by name, phone number, and address
Retrieve person information with match scores and enriched emails. Raises ------ StrictMatchWithFuzzyMatchingError If ``strict_match`` and ``include_fuzzy_matching`` are both set to true — the two flags are semantically contradictory.