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 — same input always gives the same output. No real data sources are called and nothing is charged.

Make a Live Entity Check

Use your lg_live_ key (or pay per call with x402) for real results from up to 7 data sources (the ones your request gives identifiers for):

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.10	Serve from Redis cache if available
Fresh	`fresh`	$0.85	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