Combines entity trust check with sanctions screening and company
registration verification. Returns comprehensive KYB result with
verification status, risk flags, and compliance recommendations.
verified means trust_score 60 or more; register_verified says whether
the KVK or KBO register found the company.
Paid with x402 it costs $0.29 fresh or $0.25 cached (the agent price).
An API key’s prepaid balance is debited $1.50 fresh or $0.25 cached (the account price).
KVK (NL) or KBO/CBE (BE) company number. For other countries it is not checked against a company register; it is only used to find the company's LEI in GLEIF (group_structure)
True when trust_score is 60 or more. It is a score threshold, not a register match: it can be true when no company register was checked. See register_verified.
True only when the company register in register_checked found the company (KVK for NL, KBO for BE). False when it did not, when the lookup failed, and when register_checked is null.
The company register this check asked: KVK (NL) or KBO (BE). Null when none was asked: the country is not NL or BE, a BE check had no CBE number, or the register was busy and skipped.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Limitguard","description":"Limitguard is a lead validation service for lead generation agencies, sales agents and their clients: it checks the company behind each lead against the official business registers (KVK in the Netherlands, KBO in Belgium), EU VAT (VIES) and the OFAC, EU and UN sanctions lists, and returns proceed, review or block with the source on every line. Developers and AI agents can use the same checks over its HTTP API, MCP server and A2A service, hosted in the EU.","colors":{"primary":"#0A6B4A","light":"#10B981","dark":"#0A6B4A"},"logo":{"light":"https://mintcdn.com/limitguard/uaqWIf-9wGFL37l0/logo/light.svg?fit=max\u0026auto=format\u0026n=uaqWIf-9wGFL37l0\u0026q=85\u0026s=001e2a6b81bfb747720577c78583c066","dark":"https://mintcdn.com/limitguard/uaqWIf-9wGFL37l0/logo/dark.svg?fit=max\u0026auto=format\u0026n=uaqWIf-9wGFL37l0\u0026q=85\u0026s=05ebefc386a71f5e89a9d937d8fd8089"},"favicon":{"light":"https://mintcdn.com/limitguard/uaqWIf-9wGFL37l0/favicon.svg?fit=max\u0026auto=format\u0026n=uaqWIf-9wGFL37l0\u0026q=85\u0026s=24ca319e03edbdc7dd773c74b1b24bfa","dark":"https://mintcdn.com/limitguard/uaqWIf-9wGFL37l0/favicon-dark.svg?fit=max\u0026auto=format\u0026n=uaqWIf-9wGFL37l0\u0026q=85\u0026s=21fd795bffa8691e3f5391e4fe07387b"},"api":{"playground":{"proxy":false}},"background":{"color":{"light":"#F3EEE2","dark":"#14201A"}},"navbar":{"links":[{"href":"https://limitguard.ai/?utm_source=docs\u0026utm_medium=docs\u0026utm_campaign=home\u0026utm_content=navbar","label":"limitguard.ai"},{"href":"https://status.limitguard.ai","label":"API Status"}],"primary":{"type":"button","label":"Get API Key","href":"https://dashboard.limitguard.ai/sign-up?utm_source=docs\u0026utm_medium=docs\u0026utm_campaign=signup\u0026utm_content=navbar"}},"footer":{"socials":{"x":"https://x.com/Limitguard","linkedin":"https://www.linkedin.com/company/limitguard","github":"https://github.com/jwconsultancyteam/limitguard-mcp","website":"https://limitguard.ai/?utm_source=docs\u0026utm_medium=docs\u0026utm_campaign=home\u0026utm_content=footer"}},"search":{"prompt":"Search Limitguard docs..."},"seo":{"metatags":{"og:site_name":"Limitguard","og:description":"Limitguard API docs: check the company behind each lead against the KVK and KBO registers, EU VAT and sanctions lists, and get proceed, review or block with the source, over the HTTP API, MCP or A2A."},"indexing":"navigable"},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"limitguard","hasAudioNarration":false,"actualSubdomain":"limitguard","customDomains":["docs.limitguard.ai"],"gitSource":{"type":"github","owner":"jwconsultancyteam","repo":"limitguard-docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"entitlements":{},"buildId":"6ad89f1216faa66f78bb758a","clientVersion":"0.0.4087","searchFilterCounts":[{"language":"default","tag":"API Reference","count":128},{"language":"default","tag":"Endpoints","count":72},{"language":"default","tag":"Changelog","count":32},{"language":"default","tag":"Documentation","count":18},{"language":"default","tag":"Guides","count":9},{"language":"default","tag":"mcp","count":5},{"language":"default","tag":"Get Started","count":4},{"language":"default","tag":"Core Concepts","count":3},{"language":"default","tag":"sanctions","count":3},{"language":"default","tag":"x402","count":3}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/kyb-check","slug":"/api-reference/kyb-check","pageMetadata":{"title":"KYB Check","description":"Full KYB (Know Your Business) verification.\n\nCombines entity trust check with sanctions screening and company\nregistration verification. Returns comprehensive KYB result with\nverification status, risk flags, and compliance recommendations.\n`verified` means trust_score 60 or more; `register_verified` says whether\nthe KVK or KBO register found the company.\n\nPaid with x402 it costs \\$0.29 fresh or \\$0.25 cached (the agent price).\nAn API key's prepaid balance is debited \\$1.50 fresh or \\$0.25 cached (the account price).","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/kyb/check","href":"/api-reference/kyb-check","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"Full KYB (Know Your Business) verification.\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Combines entity trust check with sanctions screening and company\\nregistration verification. Returns comprehensive KYB result with\\nverification status, risk flags, and compliance recommendations.\\n\", _jsx(_components.code, {\n children: \"verified\"\n }), \" means trust_score 60 or more; \", _jsx(_components.code, {\n children: \"register_verified\"\n }), \" says whether\\nthe KVK or KBO register found the company.\"]\n }), \"\\n\", _jsx(_components.p, {\n children: \"Paid with x402 it costs $0.29 fresh or $0.25 cached (the agent price).\\nAn API key’s prepaid balance is debited $1.50 fresh or $0.25 cached (the account price).\"\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"KYB Check","description":"Full KYB (Know Your Business) verification.\n\nCombines entity trust check with sanctions screening and company\nregistration verification. Returns comprehensive KYB result with\nverification status, risk flags, and compliance recommendations.\n`verified` means trust_score 60 or more; `register_verified` says whether\nthe KVK or KBO register found the company.\n\nPaid with x402 it costs \\$0.29 fresh or \\$0.25 cached (the agent price).\nAn API key's prepaid balance is debited \\$1.50 fresh or \\$0.25 cached (the account price).","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/kyb/check","href":"/api-reference/kyb-check","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"KYB Check","description":"Full KYB (Know Your Business) verification.\n\nCombines entity trust check with sanctions screening and company\nregistration verification. Returns comprehensive KYB result with\nverification status, risk flags, and compliance recommendations.\n`verified` means trust_score 60 or more; `register_verified` says whether\nthe KVK or KBO register found the company.\n\nPaid with x402 it costs \\$0.29 fresh or \\$0.25 cached (the agent price).\nAn API key's prepaid balance is debited \\$1.50 fresh or \\$0.25 cached (the account price).","operationId":"kyb_check_v1_kyb_check_post","requestBody":"74be1135-c062-4b0c-a3ea-91a635e47733","responses":{"200":"caf6f59a-a8d1-4d17-b75c-6c853402e530","404":"e54e19c4-1b16-4a98-b2ad-6465753357ff","422":"64c00612-9752-446b-b880-f35ea1eef06c"},"security":["e48e938a-ce80-49e8-82e1-aa5b076c52e7"],"method":"post","type":"path","servers":["5105a447-54cf-43f8-8320-a200b5dbda1d"],"path":"/v1/kyb/check","baseUrlOptions":["https://api.limitguard.ai"],"title":"KYB Check","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated","disableProxy":true},"dependencies":{"parameters":{},"requestBody":{"content":{"application/json":{"schema":{"properties":{"entity_id":{"type":"string","title":"Entity Id","description":"Internal entity identifier","isRequired":true,"uniqueKey":"entity_id","typeLabel":"string"},"registration_number":{"type":"string","title":"Registration Number","description":"KVK (NL) or KBO/CBE (BE) company number. For other countries it is not checked against a company register; it is only used to find the company's LEI in GLEIF (group_structure)","isRequired":true,"uniqueKey":"registration_number","typeLabel":"string"},"country":{"type":"string","maxLength":2,"minLength":2,"title":"Country","description":"ISO 3166-1 alpha-2 country code","isRequired":true,"uniqueKey":"country","typeLabel":"string"},"entity_name":{"oneOf":[{"type":"string","title":"Entity Name","description":"Legal entity name (optional, used for sanctions)","uniqueKey":"entity_name.oneOf.0","typeLabel":"string"},{"type":"null","title":"Entity Name","description":"Legal entity name (optional, used for sanctions)","uniqueKey":"entity_name.oneOf.1","typeLabel":"null"}],"uniqueKey":"entity_name","typeLabel":"string | null"},"vat_number":{"oneOf":[{"type":"string","title":"Vat Number","description":"VAT number for VIES verification","uniqueKey":"vat_number.oneOf.0","typeLabel":"string"},{"type":"null","title":"Vat Number","description":"VAT number for VIES verification","uniqueKey":"vat_number.oneOf.1","typeLabel":"null"}],"uniqueKey":"vat_number","typeLabel":"string | null"},"domain":{"oneOf":[{"type":"string","title":"Domain","description":"Company domain for web presence check","uniqueKey":"domain.oneOf.0","typeLabel":"string"},{"type":"null","title":"Domain","description":"Company domain for web presence check","uniqueKey":"domain.oneOf.1","typeLabel":"null"}],"uniqueKey":"domain","typeLabel":"string | null"}},"type":"object","required":["entity_id","registration_number","country"],"title":"KYBCheckRequest","description":"Request model for KYB verification.","uniqueKey":"","typeLabel":"KYBCheckRequest · object"},"examples":{"Example":{"title":"Example","value":{"entity_id":"\u003cstring>","registration_number":"\u003cstring>","country":"\u003cstring>","entity_name":"\u003cstring>","vat_number":"\u003cstring>","domain":"\u003cstring>"}}},"exampleType":"generated"}},"required":true,"exampleType":"generated"},"responses":{"caf6f59a-a8d1-4d17-b75c-6c853402e530":{"description":"KYB result","content":{"application/json":{"schema":{"properties":{"entity_id":{"type":"string","title":"Entity Id","description":"The entity_id sent in the request","isRequired":true,"uniqueKey":"entity_id","typeLabel":"string"},"registration_number":{"type":"string","title":"Registration Number","description":"The registration_number sent in the request","isRequired":true,"uniqueKey":"registration_number","typeLabel":"string"},"country":{"type":"string","title":"Country","description":"ISO 3166-1 alpha-2 country code, upper case","isRequired":true,"uniqueKey":"country","typeLabel":"string"},"verified":{"type":"boolean","title":"Verified","description":"True when trust_score is 60 or more. It is a score threshold, not a register match: it can be true when no company register was checked. See register_verified.","isRequired":true,"uniqueKey":"verified","typeLabel":"boolean"},"register_verified":{"type":"boolean","title":"Register Verified","description":"True only when the company register in register_checked found the company (KVK for NL, KBO for BE). False when it did not, when the lookup failed, and when register_checked is null.","isRequired":true,"uniqueKey":"register_verified","typeLabel":"boolean"},"register_checked":{"oneOf":[{"type":"string","title":"Register Checked","description":"The company register this check asked: KVK (NL) or KBO (BE). Null when none was asked: the country is not NL or BE, a BE check had no CBE number, or the register was busy and skipped.","enum":["KVK","KBO"],"isRequired":true,"uniqueKey":"register_checked.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","title":"Register Checked","description":"The company register this check asked: KVK (NL) or KBO (BE). Null when none was asked: the country is not NL or BE, a BE check had no CBE number, or the register was busy and skipped.","isRequired":true,"uniqueKey":"register_checked.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"register_checked","typeLabel":"enum\u003cstring> | null"},"sanctions_flagged":{"type":"boolean","title":"Sanctions Flagged","description":"True when the sanctions screen matched the entity","isRequired":true,"uniqueKey":"sanctions_flagged","typeLabel":"boolean"},"kyb_status":{"type":"string","title":"Kyb Status","description":"One of approved, review_required, edd_required or rejected","isRequired":true,"uniqueKey":"kyb_status","typeLabel":"string"},"trust_score":{"type":"integer","maximum":100,"minimum":0,"title":"Trust Score","description":"0-100 trust score. Higher = more trustworthy","isRequired":true,"uniqueKey":"trust_score","typeLabel":"integer"},"trust_level":{"type":"string","title":"Trust Level","description":"Trust level derived from trust_score","isRequired":true,"uniqueKey":"trust_level","typeLabel":"string"},"cluster":{"type":"string","title":"Cluster","description":"Entity cluster classification","isRequired":true,"uniqueKey":"cluster","typeLabel":"string"},"recommendation":{"type":"string","title":"Recommendation","description":"Action recommendation","isRequired":true,"uniqueKey":"recommendation","typeLabel":"string"},"confidence":{"type":"number","maximum":1,"minimum":0,"title":"Confidence","description":"Confidence in the assessment (0-1)","isRequired":true,"uniqueKey":"confidence","typeLabel":"number"},"top_factors":{"items":{"properties":{"source":{"type":"string","title":"Source","description":"Data source name","isRequired":true,"uniqueKey":"top_factors.items.[INDEX].source","typeLabel":"string"},"signal":{"type":"string","title":"Signal","description":"What was found","isRequired":true,"uniqueKey":"top_factors.items.[INDEX].signal","typeLabel":"string"},"impact":{"type":"string","title":"Impact","description":"positive, negative, or neutral","isRequired":true,"uniqueKey":"top_factors.items.[INDEX].impact","typeLabel":"string"},"weight":{"type":"number","title":"Weight","description":"Contribution to score (0-1)","isRequired":true,"uniqueKey":"top_factors.items.[INDEX].weight","typeLabel":"number"}},"type":"object","required":["source","signal","impact","weight"],"title":"TopFactor","uniqueKey":"top_factors.items.[INDEX]","typeLabel":"TopFactor · object"},"type":"array","title":"Top Factors","description":"Top factors behind the score","isRequired":true,"uniqueKey":"top_factors","typeLabel":"TopFactor · object[]"},"sources_checked":{"type":"integer","title":"Sources Checked","description":"Number of data sources that answered","isRequired":true,"uniqueKey":"sources_checked","typeLabel":"integer"},"processing_time_ms":{"type":"integer","title":"Processing Time Ms","description":"Time taken to produce the answer","isRequired":true,"uniqueKey":"processing_time_ms","typeLabel":"integer"},"risk_flags":{"items":{"type":"string","uniqueKey":"risk_flags.items.[INDEX]","typeLabel":"string"},"type":"array","title":"Risk Flags","description":"Negative factors and register flags, as source: signal","isRequired":true,"uniqueKey":"risk_flags","typeLabel":"string[]"},"correlations":{"additionalProperties":{"type":"number","uniqueKey":"correlations.additionalProperties","typeLabel":"number"},"type":"object","title":"Correlations","description":"Cross-source correlation scores","isRequired":true,"uniqueKey":"correlations","typeLabel":"Correlations · object"},"findings":{"items":{"properties":{"action":{"type":"string","minLength":1,"title":"Action","isRequired":true,"uniqueKey":"findings.items.[INDEX].action","typeLabel":"string"},"why":{"type":"string","minLength":1,"title":"Why","isRequired":true,"uniqueKey":"findings.items.[INDEX].why","typeLabel":"string"},"expected_result":{"type":"string","minLength":1,"title":"Expected Result","isRequired":true,"uniqueKey":"findings.items.[INDEX].expected_result","typeLabel":"string"}},"type":"object","required":["action","why","expected_result"],"title":"Finding","uniqueKey":"findings.items.[INDEX]","typeLabel":"Finding · object"},"type":"array","title":"Findings","description":"What to do about each correlation","isRequired":true,"uniqueKey":"findings","typeLabel":"Finding · object[]"},"group_structure":{"additionalProperties":true,"type":"object","title":"Group Structure","description":"LEI and parents from GLEIF; informational, never scored","isRequired":true,"uniqueKey":"group_structure","typeLabel":"Group Structure · object"},"group_chain":{"oneOf":[{"type":"object","title":"Group Chain","description":"Belgian parent chain from the NBB filing; null otherwise","additionalProperties":true,"isRequired":true,"uniqueKey":"group_chain.oneOf.0","typeLabel":"Group Chain · object"},{"type":"null","title":"Group Chain","description":"Belgian parent chain from the NBB filing; null otherwise","isRequired":true,"uniqueKey":"group_chain.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"group_chain","typeLabel":"Group Chain · object | null"},"company_profile":{"oneOf":[{"type":"object","title":"CompanyProfile","description":"What the KVK register says about the company; null when it has no record","required":["status","headline"],"properties":{"status":{"type":"string","enum":["active","stopped"],"title":"Status","isRequired":true,"uniqueKey":"company_profile.oneOf.0.status","typeLabel":"enum\u003cstring>"},"headline":{"type":"string","title":"Headline","isRequired":true,"uniqueKey":"company_profile.oneOf.0.headline","typeLabel":"string"},"stopped_on":{"oneOf":[{"type":"string","title":"Stopped On","description":"ISO date the business stopped, when it has","uniqueKey":"company_profile.oneOf.0.stopped_on.oneOf.0","typeLabel":"string"},{"type":"null","title":"Stopped On","description":"ISO date the business stopped, when it has","uniqueKey":"company_profile.oneOf.0.stopped_on.oneOf.1","typeLabel":"null"}],"uniqueKey":"company_profile.oneOf.0.stopped_on","typeLabel":"string | null"},"industry":{"oneOf":[{"type":"object","title":"Industry","required":["code","is_main"],"properties":{"code":{"type":"string","title":"Code","description":"SBI code","examples":["01241"],"isRequired":true,"uniqueKey":"company_profile.oneOf.0.industry.oneOf.0.code","typeLabel":"string"},"is_main":{"type":"boolean","title":"Is Main","isRequired":true,"uniqueKey":"company_profile.oneOf.0.industry.oneOf.0.is_main","typeLabel":"boolean"},"description":{"oneOf":[{"type":"string","title":"Description","description":"KVK's own (Dutch) SBI description","example":"Teelt van appels en peren","uniqueKey":"company_profile.oneOf.0.industry.oneOf.0.description.oneOf.0","typeLabel":"string"},{"type":"null","title":"Description","description":"KVK's own (Dutch) SBI description","example":"Teelt van appels en peren","uniqueKey":"company_profile.oneOf.0.industry.oneOf.0.description.oneOf.1","typeLabel":"null"}],"uniqueKey":"company_profile.oneOf.0.industry.oneOf.0.description","typeLabel":"string | null"}},"additionalProperties":false,"uniqueKey":"company_profile.oneOf.0.industry.oneOf.0","typeLabel":"Industry · object"},{"type":"null","uniqueKey":"company_profile.oneOf.0.industry.oneOf.1","typeLabel":"null"}],"uniqueKey":"company_profile.oneOf.0.industry","typeLabel":"Industry · object | null"},"other_activities":{"items":{"properties":{"code":{"type":"string","title":"Code","description":"SBI code","examples":["01241"],"isRequired":true,"uniqueKey":"company_profile.oneOf.0.other_activities.items.[INDEX].code","typeLabel":"string"},"is_main":{"type":"boolean","title":"Is Main","isRequired":true,"uniqueKey":"company_profile.oneOf.0.other_activities.items.[INDEX].is_main","typeLabel":"boolean"},"description":{"oneOf":[{"type":"string","title":"Description","description":"KVK's own (Dutch) SBI description","example":"Teelt van appels en peren","uniqueKey":"company_profile.oneOf.0.other_activities.items.[INDEX].description.oneOf.0","typeLabel":"string"},{"type":"null","title":"Description","description":"KVK's own (Dutch) SBI description","example":"Teelt van appels en peren","uniqueKey":"company_profile.oneOf.0.other_activities.items.[INDEX].description.oneOf.1","typeLabel":"null"}],"uniqueKey":"company_profile.oneOf.0.other_activities.items.[INDEX].description","typeLabel":"string | null"}},"additionalProperties":false,"type":"object","required":["code","is_main"],"title":"Industry","uniqueKey":"company_profile.oneOf.0.other_activities.items.[INDEX]","typeLabel":"Industry · object"},"type":"array","title":"Other Activities","default":[],"uniqueKey":"company_profile.oneOf.0.other_activities","typeLabel":"Industry · object[]"},"employees":{"oneOf":[{"type":"object","title":"Employees","properties":{"total":{"oneOf":[{"type":"integer","title":"Total","uniqueKey":"company_profile.oneOf.0.employees.oneOf.0.total.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Total","uniqueKey":"company_profile.oneOf.0.employees.oneOf.0.total.oneOf.1","typeLabel":"null"}],"uniqueKey":"company_profile.oneOf.0.employees.oneOf.0.total","typeLabel":"integer | null"},"full_time":{"oneOf":[{"type":"integer","title":"Full Time","uniqueKey":"company_profile.oneOf.0.employees.oneOf.0.full_time.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Full Time","uniqueKey":"company_profile.oneOf.0.employees.oneOf.0.full_time.oneOf.1","typeLabel":"null"}],"uniqueKey":"company_profile.oneOf.0.employees.oneOf.0.full_time","typeLabel":"integer | null"},"part_time":{"oneOf":[{"type":"integer","title":"Part Time","uniqueKey":"company_profile.oneOf.0.employees.oneOf.0.part_time.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Part Time","uniqueKey":"company_profile.oneOf.0.employees.oneOf.0.part_time.oneOf.1","typeLabel":"null"}],"uniqueKey":"company_profile.oneOf.0.employees.oneOf.0.part_time","typeLabel":"integer | null"}},"additionalProperties":false,"uniqueKey":"company_profile.oneOf.0.employees.oneOf.0","typeLabel":"Employees · object"},{"type":"null","uniqueKey":"company_profile.oneOf.0.employees.oneOf.1","typeLabel":"null"}],"uniqueKey":"company_profile.oneOf.0.employees","typeLabel":"Employees · object | null"},"branches":{"oneOf":[{"type":"object","title":"Branches","description":"Always null: branch counts are not in the KVK basisprofiel and need a second paid request.","properties":{"total":{"oneOf":[{"type":"integer","title":"Total","uniqueKey":"company_profile.oneOf.0.branches.oneOf.0.total.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Total","uniqueKey":"company_profile.oneOf.0.branches.oneOf.0.total.oneOf.1","typeLabel":"null"}],"uniqueKey":"company_profile.oneOf.0.branches.oneOf.0.total","typeLabel":"integer | null"},"commercial":{"oneOf":[{"type":"integer","title":"Commercial","uniqueKey":"company_profile.oneOf.0.branches.oneOf.0.commercial.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Commercial","uniqueKey":"company_profile.oneOf.0.branches.oneOf.0.commercial.oneOf.1","typeLabel":"null"}],"uniqueKey":"company_profile.oneOf.0.branches.oneOf.0.commercial","typeLabel":"integer | null"}},"additionalProperties":false,"uniqueKey":"company_profile.oneOf.0.branches.oneOf.0","typeLabel":"Branches · object"},{"type":"null","description":"Always null: branch counts are not in the KVK basisprofiel and need a second paid request.","uniqueKey":"company_profile.oneOf.0.branches.oneOf.1","typeLabel":"null"}],"uniqueKey":"company_profile.oneOf.0.branches","typeLabel":"Branches · object | null"},"kvk_non_mailing":{"oneOf":[{"type":"boolean","title":"Kvk Non Mailing","description":"True when the company asked KVK not to receive unsolicited marketing mail","uniqueKey":"company_profile.oneOf.0.kvk_non_mailing.oneOf.0","typeLabel":"boolean"},{"type":"null","title":"Kvk Non Mailing","description":"True when the company asked KVK not to receive unsolicited marketing mail","uniqueKey":"company_profile.oneOf.0.kvk_non_mailing.oneOf.1","typeLabel":"null"}],"uniqueKey":"company_profile.oneOf.0.kvk_non_mailing","typeLabel":"boolean | null"},"statutory_name":{"oneOf":[{"type":"string","title":"Statutory Name","uniqueKey":"company_profile.oneOf.0.statutory_name.oneOf.0","typeLabel":"string"},{"type":"null","title":"Statutory Name","uniqueKey":"company_profile.oneOf.0.statutory_name.oneOf.1","typeLabel":"null"}],"uniqueKey":"company_profile.oneOf.0.statutory_name","typeLabel":"string | null"},"trade_names":{"items":{"type":"string","uniqueKey":"company_profile.oneOf.0.trade_names.items.[INDEX]","typeLabel":"string"},"type":"array","title":"Trade Names","default":[],"uniqueKey":"company_profile.oneOf.0.trade_names","typeLabel":"string[]"},"extended_legal_form":{"oneOf":[{"type":"string","title":"Extended Legal Form","uniqueKey":"company_profile.oneOf.0.extended_legal_form.oneOf.0","typeLabel":"string"},{"type":"null","title":"Extended Legal Form","uniqueKey":"company_profile.oneOf.0.extended_legal_form.oneOf.1","typeLabel":"null"}],"uniqueKey":"company_profile.oneOf.0.extended_legal_form","typeLabel":"string | null"},"websites":{"items":{"type":"string","uniqueKey":"company_profile.oneOf.0.websites.items.[INDEX]","typeLabel":"string"},"type":"array","title":"Websites","default":[],"uniqueKey":"company_profile.oneOf.0.websites","typeLabel":"string[]"},"lines":{"items":{"type":"string","uniqueKey":"company_profile.oneOf.0.lines.items.[INDEX]","typeLabel":"string"},"type":"array","title":"Lines","default":[],"uniqueKey":"company_profile.oneOf.0.lines","typeLabel":"string[]"},"personal_data_withheld":{"type":"boolean","title":"Personal Data Withheld","description":"True for a sole trader or other natural-person form: its personal register data is not returned","default":false,"uniqueKey":"company_profile.oneOf.0.personal_data_withheld","typeLabel":"boolean"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"company_profile.oneOf.0","typeLabel":"CompanyProfile · object"},{"type":"null","description":"What the KVK register says about the company; null when it has no record","isRequired":true,"uniqueKey":"company_profile.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"company_profile","typeLabel":"CompanyProfile · object | null"},"response_quality":{"type":"string","title":"Response Quality","description":"The tier this answer was served at","isRequired":true,"uniqueKey":"response_quality","typeLabel":"string"},"disclaimers":{"items":{"type":"string","uniqueKey":"disclaimers.items.[INDEX]","typeLabel":"string"},"type":"array","title":"Disclaimers","description":"Notes about this answer, e.g. a retired tier","isRequired":true,"uniqueKey":"disclaimers","typeLabel":"string[]"}},"type":"object","required":["entity_id","registration_number","country","verified","register_verified","register_checked","sanctions_flagged","kyb_status","trust_score","trust_level","cluster","recommendation","confidence","top_factors","sources_checked","processing_time_ms","risk_flags","correlations","findings","group_structure","group_chain","company_profile","response_quality","disclaimers"],"title":"Response Kyb Check V1 Kyb Check Post","description":"Response body of POST /v1/kyb/check.","additionalProperties":true,"uniqueKey":"","typeLabel":"Response Kyb Check V1 Kyb Check Post · object"},"examples":{"Example":{"title":"Example","value":{"entity_id":"\u003cstring>","registration_number":"\u003cstring>","country":"\u003cstring>","verified":true,"register_verified":true,"register_checked":"KVK","sanctions_flagged":true,"kyb_status":"\u003cstring>","trust_score":50,"trust_level":"\u003cstring>","cluster":"\u003cstring>","recommendation":"\u003cstring>","confidence":0.5,"top_factors":[{"source":"\u003cstring>","signal":"\u003cstring>","impact":"\u003cstring>","weight":123}],"sources_checked":123,"processing_time_ms":123,"risk_flags":["\u003cstring>"],"correlations":{},"findings":[{"action":"\u003cstring>","why":"\u003cstring>","expected_result":"\u003cstring>"}],"group_structure":{},"group_chain":{},"company_profile":{"status":"active","headline":"\u003cstring>","stopped_on":"\u003cstring>","industry":{"code":"01241","is_main":true,"description":"Teelt van appels en peren"},"other_activities":[],"employees":{"total":123,"full_time":123,"part_time":123},"branches":{"total":123,"commercial":123},"kvk_non_mailing":true,"statutory_name":"\u003cstring>","trade_names":[],"extended_legal_form":"\u003cstring>","websites":[],"lines":[],"personal_data_withheld":false},"response_quality":"\u003cstring>","disclaimers":["\u003cstring>"]}}},"exampleType":"generated"}},"exampleType":"generated"},"e54e19c4-1b16-4a98-b2ad-6465753357ff":{"description":"Not cached (X-Response-Quality: cached); no data source was called","content":{"application/json":{"schema":{"properties":{"title":{"type":"string","title":"Title","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"status":{"type":"integer","title":"Status","isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"retry":{"properties":{"price_usdc":{"type":"number","title":"Price Usdc","isRequired":true,"uniqueKey":"retry.price_usdc","typeLabel":"number"},"price_raw":{"type":"integer","title":"Price Raw","isRequired":true,"uniqueKey":"retry.price_raw","typeLabel":"integer"},"header":{"type":"string","title":"Header","default":"X-Response-Quality","uniqueKey":"retry.header","typeLabel":"string"},"value":{"type":"string","title":"Value","default":"fresh","uniqueKey":"retry.value","typeLabel":"string"}},"type":"object","required":["price_usdc","price_raw"],"title":"NotCachedRetry","description":"How to retry a not_cached 404: the header, its value and the fresh price.","isRequired":true,"uniqueKey":"retry","typeLabel":"NotCachedRetry · object"},"type":{"type":"string","title":"Type","default":"about:blank","uniqueKey":"type","typeLabel":"string"},"detail":{"oneOf":[{"type":"string","title":"Detail","uniqueKey":"detail.oneOf.0","typeLabel":"string"},{"type":"null","title":"Detail","uniqueKey":"detail.oneOf.1","typeLabel":"null"}],"uniqueKey":"detail","typeLabel":"string | null"},"instance":{"oneOf":[{"type":"string","title":"Instance","uniqueKey":"instance.oneOf.0","typeLabel":"string"},{"type":"null","title":"Instance","uniqueKey":"instance.oneOf.1","typeLabel":"null"}],"uniqueKey":"instance","typeLabel":"string | null"},"errorCode":{"type":"string","title":"Errorcode","default":"not_cached","uniqueKey":"errorCode","typeLabel":"string"}},"type":"object","required":["title","status","retry"],"title":"NotCachedResponse","description":"The 404 main.py's not_cached handler returns (X-Response-Quality: cached\nwith no cached result). It carries errorCode and retry next to the RFC 7807 fields.","uniqueKey":"","typeLabel":"NotCachedResponse · object"},"examples":{"Example":{"title":"Example","value":{"title":"\u003cstring>","status":123,"retry":{"price_usdc":123,"price_raw":123,"header":"X-Response-Quality","value":"fresh"},"type":"about:blank","detail":"\u003cstring>","instance":"\u003cstring>","errorCode":"not_cached"}}},"exampleType":"generated"}},"exampleType":"generated"},"64c00612-9752-446b-b880-f35ea1eef06c":{"description":"Validation Error","content":{"application/json":{"schema":{"properties":{"detail":{"items":{"properties":{"loc":{"items":{"oneOf":[{"type":"string","uniqueKey":"detail.items.[INDEX].loc.items.[INDEX].oneOf.0","typeLabel":"string"},{"type":"integer","uniqueKey":"detail.items.[INDEX].loc.items.[INDEX].oneOf.1","typeLabel":"integer"}],"uniqueKey":"detail.items.[INDEX].loc.items.[INDEX]","typeLabel":"string | integer"},"type":"array","title":"Location","isRequired":true,"uniqueKey":"detail.items.[INDEX].loc","typeLabel":"(string | integer)[]"},"msg":{"type":"string","title":"Message","isRequired":true,"uniqueKey":"detail.items.[INDEX].msg","typeLabel":"string"},"type":{"type":"string","title":"Error Type","isRequired":true,"uniqueKey":"detail.items.[INDEX].type","typeLabel":"string"},"input":{"oneOf":[{"title":"Input"}],"uniqueKey":"detail.items.[INDEX].input","typeLabel":"any"},"ctx":{"type":"object","title":"Context","uniqueKey":"detail.items.[INDEX].ctx","typeLabel":"Context · object"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError","uniqueKey":"detail.items.[INDEX]","typeLabel":"ValidationError · object"},"type":"array","title":"Detail","uniqueKey":"detail","typeLabel":"ValidationError · object[]"}},"type":"object","title":"HTTPValidationError","uniqueKey":"","typeLabel":"HTTPValidationError · object"},"examples":{"Example":{"title":"Example","value":{"detail":[{"loc":["\u003cstring>"],"msg":"\u003cstring>","type":"\u003cstring>","input":"\u003cunknown>","ctx":{}}]}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"e48e938a-ce80-49e8-82e1-aa5b076c52e7":{"APIKeyHeader":{"type":"apiKey","in":"header","name":"X-API-Key","scopes":[],"schemeName":"APIKeyHeader"}}},"servers":{"5105a447-54cf-43f8-8320-a200b5dbda1d":{"url":"https://api.limitguard.ai"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"X-API-Key","scopes":[],"schemeName":"APIKeyHeader"},"schema":{"title":"X-API-Key","type":"string","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"APIKeyHeader","name":"X-API-Key"}],"title":"APIKeyHeader"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"limitguard","siteName":"Limitguard","title":"KYB Check - Limitguard","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-21T11:16:39.689Z","originalFileLocation":"api-reference/kyb-check.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Full KYB (Know Your Business) verification. Combines entity trust check with sanctions screening and company registration verification. Returns comprehensive KYB result with verification status, risk flags, and compliance recommendations. verified means trust_score 60 or more; register_verified says whether the KVK or KBO register found the company. Paid with x402 it costs \\$0.29 fresh or \\$0.25 cached (the agent price). An API key\u0026#x27;s prepaid balance is debited \\$1.50 fresh or \\$0.25 cached (the account price).\">\u003cmeta data-mint-head name=\"application-name\" content=\"Limitguard\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/limitguard/KV8oOqcf-pZgR4Qu/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/limitguard/KV8oOqcf-pZgR4Qu/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/limitguard/KV8oOqcf-pZgR4Qu/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/limitguard/KV8oOqcf-pZgR4Qu/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/limitguard/KV8oOqcf-pZgR4Qu/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/limitguard/KV8oOqcf-pZgR4Qu/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/limitguard/KV8oOqcf-pZgR4Qu/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/limitguard/KV8oOqcf-pZgR4Qu/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/limitguard/KV8oOqcf-pZgR4Qu/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"KYB Check - Limitguard\">\u003cmeta data-mint-head property=\"og:description\" content=\"Limitguard API docs: check the company behind each lead against the KVK and KBO registers, EU VAT and sanctions lists, and get proceed, review or block with the source, over the HTTP API, MCP or A2A.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Limitguard\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.limitguard.ai/api-reference/kyb-check\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://limitguard.mintlify.site/_mintlify/api/og/v2?division=API+Reference\u0026amp;title=KYB+Check\u0026amp;description=Full+KYB+%28Know+Your+Business%29+verification.%0A%0ACombines+entity+trust+check+with+sanctions+screening+and+company%0Aregistration+verification.+Returns+comprehensive+K\u0026amp;theme=da722dbef8d1720c22f54191\u0026amp;signature=4cd650c4635239d895d4d2b5a2e3e5808758e7766d88f9b53e209cbd58bb3064\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"KYB Check - Limitguard\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Limitguard API docs: check the company behind each lead against the KVK and KBO registers, EU VAT and sanctions lists, and get proceed, review or block with the source, over the HTTP API, MCP or A2A.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://limitguard.mintlify.site/_mintlify/api/og/v2?division=API+Reference\u0026amp;title=KYB+Check\u0026amp;description=Full+KYB+%28Know+Your+Business%29+verification.%0A%0ACombines+entity+trust+check+with+sanctions+screening+and+company%0Aregistration+verification.+Returns+comprehensive+K\u0026amp;theme=da722dbef8d1720c22f54191\u0026amp;signature=4cd650c4635239d895d4d2b5a2e3e5808758e7766d88f9b53e209cbd58bb3064\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/limitguard/KV8oOqcf-pZgR4Qu/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Limitguard\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0A6B4A\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.limitguard.ai/api-reference/kyb-check\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/kyb-check.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.limitguard.ai/#organization\",\"name\":\"Limitguard\",\"url\":\"https://docs.limitguard.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/limitguard/uaqWIf-9wGFL37l0/logo/light.svg?fit=max\u0026auto=format\u0026n=uaqWIf-9wGFL37l0\u0026q=85\u0026s=001e2a6b81bfb747720577c78583c066\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.limitguard.ai#website\",\"name\":\"Limitguard\",\"url\":\"https://docs.limitguard.ai\",\"publisher\":{\"@id\":\"https://docs.limitguard.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.limitguard.ai/api-reference/kyb-check#webpage\",\"url\":\"https://docs.limitguard.ai/api-reference/kyb-check\",\"name\":\"KYB Check\",\"description\":\"Full KYB (Know Your Business) verification. Combines entity trust check with sanctions screening and company registration verification. Returns comprehensive KYB result with verification status, risk flags, and compliance recommendations. verified means trust_score 60 or more; register_verified says whether the KVK or KBO register found the company. Paid with x402 it costs \\\\$0.29 fresh or \\\\$0.25 cached (the agent price). An API key's prepaid balance is debited \\\\$1.50 fresh or \\\\$0.25 cached (the account price).\",\"dateModified\":\"2026-10-21T11:16:39.689Z\",\"isPartOf\":{\"@id\":\"https://docs.limitguard.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.limitguard.ai/api-reference/kyb-check#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.limitguard.ai/api-reference/kyb-check#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Endpoints\",\"item\":\"https://docs.limitguard.ai/api-reference/health-check\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"API Reference\",\"item\":\"https://docs.limitguard.ai/api-reference/health-check\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"KYB Check\",\"item\":\"https://docs.limitguard.ai/api-reference/kyb-check\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.limitguard.ai/api-reference/kyb-check#apireference\",\"headline\":\"KYB Check\",\"name\":\"KYB Check\",\"description\":\"Full KYB (Know Your Business) verification. Combines entity trust check with sanctions screening and company registration verification. Returns comprehensive KYB result with verification status, risk flags, and compliance recommendations. verified means trust_score 60 or more; register_verified says whether the KVK or KBO register found the company. Paid with x402 it costs \\\\$0.29 fresh or \\\\$0.25 cached (the agent price). An API key's prepaid balance is debited \\\\$1.50 fresh or \\\\$0.25 cached (the account price).\",\"url\":\"https://docs.limitguard.ai/api-reference/kyb-check\",\"mainEntityOfPage\":{\"@id\":\"https://docs.limitguard.ai/api-reference/kyb-check#webpage\"},\"dateModified\":\"2026-10-21T11:16:39.689Z\",\"publisher\":{\"@id\":\"https://docs.limitguard.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.limitguard.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Limitguard\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Limitguard","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/introduction"}]},{"tab":"API Reference","groups":[{"group":"Overview","pages":[{"title":"API Reference","sidebarTitle":"Overview","href":"/api-reference/introduction"}]},{"group":"Endpoints","pages":[{"group":"API Reference","pages":[{"title":"Health Check","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /health","href":"/api-reference/health-check"},{"title":"Entity Check","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/entity/check","href":"/api-reference/entity-check"},{"title":"Entity Deep Check","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/entity/deep-check","href":"/api-reference/entity-deep-check"},{"title":"Risk Score","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/risk/score","href":"/api-reference/risk-score"},{"title":"Create Key","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/keys/create","href":"/api-reference/create-key"},{"title":"Get Usage","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/keys/usage","href":"/api-reference/get-usage"},{"title":"Revoke Key","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/keys/revoke","href":"/api-reference/revoke-key"},{"title":"Upgrade Key","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/keys/upgrade/{tier}","href":"/api-reference/upgrade-key"},{"title":"Topup Key","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/keys/topup/{usd}","href":"/api-reference/topup-key"},{"title":"Get Usage Summary","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/usage/summary","href":"/api-reference/get-usage-summary"},{"title":"Get Endpoint Counts","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/usage/endpoints","href":"/api-reference/get-endpoint-counts"},{"title":"Get Customer Usage","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/usage","href":"/api-reference/get-customer-usage"},{"title":"Get Audit Trail","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/audit/trail","href":"/api-reference/get-audit-trail"},{"title":"Verify Audit Chain","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/audit/verify","href":"/api-reference/verify-audit-chain"},{"title":"Query Audit Trail","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/audit/query","href":"/api-reference/query-audit-trail"},{"title":"Query Sanctions Decisions","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/audit/sanctions","href":"/api-reference/query-sanctions-decisions"},{"title":"List Webhooks","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/webhooks","href":"/api-reference/list-webhooks"},{"title":"Register Webhook","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/webhooks","href":"/api-reference/register-webhook"},{"title":"Delete Webhook","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/webhooks/{webhook_id}","href":"/api-reference/delete-webhook"},{"title":"Test Webhook","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/webhooks/{webhook_id}/test","href":"/api-reference/test-webhook"},{"title":"Purge Entity Data","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/data/purge","href":"/api-reference/purge-entity-data"},{"title":"Get Retention Policies","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/data/retention","href":"/api-reference/get-retention-policies"},{"title":"Badge JSON (withdrawn)","deprecated":true,"version":null,"openapi":"/api-reference/openapi.json get /v1/badge/{entity_id}.json","href":"/api-reference/badge-json-withdrawn"},{"title":"Badge SVG (withdrawn)","deprecated":true,"version":null,"openapi":"/api-reference/openapi.json get /v1/badge/{entity_id}","href":"/api-reference/badge-svg-withdrawn"},{"title":"Verification page data (withdrawn)","deprecated":true,"version":null,"openapi":"/api-reference/openapi.json get /v1/verify/{entity_id}","href":"/api-reference/verification-page-data-withdrawn"},{"title":"Self Verify","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/self-verify","href":"/api-reference/self-verify"},{"title":"Get Methodology","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/methodology","href":"/api-reference/get-methodology"},{"title":"Get Signals","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/self-verify/signals","href":"/api-reference/get-signals"},{"title":"Verify Certificate","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/certificate/{certificate_hash}","href":"/api-reference/verify-certificate"},{"title":"Register Provider","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/providers/register","href":"/api-reference/register-provider"},{"title":"List Providers","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/providers","href":"/api-reference/list-providers"},{"title":"Get Provider","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/providers/{provider_id}","href":"/api-reference/get-provider"},{"title":"Get Privacy Policy","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/legal/privacy","href":"/api-reference/get-privacy-policy"},{"title":"Get Terms Of Service","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/legal/terms","href":"/api-reference/get-terms-of-service"},{"title":"Get DPA","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/legal/dpa","href":"/api-reference/get-dpa"},{"title":"List Legal Documents","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/legal","href":"/api-reference/list-legal-documents"},{"title":"Get Score History","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/scores/{subject}/history","href":"/api-reference/get-score-history"},{"title":"Submit Feedback","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/feedback","href":"/api-reference/submit-feedback"},{"title":"Reputation Score","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/reputation/score","href":"/api-reference/reputation-score"},{"title":"Reputation History","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/reputation/history/{entity_hash}","href":"/api-reference/reputation-history"},{"title":"List Watchlist","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/watchlist","href":"/api-reference/list-watchlist"},{"title":"Add To Watchlist","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/watchlist","href":"/api-reference/add-to-watchlist"},{"title":"Remove From Watchlist","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/watchlist/{entity_id}","href":"/api-reference/remove-from-watchlist"},{"title":"Financial Health","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/financial/health","href":"/api-reference/financial-health"},{"title":"Treasury Settlements","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/treasury/settlements","href":"/api-reference/treasury-settlements"},{"title":"Agent Revenue","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/treasury/revenue/{agent_id}","href":"/api-reference/agent-revenue"},{"title":"Wallet Balance","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/wallet/balance","href":"/api-reference/wallet-balance"},{"title":"List Alerts","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/compliance/alerts","href":"/api-reference/list-alerts"},{"title":"List Sources","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/compliance/sources","href":"/api-reference/list-sources"},{"title":"Create Subscription","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/compliance/subscribe","href":"/api-reference/create-subscription"},{"title":"AI Act Readiness","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/compliance/readiness/{entity_id}","href":"/api-reference/ai-act-readiness"},{"title":"Compliance Report","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/compliance/report/{entity_id}","href":"/api-reference/compliance-report"},{"title":"Quickstart Guide","description":"Interactive quickstart guide, no auth required.\n\nReturns everything needed to make a first API call:\nendpoints, pricing, curl examples, and payment instructions.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/quickstart","href":"/api-reference/quickstart-guide"},{"title":"KYB Check","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/kyb/check","href":"/api-reference/kyb-check"},{"title":"Security TXT","description":null,"deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /.well-known/security.txt","href":"/api-reference/security-txt"}]},{"group":"reports","pages":[{"title":"Create Entity Report","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/reports/entity","href":"/api-reference/reports/create-entity-report"},{"title":"Get Entity Report","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/reports/{report_id}","href":"/api-reference/reports/get-entity-report"}]},{"group":"sanctions","pages":[{"title":"Sanctions Preview","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/sanctions/preview","href":"/api-reference/sanctions/sanctions-preview"},{"title":"Sanctions Screen Route","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/sanctions/screen","href":"/api-reference/sanctions/sanctions-screen-route"},{"title":"Sanctions Wallet","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/sanctions/wallet","href":"/api-reference/sanctions/sanctions-wallet"}]},{"group":"agent","pages":[{"title":"Agent Check","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/agent/check","href":"/api-reference/agent/agent-check"}]},{"group":"leads","pages":[{"title":"Lead Verify","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/leads/verify","href":"/api-reference/leads/lead-verify"}]},{"group":"Sales","pages":[{"title":"Get Marketplace Listing","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/sales/listing","href":"/api-reference/sales/get-marketplace-listing"},{"title":"Get Recommendations","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/sales/recommendations","href":"/api-reference/sales/get-recommendations"}]},{"group":"mcp","pages":[{"title":"MCP Check Entity","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/mcp/check-entity","href":"/api-reference/mcp/mcp-check-entity"},{"title":"MCP Check Agent (not implemented)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/mcp/check-agent","href":"/api-reference/mcp/mcp-check-agent-not-implemented"},{"title":"MCP Trust Score","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/mcp/trust-score","href":"/api-reference/mcp/mcp-trust-score"},{"title":"MCP Verify Wallet","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/mcp/verify-wallet","href":"/api-reference/mcp/mcp-verify-wallet"},{"title":"MCP Risk Score","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/mcp/risk-score","href":"/api-reference/mcp/mcp-risk-score"}]},{"group":"x402","pages":[{"title":"Get Supported","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /x402/supported","href":"/api-reference/x402/get-supported"},{"title":"Verify Payment","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /x402/verify","href":"/api-reference/x402/verify-payment"},{"title":"Settle Payment","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /x402/settle","href":"/api-reference/x402/settle-payment"}]}]}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog/2026-10-12"}]}]},"basePath":"","title":"KYB Check - Limitguard","buildId":"dpl_FWZhTb2vab28gFGFH4ojka6qEznQ","deploymentId":"dpl_FWZhTb2vab28gFGFH4ojka6qEznQ","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CBsVopKK.js","utils-DZAk68jJ.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-D32AYZrP.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-D_A5_cny.js","snippetPresets-xNRfS9th.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BIB25-tq.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CydJ4w4j.js","shallow-CYPBeQSG.js","getApiPlaygroundDisplay-A5xJVBOu.js","CodeSnippet-BVRTgi3m.js","CodeSnippets-DjD6BSlt.js","Page-Dr40SSJq.js","getPastedJson-D4V4JyrR.js","icon-uhcnG22T.js","MethodPill-CM-ZQdGH.js","DuplicateIcon-B_WnOiNf.js","createIcon-CJsb8utt.js","DynamicMarkdown-D-2HDKEp.js","SectionHeading-KP5xmMgQ.js","axios-vUo_bRtp.js","Markdown-D_k0dg6k.js","clsx-DK3K4Z1S.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-DE3EVdvd.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-fN9H9n9g.js"]}