{"uid":"cap_ngI-Y_CP5OVNOXgaKLYkb","slug":"17711-company-registry-check-d33c2539","name":"17711 Company Registry Check","description":"Company check (KYB): registry status, VAT number validation (VIES), LEI and directors of a company by name, SIREN or VAT number","url":"https://api.17711.xyz/registry/company-check-service/v1/company-check/verify_company?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"lei":{"type":["string","null"],"default":null,"description":"A Legal Entity Identifier (20 characters)."},"country":{"type":["string","null"],"default":null,"description":"ISO 3166-1 alpha-2 country code (`FR`, `DE`) to narrow a name or number search."},"vat_number":{"type":["string","null"],"default":null,"description":"An EU VAT number with its country prefix (`FR22424761419`, `DE811907980`)."},"company_name":{"type":["string","null"],"default":null,"description":"The company's name (`OVH`, `Mistral AI`). Give at least one of `company_name`,\n`registration_number`, `vat_number` or `lei`."},"max_age_seconds":{"type":["integer","null"],"format":"uint64","default":null,"minimum":0,"description":"The oldest answer you accept, in seconds. Omit it for the default (answers up to 6 hours\nold); `0` forces a fresh check, including a new VAT validation."},"registration_number":{"type":["string","null"],"default":null,"description":"A company registration number: a French SIREN (9 digits) or SIRET (14 digits), or a number\nfrom another register (then give `country`)."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.009","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.009/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.009","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.009","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_hsGNCBMA5N_-xZGhMY8c5","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.009","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Verifies a company's legitimacy via EU VAT/VIES validation, LEI lookup, registry status, and director information for KYB compliance","exampleAgentPrompt":"Can you verify that Mistral AI is a legitimately registered company — check their VAT number FR22424761419 and tell me their registry status and company directors?","exampleUseCases":[{"title":"KYB check before onboarding vendor","prompt":"We're about to onboard OVH as a vendor. Can you do a full business verification on them using their French VAT number FR22424761419 — I need to know their registry status, whether their VAT is valid, and who the company directors are?"},{"title":"Validate EU partner's VAT before invoicing","prompt":"Before I issue an invoice, can you validate the VAT number DE811907980 for our German partner and confirm it's active in the VIES system?"},{"title":"Due diligence on company via LEI","prompt":"I need to do due diligence on a counterparty — their LEI is 969500XOCGG3NB8JH158. Can you look them up and give me their registry status and any director information?"}],"resultDescription":"Returns structured company verification data including VAT validation status from VIES, LEI record details, company registry status (active/dissolved), company directors, and registration number details. Results may be cached up to 6 hours by default unless max_age_seconds is overridden.","failureModes":["Company not found in any registry — returns empty or null result","Invalid VAT number format causes VIES lookup failure","LEI not found in GLEIF database","Country not supported for registry lookup","Rate limit or payment failure returns 402 or 429 error","Stale cached data returned if max_age_seconds not set to 0"],"whenToPreferThis":"Use this endpoint when you need structured KYB (Know Your Business) verification for EU or internationally registered companies, especially when you need VAT validation via VIES, LEI lookups, or official registry status and director data. Prefer this over generic company profile endpoints when compliance, VAT validity, or legal entity verification is the primary goal rather than marketing or contact enrichment.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-13T12:30:09.962Z","isFirstParty":false,"canonicalSlug":"17711-company-registry-check-d33c2539"}