Opensosdata: Business Lookup

Find the registered officer name for a business from its state Secretary of State record.

Tool ID: opensosdata_business_lookup

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(
  'opensosdata_business_lookup',
  {
    "entity_name": "Example",
    "state": "AL"
  },
);

console.log(result.toolResponse.raw);

CLI

deepline tools execute opensosdata_business_lookup --input '{
  "entity_name": "Example",
  "state": "AL"
}' --json

Example response

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

{
  "success": true,
  "data": {
    "entityName": "Example",
    "entityType": "example",
    "entityId": "entity_123",
    "status": "example",
    "formationDate": "2026-01-15T12:00:00Z",
    "registeredAgentName": "Example",
    "registeredAgentAddress": "example",
    "registeredAgentCity": "San Francisco",
    "registeredAgentState": "California",
    "registeredAgentZip": "example",
    "officers": [
      {}
    ],
    "sosUrl": "https://example.com",
    "scrapedAt": "2026-01-15T12:00:00Z"
  },
  "state_scraper_version": "example"
}

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

Input reference

Look up a registered business entity and its officers/registered agent via OpenSOSData. Covers the currently active OpenSOSData jurisdictions. CA, MA, NV, OR, WA require async polling (handled automatically). FL officer names are returned as ‘LASTNAME, FIRSTNAME’. Use reverseOfficerName() to fix. OH/CA/MI/WA find the entity but return empty officers[].

Name	Type	Required	Default	Details
`payload.entity_name`	`string`	Yes	—	Business or restaurant name to look up (e.g. ‘Noble Beast Brewing’). Fuzzy matching is applied by OpenSOSData. Minimum length: 2. Maximum length: 200.
`payload.state`	`"AL" \| "AK" \| "AZ" \| "AR" \| "CA" \| "CO" \| "CT" \| "DE" \| "FL" \| "GA" \| "HI" \| "ID" \| "IL" \| "IN" \| "IA" \| "KS" \| "KY" \| "LA" \| "ME" \| "MD" \| "MA" \| "MI" \| "MN" \| "MS" \| "MO" \| "MT" \| "NE" \| "NV" \| "NH" \| "NJ" \| "NM" \| "NY" \| "NC" \| "ND" \| "OH" \| "OK" \| "OR" \| "PA" \| "RI" \| "SC" \| "SD" \| "TN" \| "TX" \| "UT" \| "VT" \| "VA" \| "WA" \| "WV" \| "WI" \| "WY" \| "DC" \| "PR"`	Yes	—	Two-letter US state code (e.g. ‘OH’, ‘FL’). All currently active OpenSOSData jurisdictions are supported. Note: OH, CA, MI, WA do NOT expose officer names in their SOS records. The entity is found but officers[] will be empty for these states. Allowed: `AL`, `AK`, `AZ`, `AR`, `CA`, `CO`, `CT`, `DE`, `FL`, `GA`, `HI`, `ID`, `IL`, `IN`, `IA`, `KS`, `KY`, `LA`, `ME`, `MD`, `MA`, `MI`, `MN`, `MS`, `MO`, `MT`, `NE`, `NV`, `NH`, `NJ`, `NM`, `NY`, `NC`, `ND`, `OH`, `OK`, `OR`, `PA`, `RI`, `SC`, `SD`, See the live schema for the complete constraint.

Output reference

Name	Type	Required	Default	Details
`result.success`	`boolean`	Yes	—	—
`result.data`	`object`	Yes	—	—
`result.data.entityName`	`string`	Yes	—	—
`result.data.entityType`	`string`	Yes	—	—
`result.data.entityId`	`string`	Yes	—	—
`result.data.status`	`string`	Yes	—	—
`result.data.formationDate`	`string`	Yes	—	—
`result.data.registeredAgentName`	`string`	Yes	—	—
`result.data.registeredAgentAddress`	`string`	Yes	—	—
`result.data.registeredAgentCity`	`string`	Yes	—	—
`result.data.registeredAgentState`	`string`	Yes	—	—
`result.data.registeredAgentZip`	`string`	Yes	—	—
`result.data.officers`	`array`	Yes	—	—
`result.data.sosUrl`	`string`	Yes	—	—
`result.data.scrapedAt`	`string`	Yes	—	—
`result.state_scraper_version`	`string`	Yes	—	—

Deepline cost

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