# GovFiles Company Lookup API

> GovFiles Company Lookup 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-15).

Retrieves normalized US company registration data (officers, filings, addresses, identifiers) for a specific entity by jurisdiction and company number

## Facts

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

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-lookup-api-4856ffe6 -d '<json body>'
```

Example prompt: Can you pull the full registration record for Delaware company number 7620463 — I need the officers, filing history, and registered address from the state registry?

## When to prefer this

Use this endpoint when you already have a specific company number and jurisdiction code (e.g. from a prior search result) and need the full normalized detail record. It is ideal for due diligence pipelines, KYB (know-your-business) workflows, compliance checks, and enriching business profiles with authoritative state-registry data across all 50 US states under one unified schema.

## Known failure modes

- Invalid or unknown jurisdiction_code returns an error — must use supported codes like us_de or us_ca
- Company number not found in the specified jurisdiction returns a not-found error
- Malformed company_number string may return validation error
- Payment failure (insufficient USDC balance) blocks the request entirely
- Some jurisdictions may have incomplete or stale data for older entities

## 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

Returns a normalized JSON record for the specified company including entity name, registered addresses, officer names and roles, filing history, and official identifiers — all unified under a single schema regardless of which US state jurisdiction it comes from.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "company_number": {
   "type": "string",
   "description": "Registry-assigned entity number (from a search result)."
  },
  "jurisdiction_code": {
   "type": "string",
   "description": "Jurisdiction code, e.g. `us_de` or `us_ca`."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/govfiles-company-lookup-api-4856ffe6/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)
