# Records for Agents: Contractor & Trade License Lookup by License Number

> Records for Agents: Contractor & Trade License Lookup by License Number is a paid API for AI agents from licenses.recordsforagents.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Look up a US contractor or trade license record by its native license number, returning full provenance, freshness metadata, and available status information.

## Facts

- Endpoint: GET https://licenses.recordsforagents.com/by-number/:license_number
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/records-for-agents-contractor-trade-license-lookup-by-license-number-078468fc
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_CGt_IoGbnSM8QQKTBiGAf

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 records-for-agents-contractor-trade-license-lookup-by-license-number-078468fc
```

Example prompt: Can you look up Texas TDLR electrician license number ELEC-12345 and tell me if it's current, who it belongs to, and when it expires?

## When to prefer this

Use this endpoint when you have a specific license number and need the full record for that license quickly. It is the most direct and precise lookup path — faster and more deterministic than a name-based or free-text search. Prefer this over the search endpoint when the license number is already known. Also prefer this when you need provenance metadata (source URL, record hash, fetched-at) for auditability or compliance workflows.

## Known failure modes

- License number not found in any covered roster — returns empty or 404
- License number format does not match any known state pattern — may return no results
- TDLR bulk files lack a status column — only expiration date is available as a status proxy
- Oregon CCB records have no status column — expiration date is the only proxy
- DBPR file excludes null-and-void, delinquent, and involuntarily-inactive licenses upstream — those records will not appear
- Stale data if the upstream bulk file has not been refreshed recently — check as_of field
- Ambiguous license number shared across states — scope to a state to disambiguate

## How this service works

US contractor and trade license verification for AI agents: Texas TDLR electrician and A/C contractor/technician rosters, Florida DBPR construction licenses, Oregon CCB construction contractor licenses, Connecticut eLicense professional/occupational credentials, and TDLR disciplinary/administrative orders. Search by name, license number, state, or profession; verify a business or person against the roster with fuzzy name matching; look up board discipline history. Coverage is honest, not exhaustive: TDLR bulk files carry no license-status column (expiration date is the only status proxy we have, reported as such), DBPR's file excludes null-and-void/ delinquent/involuntarily-inactive licenses upstream, and Oregon CCB likewise has no status column (see docs/licensing.md); Connecticut eLicense DOES carry real status/active columns, reported verbatim. Every record carries full provenance (source, source URL, fetched-at, record hash) and every response includes as_of freshness — built for agent-driven verification and compliance workflows.

## Output

Returns a license record object including the licensee's name, license type, profession, issuing state, expiration date (used as status proxy for TDLR and Oregon CCB), active/status columns where available (Connecticut eLicense), source agency, source URL, the timestamp when the record was last fetched, and a record hash for provenance. Also includes an as_of freshness field indicating data currency.

## Request schema (JSON Schema)

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

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/records-for-agents-contractor-trade-license-lookup-by-license-number-078468fc/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from licenses.recordsforagents.com](https://www.zero.xyz/host/licenses.recordsforagents.com/llms.txt)