https://api.windfalldata.com/v1/
Enrich a Person Record
Submit a person record with PII fields and receive Windfall's enriched household and career data in real time.
Request Body
id
string
Unique identifier from your system of record. Echoed back in the response.
first_name
string
First name of the individual.
last_name
string
Last name. If you only have a full name, enter it here and leave first_name empty.
addresses
object[]
A list of addresses associated with the individual.
address
string
Street address. Multiple lines should be concatenated with a space. Can be a full address if components aren't available.
city
string
City or locality recognized by the USPS.
state
string
State abbreviation or full name. May be inferred from zip code.
zipcode
string
US zip code (5+ digits, optional +4). For best results, always provide a zip code.
emails
string[]
List of email addresses.
phones
string[]
List of phone numbers. Formatting is flexible. +1 (US) assumed when no country code is provided.
company_name
string
Company name associated with the individual. Improves career matching accuracy when multiple people share the same name.
Response
id
string
The ID you submitted, echoed back.
household_matched
boolean
Whether a household match was found.
career_matched
boolean
Whether a career match was found.
household
object | null
Enriched household-level data. Null when household_matched is false. Includes net worth, property ownership, philanthropy, political giving, and more.
career
object | null
Career and employment data for the individual. Null when career_matched is false. Includes job title, employer details, LinkedIn URL, and more.
Example Request
# Enrich a person record curl -X POST https://api.windfalldata.com/v1/ \ -H "Content-Type: application/json" \ -H "X-WF-Auth-Token: YOUR_API_TOKEN" \ -d '{ "id": "16a903p", "first_name": "Jane", "last_name": "Doe", "addresses": [ { "address": "123 Main St, Apt A", "city": "San Francisco", "state": "CA", "zipcode": "94133" } ], "emails": ["jdoe@windfall.com"], "phones": ["415-555-1212"], "company_name": "Acme Inc" }'import requests response = requests.post( "https://api.windfalldata.com/v1/", headers={ "Content-Type": "application/json", "X-WF-Auth-Token": "YOUR_API_TOKEN", }, json={ "id": "16a903p", "first_name": "Jane", "last_name": "Doe", "addresses": [{ "address": "123 Main St, Apt A", "city": "San Francisco", "state": "CA", "zipcode": "94133", }], "emails": ["jdoe@windfall.com"], "phones": ["415-555-1212"], "company_name": "Acme Inc", }, ) print(response.json())const response = await fetch( "https://api.windfalldata.com/v1/", { method: "POST", headers: { "Content-Type": "application/json", "X-WF-Auth-Token": "YOUR_API_TOKEN", }, body: JSON.stringify({ id: "16a903p", first_name: "Jane", last_name: "Doe", addresses: [{ address: "123 Main St, Apt A", city: "San Francisco", state: "CA", zipcode: "94133", }], emails: ["jdoe@windfall.com"], phones: ["415-555-1212"], company_name: "Acme Inc", }), } ); const data = await response.json(); console.log(data);
Example Response
200 OK{
"id": "16a903p",
"household": {
"confidence": 1.0,
"windfall_id": "bde3d183ad...",
"net_worth": 4200000,
"low_confidence_net_worth": 3500000,
"high_confidence_net_worth": 5000000,
"multi_property_owner": true,
"philanthropic_giver": true,
"political_donor": false,
"small_business_owner": false,
"boat_owner": false,
"plane_owner": false,
...
},
"career": {
"confidence": 0.7,
"linkedin_url": "linkedin.com/in/...",
"job_title": "VP of Marketing",
"job_level": "VP",
"company_name": "Acme Inc",
"company_category": "Public Company",
"recently_changed_jobs": false,
...
},
"household_matched": true,
"career_matched": true
}