# New Business Registrations API

> New Business Registrations API is a paid API for AI agents from ats-jobs-api.groundtruthtools.workers.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-11-01).

Returns newly registered business entities from state Secretary of State records, filterable by state, date range, and entity number.

## Facts

- Endpoint: GET https://ats-jobs-api.groundtruthtools.workers.dev/x402/v1/new-businesses?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-01
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/new-business-registrations-api-8b29e8e8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_9zt4g2aklc_G3tSz126v-

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-8b29e8e8
```

Example prompt: Pull all new businesses registered in Colorado between October 16 and October 18, 2026 — I want the legal names, entity types, formation dates, and addresses.

## When to prefer this

Choose this endpoint when you need authoritative, primary-source business registration data pulled directly from state Secretary of State systems — not aggregated or stale third-party databases. Ideal for lead generation, market monitoring, compliance research, or verifying new entity filings by date range or state. Best when you need structured, machine-readable entity data including formation dates and status across multiple US states.

## Known failure modes

- Invalid state code returns empty results or error
- Date range too broad may return large payloads or be truncated
- Entity number not found returns empty results array
- Unsupported state (not yet in directory) returns no results
- Missing required query parameters returns validation error
- Payment failure (x402) blocks the request before processing

## 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 list of newly registered business entities matching the query, including legal name, entity type, formation date, principal address, entity number, status, source dataset attribution, state record URL, and pagination metadata indicating if more results are available.

## 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",
    "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)",
    "principal_state": "CO",
    "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",
    "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-8b29e8e8/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from ats-jobs-api.groundtruthtools.workers.dev](https://www.zero.xyz/host/ats-jobs-api.groundtruthtools.workers.dev/llms.txt)