# Citiview UK KYB Risk Check

> Citiview UK KYB Risk Check is a paid API for AI agents from agents.citiviewgroup.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-14).

Performs a comprehensive UK business verification (KYB) risk assessment, returning a 0-100 risk score, risk level, and detailed flags covering company status, insolvency, directors, ownership, and outstanding charges.

## Facts

- Endpoint: GET https://agents.citiviewgroup.com/v1/uk/kyb?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/citiview-uk-kyb-risk-check-aa7395a5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_1ZmfvSspYkaDyzDqXogBf

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 citiview-uk-kyb-risk-check-aa7395a5
```

Example prompt: Can you run a KYB risk check on a UK company called Acme Widgets Ltd — I need to know their risk score and whether there are any red flags like overdue filings, insolvency history, or disqualified directors before we sign a contract with them?

## When to prefer this

Choose this endpoint when you need a single-call, structured KYB risk assessment for a UK-registered company, particularly when you need director disqualification screening bundled with company status, insolvency, and ownership checks. It is more convenient than querying Companies House directly, as it aggregates multiple data points into a single normalised risk score and flag set. Prefer it for automated vendor onboarding, compliance workflows, or investment due diligence pipelines targeting UK entities.

## Known failure modes

- Company not found on Companies House — returns error or empty result if name/number doesn't match any registered entity
- Ambiguous company name with multiple matches — may require company number for precision
- Data freshness lag — Companies House data may not reflect very recent filings
- Payment failure — x402 payment not completed, request blocked
- Missing required query parameter — no name or number provided returns validation error

## How this service works

UK business verification (KYB) risk check in one call: company status and age, overdue accounts or confirmation statement, insolvency history, disputed or undeliverable office, owners (PSC), outstanding charges, and each current director screened against the disqualified directors register. Returns a 0-100 risk score, level and flags.

## Output

Returns a structured response with a 0-100 numeric risk score, a risk level label (e.g. low/medium/high), and a set of boolean or descriptive flags covering: company status (active/dissolved), company age, overdue accounts or confirmation statement, insolvency history, disputed or undeliverable registered office, Persons of Significant Control (PSC/ownership) data, outstanding charges, and disqualification status of each current director.

## 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"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "name": {
       "type": "string"
      },
      "number": {
       "type": "string",
       "description": "Company number"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/citiview-uk-kyb-risk-check-aa7395a5/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.citiviewgroup.com](https://www.zero.xyz/host/agents.citiviewgroup.com/llms.txt)