# License Record Lookup by Number

> License Record Lookup by 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-13).

Retrieve license record(s) from state contractor/trade license databases by providing a specific license number, with optional state scoping.

## Facts

- Endpoint: GET https://licenses.recordsforagents.com/licenses/by-number/:license_number
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/license-record-lookup-by-number-ed443a4e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_takvvPwrjcGi-PQEZV2Io

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 license-record-lookup-by-number-ed443a4e
```

Example prompt: Can you pull up the license record for contractor license number M-45821 in Texas so I can verify their credentials?

## When to prefer this

Use this endpoint when you have a specific license number and need to retrieve the associated license record(s). Prefer this over the free-text search endpoint when the exact license number is known, as it returns precise matches rather than fuzzy search results. Use the optional state parameter when you know the issuing state to narrow results.

## Known failure modes

- License number not found — returns empty result set or 404
- Invalid state code supplied — validation error
- License number format mismatch for the given state — no results
- Service unavailable or payment failure — 402 or 5xx error
- Ambiguous license number matching multiple records across states without state scoping

## How this service works

Look up license record(s) by native license number, optionally scoped to a state.

## Output

Returns one or more license records matching the provided license number, including licensee name, license status, license type, expiration date, and issuing state. Results may be scoped to a specific state (tx, fl, or, ct) if provided.

## 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"
     ],
     "type": "string"
    },
    "pathParams": {
     "type": "object",
     "required": [
      "license_number"
     ],
     "properties": {
      "license_number": {
       "type": "string"
      }
     }
    },
    "queryParams": {
     "type": "object",
     "required": [],
     "properties": {
      "state": {
       "enum": [
        "tx",
        "fl",
        "or",
        "de",
        "va"
       ],
       "type": "string"
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/license-record-lookup-by-number-ed443a4e/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)