API Reference

Base URL

https://api.limitguard.ai

Authentication

All paid endpoints require one of:

Method	Header	Description
API Key	`X-API-Key: lg_live_...`	Prepaid balance, debited at list price per call
x402 USDC	`PAYMENT-SIGNATURE: <base64>` (V1: `X-PAYMENT`)	Pay-per-call, no subscription
Sandbox	`X-API-Key: lg_sandbox_...`	Free sandbox key from `POST /v1/keys/create` (`"tier": "sandbox"`), mock data

See Authentication for full details.

Request Format

All POST endpoints accept JSON:

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"}'

Response Format

All responses return JSON with consistent structure. Error responses follow RFC 7807 problem details:

Error Response

{
  "type": "about:blank",
  "title": "Validation Error",
  "status": 422,
  "detail": [{"field": "country", "message": "Invalid value"}]
}

Quality Tiers

Control cost vs. freshness on tiered endpoints:

Header Value	Description
`X-Response-Quality: cached`	Serve from cache if available (cheapest)
`X-Response-Quality: fresh`	Full data source fan-out (default)

Rate Limits

Mode	Limit
Sandbox	10 requests/minute per IP
Free tier API key	10 / min, 500 / 24 h
Paid API key	Based on tier
x402 (no key)	60 / min per payer, no daily cap

See Rate Limits for details.

Endpoint Groups

Lead Verify

Check one Dutch or Belgian sales lead against the KVK or KBO register, VIES, sanctions lists and its email domain.

Company checks

Entity checks, risk scoring and KYB verification.

Reputation

Trust decay scoring, reputation history, and watchlists.

Compliance

Regulatory alerts and EU AI Act readiness. Per-entity reports are POST /v1/reports/entity.

Financial & Treasury

Wallet balances, treasury status, and settlement verification.

Webhooks

Certificates & Badges

Issue, verify, and display trust certificates and badges.

OpenAPI Specification

The full OpenAPI 3.1 specification is available for download:

This documentation is auto-generated from the spec
Interactive playground: test endpoints directly from these docs
Code generation: use the spec with any OpenAPI client generator

Use the interactive API playground on each endpoint page to test requests directly. Set your API key in the authorization section and make live requests.

Overview

Endpoints

Base URL

Authentication

Request Format

Response Format

Quality Tiers

Rate Limits

Endpoint Groups

Lead Verify

Company checks

Reputation

Compliance

Financial & Treasury

Webhooks

Certificates & Badges

OpenAPI Specification

​Base URL

​Authentication

​Request Format

​Response Format

​Quality Tiers

​Rate Limits

​Endpoint Groups

Lead Verify

Company checks

Reputation

Compliance

Financial & Treasury

Webhooks

Certificates & Badges

​OpenAPI Specification

Base URL

Authentication

Request Format

Response Format

Quality Tiers

Rate Limits

Endpoint Groups

OpenAPI Specification