---
title: "Verify an entity across registries, sanctions and risk layers"
method: POST
path: "/v1/entity/check"
---

# Verify an entity across registries, sanctions and risk layers

`POST /v1/entity/check`

## Request

- Base URL: `https://api.limitguard.ai`
- URL: `https://api.limitguard.ai/v1/entity/check`
- Auth: one of:
  - API key in header `X-API-Key`
  - none

Full entity trust check across multiple verification layers: KVK/CBE registry, OpenSanctions, country risk (CPI/FATF), domain WHOIS, IBAN validation and EU VAT/VIES. Returns trust score 0-100 with cluster and recommendation.

## Request body

- object
  - `entity_name` string, required: Legal entity name
  - `country` string, required: ISO 3166-1 alpha-2 country code
  - `kvk_number` string: Dutch KVK number (8 digits)
  - `cbe_number` string: Belgian CBE number (0XXX.XXX.XXX or 10 digits)
  - `domain` string: Entity website domain
  - `iban` string: IBAN for financial validation
  - `vat_number` string: EU VAT number
  - `wallet_address` string: Crypto wallet address (format check only; no on-chain lookup)
  - `wallet_chain` string: Blockchain the address is checked against (eth, base, polygon, arbitrum, btc, sol). Defaults to eth when omitted, so send btc or sol with a Bitcoin or Solana address
  - `target_industries` string[]: Ideal-customer industries: SBI/NACE code prefixes ("62", "64.20") or plain words matched as whole words against the register's activity descriptions. Information only: never changes the score.
  - `target_size` object: Ideal-customer employee range, both ends inclusive. Information only.
    - `min` integer
    - `max` integer

## Response `200`

Success

## Other responses

- `402`: Payment required. The x402 v2 challenge is in the base64 PAYMENT-REQUIRED header and the JSON body; pay and retry with PAYMENT-SIGNATURE, or send X-API-Key with prepaid balance.

---

[API](https://skmtc.dev/limitguard/apis/limitguard-ai.md) · [All operations](https://skmtc.dev/limitguard/apis/limitguard-ai/llms.txt) · [OpenAPI document](https://skmtc.dev/limitguard/apis/limitguard-ai/revisions/8f9718bce4a1?raw)