# SiteCheck Shop & Social – Secretary of State Business Entity Search

> SiteCheck Shop & Social – Secretary of State Business Entity Search is a paid API for AI agents from api.shopsocial-api.workers.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-29).

Searches official Secretary of State open data for business entity records across Colorado, New York, and Oregon by name, returning entity details including ID, type, status, address, and registered agent.

## Facts

- Endpoint: GET https://api.shopsocial-api.workers.dev/api/social/sos?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/sitecheck-shop-social-secretary-of-state-business-entity-search-35894d03
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ifxmZq6_QgjxxC9uiLbjv

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 sitecheck-shop-social-secretary-of-state-business-entity-search-35894d03
```

Example prompt: Can you search the Secretary of State records in Colorado, New York, and Oregon for any businesses with 'Sunrise Solar' in the name and show me up to 20 results per state — I want to see their registration status, type, and registered agent?

## When to prefer this

Use this endpoint when you need to look up business entities by name specifically in Colorado, New York, or Oregon using official government open data. It is ideal for due diligence, name availability checks, registered agent lookups, and entity verification tasks limited to these three states. Prefer this over general web search when you need structured, authoritative government data with entity type, status, formation date, and agent details.

## Known failure modes

- Missing or too-short 'name' query parameter (under 3 characters) returns an error
- Requested state not in supported set (CO, NY, OR) is ignored or returns an error
- Upstream state data portal unavailable causes partial or empty results
- name query exceeds 80 characters
- limit value outside 1-50 range causes validation error
- No matching entities found returns empty results array with count 0

## How this service works

Pay-per-call e-commerce, product, price and social media data tools for AI agents, from public sources. Payment: x402, USDC on Base, Solana, Arc, Polygon, Arbitrum, Monad, World Chain, Optimism, Avalanche, Celo or Stellar, or RLUSD/XRP on the XRP Ledger. No signup, no API key; a failed call is not charged.

## Output

A JSON object containing the total count of results, the search query, the state portals queried, a timestamp, per-state result counts, and an array of matching business entities each with entity ID, name, type (e.g. LLC, corporation), status (e.g. Good Standing), state, jurisdiction, formation date, principal address, registered agent name and address, and an optional details URL.

## 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"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "name"
     ],
     "properties": {
      "name": {
       "type": "string",
       "description": "Business name or part of it (3-80 characters)"
      },
      "limit": {
       "type": "string",
       "description": "Max entities per state, 1 to 50 (default 10)"
      },
      "states": {
       "type": "string",
       "description": "Comma-separated subset of CO, NY, OR (default all three)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 30,
  "query": "tesla",
  "source": "https://data.colorado.gov/resource/4ykn-tg5h.json https://data.ny.gov/resource/n9v6-gdp6.json https://data.oregon.gov/resource/tckn-sxa6.json",
  "states": [
   "CO",
   "NY"
  ],
  "results": [
   {
    "id": "20261863739",
    "name": "Edintesla Solutions LLC",
    "type": "DLLC",
    "agent": "EDINSON FERNEY GARCIA SANCHEZ",
    "state": "CO",
    "status": "Good Standing",
    "address": "525 S Dawson St Unit 584, Aurora, CO, 80012, US",
    "formedOn": "2026-07-17",
    "detailsUrl": null,
    "agentAddress": "525 S Dawson St Unit 584, Aurora, CO, 80012",
    "jurisdiction": "CO"
   },
   {
    "id": "20261324447",
    "name": "Tesla Property & Casualty, Inc.",
    "type": "FPC",
    "agent": "C T CORPORATION SYSTEM",
    "state": "CO",
    "status": "Good Standing",
    "address": "45500 Fremont Blvd, Fremont, CA, 94538, US",
    "formedOn": "2026-03-18",
    "detailsUrl": null,
    "agentAddress": "7700 E Arapahoe Rd Ste 220, Centennial, CO, 80112",
    "jurisdiction": "CA"
   }
  ],
  "perState": {
   "CO": 10,
   "NY": 10,
   "OR": 10
  },
  "checkedAt": "2026-10-23T09:37:52.294Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/sitecheck-shop-social-secretary-of-state-business-entity-search-35894d03/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.shopsocial-api.workers.dev](https://www.zero.xyz/host/api.shopsocial-api.workers.dev/llms.txt)