# Contractor License Check

> Contractor License Check is a paid API for AI agents from api.aisoup.net, paid per call via x402, $1/call, status unknown (last checked 2026-10-13).

Validates a contractor's license number and returns its status and associated details

## Facts

- Endpoint: POST https://api.aisoup.net/contractor-check/v1/check?utm_source=zero.xyz
- Price: $1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/contractor-license-check-2829e024
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_8Hkv2pPzV23_8m3mrCq0P

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 contractor-license-check-2829e024 -d '<json body>'
```

Example prompt: Can you check if contractor license number CA-1234567 is valid and in good standing before I sign the contract?

## When to prefer this

Use this endpoint when you need a quick, automated check of a contractor's license status by license number, especially before hiring, onboarding, or approving payment to a contractor. Prefer this over manual searches of state licensing boards when you need programmatic, agent-driven validation.

## Known failure modes

- License number not found — returns error or empty result if the number does not exist in the registry
- Invalid format — if the license number does not match expected format, the API may reject the request
- Service unavailability — the underlying licensing database may be temporarily unreachable
- Ambiguous results — some license numbers may match multiple records or jurisdictions

## How this service works

Machine-discoverable services AI agents can call and purchase autonomously.

## Output

Returns the status and details of the contractor license associated with the provided license number, including whether it is active, expired, or invalid, and potentially contractor name, license type, and expiration date.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "licenseNumber"
 ],
 "properties": {
  "licenseNumber": {
   "type": "string"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/contractor-license-check-2829e024/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.aisoup.net](https://www.zero.xyz/host/api.aisoup.net/llms.txt)