# 2s.io Secretary-of-State Business Registry Search

> 2s.io Secretary-of-State Business Registry Search is a paid API for AI agents from 2s.io, paid per call via x402, $0.00288/call, status unknown (last checked 2026-09-15).

Search NY and CO state Secretary-of-State business registries by entity name or ID, returning normalized business entity metadata across states.

## Facts

- Endpoint: GET https://2s.io/api/business/sos-search
- Price: $0.00288/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/2s-io-secretary-of-state-business-registry-search-d0a97d09
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_W-oN124dyLy6RQtW1eRlv

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability 2s-io-secretary-of-state-business-registry-search-d0a97d09
```

Example prompt: Can you search the New York Secretary of State registry for any businesses with 'Acme Holdings' in the name and tell me their registration status, entity type, formation date, and registered agent?

## When to prefer this

Use this endpoint when you need to verify or look up a business entity registered in New York, Colorado, or Connecticut using official Secretary-of-State data. Ideal for KYC workflows, vendor due diligence, counterparty verification, or any task requiring normalized, authoritative business registration data across multiple states in a single call. Prefer this over general web search when you need structured, official data fields like registered agent, formation date, and entity status.

## Known failure modes

- Missing required 'state' parameter returns a 400-level error
- Unsupported state code (not NY, CO, or CT) returns a validation error
- No matching entities found returns an empty results array
- entityId not found in the specified state returns empty results
- Rate limiting or payment failure returns 402 or 429 status
- Partial name too broad may return up to the maximum 100 results with truncation

## How this service works

Search state Secretary-of-State business registries, normalized to one schema across states. Currently supported: NY (active corporations + LLCs), CO (all entities incl. status), and CT (Business Registry Master incl. type, status, NAICS). Query by name (partial, case-insensitive) or exact entityId; results: state, entity id, name, type, status, formation jurisdiction, formation date, principal/registered address, registered agent. KYC, vendor due-diligence, and counterparty-verification staple. Each state sourced from its official open-data portal.

## Output

Returns a list of business entities matching the query, each including: state, entity ID, entity name, entity type (e.g. LLC, corporation), status (active/inactive), formation jurisdiction, formation date, principal/registered address, and registered agent — all normalized to a single schema regardless of state.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "name": "Acme Holdings",
   "limit": 10,
   "state": "NY",
   "offset": 0
  }
 }
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "queryParams"
   ],
   "properties": {
    "type": {
     "const": "http"
    },
    "method": {
     "const": "GET"
    },
    "queryParams": {
     "required": [
      "state"
     ],
     "properties": {
      "name": {
       "type": "string",
       "description": "Entity name, partial match."
      },
      "limit": {
       "type": "integer",
       "default": 10,
       "maximum": 100,
       "minimum": 1
      },
      "state": {
       "enum": [
        "NY",
        "CO",
        "CT"
       ],
       "type": "string",
       "description": "State registry to search."
      },
      "offset": {
       "type": "integer",
       "default": 0,
       "minimum": 0
      },
      "entityId": {
       "type": "string",
       "description": "Exact state entity id (NY DOS id / CO entity id)."
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/2s-io-secretary-of-state-business-registry-search-d0a97d09/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from 2s.io](https://www.zero.xyz/host/2s.io/llms.txt)