Enformion: Business Search

Look up a business by name and city/state to get its officers and registered agents, each with a tahoeId to pass to enformion_person_search.

Tool ID: enformion_business_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_business_search',
  {
    "name": "Example"
  },
);

console.log(result.toolResponse.raw);

CLI

deepline tools execute enformion_business_search --input '{
  "name": "Example"
}' --json

Example response

The static output schema lacks the details for a reliable example. Use deepline describe enformion_business_search --json for the complete live contract.

Input reference

Enformion Business Search (galaxy-search-type: BusinessV2). Step 1 of the personal-email flow: returns the business plus its officers and registered agents, each with a tahoeId. Feed those tahoeIds into enformion_person_search to get each officer’s personal contact info. COST: billed per upstream call that returns records, NOT per usable match. One lookup can bill up to 3x when the locality hint falls through the region -> city -> unfiltered walk, so pass the most precise city_state you have and set max_attempts: 1 on batch runs. NOTE: Business Search is separately entitled. profiles without it get isError:true (“Access Profile does not permit client to call Business Search”) — treat as no-result and fall back to person-search-by-name.

Name	Type	Required	Default	Details
`payload.name`	`string`	Yes	—	Business / entity name (e.g. ‘Castaways River Tiki Bar’). Minimum length: 1.
`payload.city_state`	`string`	No	—	Locality hint, most precise form first: “City, Region” (“Cutchogue, NY”), a city alone (“Cutchogue”), or a region alone (“NY”). PREFER “City, Region” — it is the cheapest option, not just the most accurate. BusinessV2 filters on ONE locality token and cannot parse the combined form, so Deepline splits the hint and walks region -> city -> unfiltered, stopping at the first attempt that yields a record in the requested region. Each attempt is a separate billed upstream call, so a hint that resolves See the live schema for the complete constraint.
`payload.max_attempts`	`integer`	No	`3`	Hard ceiling on billed upstream calls for this lookup (1-3, default 3). The locality walk stops early on a hit, so this only bounds the worst case. Set 1 for high-volume batch enrichment where a miss can fall through to a cheaper step: measured on a 273-row insurance book, the unbounded walk spent ~3.4 calls per resolved officer ($1.68/name against an assumed $0.49). capping at 1 cut that stage roughly 3x for a modest recall loss. Minimum: 1. Maximum: 3.
`payload.results_per_page`	`integer`	No	`10`	Records requested per upstream page (1-50, default 10). Does NOT change the price of a call — BusinessV2 bills per call, not per record — but a smaller page returns less noise to filter when you only need the top officer match, and a larger one gives a common business name a deeper candidate pool to find your region in. Minimum: 1. Maximum: 50.
`payload.page`	`integer`	No	`1`	Page number, for paging deeper into matches on a common business name (default 1). Each page is a separate billed call. check pagination.totalPages on the response before asking for another. Minimum: 1.

Output reference

Name	Type	Required	Default	Details
`result.businessV2Records`	`array`	Yes	—	—
`result.businessV2Records[].poseidonId`	`integer`	Yes	—	—
`result.businessV2Records[].uccFilings`	`array`	Yes	—	—
`result.businessV2Records[].newBusinessFilings`	`array`	Yes	—	—
`result.businessV2Records[].usCorpFilings`	`array`	Yes	—	—
`result.businessV2Records[].usCorpFilings[].poseidonId`	`integer`	Yes	—	—
`result.businessV2Records[].usCorpFilings[].ein`	`string`	Yes	—	—
`result.businessV2Records[].usCorpFilings[].name`	`string`	Yes	—	—
`result.businessV2Records[].usCorpFilings[].rawName`	`string`	Yes	—	—
`result.businessV2Records[].usCorpFilings[].corpFileKey`	`string`	Yes	—	—
`result.businessV2Records[].usCorpFilings[].corpStatus`	`string`	Yes	—	—
`result.businessV2Records[].usCorpFilings[].corpStatusDate`	`string`	Yes	—	—
`result.businessV2Records[].usCorpFilings[].corpType`	`string`	Yes	—	—
`result.businessV2Records[].usCorpFilings[].registryNumber`	`string`	Yes	—	—
`result.businessV2Records[].usCorpFilings[].stateCode`	`string`	Yes	—	—
`result.businessV2Records[].usCorpFilings[].statute`	`string`	Yes	—	—
`result.businessV2Records[].usCorpFilings[].stateTaxId`	`string`	Yes	—	—
`result.businessV2Records[].usCorpFilings[].term`	`string`	Yes	—	—
`result.businessV2Records[].usCorpFilings[].fileData`	`null`	Yes	—	—
`result.businessV2Records[].usCorpFilings[].fileDataDate`	`string`	Yes	—	—
`result.businessV2Records[].usCorpFilings[].filingDate`	`string`	Yes	—	—
`result.businessV2Records[].usCorpFilings[].incorporationState`	`string`	Yes	—	—
`result.businessV2Records[].usCorpFilings[].filingType`	`string`	Yes	—	—
`result.businessV2Records[].usCorpFilings[].jurisdiction`	`string`	Yes	—	—
`result.businessV2Records[].usCorpFilings[].lastReportedDate`	`string`	Yes	—	—
`result.businessV2Records[].usCorpFilings[].expireDate`	`string`	Yes	—	—
`result.businessV2Records[].usCorpFilings[].contacts`	`array`	Yes	—	—
`result.businessV2Records[].usCorpFilings[].officers`	`array`	Yes	—	—
`result.businessV2Records[].usCorpFilings[].officers[].fileDate`	`null`	Yes	—	—
`result.businessV2Records[].usCorpFilings[].officers[].name`	`object`	Yes	—	—
`result.businessV2Records[].usCorpFilings[].officers[].name.nameSuffix`	`string`	Yes	—	—
`result.businessV2Records[].usCorpFilings[].officers[].name.nameHashReq1`	`string`	Yes	—	—
`result.businessV2Records[].usCorpFilings[].officers[].name.nameFirst`	`string`	Yes	—	—
`result.businessV2Records[].usCorpFilings[].officers[].name.nameGender`	`string`	Yes	—	—
`result.businessV2Records[].usCorpFilings[].officers[].name.nameLast`	`string`	Yes	—	—
`result.businessV2Records[].usCorpFilings[].officers[].name.nameMiddle`	`string`	Yes	—	—
`result.businessV2Records[].usCorpFilings[].officers[].name.nameRaw`	`string`	Yes	—	—
`result.businessV2Records[].usCorpFilings[].officers[].name.nameProblemCodes`	`string`	Yes	—	—
`result.businessV2Records[].usCorpFilings[].officers[].name.nameHashOpt5`	`integer`	Yes	—	—
`result.businessV2Records[].usCorpFilings[].officers[].name.namePrefix`	`string`	Yes	—	—
`result.businessV2Records[].usCorpFilings[].officers[].name.nameHashOpt4`	`integer`	Yes	—	—
`result.businessV2Records[].usCorpFilings[].officers[].name.nameSuffixNorm`	`string`	Yes	—	—
`result.businessV2Records[].usCorpFilings[].officers[].name.tahoeId`	`null`	Yes	—	—
`result.businessV2Records[].usCorpFilings[].officers[].title`	`string`	Yes	—	—
`result.businessV2Records[].usCorpFilings[].officers[].startDate`	`string`	Yes	—	—
`result.businessV2Records[].usCorpFilings[].officers[].status`	`null`	Yes	—	—
`result.businessV2Records[].usCorpFilings[].officers[].address`	`object`	Yes	—	—
`result.businessV2Records[].usCorpFilings[].officers[].address.city`	`string`	Yes	—	—
`result.businessV2Records[].usCorpFilings[].officers[].address.state`	`string`	Yes	—	—
`result.businessV2Records[].usCorpFilings[].officers[].address.zip`	`string`	Yes	—	—

The table shows the first 50 fields. Expand the raw schema below for every field.

This output schema is too large for an inline display. Read the complete live contract with deepline describe enformion_business_search --json.

Deepline cost

Pricing model: per_result (per result).
Estimated Deepline credits: 2.8 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