Opensosdata: Business Lookup

Find the registered officer name for a business entity using its state SOS record.

Tool ID: opensosdata_business_lookup

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(
  '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 exposes this shape at result.toolResponse.raw. Values below are representative.

{
  "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 tools get 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.

Get started

Build and automate

Common workflows

Data and integrations

Reference

Opensosdata: Business Lookup

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