{"slug":"api-17711-xyz-registry-company-check-service-v1-company-chec-c8f7d4","title":"Company check (KYB)","host":"api.17711.xyz","method":"POST","resource":"https://api.17711.xyz/registry/company-check-service/v1/company-check/verify_company","category":"company","description":"Company check (KYB): registry status, VAT number validation (VIES), LEI and directors of a company by name, SIREN or VAT number","price_listed":0.009,"price_asked":null,"state":"down","state_label":"Not answering","checks_7d":1,"answered_7d":0,"latency_ms_median":null,"reported_calls_30d":1,"reported_payers_30d":1,"networks":["eip155:8453"],"badge":"unverified","paid_checks_7d":0,"paid_ok_7d":0,"example_input":{"body":{"company_name":"string","country":"string","lei":"string","max_age_seconds":0,"registration_number":"string","vat_number":"string"},"bodyType":"json","method":"POST","type":"http"},"output_schema":{"$defs":{"Candidate":{"properties":{"city":{"type":["string","null"]},"name":{"type":"string"},"registration_number":{"type":"string"},"status":{"type":"string"}},"required":["name","registration_number","status"],"type":"object"},"Company":{"properties":{"activity_code":{"description":"Main activity code (NAF/APE for France).","type":["string","null"]},"address":{"type":["string","null"]},"closed_at":{"description":"Date of closure (YYYY-MM-DD), when closed.","type":["string","null"]},"country":{"description":"ISO country code of the legal seat.","type":"string"},"created_at":{"description":"Date of creation (YYYY-MM-DD).","type":["string","null"]},"employees":{"description":"Employee size bracket, e.g. `50-99`.","type":["string","null"]},"head_office_id":{"description":"SIRET of the head office (France).","type":["string","null"]},"legal_form":{"description":"Legal form (`SAS`, `SARL`, ...) or its register code.","type":["string","null"]},"legal_name":{"type":"string"},"lei":{"type":["string","null"]},"registration_number":{"description":"Number in the company register (SIREN for France).","type":["string","null"]},"size_category":{"description":"Size category: `PME`, `ETI`, `GE`.","type":["string","null"]},"status":{"description":"`active`, `closed` or `unknown`.","type":"string"},"trade_name":{"description":"Commercial name or acronym, when different.","type":["string","null"]},"vat_number":{"type":["string","null"]}},"required":["legal_name","status","country"],"type":"object"},"Director":{"properties":{"born":{"description":"Month and year of birth (`1975-01`) for a person, as published in the register.","type":["string","null"]},"kind":{"description":"`person` or `company`.","type":"string"},"name":{"description":"Full name of the person or the legal entity.","type":"string"},"nationality":{"type":["string","null"]},"registration_number":{"description":"Registration number of a legal-entity director.","type":["string","null"]},"role":{"description":"Role as published (`Président de SAS`, `Directeur Général`, `Commissaire aux comptes titulaire`...).","type":"string"}},"required":["name","role","kind"],"type":"object"},"Financial":{"properties":{"net_result":{"description":"Net result, in euros.","format":"int64","type":["integer","null"]},"revenue":{"description":"Revenue, in euros.","format":"int64","type":["integer","null"]},"year":{"format":"uint32","minimum":0,"type":"integer"}},"required":["year"],"type":"object"},"Flag":{"properties":{"code":{"description":"Stable code, e.g. `company.closed`, `vat.invalid`, `vat.name_mismatch`, `lei.lapsed`.","type":"string"},"message":{"type":"string"},"severity":{"description":"`high`, `medium`, `low` or `info`.","type":"string"}},"required":["severity","code","message"],"type":"object"},"LeiParent":{"properties":{"country":{"type":["string","null"]},"legal_name":{"type":"string"},"lei":{"type":"string"}},"required":["lei","legal_name"],"type":"object"},"LeiRecord":{"properties":{"direct_parent":{"anyOf":[{"$ref":"#/$defs/LeiParent"},{"type":"null"}]},"entity_status":{"description":"Entity status in the LEI register (`ACTIVE`, `INACTIVE`).","type":"string"},"lei":{"type":"string"},"next_renewal":{"type":["string","null"]},"registration_status":{"description":"Registration status of the LEI (`ISSUED`, `LAPSED`, ...).","type":"string"},"ultimate_parent":{"anyOf":[{"$ref":"#/$defs/LeiParent"},{"type":"null"}]}},"required":["lei","entity_status","registration_status"],"type":"object"},"VatCheck":{"properties":{"checked_at":{"description":"When the number was validated (UTC).","type":"string"},"number":{"description":"The number as checked, with country prefix.","type":"string"},"registered_address":{"type":["string","null"]},"registered_name":{"description":"Name registered for the VAT number, when the member state discloses it.","type":["string","null"]},"status":{"description":"`valid`, `invalid` or `unavailable` (the EU service did not answer: try again later).","type":"string"}},"required":["number","status","checked_at"],"type":"object"}},"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"properties":{"body":{"properties":{"company_name":{"default":null,"description":"The company's name (`OVH`, `Mistral AI`). Give at least one of `company_name`,\n`registration_number`, `vat_number` or `lei`.","type":["string","null"]},"country":{"default":null,"description":"ISO 3166-1 alpha-2 country code (`FR`, `DE`) to narrow a name or number search.","type":["string","null"]},"lei":{"default":null,"description":"A Legal Entity Identifier (20 characters).","type":["string","null"]},"max_age_seconds":{"default":null,"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.","format":"uint64","minimum":0,"type":["integer","null"]},"registration_number":{"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`).","type":["string","null"]},"vat_number":{"default":null,"description":"An EU VAT number with its country prefix (`FR22424761419`, `DE811907980`).","type":["string","null"]}},"title":"VerifyCompanyRequest","type":"object"},"bodyType":{"const":"json"},"method":{"const":"POST"},"type":{"const":"http"}},"required":["type","method","bodyType","body"],"type":"object"},"output":{"properties":{"example":{"properties":{"age_seconds":{"description":"How old this answer is, in seconds (0 for a fresh check).","format":"uint64","minimum":0,"type":"integer"},"company":{"$ref":"#/$defs/Company"},"confidence":{"description":"`high` (identified by a number), `medium` (a clear name match) or `low` (several similar names).","type":"string"},"coverage_note":{"description":"What this answer does not cover for the company's country.","type":"string"},"directors":{"description":"Officers and statutory auditors published in the register (France only).","items":{"$ref":"#/$defs/Director"},"type":"array"},"financials":{"description":"Revenue and net result of the latest published years (France only).","items":{"$ref":"#/$defs/Financial"},"type":"array"},"flags":{"description":"Things to know: closed company, invalid VAT number, name mismatch, lapsed LEI.","items":{"$ref":"#/$defs/Flag"},"type":"array"},"from_cache":{"description":"`true` when this answer was served from a stored result.","type":"boolean"},"lei":{"anyOf":[{"$ref":"#/$defs/LeiRecord"},{"type":"null"}]},"matched_by":{"description":"How the company was identified: `lei`, `vat_number`, `registration_number` or `name`.","type":"string"},"other_candidates":{"description":"Other companies that matched a name search (to disambiguate).","items":{"$ref":"#/$defs/Candidate"},"type":"array"},"retrieved_at":{"description":"When the registers were queried (UTC).","type":"string"},"sources":{"description":"The registers consulted.","items":{"type":"string"},"type":"array"},"vat":{"anyOf":[{"$ref":"#/$defs/VatCheck"},{"type":"null"}],"description":"VAT number validation, when a VAT number is known."}},"required":["matched_by","confidence","company","directors","financials","other_candidates","flags","sources","coverage_note","retrieved_at","age_seconds","from_cache"],"title":"VerifyCompanyResponse","type":"object"},"type":{"const":"json"}},"required":["type"],"type":"object"}},"required":["input"],"type":"object"},"history":[{"day":"2026-10-18","reachable":false,"status":null,"valid_402":false,"asked_usdc":null,"price_match":null,"latency_ms":null,"error":"URLError"}],"description_full":"Company check (KYB): registry status, VAT number validation (VIES), LEI and directors of a company by name, SIREN or VAT number","last_updated":"2026-10-12T15:49:38.127Z","schemes":["exact"]}