# GovFiles Company Search API

> GovFiles Company Search API is a paid API for AI agents from www.stable-govfiles.dev, paid per call via x402, $0.4/call, status unknown (last checked 2026-09-13).

Search and retrieve normalized US company registration data across all 50 states, including officers, filings, addresses, and identifiers.

## Facts

- Endpoint: POST https://www.stable-govfiles.dev/api/govfiles/companies/search
- Price: $0.4/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/govfiles-company-search-api-b7ade8ea
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_8UdTtjYxnF2g7azyret28

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 govfiles-company-search-api-b7ade8ea -d '<json body>'
```

Example prompt: Search GovFiles for active companies named 'Sunrise Holdings' registered in Delaware or California, including any DBAs or trade names they might go by.

## When to prefer this

Choose this endpoint when you need normalized, unified US company registration data spanning all 50 states from a single API call. It is ideal for compliance checks, due diligence, officer lookups, and business verification workflows where you need consistent schema output regardless of jurisdiction. Prefer this over scraping individual state registries or using less comprehensive datasets.

## Known failure modes

- Missing required 'q' parameter returns a 400 validation error
- Invalid jurisdiction code returns an error or empty results
- Query too broad returns maximum 100 results requiring pagination
- Payment not completed (x402 protocol) returns 402 Payment Required
- No matching entities found returns an empty result set
- Malformed query syntax may return unexpected or empty results

## How this service works

Pay-per-request access to normalized US company-registration data across all 50 states. 75M+ entities — officers, filings, addresses, and identifiers under one unified schema.

## Output

A paginated list of up to 100 normalized company records matching the query, each containing entity identifiers, registered addresses, officer information, filing details, and registry status — all unified under a single schema across all 50 US state jurisdictions.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "q": {
   "type": "string",
   "description": "Search query. Supports Google-style syntax: AND/OR, parentheses, quoted phrases, and prefix wildcards."
  },
  "page": {
   "type": "integer",
   "default": 1,
   "maximum": 9007199254740991,
   "minimum": 1,
   "description": "1-based page number."
  },
  "limit": {
   "type": "integer",
   "default": 100,
   "maximum": 100,
   "minimum": 1,
   "description": "Results per page, 1 to 100."
  },
  "status": {
   "enum": [
    "active",
    "inactive",
    "unknown",
    "any"
   ],
   "type": "string",
   "default": "any",
   "description": "Filter by registry status."
  },
  "jurisdictions": {
   "type": "string",
   "default": "all",
   "description": "Either 'all' or a comma-separated list of jurisdiction codes (e.g. 'us_de,us_ca')."
  },
  "match_previous_names": {
   "type": "boolean",
   "default": false,
   "description": "Also match against historical legal names."
  },
  "match_alternative_names": {
   "type": "boolean",
   "default": false,
   "description": "Also match against DBAs, trade names, and other alternative names."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/govfiles-company-search-api-b7ade8ea/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from www.stable-govfiles.dev](https://www.zero.xyz/host/www.stable-govfiles.dev/llms.txt)