{"name":"kyb-company-check","id":"sfoln/kyb-company-check","title":"KYB Company Check – Registry, LEI, VAT","description":"Know-your-business check in one call: national business register (France, Norway, Finland, Czechia, Poland), GLEIF LEI with parent companies, live EU VAT validation (VIES) and a sanctions screen on OFAC, UN, EU and UK lists, with risk flags and a summary. $12 per 1,000 companies.","version":"0.1","status":"ready","family":{"id":"compliance-public-records","name":"Compliance & public records","description":"Sanctions screening, KYB company checks, LEI and VAT validation, SEC EDGAR filings, Form D offerings, insider trades and CVE records.","actors":8},"categories":["AUTOMATION","DEVELOPER_TOOLS","AI"],"availability":"on_request","seoTitle":"KYB Company Check API – Registry, LEI, VAT & Sanctions","seoDescription":"Verify companies in one call: business register, GLEIF LEI and parents, EU VAT (VIES) and OFAC, UN, EU, UK sanctions, with risk flags. $12 per 1,000.","summary":"KYB Company Check – Registry, LEI, VAT runs a know-your-business check on each company in one call: the national business register (France, Norway, Finland, Czech Republic, Poland), the GLEIF LEI record with its parent companies, a live EU VAT validation in VIES and a sanctions screen of the company and its parents against the OFAC, UN, EU and UK lists. Each company becomes one record with its legal identity, riskFlags, a riskLevel and a plain-language summary. Built for customer and supplier onboarding, payment and procurement checks, compliance tools and AI agents. $0.012 per company checked; companies that cannot be found are free.","pricing":{"model":"pay-per-event","currency":"USD","billedBy":"Apify","freePlanMaxItemsPerRun":10,"events":[{"name":"kyb-check","title":"KYB company check","description":"One company checked: national register, GLEIF LEI and parents, VIES VAT validation and a sanctions screen, with risk flags and a summary.","priceUsd":0.012}]},"input":{"description":"Companies to check, by name and country, LEI, VAT number or national registry id. Each company produces one dataset record with risk flags and a summary.","required":[],"fields":[{"name":"companies","title":"Companies","type":"array","required":false,"description":"One object per company with any of name, country, lei, vatNumber, registryId, e.g. [{\"name\": \"Equinor ASA\", \"country\": \"NO\"}, {\"lei\": \"969500KMUQ2B6CBAF162\"}, {\"vatNumber\": \"FR27552032534\"}, {\"country\": \"CZ\", \"registryId\": \"00177041\"}]. A plain string is read as an LEI, a VAT number or a company name. Accounts on the Apify free plan can process up to 10 companies per run.","prefill":[{"name":"Equinor ASA","country":"NO"}],"editor":"json"},{"name":"companyNames","title":"Company names","type":"array","required":false,"description":"Company names (or LEIs / VAT numbers), one per line; the country below applies to all of them.","editor":"stringList"},{"name":"country","title":"Country","type":"string","required":false,"description":"Default country for companies given without one (ISO code like FR or a country name). Registers searched by name: FR, NO, FI, CZ (PL by KRS number).","editor":"textfield"},{"name":"screenSanctions","title":"Screen against sanctions lists","type":"boolean","required":false,"description":"Screen the company's legal name (and the searched name and parent companies) against OFAC SDN and Consolidated, UN, EU and UK sanctions lists.","default":true},{"name":"sanctionsLists","title":"Sanctions lists","type":"array","required":false,"description":"Lists to screen against (default: all five).","default":["ofac-sdn","ofac-cons","un","eu","uk"],"editor":"select"},{"name":"sanctionsThreshold","title":"Sanctions match threshold","type":"number","required":false,"description":"Minimum name score (0.5–1) for a sanctions list entry to count as a potential match.","default":0.85,"minimum":0.5,"maximum":1,"editor":"number"},{"name":"checkVat","title":"Validate VAT numbers (VIES)","type":"boolean","required":false,"description":"Validate the given VAT number, or the one the register shows (FR, FI, CZ, PL), live against VIES.","default":true},{"name":"requesterVatNumber","title":"Your VAT number (for consultation numbers)","type":"string","required":false,"description":"Optional: your own EU VAT number, so that VIES returns a consultation number for each check.","editor":"textfield"},{"name":"includeParents","title":"Include parent companies","type":"boolean","required":false,"description":"Add the direct and ultimate parents from GLEIF and screen their names too.","default":true},{"name":"minNameScore","title":"Minimum name score","type":"number","required":false,"description":"How close (0.5–1) a register or GLEIF name must be to the searched name to be taken as the company.","default":0.8,"minimum":0.5,"maximum":1,"editor":"number"},{"name":"cacheMaxAgeHours","title":"Sanctions list cache age (hours)","type":"integer","required":false,"description":"Reuse sanctions lists your account downloaded within this many hours (kept in the key-value store \"kyb-company-check-cache\"); 0 downloads fresh copies.","default":24,"minimum":0,"maximum":24},{"name":"maxItems","title":"Max companies","type":"integer","required":false,"description":"Safety cap on companies per run; further companies are ignored and counted in the OUTPUT record.","default":1000,"minimum":1,"maximum":10000},{"name":"concurrency","title":"Concurrency","type":"integer","required":false,"description":"Companies checked in parallel (GLEIF allows about 60 requests per minute).","default":3,"minimum":1,"maximum":5},{"name":"includeRaw","title":"Include raw source records","type":"boolean","required":false,"description":"Attach the unmodified register record and GLEIF records under raw.","default":false}]},"exampleInput":{"companies":[{"name":"Equinor ASA","country":"NO"}]},"outputFields":[{"name":"input","type":"string | object","title":"Input","description":"The company as given: { name?, country?, lei?, vatNumber?, registryId? }."},{"name":"status","type":"string","title":"Status","description":"ok | not_found | error | skipped_budget | skipped_free_plan | skipped_unmetered","example":"ok"},{"name":"charged","type":"boolean","title":"Charged","description":"Whether this record incurred a pay-per-event charge."},{"name":"chargedEvent","type":"string","title":"Charged event","description":"Pay-per-event event charged for this record (present only when charged)."},{"name":"chargedCount","type":"integer","title":"Events charged","description":"Events actually charged when the charge came back short of the requested count (present only then; a warning explains it)."},{"name":"source","type":"string","title":"Source","description":"Upstream data source."},{"name":"fetchedAt","type":"string","title":"Fetched at","description":"ISO timestamp."},{"name":"error","type":"object","title":"Error","description":"{ code, message, provider?, status? } when status is not ok. Codes set by the runtime: budget_exhausted, free_plan_limit, unmetered, aborted, charge_failed, record_too_large, invalid_record, dataset_push_failed; this Actor: not_found, sources_failed, name_required (known only from a valid VAT number without a name: not screened, not charged)."},{"name":"warnings","type":"array","title":"Warnings","description":"Notes about this record, e.g. a sanctions list that was unavailable in this run."},{"name":"resolved","type":"boolean","title":"Resolved","description":"The company was found in a register, in GLEIF or as a valid VAT number."},{"name":"legalName","type":"string | null","title":"Legal name","description":"Legal name: register first, then GLEIF, then VIES, then the input."},{"name":"country","type":"string | null","title":"Country","description":"Country of registration (ISO 3166-1 alpha-2)."},{"name":"entityStatus","type":"string","title":"Entity status","description":"active | inactive | unknown (register first, else GLEIF)."},{"name":"registrationNumber","type":"string | null","title":"Registration number","description":"Id in the national register (SIREN, organisasjonsnummer, Y-tunnus, IČO, KRS) or the register id GLEIF holds."},{"name":"register","type":"string | null","title":"Register","description":"Name of the register."},{"name":"legalForm","type":"string | null","title":"Legal form","description":"Legal form name."},{"name":"incorporatedAt","type":"string | null","title":"Incorporated","description":"Incorporation or registration date."},{"name":"address","type":"string | null","title":"Address","description":"Registered address."},{"name":"website","type":"string | null","title":"Website","description":"Website as registered (NO, FI, PL)."},{"name":"lei","type":"string | null","title":"LEI","description":"Legal Entity Identifier, when the company has one."},{"name":"vatNumber","type":"string | null","title":"VAT number","description":"VAT number given, published by the register or confirmed by VIES (null for a number built from the register id that VIES does not know)."},{"name":"vatValid","type":"boolean | null","title":"VAT valid","description":"VIES answer for the VAT number (null: not checked, no answer, or no VAT registration for a number built from the register id)."},{"name":"sanctionsMatchStatus","type":"string | null","title":"Sanctions","description":"potential_match or no_match for the company's names (null when not screened: no company name, or the lists could not be loaded)."},{"name":"riskLevel","type":"string","title":"Risk level","description":"high, medium or low, from the risk flags."},{"name":"riskFlags","type":"array","title":"Risk flags","description":"sanctions_potential_match, parent_sanctions_potential_match, entity_inactive, insolvency_proceedings, vat_invalid (high); vat_name_mismatch, lei_lapsed, name_mismatch, not_found_in_registry, recently_incorporated, registry_unavailable, lei_unavailable, vat_unverified, sanctions_not_screened, sanctions_partial, company_not_found (medium)."},{"name":"summary","type":"string","title":"Summary","description":"One-paragraph summary of the checks."},{"name":"registry","type":"object | null","title":"Register record","description":"Normalised register record: source, register, country, id, idType, name, otherNames, status, insolvency, statusDetail, legalForm, incorporatedAt, dissolvedAt, address, industryCode, industryDescription, employees, website, vatNumber, financials, registryUrl."},{"name":"leiRecord","type":"object | null","title":"LEI record","description":"GLEIF record: lei, legalName, entityStatus, registrationStatus, legalForm, addresses, registrationAuthority, nextRenewalDate, directParent, ultimateParent, exceptions …"},{"name":"vat","type":"object | null","title":"VAT check","description":"vatNumber, source (input, register, or derived: built from the register id), formatValid, valid, name, address, requestDate, consultationNumber, nameMatchScore, note."},{"name":"sanctions","type":"object | null","title":"Sanctions screen","description":"screened, matchStatus (null when not screened), bestScore, matches, parents (screens of the parent companies), listsComplete, listsStale, listsScreened, listsVersion."},{"name":"checks","type":"object","title":"Checks","description":"Per source (registry, lei, vat, sanctions): status ok | not_found | unsupported | skipped | invalid | unavailable | error, with source and message."},{"name":"checkedAt","type":"string","title":"Checked at","description":"ISO timestamp."},{"name":"raw","type":"object","title":"Raw records","description":"Unmodified register and GLEIF records (only with includeRaw)."}],"outputExample":{"input":{"name":"Equinor ASA","country":"NO"},"status":"ok","charged":true,"chargedEvent":"kyb-check","source":"kyb","fetchedAt":"2026-10-14T22:58:52.980Z","resolved":true,"legalName":"EQUINOR ASA","country":"NO","entityStatus":"active","registrationNumber":"923609016","register":"Brønnøysund Register Centre (Norway)","legalForm":"Allmennaksjeselskap","incorporatedAt":"1972-09-18","address":"Forusbeen 50, 4035 STAVANGER, Norge","website":"www.equinor.com","lei":"OW6OFBNCKXC4US5C7523","vatNumber":"NO923609016MVA","vatValid":true,"sanctionsMatchStatus":"no_match","riskLevel":"low","riskFlags":[],"summary":"EQUINOR ASA (NO) is active in Brønnøysund Register Centre (Norway) (organisasjonsnummer 923609016). LEI OW6OFBNCKXC4US5C7523 is ISSUED. VAT number NO923609016MVA is valid. No sanctions match on 5 lists. Risk: low.","registry":{"source":"no-brreg","register":"Brønnøysund Register Centre (Norway)","country":"NO","idType":"organisasjonsnummer","id":"923609016","name":"EQUINOR ASA","otherNames":["Den norske stats oljeselskap a.s","STATOIL ASA","STATOILHYDRO ASA"],"status":"active","insolvency":null,"legalForm":"Allmennaksjeselskap","incorporatedAt":"1972-09-18","address":"Forusbeen 50, 4035 STAVANGER, Norge","industryCode":"06.100","industryDescription":"Utvinning av råolje","employees":"21231","website":"www.equinor.com","vatNumber":"NO923609016MVA","vatNumberSource":"register","registryUrl":"https://virksomhet.brreg.no/oppslag/enheter/923609016"},"leiRecord":{"lei":"OW6OFBNCKXC4US5C7523","legalName":"EQUINOR ASA","entityStatus":"ACTIVE","registrationStatus":"ISSUED","legalForm":{"code":"IQGE","name":"Allmennaksjeselskap"},"registrationAuthority":{"id":"RA000472","name":"The Register of Business Enterprises","entityId":"923 609 016"},"nextRenewalDate":"2027-11-09T18:00:00Z","bic":["SASANO22XXX"],"directParent":null,"directParentException":{"category":"DIRECT_ACCOUNTING_CONSOLIDATION_PARENT","reason":"NATURAL_PERSONS"},"ultimateParent":null,"gleifUrl":"https://search.gleif.org/#/record/OW6OFBNCKXC4US5C7523"},"vat":{"vatNumber":"NO923609016MVA","source":"register","formatValid":true,"valid":true,"name":null,"address":null,"requestDate":null,"consultationNumber":null,"nameMatchScore":null,"note":"Registered for VAT (MVA) in the Norwegian register; Norway is not part of VIES."},"sanctions":{"screened":true,"matchStatus":"no_match","bestScore":0.626,"matches":[],"parents":[],"listsComplete":true,"listsStale":false,"listsScreened":["ofac-sdn","ofac-cons","un","eu","uk"],"listsVersion":{"ofac-sdn":{"list":"ofac-sdn","name":"OFAC Specially Designated Nationals (SDN) List","status":"ok","sourceUrls":["https://sanctionslistservice.ofac.treas.gov/api/PublicationPreview/exports/SDN.CSV"],"fetchedAt":"2026-10-14T22:58:38.350Z","publishedAt":"2026-10-14T14:02:30.000Z","recordCount":19430,"fromCache":false}}},"checks":{"registry":{"status":"ok","source":"no-brreg","message":"Matched by name (score 1)."},"lei":{"status":"ok","source":"gleif"},"vat":{"status":"ok","source":"no-brreg"},"sanctions":{"status":"ok","source":"sanctions-lists"}},"checkedAt":"2026-10-14T22:58:51.185Z"},"faq":[{"question":"Which countries have a business register check?","answer":"France (Sirene / RNE by SIREN or name), Norway (Brønnøysund by organisation number or name), Finland (PRH YTJ by Y-tunnus or name), the Czech Republic (ARES by IČO or name) and Poland (KRS by KRS number). Companies elsewhere are checked through GLEIF, VIES and the sanctions lists; their records say registry: unsupported."},{"question":"What do the risk flags mean?","answer":"High: sanctions_potential_match, parent_sanctions_potential_match, entity_inactive, insolvency_proceedings, vat_invalid. Medium: vat_name_mismatch, lei_lapsed, name_mismatch, not_found_in_registry, recently_incorporated, registry_unavailable, lei_unavailable, vat_unverified, sanctions_not_screened, sanctions_partial, company_not_found. riskLevel is high, medium or low accordingly."},{"question":"Is a company I cannot find charged?","answer":"No. When no register, GLEIF record or valid VAT number matches and its name is not a potential sanctions match, the record has status not_found and is free. A company known only from a valid VAT number whose name VIES withholds (e.g. Germany) cannot be screened: it is returned free with error.code name_required; add the company name."}],"mcpExamplePrompt":"Run a KYB check on Equinor ASA in Norway: is it active, what is its LEI and parent company, and is it on any sanctions list?","related":["sanctions-screening","lei-lookup","vat-number-validator","company-contacts-finder","domain-intelligence"],"urls":{"site":"https://www.sfoln.com/actors/kyb-company-check/","siteJson":"https://www.sfoln.com/actors/kyb-company-check.json","siteMarkdown":"https://www.sfoln.com/actors/kyb-company-check.md","runSync":"https://api.apify.com/v2/actors/sfoln~kyb-company-check/run-sync-get-dataset-items","runAsync":"https://api.apify.com/v2/actors/sfoln~kyb-company-check/runs","mcp":"https://mcp.apify.com?tools=sfoln/kyb-company-check","requestAccess":"mailto:contact@sfoln.com?subject=Access%20request%3A%20KYB%20Company%20Check%20%E2%80%93%20Registry%2C%20LEI%2C%20VAT%20(sfoln%2Fkyb-company-check)&body=Please%20publish%20kyb-company-check.%20What%20we%20plan%20to%20use%20it%20for%3A"},"publisher":{"name":"SFOLN LLC","apifyUsername":"sfoln","url":"https://www.sfoln.com","apifyProfile":"https://apify.com/sfoln","email":"contact@sfoln.com"},"generatedAt":"2026-10-22T04:28:58.477Z"}