# Slovakia RPVS Beneficial Owners (UBO) Scraper (`regdata/slovakia-rpvs-ubo-scraper`) Actor

Search Slovakia's public beneficial-ownership register (RPVS) by IČO or company name. Returns beneficial owners with a public-official (PEP) flag, plus the authorised person. No API key.

- **URL**: https://apify.com/regdata/slovakia-rpvs-ubo-scraper.md
- **Developed by:** [getregdata](https://apify.com/regdata) (community)
- **Categories:** Lead generation, Automation, Integrations
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $5.00 / 1,000 partner records

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).


# README

## Slovakia RPVS Beneficial Owners (UBO) Scraper

Search Slovakia's **public beneficial-ownership register** - the **RPVS (Register partnerov verejného sektora)** - by **IČO or company name** and get clean, structured JSON: the company identity plus its **beneficial owners** (konečný užívateľ výhod), each flagged with a **public-official (PEP) indicator**, and the **authorised person** who filed and verifies the entry. No API key.

Slovakia's RPVS is one of only **two genuinely public beneficial-ownership registers in the EU** (the other is Poland's CRBR). Every company that takes public money - contracts, subsidies, licences - must disclose its ultimate beneficial owners here. That makes it a high-value, low-noise source for **KYC / KYB, UBO discovery, PEP screening and counterparty due diligence**.

### Why this actor

The register publishes an official open-data API, but the raw OData feed splits each partner across several entities (identity, owners, authorised person) and buries beneficial owners behind a navigation expansion. This actor does the joining for you: send an IČO or a name, get one tidy record per partner with its **full beneficial-owner list, PEP flags, and validity dates** already resolved.

### No key, no setup

Reads the official public open-data API directly. **No API key, no CAPTCHA, no proxy.** Just send an IČO or a company name.

### Pairs with our UBO & debtor actors (the source→screen flow)

This actor **sources the ultimate beneficial owners**. Chain it with a **debtor / insolvency screen** on those same people and companies:

- **[Poland CRBR Beneficial Owners](https://apify.com/regdata/crbr-beneficial-owners-scraper)** - the same public-UBO register for Poland (RPVS is its Slovak twin).
- **[Poland KRZ Debtor Registry](https://apify.com/regdata/krz-debtor-scraper)** / **[Germany Insolvency Register](https://apify.com/regdata/germany-insolvency-scraper)** - screen the owners you surface here for bankruptcy and insolvency.

Source the beneficial owners, then check them. That is the KYC/AML pattern the whole suite is built around.

### Quick Start

Look up a company's beneficial owners by IČO:

```json
{
  "searchMode": "byIco",
  "icoNumbers": ["35763469"]
}
````

Search by company name (contains-match):

```json
{
  "searchMode": "byName",
  "searchQuery": "Telekom"
}
```

Screen several companies at once, keeping only currently-valid entries:

```json
{
  "searchMode": "byIco",
  "icoNumbers": ["35763469", "31322832", "31333532"],
  "currentOnly": true
}
```

### Input

| Field | Type | Description |
|------|------|-------------|
| `searchMode` | string | `byIco` (default) or `byName`. |
| `icoNumbers` | array | One or more Slovak IČO registration numbers (used in `byIco` mode). |
| `searchQuery` | string | Company name, contains-match (used in `byName` mode). |
| `exactMatch` | boolean | `byName`: match the name exactly instead of contains. Default `false`. |
| `currentOnly` | boolean | Keep only currently-valid owners/identities (drop historical). Default `false`. |
| `maxResults` | integer | Max partner records to export across all queries. Default `50`. |

### Output

One dataset item per public-sector partner:

```json
{
  "registerNumber": 7049,
  "partnerName": "Slovak Telekom, a.s.",
  "ico": "35763469",
  "legalForm": "PravnickaOsoba",
  "partnerType": "company",
  "isCurrentlyRegistered": true,
  "validFrom": "2017-02-01T00:00:00+01:00",
  "validTo": null,
  "beneficialOwners": [
    {
      "firstName": "Timotheus", "lastName": "Höttges",
      "fullName": "Timotheus Höttges", "type": "person",
      "ico": null, "dateOfBirth": null,
      "isPublicOfficial": false,
      "validFrom": "2017-02-01T00:00:00+01:00", "validTo": null, "isCurrent": true
    }
  ],
  "beneficialOwnerCount": 20,
  "hasPublicOfficial": false,
  "authorizedPersons": [
    { "name": "Malata, Pružinský, Hegedüš & Partners s. r. o.", "type": "company", "ico": "47239915" }
  ],
  "matchedQuery": "35763469",
  "jurisdiction": "SK",
  "source": "RPVS - Register partnerov verejného sektora (Ministerstvo spravodlivosti SR)",
  "sourceUrl": "https://rpvs.gov.sk/",
  "retrievedAt": "2026-07-02T00:00:00.000Z"
}
```

`beneficialOwners` is an array (a company usually has several). `isPublicOfficial` per owner and `hasPublicOfficial` at the partner level are the register's own public-official flag - a first-pass PEP signal. Date of birth is redacted (`null`) in the public open-data feed.

### Common use cases

- **KYC / KYB & UBO discovery** - resolve the ultimate beneficial owners behind a Slovak counterparty.
- **PEP screening** - the `isPublicOfficial` flag surfaces owners the register itself marks as public officials.
- **AML source→screen** - feed the owners you find here into an insolvency / debtor / sanctions check.
- **Procurement & public-money due diligence** - see who ultimately benefits from a public-sector partner.

### Data source & compliance

- **Source:** the official **RPVS open-data API** (`rpvs.gov.sk`), maintained by the Ministry of Justice of the Slovak Republic. Every record is stamped with its source URL and retrieval timestamp.
- **Public records.** The RPVS is a public register open to anyone; this actor reads the official open-data feed and logs in to nothing.
- **Query-driven** - it looks up the IČOs / names you ask for, not a bulk copy of the register.
- Date of birth and other protected personal data are already redacted by the register in the public feed. Use the data lawfully (KYC/AML, due diligence, B2B) and gently.

### Notes

- A partner's beneficial owners and identity can change over time; historical entries are included by default (set `currentOnly: true` to keep only valid ones), each with `validFrom` / `validTo`.

# Actor input Schema

## `searchMode` (type: `string`):

Look up by Slovak company registration number (IČO), or search by company name.

## `icoNumbers` (type: `array`):

One or more Slovak IČO registration numbers (e.g. "35763469"). Used when search mode is "By IČO".

## `searchQuery` (type: `string`):

Company name to search (contains-match on the partner's registered name). Used when search mode is "By company name".

## `exactMatch` (type: `boolean`):

Off (default): contains-search. On: match the company name exactly.

## `currentOnly` (type: `boolean`):

Off (default): include historical beneficial owners and identities. On: keep only currently-valid entries.

## `maxResults` (type: `integer`):

Maximum partner records to export across all queries.

## Actor input object example

```json
{
  "searchMode": "byIco",
  "icoNumbers": [
    "35763469"
  ],
  "exactMatch": false,
  "currentOnly": false,
  "maxResults": 50
}
```

# Actor output Schema

## `partners` (type: `string`):

Partner records with beneficial owners in the default dataset.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "icoNumbers": [
        "35763469"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("regdata/slovakia-rpvs-ubo-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "icoNumbers": ["35763469"] }

# Run the Actor and wait for it to finish
run = client.actor("regdata/slovakia-rpvs-ubo-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "icoNumbers": [
    "35763469"
  ]
}' |
apify call regdata/slovakia-rpvs-ubo-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=regdata/slovakia-rpvs-ubo-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Slovakia RPVS Beneficial Owners (UBO) Scraper",
        "description": "Search Slovakia's public beneficial-ownership register (RPVS) by IČO or company name. Returns beneficial owners with a public-official (PEP) flag, plus the authorised person. No API key.",
        "version": "1.0",
        "x-build-id": "My7jcKt5slljUWUV1"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/regdata~slovakia-rpvs-ubo-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-regdata-slovakia-rpvs-ubo-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/regdata~slovakia-rpvs-ubo-scraper/runs": {
            "post": {
                "operationId": "runs-sync-regdata-slovakia-rpvs-ubo-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/regdata~slovakia-rpvs-ubo-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-regdata-slovakia-rpvs-ubo-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "properties": {
                    "searchMode": {
                        "title": "Search mode",
                        "enum": [
                            "byIco",
                            "byName"
                        ],
                        "type": "string",
                        "description": "Look up by Slovak company registration number (IČO), or search by company name.",
                        "default": "byIco"
                    },
                    "icoNumbers": {
                        "title": "IČO numbers",
                        "type": "array",
                        "description": "One or more Slovak IČO registration numbers (e.g. \"35763469\"). Used when search mode is \"By IČO\".",
                        "items": {
                            "type": "string"
                        }
                    },
                    "searchQuery": {
                        "title": "Company name",
                        "type": "string",
                        "description": "Company name to search (contains-match on the partner's registered name). Used when search mode is \"By company name\"."
                    },
                    "exactMatch": {
                        "title": "Exact name match",
                        "type": "boolean",
                        "description": "Off (default): contains-search. On: match the company name exactly.",
                        "default": false
                    },
                    "currentOnly": {
                        "title": "Current entries only",
                        "type": "boolean",
                        "description": "Off (default): include historical beneficial owners and identities. On: keep only currently-valid entries.",
                        "default": false
                    },
                    "maxResults": {
                        "title": "Max results",
                        "minimum": 1,
                        "type": "integer",
                        "description": "Maximum partner records to export across all queries.",
                        "default": 50
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```