{"uid":"cap_W-oN124dyLy6RQtW1eRlv","slug":"2s-io-secretary-of-state-business-registry-search-d0a97d09","name":"2s.io Secretary-of-State Business Registry Search","description":"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.","url":"https://2s.io/api/business/sos-search","method":"GET","headers":{},"bodySchema":{"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)."}}}}}}},"responseSchema":null,"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"name":"Acme Holdings","limit":10,"state":"NY","offset":0}}},"response":{"data":{"count":2,"state":"NY","source":{"url":"https://data.ny.gov/","provider":"New York Department of State (data.ny.gov)"},"entities":[{"name":"ACME HOLDINGS GROUP INCORPORATED","type":"DOMESTIC BUSINESS CORPORATION","agent":"REGISTERED AGENTS INC.","state":"NY","status":"Active","address":{"zip":"12207","city":"Albany","state":"NY","street":"418 Broadway STE R"},"entityId":"5831925","formedDate":"2020-09-10T00:00:00.000","jurisdiction":"New York"},{"name":"ACME HOLDINGS OF N.Y., INC.","type":"DOMESTIC BUSINESS CORPORATION","agent":"MICHAEL TOMASZEWSKI","state":"NY","status":"Active","address":{"zip":"14020","city":"BATAVIA","state":"NY","street":"4120 WEST MAIN STREET ROAD"},"entityId":"3375491","formedDate":"2006-06-13T00:00:00.000","jurisdiction":"New York"}]},"meta":{"cost":{"usd":0.00288,"tier":0},"caller":"x402","version":null,"endpoint":"business.sos-search","settlement":{"txHash":"0x0a696ecddd7db14cac4377120cd32a3cd256468e494d1c9d9648eb6612d820cd","network":"eip155:8453","success":true}}}},"exampleRequest":{"name":"Acme Holdings","limit":10,"state":"NY","offset":0},"tags":["x402"],"displayCostAmount":"0.00288","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.00288/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0072","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0072","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_aGskOyNNusptz_IYYBRIO","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0072","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search NY and CO state Secretary-of-State business registries by entity name or ID, returning normalized business entity metadata across states.","exampleAgentPrompt":"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?","exampleUseCases":null,"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T01:03:47.287Z","isFirstParty":false}