# Tolca Business Verification (KYB)

> Tolca Business Verification (KYB) is a paid API for AI agents from tolca.tonbot.ca, paid per call via x402, $0.05/call, status unknown (last checked 2026-10-29).

Checks a company against US restricted-party lists, company registries, legal entity status, and contractor licences in one call, returning a clear verdict of ok, review, blocking, or not_found with reasons.

## Facts

- Endpoint: POST https://tolca.tonbot.ca/v1/verify-business?utm_source=zero.xyz
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tolca-business-verification-kyb-3d063844
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_2yokZ78_VMOOefiVdmIsr

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 tolca-business-verification-kyb-3d063844 -d '<json body>'
```

Example prompt: Before we wire payment to Acme Construction LLC, can you run a KYB check on them — they're a US company operating in Washington state — and tell me if they're clear on sanctions, legally registered, and hold a valid contractor licence?

## When to prefer this

Use this endpoint when you need a single consolidated KYB verdict before paying, onboarding, or contracting a business — especially when you need to cross-check US sanctions (OFAC SDN, Entity List, Denied Persons), legal entity status via GLEIF, and regional contractor licences (WA, OR, QC) in one call without managing multiple API integrations. Prefer it over standalone OFAC screeners when you also need registry and licence verification, and over manual lookups when you need a machine-readable verdict with structured reasons for audit trails.

## Known failure modes

- Business name not found in any checked registry — verdict returns not_found with reasons
- Ambiguous name matches multiple entities — may return review verdict requiring manual inspection
- Region code outside supported values (WA, OR, QC) causes contractor licence check to be skipped silently
- Invalid ISO-2 country code results in a validation error
- Payment not received (x402 protocol) — request rejected before processing
- External registry or sanctions list temporarily unavailable — partial results or error response

## How this service works

Ask about any company or Québec contractor and get a verdict grounded in official registries, not guesses. Plus web search that reads the pages for you. Pay per call, no account.

## Output

A JSON object with a top-level verdict (ok, review, blocking, or not_found), a list of human-readable reasons, a sanctions block (status, matched list entries, data freshness timestamp), a legal_entity block (GLEIF LEI record with entity status, jurisdiction, and registration status), and a contractor_licences array if a region was provided. All checks are timestamped.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "name": {
   "type": "string",
   "example": "Apple Inc.",
   "description": "Business legal or trade name"
  },
  "region": {
   "type": "string",
   "example": "WA",
   "description": "Optional state or province code: WA, OR or QC enables contractor-licence checks"
  },
  "country": {
   "type": "string",
   "example": "US",
   "description": "Optional ISO 3166 alpha-2 country code (US, CA, GB...)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "reasons": [
   "Found in at least one official registry, no restricted-party match."
  ],
  "verdict": "ok",
  "sanctions": {
   "as_of": "2026-10-16T04:00:00Z",
   "lists": "US Consolidated Screening List (incl. OFAC SDN, Entity List, Denied Persons)",
   "status": "clear",
   "matches": []
  },
  "checked_at": "2026-10-16T12:00:00Z",
  "legal_entity": {
   "source": "GLEIF LEI (CC0)",
   "status": "ok",
   "records": [
    {
     "lei": "HWUPKR0MPOU8FGXBT394",
     "city": "Cupertino",
     "score": 1,
     "country": "US",
     "legal_name": "Apple Inc.",
     "jurisdiction": "US-CA",
     "entity_status": "ACTIVE",
     "registration_status": "ISSUED"
    }
   ]
  },
  "contractor_licences": []
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tolca-business-verification-kyb-3d063844/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from tolca.tonbot.ca](https://www.zero.xyz/host/tolca.tonbot.ca/llms.txt)