Quickstart

Get an API Key

Create a free API key with a single request: no account or credit card needed.

curl -X POST https://api.limitguard.ai/v1/keys/create \
  -H "Content-Type: application/json" \
  -d '{"email": "you@example.com", "tier": "free"}'

import httpx

response = httpx.post(
    "https://api.limitguard.ai/v1/keys/create",
    json={"email": "you@example.com", "tier": "free"},
)
key = response.json()
print(key["api_key"])  # lg_live_xxxxxxxxxxxxxxxxxxxx

const response = await fetch("https://api.limitguard.ai/v1/keys/create", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ email: "you@example.com", tier: "free" }),
});
const { api_key } = await response.json();
console.log(api_key); // lg_live_xxxxxxxxxxxxxxxxxxxx

Response

{
  "api_key": "lg_live_xxxxxxxxxxxxxxxxxxxx",
  "key_id": "key_abc123",
  "tier": "free",
  "monthly_limit": 500
}

Save the api_key immediately: it is shown once only. The plaintext key is never stored server-side.

Try Sandbox Mode (Free)

Test the API without calling real data sources or paying for calls with a free sandbox key. Sandbox mode is decided by the key (lg_sandbox_...), not by a header:

# 1. A free sandbox key: no wallet, no payment
curl -X POST https://api.limitguard.ai/v1/keys/create \
  -H "Content-Type: application/json" \
  -d '{"email": "you@example.com", "tier": "sandbox"}'

# 2. Any call with it returns mock data
curl -X POST https://api.limitguard.ai/v1/entity/check \
  -H "X-API-Key: lg_sandbox_xxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "entity_name": "Acme Corp BV",
    "country": "NL",
    "kvk_number": "12345678"
  }'

import httpx

key = httpx.post(
    "https://api.limitguard.ai/v1/keys/create",
    json={"email": "you@example.com", "tier": "sandbox"},
).json()["api_key"]  # lg_sandbox_...

response = httpx.post(
    "https://api.limitguard.ai/v1/entity/check",
    headers={"X-API-Key": key},
    json={
        "entity_name": "Acme Corp BV",
        "country": "NL",
        "kvk_number": "12345678",
    },
)
print(response.json())

const { api_key } = await (await fetch("https://api.limitguard.ai/v1/keys/create", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ email: "you@example.com", tier: "sandbox" }),
})).json(); // lg_sandbox_...

const response = await fetch("https://api.limitguard.ai/v1/entity/check", {
  method: "POST",
  headers: {
    "X-API-Key": api_key,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    entity_name: "Acme Corp BV",
    country: "NL",
    kvk_number: "12345678",
  }),
});
const result = await response.json();
console.log(result);

Sandbox returns deterministic mock data: the same input always gives the same output. No real data sources are called and nothing is charged.

Check a Lead

Lead Verify checks one Dutch or Belgian lead against the live KVK or KBO register, VIES, the OFAC, EU and UN sanctions lists and its email domain. It runs on the live registers only, so it needs an lg_live_ key with a prepaid balance or an x402 payment (a free key pays per call over x402, and a sandbox key gets 403). To try it without paying, sign up in the dashboard for 5 free lead checks, no card.

curl -X POST https://api.limitguard.ai/v1/leads/verify \
  -H "X-API-Key: lg_live_xxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "country": "NL",
    "company_number": "12345678",
    "name": "Acme Corp BV",
    "vat_number": "NL123456789B01",
    "email": "sales@acme-corp.nl"
  }'

import httpx

response = httpx.post(
    "https://api.limitguard.ai/v1/leads/verify",
    headers={"X-API-Key": "lg_live_xxxxxxxxxxxxxxxxxxxx"},
    json={
        "country": "NL",
        "company_number": "12345678",
        "name": "Acme Corp BV",
        "vat_number": "NL123456789B01",
        "email": "sales@acme-corp.nl",
    },
)
result = response.json()
print(result["verdict"], result["lead_score"], result["flags"])

const response = await fetch("https://api.limitguard.ai/v1/leads/verify", {
  method: "POST",
  headers: {
    "X-API-Key": "lg_live_xxxxxxxxxxxxxxxxxxxx",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    country: "NL",
    company_number: "12345678",
    name: "Acme Corp BV",
    vat_number: "NL123456789B01",
    email: "sales@acme-corp.nl",
  }),
});
const result = await response.json();
console.log(result.verdict, result.lead_score, result.flags);

A Belgian lead needs its 10-digit KBO number in company_number: Belgian companies cannot be looked up by name. The answer carries a verdict (for example real_active or not_found), a 0-100 lead_score, flags such as vat_owner_mismatch or disposable_email, and the findings behind them. An input you leave out is not checked and never counts against the lead. See the Lead Verify reference for every field and Pricing for the price.

Make a Live Entity Check

Use your lg_live_ key (or pay per call with x402) for real results from every source your identifiers allow: the business register, sanctions, country risk, domain, IBAN and VAT.

curl -X POST https://api.limitguard.ai/v1/entity/check \
  -H "X-API-Key: lg_live_xxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "entity_name": "Acme Corp BV",
    "country": "NL",
    "kvk_number": "12345678"
  }'

import httpx

response = httpx.post(
    "https://api.limitguard.ai/v1/entity/check",
    headers={"X-API-Key": "lg_live_xxxxxxxxxxxxxxxxxxxx"},
    json={
        "entity_name": "Acme Corp BV",
        "country": "NL",
        "kvk_number": "12345678",
    },
)
result = response.json()
print(f"Trust Score: {result['trust_score']}/100")
print(f"Level: {result['trust_level']}")
print(f"Action: {result['recommendation']}")

const response = await fetch("https://api.limitguard.ai/v1/entity/check", {
  method: "POST",
  headers: {
    "X-API-Key": "lg_live_xxxxxxxxxxxxxxxxxxxx",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    entity_name: "Acme Corp BV",
    country: "NL",
    kvk_number: "12345678",
  }),
});
const result = await response.json();
console.log(`Trust Score: ${result.trust_score}/100`);

Response

{
  "trust_score": 87,
  "trust_level": "high",
  "cluster": "established_eu_sme",
  "recommendation": "proceed",
  "confidence": 0.94,
  "top_factors": [
    {"source": "kvk", "signal": "Active registration, 8+ years", "impact": "positive", "weight": 0.35},
    {"source": "vat", "signal": "VIES verified EU VAT", "impact": "positive", "weight": 0.20},
    {"source": "sanctions", "signal": "No sanctions match", "impact": "positive", "weight": 0.25}
  ],
  "sources_checked": ["kvk", "sanctions", "country_risk", "domain", "vat"],
  "processing_time_ms": 342
}

Try a Quick Risk Score

For fast risk-only assessment (2 sources, cheaper):

curl -X POST https://api.limitguard.ai/v1/risk/score \
  -H "X-API-Key: lg_live_xxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"entity_name": "Acme Corp BV", "country": "NL"}'

response = httpx.post(
    "https://api.limitguard.ai/v1/risk/score",
    headers={"X-API-Key": "lg_live_xxxxxxxxxxxxxxxxxxxx"},
    json={"entity_name": "Acme Corp BV", "country": "NL"},
)
print(response.json())

const response = await fetch("https://api.limitguard.ai/v1/risk/score", {
  method: "POST",
  headers: {
    "X-API-Key": "lg_live_xxxxxxxxxxxxxxxxxxxx",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ entity_name: "Acme Corp BV", country: "NL" }),
});
console.log(await response.json());

Response Quality Tiers

Control cost vs. freshness with the X-Response-Quality header:

Tier	Header Value	Cost (entity/check)	Description
Cached	`cached`	$0.11	Serve from Redis cache if available
Fresh	`fresh`	$1.05	Always run full fan-out (default)

curl -X POST https://api.limitguard.ai/v1/entity/check \
  -H "X-API-Key: lg_live_xxxxxxxxxxxxxxxxxxxx" \
  -H "X-Response-Quality: cached" \
  -H "Content-Type: application/json" \
  -d '{"entity_name": "Acme Corp BV", "country": "NL"}'

Next Steps

Authentication

API keys, x402 USDC payments, and sandbox mode

Pricing

Full pricing table for all endpoints and tiers

Error Handling

Complete error catalog with causes and fixes

AI Agent Integration

How AI agents discover and use Limitguard

Get Started

Core Concepts

Guides

Post-mortems

Response Quality Tiers

Next Steps

Authentication

Pricing

Error Handling

AI Agent Integration

​Response Quality Tiers

​Next Steps

Authentication

Pricing

Error Handling

AI Agent Integration

Response Quality Tiers

Next Steps