{"openapi":"3.1.0","info":{"title":"Agentum EU & US Entity Resolver API","version":"0.1.0","description":"Deterministic EU & US corporate entity resolution, EU VIES VAT validation, and OFAC/EU sanctions screening for autonomous AI agents. Supports HTTP 402 via Coinbase x402 v2 and Stripe/Tempo MPP."},"servers":[{"url":"https://agentum.asimplek.cloud"}],"paths":{"/v1/entity/resolve":{"post":{"operationId":"resolve_entity","summary":"Resolve legal entity by identifier or name","description":"Resolves companies and organizations across global registers (GLEIF, EU VAT, SEC EDGAR, State Registrars) with optional sanctions screening and live VAT verification.","tags":["entity"],"x-402":{"version":2,"scheme":"exact","priceUsd":"0.005","network":"eip155:84532","payTo":"0xea7f1083bacf69d3e3aa0c02ad5fbe4f09024f1e","facilitatorUrl":"https://x402.org/facilitator","freeCallsPerDay":5},"x-mpp":{"priceUsd":"0.005","currency":"USD","methods":["tempo","stripe"],"recipient":"0xea7f1083bacf69d3e3aa0c02ad5fbe4f09024f1e","testnet":true},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","minLength":1,"description":"Company name, LEI, EU VAT, LT JAR code, US CIK/EIN, or domain"},"jurisdiction":{"description":"Optional ISO country or region filter (e.g. 'EU', 'US', 'LT', 'DE')","type":"string"},"verifyVat":{"description":"Verify EU VAT number against live VIES if available","type":"boolean"},"includeParent":{"description":"Include parent and ultimate parent LEI relationships","type":"boolean"},"checkSanctions":{"description":"Cross-screen entity against OFAC SDN & EU Financial Sanctions (default true)","type":"boolean"}},"required":["query"],"additionalProperties":false}}}},"responses":{"200":{"description":"Deterministic tool execution response","content":{"application/json":{"schema":{"type":"object","properties":{"resolved":{"type":"boolean"},"confidence":{"type":"number"},"queryType":{"type":"string","enum":["LEI","EU_VAT","LT_JAR","US_CIK","US_EIN","DOMAIN","NAME"]},"modeUsed":{"type":"string","enum":["local","hybrid","live","cache"]},"entity":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"canonicalName":{"type":"string"},"normalizedName":{"type":"string"},"jurisdiction":{"type":"string"},"region":{"type":"string","enum":["EU","US","OTHER"]},"primaryIdType":{"type":"string","enum":["LEI","LT_JAR","US_CIK","US_EIN","EU_VAT","NATIONAL_REG"]},"primaryIdValue":{"type":"string"},"lei":{"type":["string","null"]},"registrationNumber":{"type":["string","null"]},"registrationAuthority":{"type":["string","null"]},"vatNumber":{"type":["string","null"]},"vatValid":{"type":["boolean","null"]},"taxId":{"type":["string","null"]},"cik":{"type":["string","null"]},"tickers":{"type":"array","items":{"type":"string"}},"legalForm":{"type":["string","null"]},"status":{"type":"string","enum":["ACTIVE","INACTIVE","DISSOLVED","LIQUIDATING","UNKNOWN"]},"incorporationDate":{"type":["string","null"]},"legalAddress":{"anyOf":[{"type":"object","properties":{"street":{"type":"string"},"city":{"type":"string"},"postalCode":{"type":"string"},"region":{"type":"string"},"country":{"type":"string"}},"required":["country"],"additionalProperties":false},{"type":"null"}]},"headquartersAddress":{"anyOf":[{"type":"object","properties":{"street":{"type":"string"},"city":{"type":"string"},"postalCode":{"type":"string"},"region":{"type":"string"},"country":{"type":"string"}},"required":["country"],"additionalProperties":false},{"type":"null"}]},"parentLei":{"type":["string","null"]},"ultimateParentLei":{"type":["string","null"]},"domains":{"type":"array","items":{"type":"string"}},"aliases":{"type":"array","items":{"type":"string"}},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"sourceId":{"type":"string"},"fetchedAt":{"type":"string"}},"required":["source","sourceId","fetchedAt"],"additionalProperties":false}},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["canonicalName","normalizedName","jurisdiction","region","primaryIdType","primaryIdValue","lei","registrationNumber","registrationAuthority","vatNumber","vatValid","taxId","cik","tickers","legalForm","status","incorporationDate","legalAddress","headquartersAddress","parentLei","ultimateParentLei","domains","aliases","sources","confidence"],"additionalProperties":false},{"type":"null"}]},"compliance":{"anyOf":[{"type":"object","properties":{"sanctioned":{"type":"boolean"},"riskLevel":{"type":"string","enum":["CLEAR","POTENTIAL_MATCH","EXACT_MATCH"]},"matchScore":{"type":"number"},"matchedLists":{"type":"array","items":{"type":"string"}},"matches":{"type":"array","items":{"type":"object","properties":{"listSource":{"type":"string","enum":["OFAC_SDN","EU_FSF"]},"externalId":{"type":"string"},"primaryName":{"type":"string"},"entityType":{"type":"string"},"programs":{"type":"array","items":{"type":"string"}},"score":{"type":"number"},"remarks":{"type":"string"}},"required":["listSource","externalId","primaryName","entityType","programs","score"],"additionalProperties":false}}},"required":["sanctioned","riskLevel","matchScore","matchedLists","matches"],"additionalProperties":false},{"type":"null"}]},"vatVerification":{"anyOf":[{"type":"object","properties":{"valid":{"type":"boolean"},"countryCode":{"type":"string"},"vatNumber":{"type":"string"},"fullVat":{"type":"string"},"registeredName":{"type":["string","null"]},"registeredAddress":{"type":["string","null"]},"checkedAt":{"type":"string"},"source":{"type":"string","enum":["EU_VIES","CACHE","SYNTAX_ONLY"]},"error":{"type":"string"}},"required":["valid","countryCode","vatNumber","fullVat","registeredName","registeredAddress","checkedAt","source"],"additionalProperties":false},{"type":"null"}]},"candidates":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"canonicalName":{"type":"string"},"normalizedName":{"type":"string"},"jurisdiction":{"type":"string"},"region":{"type":"string","enum":["EU","US","OTHER"]},"primaryIdType":{"type":"string","enum":["LEI","LT_JAR","US_CIK","US_EIN","EU_VAT","NATIONAL_REG"]},"primaryIdValue":{"type":"string"},"lei":{"type":["string","null"]},"registrationNumber":{"type":["string","null"]},"registrationAuthority":{"type":["string","null"]},"vatNumber":{"type":["string","null"]},"vatValid":{"type":["boolean","null"]},"taxId":{"type":["string","null"]},"cik":{"type":["string","null"]},"tickers":{"type":"array","items":{"type":"string"}},"legalForm":{"type":["string","null"]},"status":{"type":"string","enum":["ACTIVE","INACTIVE","DISSOLVED","LIQUIDATING","UNKNOWN"]},"incorporationDate":{"type":["string","null"]},"legalAddress":{"anyOf":[{"type":"object","properties":{"street":{"type":"string"},"city":{"type":"string"},"postalCode":{"type":"string"},"region":{"type":"string"},"country":{"type":"string"}},"required":["country"],"additionalProperties":false},{"type":"null"}]},"headquartersAddress":{"anyOf":[{"type":"object","properties":{"street":{"type":"string"},"city":{"type":"string"},"postalCode":{"type":"string"},"region":{"type":"string"},"country":{"type":"string"}},"required":["country"],"additionalProperties":false},{"type":"null"}]},"parentLei":{"type":["string","null"]},"ultimateParentLei":{"type":["string","null"]},"domains":{"type":"array","items":{"type":"string"}},"aliases":{"type":"array","items":{"type":"string"}},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"sourceId":{"type":"string"},"fetchedAt":{"type":"string"}},"required":["source","sourceId","fetchedAt"],"additionalProperties":false}},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["canonicalName","normalizedName","jurisdiction","region","primaryIdType","primaryIdValue","lei","registrationNumber","registrationAuthority","vatNumber","vatValid","taxId","cik","tickers","legalForm","status","incorporationDate","legalAddress","headquartersAddress","parentLei","ultimateParentLei","domains","aliases","sources","confidence"],"additionalProperties":false}},"latencyMs":{"type":"number"}},"required":["resolved","confidence","queryType","modeUsed","entity","compliance","vatVerification","candidates","latencyMs"],"additionalProperties":false}}}},"402":{"description":"Payment Required — returns PAYMENT-REQUIRED (x402 v2) and WWW-Authenticate: Payment (Stripe/Tempo MPP) headers"}}}},"/v1/entity/vat-verify":{"post":{"operationId":"verify_eu_vat","summary":"Verify EU VAT registration status via VIES","description":"Validates European Union VAT identification numbers against the live official EU VIES system, linking against known company profiles.","tags":["compliance"],"x-402":{"version":2,"scheme":"exact","priceUsd":"0.005","network":"eip155:84532","payTo":"0xea7f1083bacf69d3e3aa0c02ad5fbe4f09024f1e","facilitatorUrl":"https://x402.org/facilitator","freeCallsPerDay":5},"x-mpp":{"priceUsd":"0.005","currency":"USD","methods":["tempo","stripe"],"recipient":"0xea7f1083bacf69d3e3aa0c02ad5fbe4f09024f1e","testnet":true},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"vatNumber":{"type":"string","minLength":4,"description":"EU VAT number including 2-letter country prefix (e.g. 'LT100004278519')"}},"required":["vatNumber"],"additionalProperties":false}}}},"responses":{"200":{"description":"Deterministic tool execution response","content":{"application/json":{"schema":{"type":"object","properties":{"valid":{"type":"boolean"},"countryCode":{"type":"string"},"vatNumber":{"type":"string"},"fullVat":{"type":"string"},"registeredName":{"type":["string","null"]},"registeredAddress":{"type":["string","null"]},"checkedAt":{"type":"string"},"source":{"type":"string","enum":["EU_VIES","CACHE","SYNTAX_ONLY"]},"error":{"type":"string"},"linkedEntity":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"canonicalName":{"type":"string"},"normalizedName":{"type":"string"},"jurisdiction":{"type":"string"},"region":{"type":"string","enum":["EU","US","OTHER"]},"primaryIdType":{"type":"string","enum":["LEI","LT_JAR","US_CIK","US_EIN","EU_VAT","NATIONAL_REG"]},"primaryIdValue":{"type":"string"},"lei":{"type":["string","null"]},"registrationNumber":{"type":["string","null"]},"registrationAuthority":{"type":["string","null"]},"vatNumber":{"type":["string","null"]},"vatValid":{"type":["boolean","null"]},"taxId":{"type":["string","null"]},"cik":{"type":["string","null"]},"tickers":{"type":"array","items":{"type":"string"}},"legalForm":{"type":["string","null"]},"status":{"type":"string","enum":["ACTIVE","INACTIVE","DISSOLVED","LIQUIDATING","UNKNOWN"]},"incorporationDate":{"type":["string","null"]},"legalAddress":{"anyOf":[{"type":"object","properties":{"street":{"type":"string"},"city":{"type":"string"},"postalCode":{"type":"string"},"region":{"type":"string"},"country":{"type":"string"}},"required":["country"],"additionalProperties":false},{"type":"null"}]},"headquartersAddress":{"anyOf":[{"type":"object","properties":{"street":{"type":"string"},"city":{"type":"string"},"postalCode":{"type":"string"},"region":{"type":"string"},"country":{"type":"string"}},"required":["country"],"additionalProperties":false},{"type":"null"}]},"parentLei":{"type":["string","null"]},"ultimateParentLei":{"type":["string","null"]},"domains":{"type":"array","items":{"type":"string"}},"aliases":{"type":"array","items":{"type":"string"}},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"sourceId":{"type":"string"},"fetchedAt":{"type":"string"}},"required":["source","sourceId","fetchedAt"],"additionalProperties":false}},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["canonicalName","normalizedName","jurisdiction","region","primaryIdType","primaryIdValue","lei","registrationNumber","registrationAuthority","vatNumber","vatValid","taxId","cik","tickers","legalForm","status","incorporationDate","legalAddress","headquartersAddress","parentLei","ultimateParentLei","domains","aliases","sources","confidence"],"additionalProperties":false},{"type":"null"}]}},"required":["valid","countryCode","vatNumber","fullVat","registeredName","registeredAddress","checkedAt","source","linkedEntity"],"additionalProperties":false}}}},"402":{"description":"Payment Required — returns PAYMENT-REQUIRED (x402 v2) and WWW-Authenticate: Payment (Stripe/Tempo MPP) headers"}}}},"/v1/entity/sanctions-screen":{"post":{"operationId":"screen_sanctions","summary":"Screen entity or individual against global sanctions lists","description":"Performs fuzzy and exact sanctions screening against OFAC SDN and EU Financial Sanctions with configurable similarity thresholds.","tags":["compliance"],"x-402":{"version":2,"scheme":"exact","priceUsd":"0.005","network":"eip155:84532","payTo":"0xea7f1083bacf69d3e3aa0c02ad5fbe4f09024f1e","facilitatorUrl":"https://x402.org/facilitator","freeCallsPerDay":5},"x-mpp":{"priceUsd":"0.005","currency":"USD","methods":["tempo","stripe"],"recipient":"0xea7f1083bacf69d3e3aa0c02ad5fbe4f09024f1e","testnet":true},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"description":"Entity or individual name to screen"},"country":{"description":"Optional 2-letter ISO country code","type":"string"},"registrationNumber":{"description":"Optional company registration, LEI, or tax ID","type":"string"},"threshold":{"description":"Trigram similarity threshold (default 0.75)","type":"number","minimum":0.1,"maximum":1}},"required":["name"],"additionalProperties":false}}}},"responses":{"200":{"description":"Deterministic tool execution response","content":{"application/json":{"schema":{"type":"object","properties":{"sanctioned":{"type":"boolean"},"riskLevel":{"type":"string","enum":["CLEAR","POTENTIAL_MATCH","EXACT_MATCH"]},"matchScore":{"type":"number"},"matchedLists":{"type":"array","items":{"type":"string"}},"matches":{"type":"array","items":{"type":"object","properties":{"listSource":{"type":"string","enum":["OFAC_SDN","EU_FSF"]},"externalId":{"type":"string"},"primaryName":{"type":"string"},"entityType":{"type":"string"},"programs":{"type":"array","items":{"type":"string"}},"score":{"type":"number"},"remarks":{"type":"string"}},"required":["listSource","externalId","primaryName","entityType","programs","score"],"additionalProperties":false}}},"required":["sanctioned","riskLevel","matchScore","matchedLists","matches"],"additionalProperties":false}}}},"402":{"description":"Payment Required — returns PAYMENT-REQUIRED (x402 v2) and WWW-Authenticate: Payment (Stripe/Tempo MPP) headers"}}}}}}