{"uid":"cap_ub9JWOSRWP9KCPItFnV-c","slug":"tbs-company-siren-vat-lei-api-4405d43f","name":"TBS Company SIREN/VAT/LEI API","description":"Entity resolution for KYC/KYB, supplier and customer onboarding and France 2026 e-invoicing: use when you hold a company name, brand or director and need a certain identifier. Returns the French SIREN, EU VAT or global LEI with a confidence score and ranked candidates, cross-checked across official registers (recherche-entreprises Sirene/RNE, GLEIF LEI, EU VIES VAT). Input: name or vat, optional country, director, city.","url":"https://x402.tbs-digital.com/company/resolve?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","properties":{"vat":{"type":"string","description":"EU VAT number, e.g. FR59542051180"},"city":{"type":"string","description":"Optional registered-office city"},"name":{"type":"string","description":"Company / brand / legal name"},"country":{"type":"string","description":"fr | eu | global"},"director":{"type":"string","description":"Optional officer surname"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"best":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"id_type":{"type":"string"},"confidence":{"type":"number"}}},"candidates":{"type":"array","items":{"type":"object"}},"provenance":{"type":"array","items":{"type":"object"}},"request_id":{"type":"string"},"generated_at":{"type":"string","format":"date-time"}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_2t0eKHbZND-JmP8jdJukh","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Resolves a company name, brand, or director into a verified French SIREN, EU VAT number, or global LEI identifier with confidence scoring, cross-checked against official registers.","exampleAgentPrompt":"Can you look up the SIREN and EU VAT number for 'Société Générale' in France? I need the confidence score and ranked candidates from the official registers.","exampleUseCases":[{"title":"Supplier onboarding identity check","prompt":"I need to onboard a new French supplier called 'Atos SE' — can you resolve their SIREN, EU VAT, and LEI from the official registers so I can verify their legal identity before adding them to our system?"},{"title":"France 2026 e-invoicing preparation","prompt":"We're preparing for France's 2026 e-invoicing mandate and need the SIREN number for a company called 'Legrand SA' headquartered in Limoges — can you look it up with a confidence score?"},{"title":"KYB director-based entity resolution","prompt":"I'm running a KYB check and only have the director surname 'Arnault' and the company is somewhere in France — can you resolve the company's SIREN and LEI from official registers?"}],"resultDescription":"Returns a best-match object containing the resolved identifier (SIREN, EU VAT, or LEI), the identifier type, the matched company name, and a confidence score, plus an array of ranked candidate matches, provenance details indicating which official registers were consulted, a unique request ID, and a generation timestamp.","failureModes":["Ambiguous company name with multiple close matches returns low-confidence candidates rather than a single best result","Company not found in any of the three registers returns an empty candidates array","Invalid or malformed VAT number input returns an error or zero matches","Country scope mismatch (e.g. searching 'fr' for a non-French company) returns no results","Very new or recently dissolved companies may not yet appear in official registers","Rate limiting or payment failure returns a 402 or 429 error"],"whenToPreferThis":"Choose this endpoint when you need to resolve a French company name or a European/global business entity into a verified SIREN, EU VAT, or LEI identifier for compliance, KYC/KYB, supplier onboarding, or France 2026 e-invoicing workflows. It is particularly valuable when you only have a brand name, trading name, or director surname — rather than the official identifier — because it cross-checks multiple authoritative registers (Sirene/RNE, GLEIF, EU VIES) in a single call and returns ranked candidates with confidence scores. Prefer this over manual register queries when building automated onboarding pipelines or compliance agents.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T00:48:09.303Z","isFirstParty":false,"canonicalSlug":"tbs-company-siren-vat-lei-api-b2b6d9d7"}