Slovakia Company Search API and MCP — Obchodný register by Name
Send the beginning of a business name and this source returns the matching entries in the Slovak Commercial Register (Obchodný register SR): the registered name, a link to the registry extract and the register's own ids for each entry.
- You send
- A company name, or the start of one
- You get back
- Business name and a link to the registry extract, with the register's internal ids
- Coverage
- Slovakia — entities on Obchodný register SR.
- 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 |
|---|---|---|---|
| Obchodný register SR directly | Type the name into Obchodný register SR 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 Slovakia — 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 "sk_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. 29 in the sample. |
machine.page_count | number | Number of result pages read. |
machine.first_item.name | string | Business name as registered, including the legal form (a.s., s.r.o.). |
machine.first_item.url | string | Link to the registry extract for this entry. |
machine.first_item.orsr_id | number | The register's internal id for the entry. |
machine.first_item.court_id | number | Id of the registry court section the entry belongs to. |
machine.first_item.registration_number | string | Empty string in the sample: the search listing does not include the IČO. |
machine.first_item.status | null | Not given in search results. |
machine.first_item.address | null | Not given in search results. |
machine.first_item.company_type | 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": "sk_companies_search",
"keyword": "slovnaft",
"max_items": 2,
"start_page": 1,
"partial": false,
"human": "# Slovakia — Commercial Register — company search\n\n- **Keyword:** slovnaft\n- **Results:** 2 of 29 found\n- **Proxy traffic:** 24.0 KB",
"machine": {
"total_items": 2,
"first_item": {
"registration_number": "",
"name": "SLOVNAFT BENZINOL, a.s.",
"status": null,
"address": null,
"url": "https://www.orsr.sk/vypis.asp?ID=21040&SID=2&P=0",
"company_type": null,
"incorporation_date": null,
"orsr_id": 21040,
"court_id": 2
},
"items": [
{
"registration_number": "",
"name": "SLOVNAFT BENZINOL, a.s.",
"status": null,
"address": null,
"url": "https://www.orsr.sk/vypis.asp?ID=21040&SID=2&P=0",
"company_type": null,
"incorporation_date": null,
"orsr_id": 21040,
"court_id": 2
},
{
"registration_number": "",
"name": "SLOVNAFT DEOS a.s.",
"status": null,
"address": null,
"url": "https://www.orsr.sk/vypis.asp?ID=19771&SID=2&P=0",
"company_type": null,
"incorporation_date": null,
"orsr_id": 19771,
"court_id": 2
}
],
"total_found": 29,
"page_count": 1,
"blocked": false,
"proxy_traffic_bytes": 24566
},
"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-sk-companies-search \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"keyword":"slovnaft","max_items":2}'What teams use it for
Where this field shows up in an actual workflow.
Resolve a name like "slovnaft" to the exact entry, then pass it on for the full extract.
See every register entry that starts with a name before you assume there is only one.
Turn a company name from an invoice or a CRM into a register link you can check.
Coverage, freshness and limits
What this source covers, how fresh it is, and where it stops.
Slovakia — entities on Obchodný register SR.
Read at request time, so the answer reflects the register as it stands when you ask.
Obchodný register SR is a public register. Every response carries the source URL it was read from and a session id you can trace.
- —Matches the beginning of the business name, so a word from the middle of a name will not find it.
- —Search results carry no IČO, status or address in the sample. Open the company source for those.
Questions, answered
This source searches by business name. If you already have the IČO, use the Slovakia company source, which takes it directly.
Related sources
Try slovakia company search on your own data
One request format across every source in the catalog.