Enformion: Person Search

Find a person’s personal email and phone from name and city/state, or an exact tahoeId.

Tool ID: enformion_person_search

Run this action

Use the TypeScript SDK for one call. Use ctx.tools.execute(...) inside a Play for durable calls, scheduled calls, or CSV processing.

import { Deepline } from 'deepline';

const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
  'enformion_person_search',
  {
    "first_name": "Jane",
    "last_name": "Doe",
    "city_state": "California"
  },
);

console.log(result.toolResponse.raw);

CLI

deepline tools execute enformion_person_search --input '{
  "first_name": "Jane",
  "last_name": "Doe",
  "city_state": "California"
}' --json

Example response

The SDK returns this shape at result.toolResponse.raw. The example values illustrate the response.

{
  "persons": [
    {
      "tahoeId": "tahoe_123",
      "fullName": "Example",
      "name": {
        "prefix": "example",
        "firstName": "Jane",
        "middleName": "Example",
        "lastName": "Doe",
        "suffix": "example",
        "rawNames": [
          "Example"
        ],
        "publicFirstSeenDate": "2026-01-15T12:00:00Z",
        "totalFirstSeenDate": "2026-01-15T12:00:00Z"
      },
      "age": 123,
      "emailAddresses": [
        {
          "emailAddress": "jane.doe@example.com",
          "emailOrdinal": 123,
          "isPremium": true,
          "nonBusiness": 123
        }
      ],
      "phoneNumbers": [
        {
          "phoneNumber": "+14155550123",
          "company": "Example Corp",
          "phoneType": "+14155550123",
          "isConnected": true
        }
      ],
      "addresses": [
        {
          "city": "San Francisco",
          "state": "California",
          "zip": "example",
          "fullAddress": "example"
        }
      ]
    }
  ],
  "pagination": {
    "currentPageNumber": 123,
    "resultsPerPage": 123,
    "totalPages": 123,
    "totalResults": 123
  },
  "isError": true
}

Use deepline describe enformion_person_search --json for the latest machine-readable contract.

Input reference

Enformion Person Search (galaxy-search-type: Person). Returns the individual’s PERSONAL contact info: emailAddresses[] (personal gmail/yahoo/comcast, nonBusiness:1) and phoneNumbers[] (isConnected, phoneType). Use this for personal emails — NOT enformion_workplace_search, which returns the owner’s other-employer work emails. Look up by name + city_state (optionally narrowed by a street address), or by tahoe_id for an exact identity.

Name	Type	Required	Default	Details
`payload.first_name`	`string`	No	—	Person first name. Required unless tahoe_id is provided. Do not include middle name or initial.
`payload.last_name`	`string`	No	—	Person last name. Required unless tahoe_id is provided. Middle initials and compound prefixes are stripped automatically (EnformionGO returns zero results for multi-word last names).
`payload.city_state`	`string`	No	—	City and state as “City, ST” (e.g. “Miami, FL”). Improves match precision.
`payload.address_line1`	`string`	No	—	Street address (e.g. “123 Q Street”). Used as Addresses[0].AddressLine1 alongside city_state. Narrows a name search to one resident at that address instead of a separate property lookup before this call. Minimum length: 1.
`payload.tahoe_id`	`string`	No	—	Exact-person identifier (e.g. ‘G-2492258155993150029’). When provided, looks up that specific identity directly and other fields are ignored. Use the tahoeId returned by enformion_business_search (officers/agents) to follow the vendor flow: business search → officer tahoeId → person search.

Output reference

Name	Type	Required	Default	Details
`result.persons`	`array`	Yes	—	—
`result.persons[].tahoeId`	`string`	Yes	—	—
`result.persons[].fullName`	`string`	Yes	—	—
`result.persons[].name`	`object`	Yes	—	—
`result.persons[].name.prefix`	`string`	Yes	—	—
`result.persons[].name.firstName`	`string`	Yes	—	—
`result.persons[].name.middleName`	`string`	Yes	—	—
`result.persons[].name.lastName`	`string`	Yes	—	—
`result.persons[].name.suffix`	`string`	Yes	—	—
`result.persons[].name.rawNames`	`array`	Yes	—	—
`result.persons[].name.publicFirstSeenDate`	`string`	Yes	—	—
`result.persons[].name.totalFirstSeenDate`	`string`	Yes	—	—
`result.persons[].age`	`integer`	Yes	—	—
`result.persons[].emailAddresses`	`array`	Yes	—	—
`result.persons[].emailAddresses[].emailAddress`	`string`	Yes	—	—
`result.persons[].emailAddresses[].emailOrdinal`	`integer`	Yes	—	—
`result.persons[].emailAddresses[].isPremium`	`boolean`	Yes	—	—
`result.persons[].emailAddresses[].nonBusiness`	`integer`	Yes	—	—
`result.persons[].phoneNumbers`	`array`	Yes	—	—
`result.persons[].phoneNumbers[].phoneNumber`	`string`	Yes	—	—
`result.persons[].phoneNumbers[].company`	`string`	Yes	—	—
`result.persons[].phoneNumbers[].phoneType`	`string`	Yes	—	—
`result.persons[].phoneNumbers[].isConnected`	`boolean`	Yes	—	—
`result.persons[].addresses`	`array`	Yes	—	—
`result.persons[].addresses[].city`	`string`	Yes	—	—
`result.persons[].addresses[].state`	`string`	Yes	—	—
`result.persons[].addresses[].zip`	`string`	Yes	—	—
`result.persons[].addresses[].fullAddress`	`string`	Yes	—	—
`result.pagination`	`object`	Yes	—	—
`result.pagination.currentPageNumber`	`integer`	Yes	—	—
`result.pagination.resultsPerPage`	`integer`	Yes	—	—
`result.pagination.totalPages`	`integer`	Yes	—	—
`result.pagination.totalResults`	`integer`	Yes	—	—
`result.isError`	`boolean`	Yes	—	—

Deepline cost

Pricing model: per_result (per result).
Estimated Deepline credits: 1.4 per pricing unit.

​Run this action

​CLI

​Example response

​Input reference

​Output reference

​Deepline cost

​Related documentation

Run this action

CLI

Example response

Input reference

Output reference

Deepline cost

Related documentation