corpoapi_companies_verify $0.0625 per call
Verify a company against the official register (KYB). Resolve a company and compare the supplied claims with registry data (Corpo API · Company data)
For AI agents: call corpoapi_companies_verify
POST https://toll402.dev/v1/p/corpoapi.companies.verify
{
"jurisdiction": "se",
"company_number": "5560295197",
"expected": {
"legal_name": "Volvo Business Services Aktiebolag"
}
}Answers 402 with x402 payment requirements; pay with any x402 client (@x402/fetch, x402 for Python, toll402-client, toll402-mcp) or send a prepaid-credits key as x-toll402-key (https://toll402.dev/credits). Paid per call via x402 (USDC on Base) or with a prepaid-credits key (x-toll402-key, card at /credits); charged only on success. Start at /llms.txt or connect the MCP server:
npx -y toll402-mcp · remote https://toll402.dev/mcp.Input schema
{
"type": "object",
"properties": {
"jurisdiction": {
"type": "string",
"examples": [
"se"
]
},
"company_number": {
"type": "string",
"description": "preferred; any identifier the register publishes",
"examples": [
"5560295197"
]
},
"name": {
"type": "string",
"description": "used when company_number is absent; must resolve to exactly one company"
},
"expected": {
"type": "object",
"description": "claims to check, e.g. {legal_name: ...}",
"examples": [
{
"legal_name": "Volvo Business Services Aktiebolag"
}
]
},
"reference": {
"type": "string",
"description": "your own id, echoed back"
}
},
"additionalProperties": true,
"required": [
"jurisdiction"
],
"description": "`result` is verified, partial, mismatch, not_found or ambiguous, with a check per claim. A 200 with result not_found or ambiguous is free; only a company found is billed. An Idempotency-Key header returns the stored answer for 24 h and never bills twice"
}
MCP
{"mcpServers":{"toll402":{"command":"npx","args":["-y","toll402-mcp"],"env":{"TOLL402_WALLET_KEY":"0x..."}}}}