DocumentationAPI Reference
General reference · eKYB Reference / eKYB Verification Coverage

Bulgaria

Bulgaria eKYB validates the legitimacy of Bulgarian businesses by checking their tax ID (UIC/EIK number), business name, address, UBOs, and directors against Bulgaria's government database.

Source

Country Source Description
Bulgaria Bulgarian government database Verifies submitted business details against records maintained in the government database.

Direct API approach

For general integration notes and shared response semantics, see the eKYB API Reference.

Request parameters

Parameter Required Description
plugins Mandatory Array. Must be ["ekyb"].
country Mandatory String. Two-letter Alpha-2 country code. Must be BG.
taxId Mandatory String. Bulgarian UIC/EIK number. Accepted formats: 9 digits (e.g. 123456789), or BG + 9 digits (VAT format, e.g. BG123456789). The BG prefix is stripped automatically before processing.
businessName Optional String. Registered name of the business.
street Optional String. Street name of the business.
houseNo Optional String. Building or house number.
addressLine2 Optional String. Second line of the business address.
city Optional String. City in the business address.
state Optional String. State or region in the business address.
postalCode Optional String. 4-digit Bulgarian postal code (e.g. 1000).
uboNames Optional Array. Full legal names of Unique Beneficial Owners to check against records associated with the UIC/EIK.
directors Optional Array. Full legal names of directors to check against records associated with the UIC/EIK.

The country parameter limits business validation to the specified region. Only businesses established in the country specified in the eKYB request are validated.

Sample request

{
  "plugins": ["ekyb"],
  "country": "BG",
  "taxId": "123456789",
  "businessName": "EXAMPLE BULGARIA OOD",
  "street": "VITOSHA BLVD",
  "houseNo": "10",
  "city": "SOFIA",
  "postalCode": "1000",
  "uboNames": ["MARIA GEORGIEVA"],
  "directors": ["IVAN PETROV IVANOV"]
}

Sample response

{
  "kyb": [
    { "key": "name", "sub_label": "Verified" },
    { "key": "tin", "sub_label": "Verified" },
    { "key": "address_verification", "sub_label": "Approximate Match" },
    { "key": "cityMatch", "sub_label": "Verified" },
    { "key": "postalCodeMatch", "sub_label": "Verified" },
    { "key": "registrationStatus", "sub_label": "Active" },
    {
      "key": "entityType",
      "entityType": { "entityType": "Private limited with Share Capital" }
    },
    { "key": "ubo_name_match", "sub_label": "Verified", "uboName_input": "Maria Georgieva" },
    { "key": "ubo_name_match", "sub_label": "Unverified", "uboName_input": "Sarah Smith" },
    { "key": "directors_name_match", "sub_label": "Verified", "directorsName_input": "Ivan Petrov Ivanov" },
    { "key": "directors_name_match", "sub_label": "Unverified", "directorsName_input": "Sarah Schrader" }
  ]
}

Response fields

Key Status Description
name Verified, Approximate Match, Unverified Submitted business name against the business name associated with the UIC/EIK.
tin Verified, Unverified Submitted UIC/EIK number against the government database.
address_verification Verified, Approximate Match, Unverified Submitted address against the address associated with the UIC/EIK.
cityMatch Verified, Approximate Match, Unverified Submitted city against the city associated with the UIC/EIK.
postalCodeMatch Verified, Unverified Submitted postal code against the postal code associated with the UIC/EIK. Always 4 digits for Bulgaria.
registrationStatus Active, Inactive, Unknown Registration status of the business in the government database. See Registration status values for definitions.
entityType Legal entity type of the business The legal entity type of the company, if available (e.g. Private limited with Share Capital, Limited liability company with one shareholder only). If not available, displays Unknown.
ubo_name_match Verified, Approximate Match, Unverified Submitted UBO against UBOs associated with the UIC/EIK. Distinguished by the uboName_input field on each entry.
directors_name_match Verified, Approximate Match, Unverified Submitted director against directors associated with the UIC/EIK. Distinguished by the directorsName_input field on each entry.

Registration status values

Status Description
Active The business registration is active.
Inactive The business registration is suspended, inactive, or the business no longer exists.
Unknown Registration status is not available.

Approximate Match

Approximate Match is generated through Incode's proprietary fuzzy matching algorithm. It is returned when the submitted string is similar to, but not an exact match for, the value stored in the government database. This accounts for misspellings, typographical errors, and slight variations in input data.

Error responses

See the eKYB API Reference for standard error responses.

Single Session Dashboard results

View eKYB results on the Business tab in single Session view.

Was this page helpful?