# Tolca Sanctions Check

> Tolca Sanctions Check is a paid API for AI agents from tolca.tonbot.ca, paid per call via x402, $0.005/call, status unknown (last checked 2026-11-11).

Checks a company or contractor name against official international sanctions lists (EU, UK, US) and returns a risk verdict with match details.

## Facts

- Endpoint: POST https://tolca.tonbot.ca/v1/sanctions-check?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tolca-sanctions-check-92c4f3dc
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_3a3uaS0dpIKZCvAg0NZJY

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-sanctions-check-92c4f3dc -d '<json body>'
```

Example prompt: Can you run a sanctions check on 'Acme Trading Ltd' from the UK to see if they appear on any official EU, UK, or US sanctions lists before we send them a payment?

## When to prefer this

Choose this endpoint when you need a pay-per-call, no-account sanctions check grounded in official EU, UK, and US registries with a cryptographic receipt for audit trails. It is especially suited for Québec contractor screening and scenarios where you want a clear block/review/pass verdict without subscribing to a full compliance platform.

## Known failure modes

- Name not found in any list — returns 'pass' status with empty matches array
- Ambiguous name may produce false positives — returns partial matches with lower confidence scores
- Missing or invalid country code — country field is optional so lookup proceeds globally
- Sanctions list data temporarily stale — lists_as_of timestamps indicate data freshness
- Network or payment failure — x402 payment must succeed before result is returned

## How this service works

Sanctions screening of a company name (OFAC, US, UK, EU, Canada), cheapest tier: is this company sanctioned? One call checks the US Consolidated Screening List (incl. OFAC SDN), the UK Sanctions List, the EU consolidated financial sanctions list and Canada's autonomous sanctions list, refreshed daily. Returns allow / review / block, a 0-100 risk score, matches with official references and dates, and an Ed25519-signed receipt. Companies only. Input: name, optional country.

## Output

Returns a JSON object with an action verdict ('block', 'review', or 'pass'), a status indicating whether a match was found, an array of matched sanctions lists with exact match flags and confidence scores, an overall risk score (0–100), timestamps showing how current each list is, and a cryptographic receipt URL for audit purposes.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "name": {
   "type": "string",
   "example": "Abu Nidal Organisation",
   "description": "Company legal or trade name"
  },
  "country": {
   "type": "string",
   "description": "Optional ISO 3166 alpha-2 country code (US, CA, GB...)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "action": "block",
  "status": "match",
  "matches": [
   {
    "list": "UK Sanctions List (FCDO)",
    "exact": true,
    "score": 1,
    "listed_name": "Abu Nidal Organisation"
   },
   {
    "list": "EU Consolidated Financial Sanctions List (European Commission)",
    "exact": true,
    "score": 1,
    "listed_name": "Abu Nidal Organisation"
   }
  ],
  "receipt": {
   "alg": "Ed25519",
   "verify_url": "https://tolca.tonbot.ca/receipts/rcpt_..."
  },
  "risk_score": 95,
  "lists_as_of": {
   "eu": "2026-10-30T06:05:52Z",
   "uk": "2026-10-30T05:33:26Z",
   "us": "2026-10-29T10:35:13Z"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tolca-sanctions-check-92c4f3dc/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)
