Enformion: Business Search

Step 1 of the personal-email flow: look up a business by name (+ city/state) to get its officers and registered agents, each with a tahoeId.

Tool ID: enformion_business_search

Run this action

Use the TypeScript SDK for a single call. Put ctx.tools.execute(...) inside a Play when the call should be durable, scheduled, or run across a CSV.

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 is not detailed enough to generate a reliable example. Use deepline tools get 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 to embed without slowing the page. Get the complete live contract with deepline tools get enformion_business_search --json.

Deepline cost

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

Get started

Build and automate

Common workflows

Data and integrations

Reference

Enformion: Business Search

Run this action

CLI

Example response

Input reference

Output reference

Deepline cost

​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