# Alvento Companies KYB API

> Alvento Companies KYB API is a paid API for AI agents from companies.alvento.uk, paid per call via x402, $1.25/call, status unknown (last checked 2026-09-15).

Verifies UK companies via Companies House with sanctions screening and disqualified-director cross-checks in batch

## Facts

- Endpoint: POST https://companies.alvento.uk/v1/batch
- Price: $1.25/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/alvento-companies-kyb-api-ebce0c1a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_0ZxvQqxdGfvs4tOUc_c8V

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 alvento-companies-kyb-api-ebce0c1a -d '<json body>'
```

Example prompt: Can you run a KYB check on Acme Trading Ltd (company number 12345678) — I need to know if they're a legitimate UK company, whether they appear on any sanctions lists, and whether any directors have been disqualified?

## When to prefer this

Choose this endpoint when you need to verify UK-registered companies specifically, especially when compliance requirements demand cross-checks against both Companies House records and sanctions/disqualified-director lists in a single call. Prefer it over generic business lookup APIs when UK regulatory compliance (AML, KYB) is the primary goal, or when you need to process multiple UK companies in one batch request.

## Known failure modes

- Company number not found in Companies House — returns not-found error
- Invalid or malformed company registration number in batch — validation error per entry
- Sanctions database or disqualified directors data temporarily unavailable — partial result or service error
- Rate limiting or payment failure (x402) — 402 Payment Required response
- Empty batch submitted — returns validation error

## How this service works

UK company verification (Know Your Business) over Companies House, with sanctions and disqualified-director cross-checks.

## Output

A JSON response containing the verified company details from Companies House (status, incorporation date, registered address, officers), along with flags indicating any sanctions matches and whether any directors appear on the disqualified directors register.

## Response schema (JSON Schema)

```json
{
 "type": "json"
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/alvento-companies-kyb-api-ebce0c1a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from companies.alvento.uk](https://www.zero.xyz/host/companies.alvento.uk/llms.txt)