Bulgaria Company Search API and MCP — Commercial Register by Name or UIC
Send a company name or a UIC (ЕИК) and this source returns the matching entries in the Bulgarian Commercial Register: the name, the UIC, the legal form and a link to the registry card.
- You send
- A company name or a UIC (ЕИК)
- You get back
- Name, UIC, legal form and a link to the registry card
- Coverage
- Bulgaria — entities on Commercial Register.
- Price
- 1 point per returned record — $1 per 1,000
- Billed per record actually returned, capped by max_items. A request that returns nothing costs nothing.
Ways to get this data
Three approaches teams use today, and where each one runs into trouble.
| Approach | What it takes | Cost | Trade-off |
|---|---|---|---|
| Commercial Register directly | Type the name into Commercial Register and read the results | Usually free, sometimes per-document | A different interface, language and data shape for every country you add |
| Collecting it yourself | Build and host a crawler per register, then keep each one alive | Infrastructure and maintenance | Registers change their pages without warning, and nobody is on the hook when yours breaks |
| NeuralVerge | One request, the same shape as every other source in the catalog | $1 per 1,000, misses not billed | Covers Bulgaria — other countries are separate sources with the same request format |
What you get back
Every field in the example response below.
| Field | Type | Description |
|---|---|---|
session_id | string | Id of this run, for tracing. |
kind | string | Run type, for example "bg_companies_search". |
human | string | Readable summary of the result, in Markdown. |
machine | object | The structured result. Everything below lives inside it. |
total_points | number | Points charged for this run. |
machine.total_items | number | Number of records returned in this response. |
machine.first_item | object | The first match, repeated from items for quick access. |
machine.items | array | The matches in order. Each one has the fields listed under first_item. |
machine.total_found | number | null | Total matches the register reported, when it says. Null in the sample. |
machine.page_count | number | Number of result pages read. |
machine.first_item.registration_number | string | The company's UIC (ЕИК). |
machine.first_item.name | string | Company name in Cyrillic. |
machine.first_item.full_name | string | Name with the legal form, for example "СОФАРМА" АД. |
machine.first_item.company_type | string | Legal form abbreviation, for example АД (joint-stock company). |
machine.first_item.url | string | Link to the registry card. |
machine.first_item.status | null | Not given in search results. |
machine.first_item.address | null | Not given in search results. |
machine.first_item.incorporation_date | null | Not given in search results. |
machine.blocked | boolean | Whether the register refused the read. false in the sample. |
machine.proxy_traffic_bytes | number | Size of the data transferred for this run, in bytes. |
Example response
A real response, as returned.
{
"session_id": "11111111-1111-1111-1111-111111111111",
"kind": "bg_companies_search",
"keyword": "sopharma",
"max_items": 2,
"start_page": 1,
"partial": false,
"human": "# Bulgaria — Commercial Register — company search\n\n- **Keyword:** sopharma\n- **Results:** 2\n- **Proxy traffic:** 1.2 KB",
"machine": {
"total_items": 2,
"first_item": {
"registration_number": "831902088",
"name": "СОФАРМА",
"status": null,
"address": null,
"url": "https://portal.registryagency.bg/CR/en/Reports/ActiveConditionTabResult?uic=831902088",
"company_type": "АД",
"incorporation_date": null,
"full_name": "\"СОФАРМА\" АД"
},
"items": [
{
"registration_number": "831902088",
"name": "СОФАРМА",
"status": null,
"address": null,
"url": "https://portal.registryagency.bg/CR/en/Reports/ActiveConditionTabResult?uic=831902088",
"company_type": "АД",
"incorporation_date": null,
"full_name": "\"СОФАРМА\" АД"
},
{
"registration_number": "175346309",
"name": "СОФАРМА БИЛДИНГС",
"status": null,
"address": null,
"url": "https://portal.registryagency.bg/CR/en/Reports/ActiveConditionTabResult?uic=175346309",
"company_type": "АДСИЦ",
"incorporation_date": null,
"full_name": "\"СОФАРМА БИЛДИНГС\" АДСИЦ"
}
],
"total_found": null,
"page_count": 1,
"blocked": false,
"proxy_traffic_bytes": 1199
},
"total_points": 2
}How to run it
The same lookup works from the app, the API, or as a tool an agent can call mid-task.
Results come back in the same envelope as every other source: a session id, a readable summary, the structured result and the points charged.
curl -X POST https://api.neuralverge.ai/functions/v1/run-bg-companies-search \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"keyword":"sopharma","max_items":2}'What teams use it for
Where this field shows up in an actual workflow.
Turn a company name into the identifier used for the full lookup.
See group companies that share a name stem, such as a parent and its property arm.
Attach UICs and legal forms to company names.
Coverage, freshness and limits
What this source covers, how fresh it is, and where it stops.
Bulgaria — entities on Commercial Register.
Read at request time, so the answer reflects the register as it stands when you ask.
Commercial Register is a public register. Every response carries the source URL it was read from and a session id you can trace.
- —Status, address and registration date are not in search results. The company source returns them.
- —Names are in Cyrillic, so search with the registered spelling where you can.
- —total_found is null in the sample, so the register did not report a total.
Questions, answered
Yes. The register search takes a company name or a UIC. For a full record by UIC, use the Bulgaria company source.
Related sources
Try bulgaria company search on your own data
One request format across every source in the catalog.