{"title":"Limitguard lead validation API: quick start","version":"1.0","time_to_first_call":"< 5 minutes","base_url":"https://api.limitguard.ai","steps":[{"step":1,"title":"Try Sandbox (Free)","description":"Create a free sandbox key; no payment needed.","curl":"curl -X POST https://api.limitguard.ai/v1/keys/create -H \"Content-Type: application/json\" -d '{\"email\": \"you@example.com\", \"tier\": \"sandbox\"}'","note":"Returns an lg_sandbox_ key. Sandbox returns mock data, for integration testing."},{"step":2,"title":"Make Your First Call","description":"Use your sandbox key to check a company.","curl":"curl -X POST https://api.limitguard.ai/v1/entity/check -H \"X-API-Key: YOUR_SANDBOX_KEY\" -H \"Content-Type: application/json\" -d '{\"entity_name\": \"Acme B.V.\", \"country\": \"NL\"}'","note":"Returns a 0-100 score, a risk level and a recommendation, with the factors behind them.","python_sdk":{"install":"pip install limitguard","description":"Same call through the Python SDK on PyPI; the key carries auth and its prepaid balance, nothing else to configure.","python":"from limitguard import LimitGuardClient\nasync with LimitGuardClient(api_key=\"YOUR_SANDBOX_KEY\") as client:\n    result = await client.check_entity(\"Acme B.V.\", country=\"NL\")\n    print(result.trust_score, result.recommendation)"},"lead_verify":{"description":"The main check for a Dutch or Belgian lead: register status, VAT, sanctions and the email domain, with a verdict and a lead score. Live registers only: use a live key with a prepaid balance or pay by x402; a sandbox key gets 403.","price_usdc":"$0.27","curl":"curl -X POST https://api.limitguard.ai/v1/leads/verify -H \"X-API-Key: YOUR_LIVE_KEY\" -H \"Content-Type: application/json\" -d '{\"country\": \"NL\", \"name\": \"Voorbeeld Bouw B.V.\"}'"}},{"step":3,"title":"Pay Per Call with USDC (No Signup)","description":"Send a request without a key. You'll get a 402 response with payment instructions. Pay with USDC on Base or Solana, then resend with payment proof.","flow":["1. Send request → receive HTTP 402 with payment details","2. Sign USDC transfer on Base (EIP-3009) or Solana","3. Resend request with PAYMENT-SIGNATURE header","4. Receive the full response; no account needed"],"supported_chains":[{"chain":"Base","token":"USDC","chain_id":"eip155:8453"},{"chain":"Solana","token":"USDC","chain_id":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"}],"already_paid":{"scheme":"settled-transfer","description":"Sent the USDC yourself, on Base, without signing an EIP-3009 authorization? Quote the transaction hash instead of a signature.","curl":"curl -X POST https://api.limitguard.ai/v1/entity/check -H \"X-PAYMENT: 0xYOUR_TRANSACTION_HASH\" -H \"Content-Type: application/json\" -d '{\"entity_name\": \"Acme B.V.\", \"country\": \"NL\"}'","note":"The transfer must pay at least the quoted amount to the payTo in the 402 body and be mined within the last 150 blocks (~5 min on Base). Each transaction hash pays once. The paying wallet must send the transaction itself: the transaction's sender must be the address the USDC comes from. A transfer that a facilitator, bundler or relayer sends for you is refused."},"python_sdk":{"install":"pip install \"limitguard[solana]\"  # or \"limitguard[evm]\" for Base","description":"Same 402-and-retry flow through the Python SDK: pass a wallet instead of an api_key and the client pays each call in USDC automatically, no key or signup needed.","python":"from limitguard import LimitGuardClient\nfrom limitguard.x402 import SolanaWallet\nasync with LimitGuardClient(wallet=SolanaWallet(keypair=keypair)) as client:\n    result = await client.check_entity(\"Acme B.V.\", country=\"NL\")"}},{"step":4,"title":"Or Get an API Key and Prepay","description":"For regular usage, create a live key and top up a prepaid balance; each call is debited at the price in the table.","tiers":[{"name":"Free","price":"$0","credit":"none; pays x402 per call"},{"name":"Indie","price":"$29","credit":"$29 prepaid balance"},{"name":"Starter","price":"$99","credit":"$99 prepaid balance"},{"name":"Growth","price":"$299","credit":"$299 prepaid balance"},{"name":"Pro","price":"$999","credit":"$999 prepaid balance"}]}],"endpoints":[{"path":"/v1/agent/check","price_usdc":"$0.75","x402_price_usdc":"$0.005","method":"POST"},{"path":"/v1/compliance/alerts","price_usdc":"$0.11","x402_price_usdc":"$0.11","method":"GET","note":"Daily changes to the OFAC, EU and UN sanctions lists, plus alerts when an entity or wallet this key checked is listed. Poll this route; alerts about entities or wallets this key checked are also sent to a webhook registered for sanctions.match.new (POST /v1/webhooks)."},{"path":"/v1/entity/check","price_usdc":"$1.05","x402_price_usdc":"$0.29","method":"POST"},{"path":"/v1/entity/deep-check","price_usdc":"$0.88","x402_price_usdc":"$0.88","method":"POST"},{"path":"/v1/entity/light-check","price_usdc":"$0.11","x402_price_usdc":"$0.05","method":"POST"},{"path":"/v1/keys/create","price_usdc":"FREE","x402_price_usdc":"FREE","method":"POST"},{"path":"/v1/kyb/check","price_usdc":"$1.50","x402_price_usdc":"$0.29","method":"POST"},{"path":"/v1/leads/verify","price_usdc":"$0.27","x402_price_usdc":"$0.10","method":"POST"},{"path":"/v1/mcp/check-agent","price_usdc":"FREE","x402_price_usdc":"FREE","method":"POST","status":"unimplemented","note":"Unimplemented / beta: returns placeholder data, not a real result. Free ($0) until real logic ships."},{"path":"/v1/mcp/check-entity","price_usdc":"$1.05","x402_price_usdc":"$0.29","method":"POST"},{"path":"/v1/mcp/risk-score","price_usdc":"$0.90","x402_price_usdc":"$0.25","method":"POST"},{"path":"/v1/mcp/trust-score","price_usdc":"FREE","x402_price_usdc":"FREE","method":"POST"},{"path":"/v1/mcp/verify-wallet","price_usdc":"$0.11","x402_price_usdc":"$0.005","method":"POST"},{"path":"/v1/reports/entity","price_usdc":"$1.85","x402_price_usdc":"$0.55","method":"POST"},{"path":"/v1/reputation/score","price_usdc":"$0.90","x402_price_usdc":"$0.90","method":"POST"},{"path":"/v1/risk/score","price_usdc":"$0.90","x402_price_usdc":"$0.25","method":"POST"},{"path":"/v1/sanctions/preview","price_usdc":"FREE","x402_price_usdc":"FREE","method":"POST"},{"path":"/v1/sanctions/screen","price_usdc":"$0.11","x402_price_usdc":"$0.005","method":"POST"},{"path":"/v1/sanctions/wallet","price_usdc":"FREE","x402_price_usdc":"FREE","method":"POST"},{"path":"/v1/seller/preflight","price_usdc":"$0.11","x402_price_usdc":"$0.005","method":"POST"},{"path":"/v1/wallet/balance","price_usdc":"$0.11","x402_price_usdc":"$0.11","method":"GET"}],"discovery":{"x402":"/.well-known/x402.json","agent_card":"/.well-known/agent-card.json","mcp":"/.well-known/mcp.json","pricing":"https://limitguard.ai/pricing/?utm_source=api&utm_medium=agent&utm_campaign=pricing&utm_content=quickstart"},"playground":"https://limitguard.ai/playground/?utm_source=api&utm_medium=agent&utm_campaign=playground&utm_content=quickstart","docs":"https://docs.limitguard.ai/?utm_source=api&utm_medium=agent&utm_campaign=docs&utm_content=quickstart","support":"support@limitguard.ai"}