# New Business Registrations API (companyfacts.dev)

> New Business Registrations API (companyfacts.dev) is a paid API for AI agents from companyfacts.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-31).

Returns newly registered business entities filed with state Secretary of State offices within a specified date window, filterable by state and entity number.

## Facts

- Endpoint: GET https://companyfacts.dev/x402/v1/new-businesses?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-31
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/new-business-registrations-api-companyfacts-dev-5c2a7d81
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_0001r8gH6bp40YO6nFdkz

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 new-business-registrations-api-companyfacts-dev-5c2a7d81
```

Example prompt: Show me all new businesses registered in Colorado and Wyoming between October 1 and October 15, 2026 — up to 50 results.

## When to prefer this

Choose this endpoint when you need freshly filed business registration data sourced directly from state government records, with clean structured output including formation dates, entity types, and official state URLs. Prefer it over generic business databases when you need recency (new filings by date window), multi-state filtering, or authoritative public-domain sourcing. Best for lead generation targeting newly formed companies, market monitoring, or any workflow requiring verified government entity data.

## Known failure modes

- Invalid or unsupported state code returns empty results or error
- Date range too broad may trigger limit enforcement or truncated results
- Entity number not found returns empty results set
- Missing required 'type' or 'method' fields in input object causes validation error
- Payment failure (x402) if USDC balance insufficient — request rejected before data is returned
- States with no new filings in the window return count 0 and empty results array

## How this service works

Open job postings read first-hand from the applicant-tracking system behind a company's careers page: Greenhouse, Ashby, Lever or Workable. Includes a directory of 8532 company job boards, because none of the vendors publishes one. Salaries are parsed into numbers where the employer publishes them and refused where ambiguous. No personal data.

## Output

A JSON object containing a count of matching results, a list of newly registered business entities (each with legal name, entity type, formation date, status, principal address, state record URL, verification URL, and website if found), a breakdown by state, attribution to source datasets, and pagination signals (more_available flag).

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [],
     "properties": {
      "name": {
       "type": "string"
      },
      "limit": {
       "type": "string"
      },
      "since": {
       "type": "string"
      },
      "until": {
       "type": "string"
      },
      "states": {
       "type": "string"
      },
      "entity_numbers": {
       "type": "string"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "mode": "new",
  "count": 1,
  "notes": [],
  "states": [
   "CO"
  ],
  "window": {
   "since": "2026-10-16",
   "until": "2026-10-18"
  },
  "missing": [],
  "results": [
   {
    "state": "CO",
    "status": "Good Standing",
    "website": null,
    "legal_name": "Backyard Bakery & BBQ LLC",
    "verify_url": "https://data.colorado.gov/resource/4ykn-tg5h.json?entityid=20268272035",
    "entity_type": "Limited Liability Company",
    "address_type": "principal_office",
    "retrieved_at": "2026-10-18T12:00:00Z",
    "status_group": "active",
    "entity_number": "20268272035",
    "principal_zip": "80550",
    "status_detail": null,
    "formation_date": "2026-10-16",
    "principal_city": "Severance",
    "source_dataset": "data.colorado.gov 4ykn-tg5h (Business Entities in Colorado)",
    "source_license": "Public Domain (declared on the dataset by the publisher, Colorado Department of State)",
    "website_status": "no website found",
    "principal_state": "CO",
    "website_checked": "2026-10-31",
    "entity_type_code": "DLLC",
    "state_record_url": "https://www.sos.state.co.us/biz/BusinessEntityDetail.do?quitButtonDestination=BusinessEntityResults&fileId=20268272035",
    "state_search_url": "https://www.sos.state.co.us/biz/BusinessEntityCriteria.do",
    "website_evidence": null,
    "website_source_url": null,
    "registered_agent_company": null,
    "jurisdiction_of_formation": "CO"
   }
  ],
  "by_state": {
   "CO": {
    "returned": 1,
    "newest_formation_date": "2026-10-16"
   }
  },
  "attribution": [
   "Colorado Department of State (CDOS), via data.colorado.gov"
  ],
  "retrieved_at": "2026-10-18T12:00:00Z",
  "more_available": false
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/new-business-registrations-api-companyfacts-dev-5c2a7d81/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from companyfacts.dev](https://www.zero.xyz/host/companyfacts.dev/llms.txt)