> ## Documentation Index
> Fetch the complete documentation index at: https://docs.topograph.co/llms.txt
> Use this file to discover all available pages before exploring further.
# Bulgaria
> Country-specific identifiers, data sources, and implementation details
## Start here
This guide contains public integration notes for Bulgaria. 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.
Open the current catalog for supported datapoints, documents, sources, identifiers, and availability.
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.
## Table of Contents
* [Data Sources](#data-sources)
* [Company Identifiers](#company-identifiers)
* [Search Capabilities](#search-capabilities)
* [Quirks & Gotchas](#quirks--gotchas)
* [Mappings](#mappings)
* [Data Availability](#data-availability)
* [Example API Responses](#example-api-responses)
## Data Sources
Bulgaria has two official registers, operated by the same Registry Agency and sharing one UIC numbering space. They cover complementary sets of entities and never overlap, so a single lookup resolves to whichever register holds the entity.
* **Trade Register (Търговски регистър).** Operated by the Registry Agency (Агенция по вписванията) under the Ministry of Justice, the Trade Register is the official commercial register for traders and non-profit legal entities. It is our primary source for those entities, providing structured data for company identification, status, legal form, address, share capital, shareholders, legal representatives, supervisory board members, and UBOs.
* **BULSTAT register (Регистър БУЛСТАТ).** Also operated by the Registry Agency, BULSTAT holds the entities that are **not** in the Commercial Register: civil-law partnerships (ДЗЗД / Дружество по ЗЗД), freelancers and self-employed professionals, foreign entities and branches, associations, foundations, community centres (читалища), cooperatives, and state/municipal institutions. When a UIC is not a Commercial-Register trader, we resolve it automatically from BULSTAT, returning the same structured company data (identity, registered seat, activity, status, management, and ownership participation) plus a Trade Register Extract. For a natural-person subject only the register-public correspondence address is returned; the register's own masked fields are never surfaced.
* **Open Data (data.egov.bg).** Bulk datasets published periodically by the Registry Agency on Bulgaria's government Open Data portal. Contains historical deed filings with company data including status, legal form, address, capital, activity codes (NKID/NACE), legal representatives, and shareholders. Used for **search** and **onboarding profile** (fast, pre-indexed lookups).
**Open Data for fast lookups:** The seach and onboarding profile use
pre-indexed Open Data for sub-second response times. The company profile and
UBO endpoints query the live Trade Register for the most current data.
### Data Source Priority & Routing
A lookup first resolves **which register holds the entity**, then queries the right sources for it. The Commercial Register and BULSTAT share one UIC space and never overlap, so a single UIC resolves to exactly one of them.
**Commercial-Register entity** (traders and non-profit legal entities) — **data comes from two sources in parallel:**
1. **Trade Register (Live API).** Real-time query to the Registry Agency portal for the most current data
2. **Open Data (Pre-indexed).** Batch-processed data providing fast lookups with broader field coverage (activity codes, NACE/ISIC)
Both sources contribute; results are merged with the live registry taking priority for freshness, while Open Data adds structured fields like activity-code classifications.
**BULSTAT entity** (civil-law partnerships, self-employed persons, foreign entities, associations, foundations, cooperatives, institutions) — resolved from a **single live BULSTAT query**. There is no Open Data layer for these entities, so the onboarding profile and the company profile both come from the same live source.
### Attribute-Level Source Mapping
| Attribute | Source | Notes |
| -------------------------------------------- | ------------------ | -------------------------------------------------------------------- |
| Company name, legal form, status | **Trade Register** | From live deed data |
| Latin transliteration (`legalNameInEnglish`) | **Trade Register** | From official transliteration field |
| Registered address | **Trade Register** | Structured parsing of Bulgarian address format |
| Share capital | **Trade Register** | Amount + currency (BGN, EUR, USD) |
| Activity description | **Trade Register** | Bulgarian text description of business purpose |
| Activity codes (NKID/NACE/ISIC) | **Open Data** | Deterministic classification chain |
| Legal representatives | **Both** | Live API for current data, Open Data for batch |
| Shareholders | **Both** | Partners (OOD) or sole owner (EOOD) with capital amounts |
| UBOs | **Trade Register** | Live-only (always fetched fresh); not available for BULSTAT entities |
The mapping above applies to Commercial-Register entities. A **BULSTAT entity**
gets its identity, registered seat, activity, status, management, and ownership
participation from the single live BULSTAT query — there is no Open Data layer
and no UBO datapoint for these entities.
## Company Identifiers
### Query Identifiers
| Company Type | Register | Format | Example | Notes |
| ----------------------- | -------------- | ------------------------- | --------------- | ---------------------------------------------------------------------------------------------------------------------- |
| **All companies** | Trade Register | 9 digits (UIC/EIK) | `831094393` | Unified Identification Code, accepted for all endpoints |
| **Sole traders** | Trade Register | 13 digits (UIC/EIK) | `1234567890123` | Extended format for sole traders |
| **Non-trader entities** | BULSTAT | 9, 10, or 13 digits (UIC) | `103861777` | Civil-law partnerships, self-employed persons, foreign entities, associations, foundations, cooperatives, institutions |
The **UIC (Unified Identification Code)**, also known as **EIK (Единен
идентификационен код)**, is the primary identifier used across all endpoints.
The Commercial Register and BULSTAT share this one numbering space, so you pass
the same UIC regardless of which register holds the entity — routing to the
right register is automatic. A legacy 10-digit BULSTAT code is remapped to its
current UIC automatically. You can also search by **VAT number** using the `BG`
prefix (e.g., `BG831094393`).
### Identifiers in API Response
Once you retrieve company data, the `identifiers` object contains:
| Identifier Type | Format | Example | Found In |
| --------------- | -------------- | ----------- | ----------------------------------------- |
| `uic` | 9 or 13 digits | `831094393` | All companies |
| `VAT` | 9 digits | `831094393` | VAT-registered companies (via VIES check) |
## Search Capabilities
| Search Type | Pattern | Example | Match Type | Expected Results |
| ---------------------- | ------------- | --------------- | ---------- | -------------------------------------------------------------------- |
| By UIC/EIK (9 digits) | `^\d{9}$` | `831094393` | Exact | Exact match returned first (matchType: id); other results may follow |
| By UIC/EIK (13 digits) | `^\d{13}$` | `1234567890123` | Exact | Exact match returned first (matchType: id); other results may follow |
| By VAT Number | `^BG\d{9}$` | `BG831094393` | Exact | Exact match returned first (matchType: id); other results may follow |
| By Name (Cyrillic) | Cyrillic text | `ВИВАКОМ` | Fuzzy | Multiple results (up to 25) |
**Cyrillic required for name search.** Bulgarian company names are registered
in Cyrillic script. Name searches must use Cyrillic characters to return
results. Latin transliterations will not match.
**Search is free.** Search queries do not incur any cost. Only onboarding
profile, company profile, UBO, and document retrieval are charged.
**Address may be missing in name search results.** Name searches return data
from pre-indexed Open Data (change feeds since January 2021). Companies that
have not filed an address change in that period will not have an address. The
live Trade Register fallback for name search does not return addresses either.
Use the **company profile** endpoint to get the current address.
### Search Source Priority
Search queries use pre-built indexes, live registry lookups, and the BULSTAT register:
1. **Pre-built index by ID.** Fast lookup in pre-indexed Open Data for identifier-based searches
2. **Pre-built index by name.** Full-text search in pre-indexed Open Data for name-based searches
3. **VAT number lookup.** Validates VAT via EU VIES service, then searches by VIES-returned company name
4. **Live Trade Register by name.** Fallback to live API for name searches not found in index
5. **Live Trade Register by ID.** Fallback to live API for ID searches not found in index
6. **BULSTAT by ID / name.** Makes non-trader entities (civil-law partnerships, self-employed persons, foreign entities, associations, foundations) findable by UIC or Cyrillic name. Lower priority, so Commercial-Register results stream first and BULSTAT results follow.
Search streams results as each source resolves. Commercial-Register hits (fast,
pre-indexed) return first; a BULSTAT-only entity surfaces a moment later. Once an
entity has been retrieved via `/v2/company`, it is indexed and returns quickly on
subsequent searches.
## Supported Entity Families
| Entity Family | Supported | Notes |
| ----------------------------- | --------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Companies | ✅ | ООД, ЕООД, АД, ЕАД, СД, КД, КДА, ЕДПК (all commercial legal forms) |
| Sole traders / entrepreneurs | ✅ | ЕТ (Едноличен търговец), 13-digit UIC format |
| Associations / organisations | ✅ | Сдружение, Фондация, Народно читалище — from the Commercial Register or BULSTAT depending on registration |
| Non-trader entities (BULSTAT) | ✅ | Civil-law partnerships (ДЗЗД), freelancers / self-employed, foreign entities & branches, cooperatives, and state/municipal institutions — resolved from the BULSTAT register |
| Closed / dissolved entities | ✅ | Companies in liquidation, insolvency, or ceased. Status detected from deed codes and name text |
## Quirks & Gotchas
| Quirk | Details |
| ------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Cyrillic-only name search** | Company names are registered in Cyrillic. Name searches must use Cyrillic characters. Latin text will return no results. |
| **Rate limiting** | The Trade Register applies aggressive rate limiting (\~6 requests before temporary block). Responses return HTTP 200 with an empty body rather than HTTP 429. |
| **Status from company name** | Company status can be inferred from the company name itself (e.g., names containing "в ликвидация" or "в несъстоятелност"), which takes priority over the deed status code. |
| **Capital in EUR** | Since Bulgaria's euro adoption (1 January 2026), share capital is reported in **EUR**. Partner holdings (`nominalCapitalHeld`) remain filed in **BGN**, so ownership percentages are derived from the sum of the BGN holdings — see Shareholders. Some legacy or foreign-invested filings may still show BGN or USD. |
| **Latin transliteration** | Many companies have an official Latin transliteration of their name registered in the Trade Register, returned as `legalNameInEnglish`. This is a transliteration, not a translation. |
| **Shareholder availability** | OOD (LLC) companies have multiple partners with share amounts. EOOD (Single-Member LLC) and single-member EAD (joint-stock) companies have a sole owner at 100% holding the full registered capital. KD (Limited Partnership) companies have general and limited partners. Multi-shareholder AD (joint-stock) companies do not disclose individual shareholders in the Trade Register. Entities with **no share capital** — ET (Sole Trader) and BULSTAT natural persons and non-profits — have no shareholder record: `shareholders` returns a benign not-applicable response and the person/officers are returned under `legalRepresentatives`. |
| **Former partners after conversion** | A company that converted from a multi-partner OOD to a single-member EOOD keeps its former partner list on the register as a struck-through (ceased) record. Only the current sole owner is returned in `shareholders`. The prior partners are historical and are not included. |
| **No NACE from live API** | Activity codes (NKID/NACE/ISIC) are only available from Open Data. The live Trade Register API returns only a free-text activity description that we reuse to infer NACE and ISIC codes (AI). |
| **Address in name search** | Name search results use pre-indexed Open Data (change feeds since Jan 2021) or the live Summary endpoint as fallback, neither of which guarantees an address. \~77% of indexed companies have no address because they haven't filed an address change in that period. The **company profile** endpoint always fetches the current address from the live Trade Register. |
| **UBO data varies** | UBO declarations are only available for companies that have filed beneficial ownership declarations. Not all companies have UBO filings. |
## Mappings
### Company Status
Company status is determined **deterministically** from deed status codes and company name patterns. No AI inference is involved.
#### Deed Status Codes
| Code | Bulgarian Status | English | Standardized Status | Closure Reason |
| ---- | ---------------- | ---------------- | ------------------- | --------------------- |
| A | Вписан | Registered | Active | - |
| N | Новорегистриран | Newly Registered | Active | - |
| E | Вписана промяна | Amended | Active | - |
| L | В ликвидация | In Liquidation | Closed | Liquidation |
| C | Прекратено | Ceased | Closed | Voluntary Dissolution |
#### Status Detection from Company Name
When the company name contains specific keywords, the status is overridden regardless of the deed status code:
| Name Pattern | English | Standardized Status | Closure Reason |
| -------------------- | ------------------- | --------------------------- | -------------------------- |
| в ликвидация | In Liquidation | Closed | Liquidation |
| в несъстоятелност | In Insolvency | Under Insolvency Proceeding | Bankruptcy |
| прекратено / заличен | Ceased / Struck Off | Closed | Administrative Dissolution |
Company name patterns take **priority** over deed status codes. A company with
deed status `E` (Amended) but "в ликвидация" in its name is correctly mapped
as Closed with Liquidation as the closure reason.
### Legal Forms
Bulgaria uses numeric codes from the Trade Register, string codes from Open Data, and legal-form names from the BULSTAT register. The **deterministic mapping covers every common Commercial-Register and BULSTAT legal form** — including civil-law partnerships, cooperatives, associations, foundations, foreign entities, and state/municipal institutions — with the ISO 20275 (ELF) code taken from the official Bulgarian GLEIF list. For a rarer form outside the static map, the standardized type and ISO 20275 code are filled in by AI enrichment **in verification mode only**; in onboarding mode the local Bulgarian name is returned verbatim without a standardized mapping. The local Bulgarian legal form name is always preserved verbatim in every mode.
#### Common Legal Forms
| Bulgarian Name | Abbreviation | English Translation | Standardized | ISO 20275 |
| -------------------------------------------- | ------------ | --------------------------------------- | ------------------------- | --------- |
| Дружество с ограничена отговорност | ООД | Limited Liability Company | Limited Liability Company | VJ3G |
| Еднолично дружество с ограничена отговорност | ЕООД | Single-Member Limited Liability Company | Limited Liability Company | WVIN |
| Акционерно дружество | АД | Joint Stock Company | Corporation | WTK4 |
| Еднолично акционерно дружество | ЕАД | Single-Member Joint Stock Company | Corporation | EJ06 |
| Инвестиционно акционерно дружество | ИАД | Investment Joint Stock Company | Corporation | WTK4 |
#### Sole Traders
| Bulgarian Name | Abbreviation | English Translation | Standardized | ISO 20275 |
| ------------------ | ------------ | ------------------- | ------------------- | --------- |
| Едноличен търговец | ЕТ | Sole Trader | Sole Proprietorship | 946C |
**Sole trader (ЕТ) vs. self-employed natural person.** Both are one-person
operators standardized as `Sole Proprietorship`, but they come from two
different registers and are distinguished by their local name:
* **Sole trader (Едноличен търговец, ЕТ)** is a natural person registered **as a
trader in the Commercial Register** — a registered one-person business
(`localName: "Едноличен търговец"`, ISO 20275 `946C`). The trader is returned
under `legalRepresentatives` and, for a beneficial-ownership request, as the
sole 100% beneficial owner.
* **Self-employed natural person** (freelancer / free-profession practitioner —
lawyer, notary, farmer, etc.) is **not** a trader and is held **only in the
BULSTAT register** (`localName: "Физическо лице"`, no ISO 20275 code, since the
register states no legal form). It has no shareholders and no ultimate
beneficial owners (both return a benign not-applicable response).
A given UIC resolves to exactly one register, so the two never overlap. Our
standardized enum has no dedicated "self-employed" value — `Sole Proprietorship`
is the fleet-standard bucket for one-person operators (as with Estonia's FIE) —
so the register of origin and the local name carry the distinction.
#### Partnerships
| Bulgarian Name | Abbreviation | English Translation | Standardized | ISO 20275 |
| ---------------------------- | ------------ | ------------------------------- | ------------ | --------- |
| Събирателно дружество | СД | General Partnership | Partnership | FPP2 |
| Командитно дружество | КД | Limited Partnership | Partnership | S94S |
| Командитно дружество с акции | КДА | Limited Partnership with Shares | Partnership | HN63 |
#### Cooperatives
| Bulgarian Name | Abbreviation | English Translation | Standardized | ISO 20275 |
| -------------- | ------------ | ------------------- | ------------ | --------- |
| Кооперация | К | Cooperative | Cooperative | CTCH |
#### Non-Profits & Public Entities
| Bulgarian Name | Abbreviation | English Translation | Standardized | ISO 20275 |
| ---------------------------------------------- | ------------ | --------------------------------------- | ----------------------- | --------- |
| Сдружение | Сдр | Association | Nonprofit Organization | - |
| Фондация | Ф | Foundation | Nonprofit Organization | UFG8 |
| Народно читалище | НЧ | Community Center | Nonprofit Organization | - |
| Търговско предприятие на публичноправен субект | ТППД | Trading Enterprise of Public Law Entity | Government-Owned Entity | - |
#### Branch Offices
| Bulgarian Name | Abbreviation | English Translation | Standardized | ISO 20275 |
| ------------------------------------ | ------------ | ------------------------------ | ------------------------------- | --------- |
| Клон на чуждестранен търговец | Клон / КЧТ | Branch of Foreign Trader | Branch or Representative Office | - |
| Клон на чуждестранно юридическо лице | КЧЮЛ | Branch of Foreign Legal Entity | Branch or Representative Office | - |
#### Variable Capital Companies
| Bulgarian Name | Abbreviation | English Translation | Standardized | ISO 20275 |
| --------------------------------------- | ------------ | -------------------------------------- | ------------------------- | --------- |
| Еднолично дружество с променлив капитал | ЕДПК | Single-Member Variable Capital Company | Limited Liability Company | - |
#### BULSTAT-only Forms
These forms are not held in the Commercial Register — they are resolved from the BULSTAT register:
| Bulgarian Name | English Translation | Standardized | ISO 20275 |
| ---------------------------------------------------------- | --------------------------------------------- | ------------------------------- | --------- |
| Дружество по ЗЗД (ДЗЗД) | Civil-Law Partnership (Consortium) | Partnership | TCGV |
| Жилищностроителна кооперация | Housing Construction Cooperative | Cooperative | CTCH |
| Физическо лице | Natural person (self-employed) | Sole Proprietorship | - |
| Чуждестранно нефизическо лице с място на стопанска дейност | Foreign legal entity with a place of business | Branch or Representative Office | - |
| Чуждестранно лице | Foreign entity | Other | - |
| Детска градина / училище / община | Kindergarten / school / municipality | Government-Owned Entity | - |
The deterministic mapping covers every common Commercial-Register and BULSTAT
legal form, with the ISO 20275 (ELF) code taken from the official Bulgarian
GLEIF list (only currently-active ELF codes are used). For a rarer form outside
the static map, the standardized type and ISO 20275 code are filled in by AI
enrichment **in verification mode only**; in onboarding mode the local Bulgarian
name is returned verbatim. The local Bulgarian legal form name is always
preserved verbatim in every mode.
The most common Bulgarian legal forms are **ООД** (LLC, \~45% of active
companies), **ЕООД** (Single-Member LLC, \~35%), **ЕТ** (Sole Trader, \~10%),
and **АД/ЕАД** (Joint Stock, \~5%).
### Legal Representatives
The deterministic mapping covers the common Bulgarian executive and management roles from both the Commercial Register and BULSTAT. For an unmapped role, keyword matching on the Bulgarian text infers the standardized role (e.g. a role containing "директор" maps to Director), and in verification mode AI enrichment resolves anything the keyword pass cannot. Role names are always preserved in Bulgarian alongside the English translation.
| Bulgarian Role | English Translation | Standardized Role |
| --------------------------------- | -------------------------------- | -------------------- |
| Управител | Manager | Managing Director |
| Управител на клон | Branch Manager | Managing Director |
| Изпълнителен директор | Executive Director | Executive Director |
| Главен изпълнителен директор | Chief Executive Director | CEO |
| Председател на управителния съвет | Chairman of the Management Board | Chairman |
| Член на управителния съвет | Member of the Management Board | Board Member |
| Представител | Representative | Authorized Signatory |
| Прокурист | Procurator | Authorized Signatory |
| Ликвидатор | Liquidator | Liquidator |
| Синдик | Receiver / Trustee in Bankruptcy | Receiver |
| Председател | Chairman | Chairman |
| Зам. председател | Deputy Chairman | Vice President |
| Едноличен търговец | Sole Trader | Owner |
| Друга длъжност | Other position | Other |
The most common role is **Управител** (Manager) for OOD/EOOD companies and
**Изпълнителен директор** (Executive Director) for AD/EAD companies. Both
individual and corporate legal representatives are supported. Roles not in the
static mapping are classified via keyword matching on the Bulgarian role text
(e.g., a role containing "директор" is mapped to Director).
### Other Key Persons
Board members, auditors, and controllers are extracted separately from legal representatives. For joint-stock companies (AD/EAD), this covers both board structures: the one-tier **Board of Directors** (Съвет на директорите) and the two-tier **Management Board** (Управителен съвет) plus **Supervisory Board** (Надзорен съвет). A board member who also represents the company is returned under `legalRepresentatives`, not duplicated here. Common board and audit roles are mapped deterministically. Unknown roles are classified via keyword matching on the Bulgarian text, falling back to `Other` when no keyword matches.
| Bulgarian Role | English Translation | Standardized Role |
| ------------------------------ | ------------------------------ | ------------------------ |
| Член на Съвета на директорите | Board of Directors Member | Board Member |
| Член на управителния съвет | Management Board Member | Board Member |
| Член на надзорния съвет | Supervisory Board Member | Supervisory Board Member |
| Контрольор | Controller / Auditor | Auditor |
| Член на проверителната комисия | Verification Commission Member | Auditor |
| Член на настоятелството | Board of Trustees Member | Board Member |
| Председател | Chairman | Board Member |
| Член | Board Member | Board Member |
### Shareholders
Shareholders are extracted from the Trade Register for **OOD, EOOD, KD, and single-member EAD entities**. Multi-shareholder **AD** (joint-stock) companies do not disclose their individual shareholders in the Bulgarian Trade Register. Entities with **no share capital** — **ET** (sole traders) and BULSTAT natural persons (freelancers / self-employed) and non-profits (associations, foundations) — have no shareholders: the `shareholders` datapoint returns an explicit not-applicable response (at no charge) and the person or officers are returned under `legalRepresentatives` instead.
#### Extraction Logic
| Legal Form | Source | Data Available |
| --------------------------------------------------------- | -------------------------- | -------------------------------------------------------------------------------------- |
| **ООД** (LLC) | Partners list | Multiple shareholders with nominal capital held and share percentage |
| **ЕООД** (Single-Member LLC) | Sole owner | Single shareholder at 100%, holding the full registered capital (`nominalCapitalHeld`) |
| **ЕАД** (Single-Member Joint Stock) | Sole owner | Single shareholder at 100%, holding the full registered capital (`nominalCapitalHeld`) |
| **ЕТ** (Sole Trader) | — (no share capital) | Not applicable — no shareholders; the trader is returned under `legalRepresentatives` |
| **КД** (Limited Partnership) | General + limited partners | General partners (unlimited liability) and limited partners |
| **АД** (multi-shareholder Joint Stock) | - | Not available (individual shareholders not disclosed in Trade Register) |
| **ДЗЗД** (Civil-Law Partnership, BULSTAT) | Participants list | Partners with participation percentage where the register states it |
| **BULSTAT natural persons** (freelancers / self-employed) | — (no share capital) | Not applicable — no shareholders; the person is returned under `legalRepresentatives` |
| **Non-profits** (Сдружение, Фондация, читалище) | — (no share capital) | Not applicable — no shareholders; officers are returned under `legalRepresentatives` |
#### Ownership Fields
| Field | Description | Notes |
| -------------------- | --------------------- | ----------------------------------------------------------------- |
| `sharePercentage` | Ownership percentage | Each partner's share of the total holdings (see note below) |
| `nominalCapitalHeld` | Absolute capital held | Amount as filed in the register — partner holdings are in **BGN** |
Since Bulgaria's euro adoption (1 January 2026), the register reports the
company's **share capital in EUR** while partner holdings remain filed in
**BGN**. Ownership percentages are therefore derived from the **sum of the
partners' BGN holdings** (no currency conversion), so they always total 100%.
The held amounts (`nominalCapitalHeld`) are returned in their filed currency
(BGN); the company-level `capital` is the register's EUR figure. For a
single-member company (ЕООД), the sole owner holds the entire registered
capital, so their `nominalCapitalHeld` equals the company's registered capital
(the EUR figure). A sole trader (ЕТ) has no registered capital, so the field is
omitted.
Both individual and corporate shareholders are supported. Corporate
shareholders include the company's legal name, registration number (when
available), and country code. Foreign corporate shareholders are identified by
markers in the registry text.
### Activity Code Mapping
Bulgaria uses the **NKID (Национална класификация на икономическите дейности)** classification, which is Bulgaria's national transposition of the European NACE Rev. 2 standard.
```
NKID (Bulgarian) -> NACE Rev. 2 (European) -> ISIC Rev. 4 (International)
```
| Classification | Source | Example | AI Inferred? |
| -------------- | --------------------------------------------- | ------- | -------------------------------- |
| **NKID** | Open Data (official) | `6201` | No |
| **NACE** | Derived from NKID (identical structure) | `62.01` | No (formal mapping) |
| **ISIC** | Derived from NACE via UN correspondence table | `6201` | No (formal mapping) |
| **NACE** | AI-inferred from activity description | `62.01` | Yes (when Open Data unavailable) |
| **ISIC** | AI-inferred from activity description | `6201` | Yes (when Open Data unavailable) |
When Open Data provides a NKID code, the full NKID → NACE → ISIC chain is
**deterministic** (no AI). When only the live Trade Register API is available
(company not yet in Open Data), NACE and ISIC codes are **AI-inferred** from
the free-text activity description. Check the `isAIInferred` flag on each
activity code to distinguish.
## Data Availability
### Data Availability Matrix
| Data Type | Open Data (Pre-indexed) | Trade Register (Live) | Notes |
| -------------------------- | ----------------------- | --------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| Onboarding Profile | ✅ Fast | ✅ Fallback | Pre-indexed for sub-second response |
| Company Profile | ✅ | ✅ | Both sources contribute in parallel |
| Legal Representatives | ✅ | ✅ | Live for current data, Open Data for batch |
| Other Key Persons | ✅ | ✅ | Supervisory board, auditors, controllers |
| Shareholders | ✅ | ✅ | OOD/EOOD + single-member EAD; multi-shareholder AD not disclosed; not applicable for no-capital entities (ET, BULSTAT natural persons/non-profits) |
| Ultimate Beneficial Owners | ❌ | ✅ | Live-only (always fetched fresh); not applicable for BULSTAT-only entities |
| Activity Codes | ✅ | ❌ | NKID/NACE/ISIC from Open Data only |
| Activity Description | ❌ | ✅ | Free-text from live API only |
| VAT Validation (taxId) | - | ✅ (via VIES) | EU VAT verification with consultation number |
| Documents | - | ✅ | Trade Register Extract + conditional documents |
**Legend:** ✅ Available | ❌ Not Available
The matrix above describes Commercial-Register entities. **BULSTAT-only
entities** (civil-law partnerships, self-employed persons, foreign entities,
associations, foundations, cooperatives, institutions) are resolved from a
single live BULSTAT query — Open Data does not cover them. They return identity,
registered seat, activity, status, management, and (where applicable) ownership
participation, plus a Trade Register Extract. Ultimate beneficial owners are not
applicable for BULSTAT-only entities, and personal data is anonymised by the
register, so legal-representative and key-person street addresses are not
returned.
### Documents by Company Type
| Document Type | API Category | Format | Catalog item | Availability |
| --------------------------- | ----------------------- | ------ | ----------------------------- | --------------- |
| **Trade Register Extract** | `tradeRegisterExtract` | PDF | `bgr-register-extract` | ✅ All companies |
| **Articles of Association** | `articlesOfAssociation` | PDF | `bgr-articles-of-association` | Conditional |
| **Financial Statements** | `financialStatement` | PDF | `bgr-financial-statements` | Conditional |
The **Trade Register Extract** is always available for any registered company —
for a Commercial-Register entity it is an extract of the trade-register record,
and for a BULSTAT-only entity it is a printable extract of the BULSTAT detail
page. **Articles of Association** and **Financial Statements** are available only
when a Commercial-Register company has filed them with the registry (they are not
offered for BULSTAT-only entities). Additional document types (shareholder
meeting notices, transformation plans, insolvency documents) may be available
depending on the company's filing history.
The following additional documents may be available depending on the company's filing history:
| Category | Documents |
| ------------------------- | ------------------------------------------------------------------------------------------------------------------------- |
| **Financial** | Annual Financial Statement, Annual Activity Report, Management Board Report |
| **Corporate Actions** | New Share Subscription Invitation, Capital Increase Resolution, Shareholder Privileges Resolution, Share Buyback Proposal |
| **Official Publications** | Shareholders Meeting Notice, Bondholders Meeting Notice, Bond Loan Notice, Minority Shareholders Proposal |
| **Transformation** | Transformation Plan, Transformation Board Report |
| **Insolvency** | Accepted Claims List, Distribution Account Notice, Foreign Creditor Summons, Court Order on Accepted Claims |
| **Non-Profit** | NFPO Members Meeting Notice, NFPO Registration Changes |
## Example API Responses
All examples use **placeholder data**. Query: `POST /v2/company` with `{ "id": "123456789", "countryCode": "BG", "dataPoints": ["company", "legalRepresentatives"] }`
```json theme={null}
{
"company": {
"id": "123456789",
"countryCode": "BG",
"identifiers": { "uic": "123456789", "VAT": "123456789" },
"legalName": "ПРИМЕРНА КОМПАНИЯ ООД",
"legalNameInEnglish": "PRIMERNA KOMPANIYA",
"status": { "localName": "Вписана промяна", "active": true, "statusDetails": { "status": "ACTIVE" } },
"legalForm": { "localName": "Дружество с ограничена отговорност", "abbreviation": "ООД", "englishTranslation": "Limited Liability Company", "standardized": "Limited Liability Company", "iso20275Code": "VJ3G" },
"capital": { "amount": 51129.19, "currency": "EUR" },
"activityDescription": "Търговия на дребно с хранителни стоки, консултантска дейност",
"legalAddress": { "addressLine1": "бул. Витоша № 100", "city": "София", "postalCode": "1000", "countryCode": "BG" }
},
"legalRepresentatives": [
{ "type": "individual", "role": { "localName": "Управител", "englishTranslation": "Manager", "standardized": "Managing Director" }, "individual": { "name": { "fullName": "ИВАНОВ ПЕТЪР ГЕОРГИЕВ" } } }
],
"shareholders": [
{ "type": "individual", "sharePercentage": 60, "nominalCapitalHeld": { "amount": 60000, "currency": "BGN" }, "individual": { "name": { "fullName": "ИВАНОВ ПЕТЪР ГЕОРГИЕВ" } } },
{ "type": "company", "sharePercentage": 40, "nominalCapitalHeld": { "amount": 40000, "currency": "BGN" }, "company": { "legalName": "ПАРТНЬОР ХОЛДИНГ ГмбХ", "id": "FN524697", "countryCode": "AT" } }
]
}
```
```json theme={null}
{
"company": {
"id": "987654321",
"countryCode": "BG",
"identifiers": { "uic": "987654321", "VAT": "987654321" },
"legalName": "ТЕХНОЛОГИИ БЪЛГАРИЯ ЕООД",
"legalNameInEnglish": "TEHNOLOGII BULGARIA",
"status": { "localName": "Вписана промяна", "active": true, "statusDetails": { "status": "ACTIVE" } },
"legalForm": { "localName": "Еднолично дружество с ограничена отговорност", "abbreviation": "ЕООД", "englishTranslation": "Single-Member Limited Liability Company", "standardized": "Limited Liability Company", "iso20275Code": "WVIN" },
"capital": { "amount": 25564.59, "currency": "EUR" },
"legalAddress": { "addressLine1": "ул. Раковски № 50", "city": "Пловдив", "postalCode": "4000", "countryCode": "BG" }
},
"legalRepresentatives": [
{ "type": "individual", "role": { "localName": "Управител", "englishTranslation": "Manager", "standardized": "Managing Director" }, "individual": { "name": { "fullName": "ДИМИТРОВА МАРИЯ СТЕФАНОВА" } } }
],
"shareholders": [
{ "type": "company", "sharePercentage": 100, "nominalCapitalHeld": { "amount": 25564.59, "currency": "EUR" }, "company": { "legalName": "ПАРЕНТ КОРП С.А.Р.Л.", "id": "B145882", "countryCode": "LU" } }
]
}
```
```json theme={null}
{
"company": {
"id": "201234567",
"countryCode": "BG",
"identifiers": { "uic": "201234567" },
"legalName": "СЧЕТОВОДНА КЪЩА - ПЕТЪР ИВАНОВ ЕТ",
"legalNameInEnglish": "SCHETOVODNA KASHTA - PETAR IVANOV",
"status": { "localName": "Вписан", "active": true, "statusDetails": { "status": "ACTIVE" } },
"legalForm": { "localName": "Едноличен търговец", "abbreviation": "ЕТ", "englishTranslation": "Sole Trader", "standardized": "Sole Proprietorship", "iso20275Code": "946C" },
"activityDescription": "Счетоводни услуги, търговска и транспортна дейност",
"legalAddress": { "addressLine1": "ул. Хан Аспарух № 12", "city": "Пловдив", "postalCode": "4000", "countryCode": "BG" }
},
"legalRepresentatives": [
{ "type": "individual", "role": { "localName": "Едноличен търговец", "englishTranslation": "Sole Trader", "standardized": "Owner" }, "individual": { "name": { "fullName": "ПЕТЪР ГЕОРГИЕВ ИВАНОВ" } } }
]
}
```
**Note:** A sole trader (ЕТ) is a natural person trading under a business name, with no share capital. The `shareholders` datapoint is therefore **not applicable** — it returns a benign not-applicable response (at no charge) rather than a fabricated record. The trader is returned under `legalRepresentatives`, and, where a beneficial-ownership datapoint is requested, as the sole 100% beneficial owner.
```json theme={null}
{
"company": {
"id": "202345678",
"countryCode": "BG",
"identifiers": { "uic": "202345678" },
"legalName": "КАПИТАЛ ПАРТНЪРС - ИВАНОВ И СИЕ КД",
"status": { "localName": "Вписан", "active": true, "statusDetails": { "status": "ACTIVE" } },
"legalForm": { "localName": "Командитно дружество", "abbreviation": "КД", "englishTranslation": "Limited Partnership", "standardized": "Partnership", "iso20275Code": "S94S" },
"legalAddress": { "addressLine1": "бул. Христо Ботев № 79", "city": "София", "postalCode": "1303", "countryCode": "BG" }
},
"legalRepresentatives": [
{ "type": "individual", "role": { "localName": "Управител", "englishTranslation": "Manager", "standardized": "Managing Director" }, "individual": { "name": { "fullName": "ИВАНОВ ГЕОРГИ ПЕТРОВ" } } }
],
"shareholders": [
{ "type": "company", "company": { "legalName": "КАПИТАЛ ХОЛДИНГ ЕООД", "id": "175000001", "countryCode": "BG" } },
{ "type": "individual", "individual": { "name": { "fullName": "ФРАНЦ МЮЛЕР" } } }
]
}
```
**Note:** A limited partnership (КД) has at least one general partner (unlimited liability, listed first) and one or more limited partners (liability capped at their contribution). Partners can be individuals or companies, and either type can be foreign. КД partners are returned without a `sharePercentage`, because the register records partner roles rather than share amounts.
```json theme={null}
{
"company": {
"id": "111222333",
"countryCode": "BG",
"identifiers": { "uic": "111222333", "VAT": "111222333" },
"legalName": "ТЕЛЕКОМ БЪЛГАРИЯ ЕАД",
"status": { "localName": "Вписана промяна", "active": true, "statusDetails": { "status": "ACTIVE" } },
"legalForm": { "localName": "Еднолично акционерно дружество", "abbreviation": "ЕАД", "englishTranslation": "Single-Member Joint Stock Company", "standardized": "Corporation", "iso20275Code": "EJ06" },
"capital": { "amount": 766937.61, "currency": "EUR" },
"legalAddress": { "addressLine1": "бул. Цариградско шосе № 111", "city": "София", "postalCode": "1784", "countryCode": "BG" }
},
"legalRepresentatives": [
{ "type": "individual", "role": { "localName": "Изпълнителен директор", "englishTranslation": "Executive Director", "standardized": "Executive Director" }, "individual": { "name": { "fullName": "ГЕОРГИЕВ АЛЕКСАНДЪР НИКОЛАЕВ" } } }
],
"otherKeyPersons": [
{ "type": "individual", "role": { "localName": "Член на Съвета на директорите", "englishTranslation": "Board of Directors Member", "standardized": "Board Member" }, "individual": { "name": { "fullName": "СТОЯНОВА ЕЛЕНА ПЕТРОВА" } } },
{ "type": "individual", "role": { "localName": "Член на Съвета на директорите", "englishTranslation": "Board of Directors Member", "standardized": "Board Member" }, "individual": { "name": { "fullName": "ПЕТКОВ МАРТИН АНГЕЛОВ" } } }
],
"shareholders": [
{ "type": "company", "sharePercentage": 100, "nominalCapitalHeld": { "amount": 766937.61, "currency": "EUR" }, "company": { "legalName": "ХОЛДИНГ ГРУП АД", "id": "831000001", "countryCode": "BG" } }
]
}
```
**Note:** A single-member joint-stock company (ЕАД) discloses its sole owner, returned in `shareholders` at 100% with the full registered capital. Multi-shareholder AD companies do not disclose individual shareholders. Board members are returned in `otherKeyPersons`. This example shows a one-tier **Board of Directors** (Съвет на директорите); two-tier companies instead have a **Management Board** (Управителен съвет) plus a **Supervisory Board** (Надзорен съвет). A board member who also represents the company (the Executive Director above) is returned once, under `legalRepresentatives`.
```json theme={null}
{
"company": {
"id": "444555666",
"countryCode": "BG",
"identifiers": { "uic": "444555666", "VAT": "444555666" },
"legalName": "СТАРА ФИРМА ООД - в ликвидация",
"status": { "localName": "В ликвидация", "active": false, "statusDetails": { "status": "CLOSED", "closureReason": "LIQUIDATION" } },
"legalForm": { "localName": "Дружество с ограничена отговорност", "abbreviation": "ООД", "englishTranslation": "Limited Liability Company", "standardized": "Limited Liability Company", "iso20275Code": "VJ3G" },
"legalAddress": { "addressLine1": "ул. Шипка № 25", "city": "Варна", "postalCode": "9000", "countryCode": "BG" }
},
"legalRepresentatives": [
{ "type": "individual", "role": { "localName": "Ликвидатор", "englishTranslation": "Liquidator", "standardized": "Liquidator" }, "individual": { "name": { "fullName": "НИКОЛОВ ДИМИТЪР ИВАНОВ" } } }
]
}
```
**Note:** Companies in liquidation have a Ликвидатор (Liquidator) as legal representative instead of the regular Управител (Manager). The company name itself contains "в ликвидация" (in liquidation).
Query: `POST /v2/company` with `{ "id": "123456789", "countryCode": "BG", "dataPoints": ["ultimateBeneficialOwners"] }`
```json theme={null}
{
"ultimateBeneficialOwners": [
{ "name": { "fullName": "ИВАНОВ ПЕТЪР ГЕОРГИЕВ" } },
{ "name": { "fullName": "ДИМИТРОВА МАРИЯ СТЕФАНОВА" } }
]
}
```
**Note:** UBO data is fetched live from the Commercial Register beneficial-ownership declarations. Not all companies have UBO filings, so the field may be absent if no declaration has been filed. Beneficial ownership is a Commercial-Register concept: for entities held only in the BULSTAT register (civil-law partnerships, self-employed persons, foreign entities, associations, and foundations) the `ultimateBeneficialOwners` datapoint returns a benign not-applicable response (at no charge) — a self-employed person is never synthesised as their own beneficial owner. A sole trader (ЕТ), by contrast, is a Commercial-Register entity whose trader is legitimately returned as the sole 100% beneficial owner.
Query: `POST /v2/company` with `{ "id": "123456789", "countryCode": "BG", "dataPoints": ["availableDocuments"] }`
```json theme={null}
{
"documents": {
"tradeRegisterExtract": {
"id": "bgr-register-extract-123456789",
"name": "Trade Register Extract",
"format": "pdf",
"price": 200
},
"articlesOfAssociation": {
"id": "bgr-articles-123456789",
"name": "Articles of Association",
"format": "pdf",
"price": 200
},
"financialStatements": [
{
"id": "bgr-fs-123456789-2024",
"name": "Annual Financial Statement 2024",
"format": "pdf",
"price": 200,
"year": 2024
},
{
"id": "bgr-fs-123456789-2023",
"name": "Annual Financial Statement 2023",
"format": "pdf",
"price": 200,
"year": 2023
}
]
}
}
```
**Note:** The Trade Register Extract is always available. Articles of Association and Financial Statements are conditional, only listed when the company has filed them with the registry.
Query: `POST /v2/company` with `{ "id": "175883961", "countryCode": "BG", "dataPoints": ["company", "legalRepresentatives", "shareholders"] }`
```json theme={null}
{
"company": {
"id": "175883961",
"countryCode": "BG",
"identifiers": { "uic": "175883961" },
"legalName": "ДЗЗД ОБЕДИНЕНИЕ ПЪТИЩА",
"legalForm": { "localName": "Дружество по ЗЗД (ДЗЗД)", "englishTranslation": "Civil-Law Partnership (Consortium)", "standardized": "Partnership", "iso20275Code": "TCGV" },
"status": { "localName": "Действащ", "active": true, "statusDetails": { "status": "ACTIVE" } },
"legalAddress": { "addressLine1": "гр. София, ул. Оборище № 5", "city": "София", "countryCode": "BG" },
"activityDescription": "Строителство на пътища и магистрали"
},
"legalRepresentatives": [
{ "type": "individual", "role": { "localName": "Представляващ", "englishTranslation": "Representative", "standardized": "Authorized Signatory" }, "individual": { "name": { "fullName": "ГЕОРГИЕВ ИВАН ПЕТРОВ" } } }
],
"shareholders": [
{ "type": "company", "sharePercentage": 50, "company": { "legalName": "ПЪТСТРОЙ ЕООД", "id": "131234567" } },
{ "type": "company", "sharePercentage": 50, "company": { "legalName": "МАГИСТРАЛИ АД", "id": "121987654" } }
]
}
```
**Note:** A civil-law partnership (ДЗЗД) is held only in the BULSTAT register — it is resolved automatically when the UIC is not a Commercial-Register trader. Unlike sole traders and self-employed persons, a ДЗЗД has participating members, so `shareholders` returns them (with participation percentage where the register states it). Note there is no `VAT` identifier: it is only added when a VIES check confirms the entity is VAT-registered. Identifiers, values, and names above are illustrative.
Query: `POST /v2/company` with `{ "id": "1122334455", "countryCode": "BG", "dataPoints": ["company", "legalRepresentatives", "shareholders", "ultimateBeneficialOwners"] }`
```json theme={null}
{
"company": {
"id": "1122334455",
"countryCode": "BG",
"identifiers": { "uic": "1122334455" },
"legalName": "МАРИЯ ИВАНОВА ДИМИТРОВА",
"legalForm": { "localName": "Физическо лице", "englishTranslation": "Natural person (self-employed)", "standardized": "Sole Proprietorship" },
"status": { "localName": "Действащ", "active": true, "statusDetails": { "status": "ACTIVE" } },
"legalAddress": { "addressLine1": "гр. Пловдив", "city": "Пловдив", "countryCode": "BG" },
"activityDescription": "Адвокатска дейност"
},
"legalRepresentatives": [
{ "type": "individual", "individual": { "name": { "fullName": "МАРИЯ ИВАНОВА ДИМИТРОВА" } } }
],
"shareholders": { "status": "not_applicable" },
"ultimateBeneficialOwners": { "status": "not_applicable" }
}
```
**Note:** A self-employed natural person (freelancer / free-profession practitioner) is held only in BULSTAT and is **not** a sole trader (ЕТ) — sole traders live in the Commercial Register. Both standardize as `Sole Proprietorship`; they are distinguished by the local name (`Физическо лице` vs `Едноличен търговец`) and the register of origin. The person has no share capital, so both `shareholders` and `ultimateBeneficialOwners` return a benign not-applicable response (at no charge) rather than a fabricated record. There is no `VAT` identifier or `taxId` unless a VIES check confirms VAT registration. BULSTAT anonymises personal data, so only the register-public correspondence locality is returned, not a full street address. Identifiers, values, and names above are illustrative.