This guide contains public integration notes for Ukraine. Use it for identifier formats, search behavior, and country-specific caveats. The live source of truth for coverage, pricing, data sources, documents, legal forms, roles, and status values is the pricing page.
Ukraine coverage, pricing, and sources
Open the current catalog for supported datapoints, documents, sources, identifiers, and availability.
This jurisdiction may be in preview or limited availability. Check the live pricing page or contact support before relying on it in production.
Country details below are preserved as integration notes. If a table or example conflicts with the live pricing page, use the pricing page as the source of truth and contact support.
Ukraine uses a single official registry with three distinct datasets. For a given entity, data comes from exactly one dataset — the system routes to the correct dataset based on the identifier format and EDRPOU overlap resolution.
The EDR (Єдиний державний реєстр юридичних осіб, фізичних осіб-підприємців та громадських формувань) — Unified State Register of Legal Entities, Individual Entrepreneurs and Public Associations — is operated by the Ministry of Justice of Ukraine and published as open data at data.gov.ua. It contains three separate datasets:
UO (Юридичні особи) — Legal entities: LLCs, JSCs, cooperatives, nonprofits, state bodies, and all other company types. Identified by EDRPOU (8-digit code, Код ЄДРПОУ).
FOP (Фізичні особи-підприємці) — Individual entrepreneurs (sole proprietors). Identified by RECORD (numeric internal registry ID, exposed in the API with a FOP- prefix to avoid collision with UO EDRPOU codes).
FSU (Відокремлені підрозділи іноземних юридичних осіб) — Subdivisions of foreign legal entities: representative offices and branches of foreign companies registered in Ukraine. Identified by EDRPOU (same 8-digit format as UO, but a separate dataset).
EDR data is sourced from the government open data bulk dataset published by the Ministry of Justice of Ukraine at data.gov.ua. No live API access is provided by the Ukrainian government for EDR data — the bulk dataset is the only officially available access method.
For a given identifier, the system determines the correct dataset as follows:
If the identifier starts with FOP- (e.g. FOP-10693269), route to FOP dataset.
If the identifier is numeric only, check FSU first — this resolves the ~40 known EDRPOU codes that appear in both FSU and UO datasets (FSU takes precedence). If not found in FSU, route to UO.
FOP records are stored and returned with the FOP- prefix as the id field (e.g. FOP-10693269). The identifiers.RECORD field contains the bare numeric value (10693269). Search works with both formats.
Latin queries are matched against companyNameTransliterations (see below). Works whether you spell with KMU 55 (Naftohaz), GOST (Naftogaz), or paste a diacritic form (Hruŝovka)
By FOP surname
ІВАНОВ or Ivanov
name
Full legal name (Surname + Given + Patronymic). Surname-first ordering makes surname prefix search effective. Latin spellings of the surname also match
Latin-script search and the companyNameTransliterations field
Ukrainian companies are registered in Cyrillic. To make Latin queries hit them, every Ukrainian company response carries a companyNameTransliterations: string[] field with the canonical Latin forms of the legal name and any commercial name. The same array is indexed in search, so a Latin query matches even when the source name is fully in Cyrillic.Three deterministic standards are generated per company, deduped:
Standard
Example for «Нафтогаз»
Example for «Хрущовка»
Typical paste source
Generic Latin folding
Naftogaz
Khrushchovka
Company self-branding (Soviet-era spellings), LEI/GLEIF Latin self-spellings
KMU 55 (Ukrainian National 2010)
Naftohaz
Khrushchovka
UA passports, government documents, post-2018 Wikipedia
ISO 9 (academic, diacritics)
Naftogaz
Hruŝovka
Academic papers, EU databases
Notes:
Element [0] is the generic-folding variant. It matches what you get from the transliterate=true flag (see Transliteration), so the two features stay aligned.
The diacritic ISO 9 form lets you paste copies like Hruŝovka from academic sources and still match. Diacritics are folded on the query side, so the index entry Hruŝovka is hit by a query for Hrusovka too.
The field is absent for Latin-script company names where the array would be empty. For non-Latin-script countries other than Ukraine, the field is currently absent (other countries follow in later releases).
Source-language alternates (Kyiv vs Kiev, Lviv vs Lvov, Odesa vs Odessa) are not derivable from transliteration. Those forms come from transliterating different source-language Cyrillic strings and are not covered today.
FOP public IDs are prefixed with FOP- because both FOP RECORD numbers and UO EDRPOU codes are 8-digit integers. Without the prefix, collisions would occur. Always include FOP- when querying a specific individual entrepreneur.
~40 EDRPOU overlap between FSU and UO
A small number of EDRPOU codes appear in both the FSU and UO datasets. The system checks FSU first; for these codes, the FSU record takes precedence.
No address data
The EDR open data bulk dataset does not include registered address information. The legalAddress field is always absent for Ukrainian entities. The ADDRESS field exists in the XML schema but is not populated by the Ukrainian government in their open data exports.
No activity/KVED codes
Activity codes (KVED / КВЕД, the Ukrainian classification of economic activities) are not included in the onboarding profile. The EDR open dataset field is not populated reliably enough for use.
FOP has no capital
Individual entrepreneurs do not have share capital; the capital field is absent for all FOP records.
FSU has no capital
Foreign entity subdivisions do not have share capital under Ukrainian law; the capital field is absent for all FSU records.
в стані припинення = dissolution process
The status “in process of termination” maps to UNDER_INSOLVENCY_PROCEEDING with closureReason: LIQUIDATION (for UO) or VOLUNTARY_DISSOLUTION (for FSU foreign branches). The company is not yet closed but is in active dissolution proceedings.
FSU parent company extracted from text
For FSU records, the foreign parent company details (legalName, countryCode, foreignCode) are parsed from the free-text FOUNDER field in the EDR data. This parsing covers common formats but may miss unusual entries.
FOP farmers
FOP records of farmers (фермер) carry activityDescription: "Farmer (фермер)" rather than a KVED code.
Historical records back to ~1991
The EDR contains records since Ukrainian independence. Older records (pre-1996) may have incomplete data: missing registration date, missing legal form (OPF), or empty founder/signer fields.
representationMode is partial
Signing authority is inferred from the free-text SIGNER field. mode: sole is set when the text includes “без обмежень” or “самостійно”. mode: joint is set when it includes “спільно з” or “разом з”. Scopes that defer to the charter (“згідно статуту”) or list financial caps leave representationMode absent. When set, particularity.localText carries the original Ukrainian scope text and particularity.englishTranslation provides a translation for common phrases.
Legal forms are mapped deterministically from the EDR OPF field — no AI inference is involved. The local Ukrainian name is always preserved verbatim in legalForm.localName.
FSU records (foreign subdivisions) always have legalForm.localName inferred from their name prefix: names starting with “Представництво” → Representative Office; otherwise → Branch.
UO: Shareholders are extracted from the FOUNDERS (ЗАСНОВНИКИ) section of the EDR record. Both individual and company shareholders are supported, with nominal capital amounts in UAH.
FOP: Always a single self-shareholder (100%) — the individual entrepreneur themselves. sharePercentage: 100.
FSU: The foreign parent company is represented as a single company shareholder (100%). Includes countryCode, legalName, and identifiers.foreignCode when available in the source data.
“Partial” for UO shareholders and legal representatives reflects the EDR open data: the structured FOUNDERS and SIGNERS sections are populated for most entities but may be empty for older records (pre-1996) or for government bodies and state enterprises that do not list individual founders.
A foreign company’s representative office registered in Ukraine. The parent company is the shareholder (100%), with country code and foreign registration number extracted from the EDR source.
