latestOpenAPI 3.1.02026-08-10149.3 KB

3e69798fe200

Enrich a person record

Submit a person record with PII fields and receive Windfall's enriched household and career data in real time.

post/

Request body

idstring nullable

Unique identifier from your system of record. Echoed back in the response for correlation.

first_namestring nullable

First name of the individual.

last_namestring nullable

Last name of the individual. If you only have a full name, enter it here and leave first_name empty.

emailsstring[]

A list of email addresses associated with the individual.

phonesstring[]

A list of phone numbers. When a country code is not provided, +1 (United States) is assumed. Formatting is flexible.

company_namestring nullable

A company name associated with the individual. Used to improve career matching accuracy when multiple people share the same name.

Response

Enrichment results returned successfully.

idstring nullable

The ID you submitted, echoed back.

householdobject nullable

Enriched household data including Windfall ID, net worth, and confidence score. Only present when a household match is found. Fields vary by account configuration.

careerobject nullable

Career data including LinkedIn URL and confidence score. Only present when a career match is found. Fields vary by account configuration.

household_matchedboolean required

Whether household attributes were returned.

career_matchedboolean required

Whether career attributes were returned.