---
type: "firecrawl-provider"
description: "Slovak Ministry of Justice Register of Public Sector Partners: every company that contracts with the Slovak public sector, its company identity versions and dated beneficial-owner history, from the open-data OData v4 API."
use_when: "Slovak Ministry of Justice Register of Public Sector Partners: every company that contracts with the Slovak public sector, its company identity versions and dated beneficial-owner history, from the open-data OData v4 API."
categories: "Public records"
capabilities: 5
credits_per_call: 5
---
# RPVS (Slovak Register of Public Sector Partners) on Firecrawl Alexandria

Slovak Ministry of Justice Register of Public Sector Partners: every company that contracts with the Slovak public sector, its company identity versions and dated beneficial-owner history, from the open-data OData v4 API.

- Categories: Public records
- Category index: [Public records category](https://firecrawl.dev/alexandria/agents/categories/public-records)
- Provider key: `rpvs-gov-sk`
- Access: Firecrawl credits
- Cost: 5 credits per call

## More

- [Human guide](https://firecrawl.dev/app/alexandria/rpvs-gov-sk)
- [OpenAPI spec](https://firecrawl.dev/alexandria/agents/providers/rpvs-gov-sk/openapi.json)

## Capabilities

- [Records changes](https://firecrawl.dev/alexandria/agents/providers/rpvs-gov-sk/beneficial-owners/records_changes): Date-based changes, built on the register's own validity dates (not a publisher delta log). `stream` `owners`: `KonecniUzivateliaVyhod?$filter=PlatnostOd ge <since> or PlatnostDo ge <since>` with partner, nationality and residence country expanded; `stream` `deregistrations`: `Partneri?$filter=Vymaz/Datum ge <since>`. Pages of 20 rows, up to `max_pages` per call; `since` is interpreted at 00:00 UTC.
- [Records get](https://firecrawl.dev/alexandria/agents/providers/rpvs-gov-sk/beneficial-owners/records_get): One partner by its OData `partner_id` (`Partneri(<Id>)`) or by company registration number `ico` (`PartneriVerejnehoSektora?$filter=Ico eq '<ico>'`, then the partner). Owners come from `KonecniUzivateliaVyhod?$filter=Partner/Id eq <Id>` with `Adresa($expand=Stat)` so `country_of_residence` is filled; all pages are followed.
- [Records list](https://firecrawl.dev/alexandria/agents/providers/rpvs-gov-sk/beneficial-owners/records_list): The full current list of partners (`Partneri`) with company identity versions and the complete beneficial-owner history, 20 partners per upstream page, up to `max_pages` pages per call. The cursor pins the pass to `$filter=Id le <max partner Id at start>` and the row count of that set; every call re-reads that `$count` and fails with `upstream_error` `publication_changed` if the pinned set changed. Segment by partner Id with `id_from`/`id_to` to run a pass in parallel. About 2,700 pages for the whole register.
- [Search](https://firecrawl.dev/alexandria/agents/providers/rpvs-gov-sk/beneficial-owners/search): Partner name search over `PartneriVerejnehoSektora/ObchodneMeno` (`contains(tolower(ObchodneMeno),'<query>')`, case-insensitive); an all-digit query is matched as an exact ICO instead. Each hit is one company identity version with its partner Id. Pages of 20 hits.
- [Source status](https://firecrawl.dev/alexandria/agents/providers/rpvs-gov-sk/beneficial-owners/source_status): Cheap version check of the register: `$count` and the highest `Id` of the Partneri, PartneriVerejnehoSektora and KonecniUzivateliaVyhod entity sets (six small requests). The publisher exposes no ETag, Last-Modified, release date or hash, so `publication_id` is the Partneri pin `partneri:le<max Id>:n<count>` and `content_hash` is null.

## 1. Choose this provider when

Slovak Ministry of Justice Register of Public Sector Partners: every company that contracts with the Slovak public sector, its company identity versions and dated beneficial-owner history, from the open-data OData v4 API.

## 2. Minimal request

Call `POST https://api.firecrawl.dev/v2/scrape` with `{ alexandria: { provider, capability, options } }`. For a batch, send `{ alexandria: [...] }` with up to 10 calls.

```json
{
  "provider": "rpvs-gov-sk",
  "capability": "beneficial-owners/records_changes",
  "options": {
    "max_pages": 1,
    "since": "2026-10-15"
  }
}
```

## 3. Add provider options

Use only the options needed for the task:

- `cursor` (string): `next_cursor` from the previous page (the upstream `$skiptoken` Id). Pattern: ^[0-9]+$. Example: `next_cursor`
- `include_birth_date` (boolean): Also return the full `birth_date` (personal data). Off by default: only `birth_month_year` is returned. Example: `false`
- `max_pages` (number): max_pages Example: `5`
- `since` (string, required): Inclusive start date, YYYY-MM-DD. Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. Example: `<since>`
- `stream` (string): stream Example: `owners`

## 4. Request through your preferred interface

### JavaScript

```javascript
const result = await firecrawl.scrape({
  alexandria: {
    provider: "rpvs-gov-sk",
    capability: "beneficial-owners/records_changes",
    options: {
      max_pages: 1,
      since: "2026-10-15",
    },
  },
});
```

### Python

```python
result = firecrawl.scrape_alexandria({
  "provider": "rpvs-gov-sk",
  "capability": "beneficial-owners/records_changes",
  "options": {
    "max_pages": 1,
    "since": "2026-10-15"
  }
})
```

### cURL

```sh
curl https://api.firecrawl.dev/v2/scrape \
  -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "alexandria": {
    "provider": "rpvs-gov-sk",
    "capability": "beneficial-owners/records_changes",
    "options": {
      "max_pages": 1,
      "since": "2026-10-15"
    }
  }
}'
```

### CLI

```sh
firecrawl scrape 'rpvs-gov-sk/beneficial-owners/records_changes' \
  --options '{"max_pages":1,"since":"2026-10-15"}'
```


### MCP

Call the FCX MCP retrieve tool with this object:

```json
{
  "provider": "rpvs-gov-sk",
  "capability": "beneficial-owners/records_changes",
  "options": {
    "max_pages": 1,
    "since": "2026-10-15"
  }
}
```

Ask for only the returned fields needed by the task.

## 5. Full request shape

```json
{
  "provider": "rpvs-gov-sk",
  "capability": "beneficial-owners/records_changes",
  "options": {
    "max_pages": 1,
    "since": "2026-10-15"
  }
}
```

## 6. Response data

The response includes `success`, `provider`, `capability`, `creditsCost` and `data`. This example shows the provider payload in `data`:

```json
{
  "changes": [
    {
      "change_kinds": [
        "owner_ceased"
      ],
      "changed_on": "2026-10-16",
      "deregistration": null,
      "owner": {
        "birth_month_year": "1947-07",
        "ceased_on": "2026-10-16",
        "country_of_residence": {
          "code": "703",
          "name": "Slovenská republika"
        },
        "is_current": false,
        "is_pep": false,
        "nationalities": [
          {
            "iso_numeric": "703",
            "name": "Slovenská republika"
          }
        ],
        "natures_of_control": null,
        "notified_on": "2017-05-11",
        "owner_id": 35757,
        "owner_kind": "person",
        "owner_name": "Ivan Štoder",
        "ownership_percent_band": null,
        "residence_city": "Považská Bystrica",
        "source_record_id": "sk:kuv:35757",
        "source_url": "https://rpvs.gov.sk/opendatav2/KonecniUzivateliaVyhod(35757)",
        "title_after": null,
        "title_before": "Ing."
      },
      "partner": {
        "company_name": null,
        "company_registration_number": null,
        "partner_id": 8557,
        "portal_url": "https://rpvs.gov.sk/rpvs/Partner/Partner/Detail/8557",
        "register_insert_number": 8557,
        "source_url": "https://rpvs.gov.sk/opendatav2/Partneri(8557)"
      },
      "publication_id": "partneri:le58539:n53873",
      "retrieved_at": "2026-10-18T06:07:22Z",
      "source_record_id": "sk:kuv:35757",
      "source_url": "https://rpvs.gov.sk/opendatav2/KonecniUzivateliaVyhod(35757)"
    },
    {
      "change_kinds": [
        "owner_ceased"
      ],
      "changed_on": "2026-10-15",
      "deregistration": null,
      "owner": {
        "birth_month_year": "1957-03",
        "ceased_on": "2026-10-15",
        "country_of_residence": {
          "code": "703",
          "name": "Slovenská republika"
        },
        "is_current": false,
        "is_pep": false,
        "nationalities": [
          {
            "iso_numeric": "703",
            "name": "Slovenská republika"
          }
        ],
        "natures_of_control": null,
        "notified_on": "2017-07-22",
        "owner_id": 62003,
        "owner_kind": "person",
        "owner_name": "Emil Machyna",
        "ownership_percent_band": null,
        "residence_city": "Rosina",
        "source_record_id": "sk:kuv:62003",
        "source_url": "https://rpvs.gov.sk/opendatav2/KonecniUzivateliaVyhod(62003)",
        "title_after": null,
        "title_before": "PhDr."
      },
      "partner": {
        "company_name": null,
        "company_registration_number": null,
        "partner_id": 6395,
        "portal_url": "https://rpvs.gov.sk/rpvs/Partner/Partner/Detail/6395",
        "register_insert_number": 6395,
        "source_url": "https://rpvs.gov.sk/opendatav2/Partneri(6395)"
      },
      "publication_id": "partneri:le58539:n53873",
      "retrieved_at": "2026-10-18T06:07:22Z",
      "source_record_id": "sk:kuv:62003",
      "source_url": "https://rpvs.gov.sk/opendatav2/KonecniUzivateliaVyhod(62003)"
    },
    {
      "change_kinds": [
        "owner_ceased"
      ],
      "changed_on": "2026-10-15",
      "deregistration": null,
      "owner": {
        "birth_month_year": "1976-11",
        "ceased_on": "2026-10-15",
        "country_of_residence": {
          "code": "703",
          "name": "Slovenská republika"
        },
        "is_current": false,
        "is_pep": false,
        "nationalities": [
          {
            "iso_numeric": "703",
            "name": "Slovenská republika"
          }
        ],
        "natures_of_control": null,
        "notified_on": "2017-07-25",
        "owner_id": 63796,
        "owner_kind": "person",
        "owner_name": "Barbora Vadkerti",
        "ownership_percent_band": null,
        "residence_city": "Nitra",
        "source_record_id": "sk:kuv:63796",
        "source_url": "https://rpvs.gov.sk/opendatav2/KonecniUzivateliaVyhod(63796)",
        "title_after": null,
        "title_before": "Ing."
      },
      "partner": {
        "company_name": null,
        "company_registration_number": null,
        "partner_id": 2462,
        "portal_url": "https://rpvs.gov.sk/rpvs/Partner/Partner/Detail/2462",
        "register_insert_number": 2462,
        "source_url": "https://rpvs.gov.sk/opendatav2/Partneri(2462)"
      },
      "publication_id": "partneri:le58539:n53873",
      "retrieved_at": "2026-10-18T06:07:22Z",
      "source_record_id": "sk:kuv:63796",
      "source_url": "https://rpvs.gov.sk/opendatav2/KonecniUzivateliaVyhod(63796)"
    },
    {
      "change_kinds": [
        "owner_ceased"
      ],
      "changed_on": "2026-10-16",
      "deregistration": null,
      "owner": {
        "birth_month_year": "1954-09",
        "ceased_on": "2026-10-16",
        "country_of_residence": {
          "code": "703",
          "name": "Slovenská republika"
        },
        "is_current": false,
        "is_pep": false,
        "nationalities": [
          {
            "iso_numeric": "703",
            "name": "Slovenská republika"
          }
        ],
        "natures_of_control": null,
        "notified_on": "2017-08-10",
        "owner_id": 77562,
        "owner_kind": "person",
        "owner_name": "Jaroslav Polák",
        "ownership_percent_band": null,
        "residence_city": "Gočovo",
        "source_record_id": "sk:kuv:77562",
        "source_url": "https://rpvs.gov.sk/opendatav2/KonecniUzivateliaVyhod(77562)",
        "title_after": null,
        "title_before": null
      },
      "partner": {
        "company_name": null,
        "company_registration_number": null,
        "partner_id": 18897,
        "portal_url": "https://rpvs.gov.sk/rpvs/Partner/Partner/Detail/18524",
        "register_insert_number": 18524,
        "source_url": "https://rpvs.gov.sk/opendatav2/Partneri(18897)"
      },
      "publication_id": "partneri:le58539:n53873",
      "retrieved_at": "2026-10-18T06:07:22Z",
      "source_record_id": "sk:kuv:77562",
      "source_url": "https://rpvs.gov.sk/opendatav2/KonecniUzivateliaVyhod(77562)"
    },
    {
      "change_kinds": [
        "owner_ceased"
      ],
      "changed_on": "2026-10-16",
      "deregistration": null,
      "owner": {
        "birth_month_year": "1956-11",
        "ceased_on": "2026-10-16",
        "country_of_residence": {
          "code": "703",
          "name": "Slovenská republika"
        },
        "is_current": false,
        "is_pep": false,
        "nationalities": [
          {
            "iso_numeric": "703",
            "name": "Slovenská republika"
          }
        ],
        "natures_of_control": null,
        "notified_on": "2017-08-10",
        "owner_id": 77563,
        "owner_kind": "person",
        "owner_name": "Emil Gál",
        "ownership_percent_band": null,
        "residence_city": "Vlachovo",
        "source_record_id": "sk:kuv:77563",
        "source_url": "https://rpvs.gov.sk/opendatav2/KonecniUzivateliaVyhod(77563)",
        "title_after": null,
        "title_before": null
      },
      "partner": {
        "company_name": null,
        "company_registration_number": null,
        "partner_id": 18897,
        "portal_url": "https://rpvs.gov.sk/rpvs/Partner/Partner/Detail/18524",
        "register_insert_number": 18524,
        "source_url": "https://rpvs.gov.sk/opendatav2/Partneri(18897)"
      },
      "publication_id": "partneri:le58539:n53873",
      "retrieved_at": "2026-10-18T06:07:22Z",
      "source_record_id": "sk:kuv:77563",
      "source_url": "https://rpvs.gov.sk/opendatav2/KonecniUzivateliaVyhod(77563)"
    },
    {
      "change_kinds": [
        "owner_ceased"
      ],
      "changed_on": "2026-10-16",
      "deregistration": null,
      "owner": {
        "birth_month_year": "1960-02",
        "ceased_on": "2026-10-16",
        "country_of_residence": {
          "code": "703",
          "name": "Slovenská republika"
        },
        "is_current": false,
        "is_pep": false,
        "nationalities": [
          {
            "iso_numeric": "703",
            "name": "Slovenská republika"
          }
        ],
        "natures_of_control": null,
        "notified_on": "2017-08-10",
        "owner_id": 77566,
        "owner_kind": "person",
        "owner_name": "Viera Klementová",
        "ownership_percent_band": null,
        "residence_city": "Vlachovo",
        "source_record_id": "sk:kuv:77566",
        "source_url": "https://rpvs.gov.sk/opendatav2/KonecniUzivateliaVyhod(77566)",
        "title_after": null,
        "title_before": null
      },
      "partner": {
        "company_name": null,
        "company_registration_number": null,
        "partner_id": 18897,
        "portal_url": "https://rpvs.gov.sk/rpvs/Partner/Partner/Detail/18524",
        "register_insert_number": 18524,
        "source_url": "https://rpvs.gov.sk/opendatav2/Partneri(18897)"
      },
      "publication_id": "partneri:le58539:n53873",
      "retrieved_at": "2026-10-18T06:07:22Z",
      "source_record_id": "sk:kuv:77566",
      "source_url": "https://rpvs.gov.sk/opendatav2/KonecniUzivateliaVyhod(77566)"
    },
    {
      "change_kinds": [
        "owner_ceased"
      ],
      "changed_on": "2026-10-16",
      "deregistration": null,
      "owner": {
        "birth_month_year": "1959-10",
        "ceased_on": "2026-10-16",
        "country_of_residence": {
          "code": "703",
          "name": "Slovenská republika"
        },
        "is_current": false,
        "is_pep": false,
        "nationalities": [
          {
            "iso_numeric": "703",
            "name": "Slovenská republika"
          }
        ],
        "natures_of_control": null,
        "notified_on": "2017-08-10",
        "owner_id": 77568,
        "owner_kind": "person",
        "owner_name": "Jarmila Sojáková",
        "ownership_percent_band": null,
        "residence_city": "Vlachovo",
        "source_record_id": "sk:kuv:77568",
        "source_url": "https://rpvs.gov.sk/opendatav2/KonecniUzivateliaVyhod(77568)",
        "title_after": null,
        "title_before": null
      },
      "partner": {
        "company_name": null,
        "company_registration_number": null,
        "partner_id": 18897,
        "portal_url": "https://rpvs.gov.sk/rpvs/Partner/Partner/Detail/18524",
        "register_insert_number": 18524,
        "source_url": "https://rpvs.gov.sk/opendatav2/Partneri(18897)"
      },
      "publication_id": "partneri:le58539:n53873",
      "retrieved_at": "2026-10-18T06:07:22Z",
      "source_record_id": "sk:kuv:77568",
      "source_url": "https://rpvs.gov.sk/opendatav2/KonecniUzivateliaVyhod(77568)"
    },
    {
      "change_kinds": [
        "owner_ceased"
      ],
      "changed_on": "2026-10-16",
      "deregistration": null,
      "owner": {
        "birth_month_year": "1950-02",
        "ceased_on": "2026-10-16",
        "country_of_residence": {
          "code": "703",
          "name": "Slovenská republika"
        },
        "is_current": false,
        "is_pep": false,
        "nationalities": [
          {
            "iso_numeric": "703",
            "name": "Slovenská republika"
          }
        ],
        "natures_of_control": null,
        "notified_on": "2017-08-16",
        "owner_id": 79380,
        "owner_kind": "person",
        "owner_name": "Tatiana Čarnoká",
        "ownership_percent_band": null,
        "residence_city": "Prešov",
        "source_record_id": "sk:kuv:79380",
        "source_url": "https://rpvs.gov.sk/opendatav2/KonecniUzivateliaVyhod(79380)",
        "title_after": null,
        "title_before": "MUDr."
      },
      "partner": {
        "company_name": null,
        "company_registration_number": null,
        "partner_id": 19219,
        "portal_url": "https://rpvs.gov.sk/rpvs/Partner/Partner/Detail/18832",
        "register_insert_number": 18832,
        "source_url": "https://rpvs.gov.sk/opendatav2/Partneri(19219)"
      },
      "publication_id": "partneri:le58539:n53873",
      "retrieved_at": "2026-10-18T06:07:22Z",
      "source_record_id": "sk:kuv:79380",
      "source_url": "https://rpvs.gov.sk/opendatav2/KonecniUzivateliaVyhod(79380)"
    },
    {
      "change_kinds": [
        "owner_ceased"
      ],
      "changed_on": "2026-10-16",
      "deregistration": null,
      "owner": {
        "birth_month_year": "1965-12",
        "ceased_on": "2026-10-16",
        "country_of_residence": {
          "code": "040",
          "name": "Rakúska republika"
        },
        "is_current": false,
        "is_pep": false,
        "nationalities": [
          {
            "iso_numeric": "276",
            "name": "Nemecká spolková republika"
          }
        ],
        "natures_of_control": null,
        "notified_on": "2017-08-18",
        "owner_id": 80228,
        "owner_kind": "person",
        "owner_name": "Holger Mägdefrau",
        "ownership_percent_band": null,
        "residence_city": "Viedeň",
        "source_record_id": "sk:kuv:80228",
        "source_url": "https://rpvs.gov.sk/opendatav2/KonecniUzivateliaVyhod(80228)",
        "title_after": null,
        "title_before": "Dipl. Ing."
      },
      "partner": {
        "company_name": null,
        "company_registration_number": null,
        "partner_id": 5478,
        "portal_url": "https://rpvs.gov.sk/rpvs/Partner/Partner/Detail/5478",
        "register_insert_number": 5478,
        "source_url": "https://rpvs.gov.sk/opendatav2/Partneri(5478)"
      },
      "publication_id": "partneri:le58539:n53873",
      "retrieved_at": "2026-10-18T06:07:22Z",
      "source_record_id": "sk:kuv:80228",
      "source_url": "https://rpvs.gov.sk/opendatav2/KonecniUzivateliaVyhod(80228)"
    },
    {
      "change_kinds": [
        "owner_ceased"
      ],
      "changed_on": "2026-10-16",
      "deregistration": null,
      "owner": {
        "birth_month_year": "1950-04",
        "ceased_on": "2026-10-16",
        "country_of_residence": {
          "code": "703",
          "name": "Slovenská republika"
        },
        "is_current": false,
        "is_pep": false,
        "nationalities": [
          {
            "iso_numeric": "703",
            "name": "Slovenská republika"
          }
        ],
        "natures_of_control": null,
        "notified_on": "2017-09-07",
        "owner_id": 82929,
        "owner_kind": "person",
        "owner_name": "Slavka Kozárová",
        "ownership_percent_band": null,
        "residence_city": "Nitra",
        "source_record_id": "sk:kuv:82929",
        "source_url": "https://rpvs.gov.sk/opendatav2/KonecniUzivateliaVyhod(82929)",
        "title_after": null,
        "title_before": "MUDr."
      },
      "partner": {
        "company_name": null,
        "company_registration_number": null,
        "partner_id": 19931,
        "portal_url": "https://rpvs.gov.sk/rpvs/Partner/Partner/Detail/19500",
        "register_insert_number": 19500,
        "source_url": "https://rpvs.gov.sk/opendatav2/Partneri(19931)"
      },
      "publication_id": "partneri:le58539:n53873",
      "retrieved_at": "2026-10-18T06:07:22Z",
      "source_record_id": "sk:kuv:82929",
      "source_url": "https://rpvs.gov.sk/opendatav2/KonecniUzivateliaVyhod(82929)"
    },
    {
      "change_kinds": [
        "owner_ceased"
      ],
      "changed_on": "2026-10-16",
      "deregistration": null,
      "owner": {
        "birth_month_year": "1990-03",
        "ceased_on": "2026-10-16",
        "country_of_residence": {
          "code": "703",
          "name": "Slovenská republika"
        },
        "is_current": false,
        "is_pep": false,
        "nationalities": [
          {
            "iso_numeric": "703",
            "name": "Slovenská republika"
          }
        ],
        "natures_of_control": null,
        "notified_on": "2020-11-04",
        "owner_id": 162885,
        "owner_kind": "person",
        "owner_name": "Gabriel Vasiľ",
        "ownership_percent_band": null,
        "residence_city": "Vyšný Žipov",
        "source_record_id": "sk:kuv:162885",
        "source_url": "https://rpvs.gov.sk/opendatav2/KonecniUzivateliaVyhod(162885)",
        "title_after": null,
        "title_before": "Mgr."
      },
      "partner": {
        "company_name": null,
        "company_registration_number": null,
        "partner_id": 36353,
        "portal_url": "https://rpvs.gov.sk/rpvs/Partner/Partner/Detail/31811",
        "register_insert_number": 31811,
        "source_url": "https://rpvs.gov.sk/opendatav2/Partneri(36353)"
      },
      "publication_id": "partneri:le58539:n53873",
      "retrieved_at": "2026-10-18T06:07:22Z",
      "source_record_id": "sk:kuv:162885",
      "source_url": "https://rpvs.gov.sk/opendatav2/KonecniUzivateliaVyhod(162885)"
    },
    {
      "change_kinds": [
        "owner_ceased"
      ],
      "changed_on": "2026-10-16",
      "deregistration": null,
      "owner": {
        "birth_month_year": "1952-05",
        "ceased_on": "2026-10-16",
        "country_of_residence": {
          "code": "703",
          "name": "Slovenská republika"
        },
        "is_current": false,
        "is_pep": false,
        "nationalities": [
          {
            "iso_numeric": "703",
            "name": "Slovenská republika"
          }
        ],
        "natures_of_control": null,
        "notified_on": "2020-12-04",
        "owner_id": 164476,
        "owner_kind": "person",
        "owner_name": "Ján Michlík",
        "ownership_percent_band": null,
        "residence_city": "Spišská Teplica",
        "source_record_id": "sk:kuv:164476",
        "source_url": "https://rpvs.gov.sk/opendatav2/KonecniUzivateliaVyhod(164476)",
        "title_after": null,
        "title_before": null
      },
      "partner": {
        "company_name": null,
        "company_registration_number": null,
        "partner_id": 36634,
        "portal_url": "https://rpvs.gov.sk/rpvs/Partner/Partner/Detail/32092",
        "register_insert_number": 32092,
        "source_url": "https://rpvs.gov.sk/opendatav2/Partneri(36634)"
      },
      "publication_id": "partneri:le58539:n53873",
      "retrieved_at": "2026-10-18T06:07:22Z",
      "source_record_id": "sk:kuv:164476",
      "source_url": "https://rpvs.gov.sk/opendatav2/KonecniUzivateliaVyhod(164476)"
    },
    {
      "change_kinds": [
        "owner_ceased"
      ],
      "changed_on": "2026-10-15",
      "deregistration": null,
      "owner": {
        "birth_month_year": "1957-03",
        "ceased_on": "2026-10-15",
        "country_of_residence": {
          "code": "703",
          "name": "Slovenská republika"
        },
        "is_current": false,
        "is_pep": false,
        "nationalities": [
          {
            "iso_numeric": "703",
            "name": "Slovenská republika"
          }
        ],
        "natures_of_control": null,
        "notified_on": "2021-07-17",
        "owner_id": 179705,
        "owner_kind": "person",
        "owner_name": "Emil Machyna",
        "ownership_percent_band": null,
        "residence_city": "Rosina",
        "source_record_id": "sk:kuv:179705",
        "source_url": "https://rpvs.gov.sk/opendatav2/KonecniUzivateliaVyhod(179705)",
        "title_after": null,
        "title_before": "PhDr."
      },
      "partner": {
        "company_name": null,
        "company_registration_number": null,
        "partner_id": 38989,
        "portal_url": "https://rpvs.gov.sk/rpvs/Partner/Partner/Detail/34443",
        "register_insert_number": 34443,
        "source_url": "https://rpvs.gov.sk/opendatav2/Partneri(38989)"
      },
      "publication_id": "partneri:le58539:n53873",
      "retrieved_at": "2026-10-18T06:07:22Z",
      "source_record_id": "sk:kuv:179705",
      "source_url": "https://rpvs.gov.sk/opendatav2/KonecniUzivateliaVyhod(179705)"
    },
    {
      "change_kinds": [
        "owner_ceased"
      ],
      "changed_on": "2026-10-16",
      "deregistration": null,
      "owner": {
        "birth_month_year": "1972-12",
        "ceased_on": "2026-10-16",
        "country_of_residence": {
          "code": "703",
          "name": "Slovenská republika"
        },
        "is_current": false,
        "is_pep": false,
        "nationalities": [
          {
            "iso_numeric": "703",
            "name": "Slovenská republika"
          }
        ],
        "natures_of_control": null,
        "notified_on": "2021-12-21",
        "owner_id": 186266,
        "owner_kind": "person",
        "owner_name": "Martin Petruf",
        "ownership_percent_band": null,
        "residence_city": "Bratislava - mestská časť Karlova Ves",
        "source_record_id": "sk:kuv:186266",
        "source_url": "https://rpvs.gov.sk/opendatav2/KonecniUzivateliaVyhod(186266)",
        "title_after": null,
        "title_before": "Ing."
      },
      "partner": {
        "company_name": null,
        "company_registration_number": null,
        "partner_id": 4599,
        "portal_url": "https://rpvs.gov.sk/rpvs/Partner/Partner/Detail/4599",
        "register_insert_number": 4599,
        "source_url": "https://rpvs.gov.sk/opendatav2/Partneri(4599)"
      },
      "publication_id": "partneri:le58539:n53873",
      "retrieved_at": "2026-10-18T06:07:22Z",
      "source_record_id": "sk:kuv:186266",
      "source_url": "https://rpvs.gov.sk/opendatav2/KonecniUzivateliaVyhod(186266)"
    },
    {
      "change_kinds": [
        "owner_ceased"
      ],
      "changed_on": "2026-10-16",
      "deregistration": null,
      "owner": {
        "birth_month_year": "1963-03",
        "ceased_on": "2026-10-16",
        "country_of_residence": {
          "code": "703",
          "name": "Slovenská republika"
        },
        "is_current": false,
        "is_pep": false,
        "nationalities": [
          {
            "iso_numeric": "703",
            "name": "Slovenská republika"
          }
        ],
        "natures_of_control": null,
        "notified_on": "2022-02-24",
        "owner_id": 190801,
        "owner_kind": "person",
        "owner_name": "Ľubomír Šmegner",
        "ownership_percent_band": null,
        "residence_city": "Kobeliarovo",
        "source_record_id": "sk:kuv:190801",
        "source_url": "https://rpvs.gov.sk/opendatav2/KonecniUzivateliaVyhod(190801)",
        "title_after": null,
        "title_before": null
      },
      "partner": {
        "company_name": null,
        "company_registration_number": null,
        "partner_id": 18897,
        "portal_url": "https://rpvs.gov.sk/rpvs/Partner/Partner/Detail/18524",
        "register_insert_number": 18524,
        "source_url": "https://rpvs.gov.sk/opendatav2/Partneri(18897)"
      },
      "publication_id": "partneri:le58539:n53873",
      "retrieved_at": "2026-10-18T06:07:22Z",
      "source_record_id": "sk:kuv:190801",
      "source_url": "https://rpvs.gov.sk/opendatav2/KonecniUzivateliaVyhod(190801)"
    },
    {
      "change_kinds": [
        "owner_ceased"
      ],
      "changed_on": "2026-10-16",
      "deregistration": null,
      "owner": {
        "birth_month_year": "1989-03",
        "ceased_on": "2026-10-16",
        "country_of_residence": {
          "code": "703",
          "name": "Slovenská republika"
        },
        "is_current": false,
        "is_pep": false,
        "nationalities": [
          {
            "iso_numeric": "703",
            "name": "Slovenská republika"
          }
        ],
        "natures_of_control": null,
        "notified_on": "2022-02-25",
        "owner_id": 190865,
        "owner_kind": "person",
        "owner_name": "Juraj Vidor",
        "ownership_percent_band": null,
        "residence_city": "Lazany",
        "source_record_id": "sk:kuv:190865",
        "source_url": "https://rpvs.gov.sk/opendatav2/KonecniUzivateliaVyhod(190865)",
        "title_after": null,
        "title_before": null
      },
      "partner": {
        "company_name": null,
        "company_registration_number": null,
        "partner_id": 30372,
        "portal_url": "https://rpvs.gov.sk/rpvs/Partner/Partner/Detail/26865",
        "register_insert_number": 26865,
        "source_url": "https://rpvs.gov.sk/opendatav2/Partneri(30372)"
      },
      "publication_id": "partneri:le58539:n53873",
      "retrieved_at": "2026-10-18T06:07:22Z",
      "source_record_id": "sk:kuv:190865",
      "source_url": "https://rpvs.gov.sk/opendatav2/KonecniUzivateliaVyhod(190865)"
    },
    {
      "change_kinds": [
        "owner_ceased"
      ],
      "changed_on": "2026-10-16",
      "deregistration": null,
      "owner": {
        "birth_month_year": "1970-03",
        "ceased_on": "2026-10-16",
        "country_of_residence": {
          "code": "703",
          "name": "Slovenská republika"
        },
        "is_current": false,
        "is_pep": false,
        "nationalities": [
          {
            "iso_numeric": "703",
            "name": "Slovenská republika"
          }
        ],
        "natures_of_control": null,
        "notified_on": "2022-04-07",
        "owner_id": 195007,
        "owner_kind": "person",
        "owner_name": "Roman Radáči",
        "ownership_percent_band": null,
        "residence_city": "Šemša",
        "source_record_id": "sk:kuv:195007",
        "source_url": "https://rpvs.gov.sk/opendatav2/KonecniUzivateliaVyhod(195007)",
        "title_after": null,
        "title_before": null
      },
      "partner": {
        "company_name": null,
        "company_registration_number": null,
        "partner_id": 41004,
        "portal_url": "https://rpvs.gov.sk/rpvs/Partner/Partner/Detail/36452",
        "register_insert_number": 36452,
        "source_url": "https://rpvs.gov.sk/opendatav2/Partneri(41004)"
      },
      "publication_id": "partneri:le58539:n53873",
      "retrieved_at": "2026-10-18T06:07:22Z",
      "source_record_id": "sk:kuv:195007",
      "source_url": "https://rpvs.gov.sk/opendatav2/KonecniUzivateliaVyhod(195007)"
    },
    {
      "change_kinds": [
        "owner_ceased"
      ],
      "changed_on": "2026-10-15",
      "deregistration": null,
      "owner": {
        "birth_month_year": "1989-03",
        "ceased_on": "2026-10-15",
        "country_of_residence": {
          "code": "703",
          "name": "Slovenská republika"
        },
        "is_current": false,
        "is_pep": false,
        "nationalities": [
          {
            "iso_numeric": "703",
            "name": "Slovenská republika"
          }
        ],
        "natures_of_control": null,
        "notified_on": "2022-07-07",
        "owner_id": 198956,
        "owner_kind": "person",
        "owner_name": "Jozef Kužma",
        "ownership_percent_band": null,
        "residence_city": "Michalovce",
        "source_record_id": "sk:kuv:198956",
        "source_url": "https://rpvs.gov.sk/opendatav2/KonecniUzivateliaVyhod(198956)",
        "title_after": null,
        "title_before": null
      },
      "partner": {
        "company_name": null,
        "company_registration_number": null,
        "partner_id": 36565,
        "portal_url": "https://rpvs.gov.sk/rpvs/Partner/Partner/Detail/32023",
        "register_insert_number": 32023,
        "source_url": "https://rpvs.gov.sk/opendatav2/Partneri(36565)"
      },
      "publication_id": "partneri:le58539:n53873",
      "retrieved_at": "2026-10-18T06:07:22Z",
      "source_record_id": "sk:kuv:198956",
      "source_url": "https://rpvs.gov.sk/opendatav2/KonecniUzivateliaVyhod(198956)"
    },
    {
      "change_kinds": [
        "owner_ceased"
      ],
      "changed_on": "2026-10-16",
      "deregistration": null,
      "owner": {
        "birth_month_year": "1969-05",
        "ceased_on": "2026-10-16",
        "country_of_residence": {
          "code": "703",
          "name": "Slovenská republika"
        },
        "is_current": false,
        "is_pep": true,
        "nationalities": [
          {
            "iso_numeric": "703",
            "name": "Slovenská republika"
          }
        ],
        "natures_of_control": null,
        "notified_on": "2022-10-05",
        "owner_id": 202815,
        "owner_kind": "person",
        "owner_name": "Jozef Pavle",
        "ownership_percent_band": null,
        "residence_city": "Nitra",
        "source_record_id": "sk:kuv:202815",
        "source_url": "https://rpvs.gov.sk/opendatav2/KonecniUzivateliaVyhod(202815)",
        "title_after": null,
        "title_before": "Ing."
      },
      "partner": {
        "company_name": null,
        "company_registration_number": null,
        "partner_id": 19377,
        "portal_url": "https://rpvs.gov.sk/rpvs/Partner/Partner/Detail/18984",
        "register_insert_number": 18984,
        "source_url": "https://rpvs.gov.sk/opendatav2/Partneri(19377)"
      },
      "publication_id": "partneri:le58539:n53873",
      "retrieved_at": "2026-10-18T06:07:22Z",
      "source_record_id": "sk:kuv:202815",
      "source_url": "https://rpvs.gov.sk/opendatav2/KonecniUzivateliaVyhod(202815)"
    },
    {
      "change_kinds": [
        "owner_ceased"
      ],
      "changed_on": "2026-10-16",
      "deregistration": null,
      "owner": {
        "birth_month_year": "1996-01",
        "ceased_on": "2026-10-16",
        "country_of_residence": {
          "code": "203",
          "name": "Česká republika"
        },
        "is_current": false,
        "is_pep": false,
        "nationalities": [
          {
            "iso_numeric": "203",
            "name": "Česká republika"
          }
        ],
        "natures_of_control": null,
        "notified_on": "2023-02-21",
        "owner_id": 212650,
        "owner_kind": "person",
        "owner_name": "Marie Hlaváčková",
        "ownership_percent_band": null,
        "residence_city": "Přezletice",
        "source_record_id": "sk:kuv:212650",
        "source_url": "https://rpvs.gov.sk/opendatav2/KonecniUzivateliaVyhod(212650)",
        "title_after": null,
        "title_before": null
      },
      "partner": {
        "company_name": null,
        "company_registration_number": null,
        "partner_id": 9504,
        "portal_url": "https://rpvs.gov.sk/rpvs/Partner/Partner/Detail/9504",
        "register_insert_number": 9504,
        "source_url": "https://rpvs.gov.sk/opendatav2/Partneri(9504)"
      },
      "publication_id": "partneri:le58539:n53873",
      "retrieved_at": "2026-10-18T06:07:22Z",
      "source_record_id": "sk:kuv:212650",
      "source_url": "https://rpvs.gov.sk/opendatav2/KonecniUzivateliaVyhod(212650)"
    }
  ],
  "count": 20,
  "next_cursor": "212650",
  "pages_fetched": 1,
  "publication_id": "partneri:le58539:n53873",
  "retrieved_at": "2026-10-18T06:07:22Z",
  "since": "2026-10-15",
  "stream": "owners",
  "total_count": 143
}
```

## API reference-derived contract

The following capability contract is generated from the same normalized Alexandria API reference exposed in the API spec.

### Records changes

- Capability: `beneficial-owners/records_changes`
- Description: Date-based changes, built on the register's own validity dates (not a publisher delta log). `stream` `owners`: `KonecniUzivateliaVyhod?$filter=PlatnostOd ge <since> or PlatnostDo ge <since>` with partner, nationality and residence country expanded; `stream` `deregistrations`: `Partneri?$filter=Vymaz/Datum ge <since>`. Pages of 20 rows, up to `max_pages` per call; `since` is interpreted at 00:00 UTC.
- Instructions: Owners whose validity started or ended since a date, or partners deregistered since a date. Rows edited in place without a date change are not detectable; diff records_list snapshots for those.
- Cost: 5 credits per call
- Capability file: [Records changes](https://firecrawl.dev/alexandria/agents/providers/rpvs-gov-sk/beneficial-owners/records_changes)

Accepted options:
- `cursor` (string): `next_cursor` from the previous page (the upstream `$skiptoken` Id). Pattern: ^[0-9]+$. Example: `next_cursor`
- `include_birth_date` (boolean): Also return the full `birth_date` (personal data). Off by default: only `birth_month_year` is returned. Example: `false`
- `max_pages` (number): max_pages Example: `5`
- `since` (string, required): Inclusive start date, YYYY-MM-DD. Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. Example: `<since>`
- `stream` (string): stream Example: `owners`

Response schema example:
```json
{
  "changes": [
    {
      "change_kinds": [
        "owner_ceased"
      ],
      "changed_on": "2026-10-16",
      "deregistration": null,
      "owner": {
        "birth_month_year": "1947-07",
        "ceased_on": "2026-10-16",
        "country_of_residence": {
          "code": "703",
          "name": "Slovenská republika"
        },
        "is_current": false,
        "is_pep": false,
        "nationalities": [
          {
            "iso_numeric": "703",
            "name": "Slovenská republika"
          }
        ],
        "natures_of_control": null,
        "notified_on": "2017-05-11",
        "owner_id": 35757,
        "owner_kind": "person",
        "owner_name": "Ivan Štoder",
        "ownership_percent_band": null,
        "residence_city": "Považská Bystrica",
        "source_record_id": "sk:kuv:35757",
        "source_url": "https://rpvs.gov.sk/opendatav2/KonecniUzivateliaVyhod(35757)",
        "title_after": null,
        "title_before": "Ing."
      },
      "partner": {
        "company_name": null,
        "company_registration_number": null,
        "partner_id": 8557,
        "portal_url": "https://rpvs.gov.sk/rpvs/Partner/Partner/Detail/8557",
        "register_insert_number": 8557,
        "source_url": "https://rpvs.gov.sk/opendatav2/Partneri(8557)"
      },
      "publication_id": "partneri:le58539:n53873",
      "retrieved_at": "2026-10-18T06:07:22Z",
      "source_record_id": "sk:kuv:35757",
      "source_url": "https://rpvs.gov.sk/opendatav2/KonecniUzivateliaVyhod(35757)"
    },
    {
      "change_kinds": [
        "owner_ceased"
      ],
      "changed_on": "2026-10-15",
      "deregistration": null,
      "owner": {
        "birth_month_year": "1957-03",
        "ceased_on": "2026-10-15",
        "country_of_residence": {
          "code": "703",
          "name": "Slovenská republika"
        },
        "is_current": false,
        "is_pep": false,
        "nationalities": [
          {
            "iso_numeric": "703",
            "name": "Slovenská republika"
          }
        ],
        "natures_of_control": null,
        "notified_on": "2017-07-22",
        "owner_id": 62003,
        "owner_kind": "person",
        "owner_name": "Emil Machyna",
        "ownership_percent_band": null,
        "residence_city": "Rosina",
        "source_record_id": "sk:kuv:62003",
        "source_url": "https://rpvs.gov.sk/opendatav2/KonecniUzivateliaVyhod(62003)",
        "title_after": null,
        "title_before": "PhDr."
      },
      "partner": {
        "company_name": null,
        "company_registration_number": null,
        "partner_id": 6395,
        "portal_url": "https://rpvs.gov.sk/rpvs/Partner/Partner/Detail/6395",
        "register_insert_number": 6395,
        "source_url": "https://rpvs.gov.sk/opendatav2/Partneri(6395)"
      },
      "publication_id": "partneri:le58539:n53873",
      "retrieved_at": "2026-10-18T06:07:22Z",
      "source_record_id": "sk:kuv:62003",
      "source_url": "https://rpvs.gov.sk/opendatav2/KonecniUzivateliaVyhod(62003)"
    },
    {
      "change_kinds": [
        "owner_ceased"
      ],
      "changed_on": "2026-10-15",
      "deregistration": null,
      "owner": {
        "birth_month_year": "1976-11",
        "ceased_on": "2026-10-15",
        "country_of_residence": {
          "code": "703",
          "name": "Slovenská republika"
        },
        "is_current": false,
        "is_pep": false,
        "nationalities": [
          {
            "iso_numeric": "703",
            "name": "Slovenská republika"
          }
        ],
        "natures_of_control": null,
        "notified_on": "2017-07-25",
        "owner_id": 63796,
        "owner_kind": "person",
        "owner_name": "Barbora Vadkerti",
        "ownership_percent_band": null,
        "residence_city": "Nitra",
        "source_record_id": "sk:kuv:63796",
        "source_url": "https://rpvs.gov.sk/opendatav2/KonecniUzivateliaVyhod(63796)",
        "title_after": null,
        "title_before": "Ing."
      },
      "partner": {
        "company_name": null,
        "company_registration_number": null,
        "partner_id": 2462,
        "portal_url": "https://rpvs.gov.sk/rpvs/Partner/Partner/Detail/2462",
        "register_insert_number": 2462,
        "source_url": "https://rpvs.gov.sk/opendatav2/Partneri(2462)"
      },
      "publication_id": "partneri:le58539:n53873",
      "retrieved_at": "2026-10-18T06:07:22Z",
      "source_record_id": "sk:kuv:63796",
      "source_url": "https://rpvs.gov.sk/opendatav2/KonecniUzivateliaVyhod(63796)"
    },
    {
      "change_kinds": [
        "owner_ceased"
      ],
      "changed_on": "2026-10-16",
      "deregistration": null,
      "owner": {
        "birth_month_year": "1954-09",
        "ceased_on": "2026-10-16",
        "country_of_residence": {
          "code": "703",
          "name": "Slovenská republika"
        },
        "is_current": false,
        "is_pep": false,
        "nationalities": [
          {
            "iso_numeric": "703",
            "name": "Slovenská republika"
          }
        ],
        "natures_of_control": null,
        "notified_on": "2017-08-10",
        "owner_id": 77562,
        "owner_kind": "person",
        "owner_name": "Jaroslav Polák",
        "ownership_percent_band": null,
        "residence_city": "Gočovo",
        "source_record_id": "sk:kuv:77562",
        "source_url": "https://rpvs.gov.sk/opendatav2/KonecniUzivateliaVyhod(77562)",
        "title_after": null,
        "title_before": null
      },
      "partner": {
        "company_name": null,
        "company_registration_number": null,
        "partner_id": 18897,
        "portal_url": "https://rpvs.gov.sk/rpvs/Partner/Partner/Detail/18524",
        "register_insert_number": 18524,
        "source_url": "https://rpvs.gov.sk/opendatav2/Partneri(18897)"
      },
      "publication_id": "partneri:le58539:n53873",
      "retrieved_at": "2026-10-18T06:07:22Z",
      "source_record_id": "sk:kuv:77562",
      "source_url": "https://rpvs.gov.sk/opendatav2/KonecniUzivateliaVyhod(77562)"
    },
    {
      "change_kinds": [
        "owner_ceased"
      ],
      "changed_on": "2026-10-16",
      "deregistration": null,
      "owner": {
        "birth_month_year": "1956-11",
        "ceased_on": "2026-10-16",
        "country_of_residence": {
          "code": "703",
          "name": "Slovenská republika"
        },
        "is_current": false,
        "is_pep": false,
        "nationalities": [
          {
            "iso_numeric": "703",
            "name": "Slovenská republika"
          }
        ],
        "natures_of_control": null,
        "notified_on": "2017-08-10",
        "owner_id": 77563,
        "owner_kind": "person",
        "owner_name": "Emil Gál",
        "ownership_percent_band": null,
        "residence_city": "Vlachovo",
        "source_record_id": "sk:kuv:77563",
        "source_url": "https://rpvs.gov.sk/opendatav2/KonecniUzivateliaVyhod(77563)",
        "title_after": null,
        "title_before": null
      },
      "partner": {
        "company_name": null,
        "company_registration_number": null,
        "partner_id": 18897,
        "portal_url": "https://rpvs.gov.sk/rpvs/Partner/Partner/Detail/18524",
        "register_insert_number": 18524,
        "source_url": "https://rpvs.gov.sk/opendatav2/Partneri(18897)"
      },
      "publication_id": "partneri:le58539:n53873",
      "retrieved_at": "2026-10-18T06:07:22Z",
      "source_record_id": "sk:kuv:77563",
      "source_url": "https://rpvs.gov.sk/opendatav2/KonecniUzivateliaVyhod(77563)"
    },
    {
      "change_kinds": [
        "owner_ceased"
      ],
      "changed_on": "2026-10-16",
      "deregistration": null,
      "owner": {
        "birth_month_year": "1960-02",
        "ceased_on": "2026-10-16",
        "country_of_residence": {
          "code": "703",
          "name": "Slovenská republika"
        },
        "is_current": false,
        "is_pep": false,
        "nationalities": [
          {
            "iso_numeric": "703",
            "name": "Slovenská republika"
          }
        ],
        "natures_of_control": null,
        "notified_on": "2017-08-10",
        "owner_id": 77566,
        "owner_kind": "person",
        "owner_name": "Viera Klementová",
        "ownership_percent_band": null,
        "residence_city": "Vlachovo",
        "source_record_id": "sk:kuv:77566",
        "source_url": "https://rpvs.gov.sk/opendatav2/KonecniUzivateliaVyhod(77566)",
        "title_after": null,
        "title_before": null
      },
      "partner": {
        "company_name": null,
        "company_registration_number": null,
        "partner_id": 18897,
        "portal_url": "https://rpvs.gov.sk/rpvs/Partner/Partner/Detail/18524",
        "register_insert_number": 18524,
        "source_url": "https://rpvs.gov.sk/opendatav2/Partneri(18897)"
      },
      "publication_id": "partneri:le58539:n53873",
      "retrieved_at": "2026-10-18T06:07:22Z",
      "source_record_id": "sk:kuv:77566",
      "source_url": "https://rpvs.gov.sk/opendatav2/KonecniUzivateliaVyhod(77566)"
    },
    {
      "change_kinds": [
        "owner_ceased"
      ],
      "changed_on": "2026-10-16",
      "deregistration": null,
      "owner": {
        "birth_month_year": "1959-10",
        "ceased_on": "2026-10-16",
        "country_of_residence": {
          "code": "703",
          "name": "Slovenská republika"
        },
        "is_current": false,
        "is_pep": false,
        "nationalities": [
          {
            "iso_numeric": "703",
            "name": "Slovenská republika"
          }
        ],
        "natures_of_control": null,
        "notified_on": "2017-08-10",
        "owner_id": 77568,
        "owner_kind": "person",
        "owner_name": "Jarmila Sojáková",
        "ownership_percent_band": null,
        "residence_city": "Vlachovo",
        "source_record_id": "sk:kuv:77568",
        "source_url": "https://rpvs.gov.sk/opendatav2/KonecniUzivateliaVyhod(77568)",
        "title_after": null,
        "title_before": null
      },
      "partner": {
        "company_name": null,
        "company_registration_number": null,
        "partner_id": 18897,
        "portal_url": "https://rpvs.gov.sk/rpvs/Partner/Partner/Detail/18524",
        "register_insert_number": 18524,
        "source_url": "https://rpvs.gov.sk/opendatav2/Partneri(18897)"
      },
      "publication_id": "partneri:le58539:n53873",
      "retrieved_at": "2026-10-18T06:07:22Z",
      "source_record_id": "sk:kuv:77568",
      "source_url": "https://rpvs.gov.sk/opendatav2/KonecniUzivateliaVyhod(77568)"
    },
    {
      "change_kinds": [
        "owner_ceased"
      ],
      "changed_on": "2026-10-16",
      "deregistration": null,
      "owner": {
        "birth_month_year": "1950-02",
        "ceased_on": "2026-10-16",
        "country_of_residence": {
          "code": "703",
          "name": "Slovenská republika"
        },
        "is_current": false,
        "is_pep": false,
        "nationalities": [
          {
            "iso_numeric": "703",
            "name": "Slovenská republika"
          }
        ],
        "natures_of_control": null,
        "notified_on": "2017-08-16",
        "owner_id": 79380,
        "owner_kind": "person",
        "owner_name": "Tatiana Čarnoká",
        "ownership_percent_band": null,
        "residence_city": "Prešov",
        "source_record_id": "sk:kuv:79380",
        "source_url": "https://rpvs.gov.sk/opendatav2/KonecniUzivateliaVyhod(79380)",
        "title_after": null,
        "title_before": "MUDr."
      },
      "partner": {
        "company_name": null,
        "company_registration_number": null,
        "partner_id": 19219,
        "portal_url": "https://rpvs.gov.sk/rpvs/Partner/Partner/Detail/18832",
        "register_insert_number": 18832,
        "source_url": "https://rpvs.gov.sk/opendatav2/Partneri(19219)"
      },
      "publication_id": "partneri:le58539:n53873",
      "retrieved_at": "2026-10-18T06:07:22Z",
      "source_record_id": "sk:kuv:79380",
      "source_url": "https://rpvs.gov.sk/opendatav2/KonecniUzivateliaVyhod(79380)"
    },
    {
      "change_kinds": [
        "owner_ceased"
      ],
      "changed_on": "2026-10-16",
      "deregistration": null,
      "owner": {
        "birth_month_year": "1965-12",
        "ceased_on": "2026-10-16",
        "country_of_residence": {
          "code": "040",
          "name": "Rakúska republika"
        },
        "is_current": false,
        "is_pep": false,
        "nationalities": [
          {
            "iso_numeric": "276",
            "name": "Nemecká spolková republika"
          }
        ],
        "natures_of_control": null,
        "notified_on": "2017-08-18",
        "owner_id": 80228,
        "owner_kind": "person",
        "owner_name": "Holger Mägdefrau",
        "ownership_percent_band": null,
        "residence_city": "Viedeň",
        "source_record_id": "sk:kuv:80228",
        "source_url": "https://rpvs.gov.sk/opendatav2/KonecniUzivateliaVyhod(80228)",
        "title_after": null,
        "title_before": "Dipl. Ing."
      },
      "partner": {
        "company_name": null,
        "company_registration_number": null,
        "partner_id": 5478,
        "portal_url": "https://rpvs.gov.sk/rpvs/Partner/Partner/Detail/5478",
        "register_insert_number": 5478,
        "source_url": "https://rpvs.gov.sk/opendatav2/Partneri(5478)"
      },
      "publication_id": "partneri:le58539:n53873",
      "retrieved_at": "2026-10-18T06:07:22Z",
      "source_record_id": "sk:kuv:80228",
      "source_url": "https://rpvs.gov.sk/opendatav2/KonecniUzivateliaVyhod(80228)"
    },
    {
      "change_kinds": [
        "owner_ceased"
      ],
      "changed_on": "2026-10-16",
      "deregistration": null,
      "owner": {
        "birth_month_year": "1950-04",
        "ceased_on": "2026-10-16",
        "country_of_residence": {
          "code": "703",
          "name": "Slovenská republika"
        },
        "is_current": false,
        "is_pep": false,
        "nationalities": [
          {
            "iso_numeric": "703",
            "name": "Slovenská republika"
          }
        ],
        "natures_of_control": null,
        "notified_on": "2017-09-07",
        "owner_id": 82929,
        "owner_kind": "person",
        "owner_name": "Slavka Kozárová",
        "ownership_percent_band": null,
        "residence_city": "Nitra",
        "source_record_id": "sk:kuv:82929",
        "source_url": "https://rpvs.gov.sk/opendatav2/KonecniUzivateliaVyhod(82929)",
        "title_after": null,
        "title_before": "MUDr."
      },
      "partner": {
        "company_name": null,
        "company_registration_number": null,
        "partner_id": 19931,
        "portal_url": "https://rpvs.gov.sk/rpvs/Partner/Partner/Detail/19500",
        "register_insert_number": 19500,
        "source_url": "https://rpvs.gov.sk/opendatav2/Partneri(19931)"
      },
      "publication_id": "partneri:le58539:n53873",
      "retrieved_at": "2026-10-18T06:07:22Z",
      "source_record_id": "sk:kuv:82929",
      "source_url": "https://rpvs.gov.sk/opendatav2/KonecniUzivateliaVyhod(82929)"
    },
    {
      "change_kinds": [
        "owner_ceased"
      ],
      "changed_on": "2026-10-16",
      "deregistration": null,
      "owner": {
        "birth_month_year": "1990-03",
        "ceased_on": "2026-10-16",
        "country_of_residence": {
          "code": "703",
          "name": "Slovenská republika"
        },
        "is_current": false,
        "is_pep": false,
        "nationalities": [
          {
            "iso_numeric": "703",
            "name": "Slovenská republika"
          }
        ],
        "natures_of_control": null,
        "notified_on": "2020-11-04",
        "owner_id": 162885,
        "owner_kind": "person",
        "owner_name": "Gabriel Vasiľ",
        "ownership_percent_band": null,
        "residence_city": "Vyšný Žipov",
        "source_record_id": "sk:kuv:162885",
        "source_url": "https://rpvs.gov.sk/opendatav2/KonecniUzivateliaVyhod(162885)",
        "title_after": null,
        "title_before": "Mgr."
      },
      "partner": {
        "company_name": null,
        "company_registration_number": null,
        "partner_id": 36353,
        "portal_url": "https://rpvs.gov.sk/rpvs/Partner/Partner/Detail/31811",
        "register_insert_number": 31811,
        "source_url": "https://rpvs.gov.sk/opendatav2/Partneri(36353)"
      },
      "publication_id": "partneri:le58539:n53873",
      "retrieved_at": "2026-10-18T06:07:22Z",
      "source_record_id": "sk:kuv:162885",
      "source_url": "https://rpvs.gov.sk/opendatav2/KonecniUzivateliaVyhod(162885)"
    },
    {
      "change_kinds": [
        "owner_ceased"
      ],
      "changed_on": "2026-10-16",
      "deregistration": null,
      "owner": {
        "birth_month_year": "1952-05",
        "ceased_on": "2026-10-16",
        "country_of_residence": {
          "code": "703",
          "name": "Slovenská republika"
        },
        "is_current": false,
        "is_pep": false,
        "nationalities": [
          {
            "iso_numeric": "703",
            "name": "Slovenská republika"
          }
        ],
        "natures_of_control": null,
        "notified_on": "2020-12-04",
        "owner_id": 164476,
        "owner_kind": "person",
        "owner_name": "Ján Michlík",
        "ownership_percent_band": null,
        "residence_city": "Spišská Teplica",
        "source_record_id": "sk:kuv:164476",
        "source_url": "https://rpvs.gov.sk/opendatav2/KonecniUzivateliaVyhod(164476)",
        "title_after": null,
        "title_before": null
      },
      "partner": {
        "company_name": null,
        "company_registration_number": null,
        "partner_id": 36634,
        "portal_url": "https://rpvs.gov.sk/rpvs/Partner/Partner/Detail/32092",
        "register_insert_number": 32092,
        "source_url": "https://rpvs.gov.sk/opendatav2/Partneri(36634)"
      },
      "publication_id": "partneri:le58539:n53873",
      "retrieved_at": "2026-10-18T06:07:22Z",
      "source_record_id": "sk:kuv:164476",
      "source_url": "https://rpvs.gov.sk/opendatav2/KonecniUzivateliaVyhod(164476)"
    },
    {
      "change_kinds": [
        "owner_ceased"
      ],
      "changed_on": "2026-10-15",
      "deregistration": null,
      "owner": {
        "birth_month_year": "1957-03",
        "ceased_on": "2026-10-15",
        "country_of_residence": {
          "code": "703",
          "name": "Slovenská republika"
        },
        "is_current": false,
        "is_pep": false,
        "nationalities": [
          {
            "iso_numeric": "703",
            "name": "Slovenská republika"
          }
        ],
        "natures_of_control": null,
        "notified_on": "2021-07-17",
        "owner_id": 179705,
        "owner_kind": "person",
        "owner_name": "Emil Machyna",
        "ownership_percent_band": null,
        "residence_city": "Rosina",
        "source_record_id": "sk:kuv:179705",
        "source_url": "https://rpvs.gov.sk/opendatav2/KonecniUzivateliaVyhod(179705)",
        "title_after": null,
        "title_before": "PhDr."
      },
      "partner": {
        "company_name": null,
        "company_registration_number": null,
        "partner_id": 38989,
        "portal_url": "https://rpvs.gov.sk/rpvs/Partner/Partner/Detail/34443",
        "register_insert_number": 34443,
        "source_url": "https://rpvs.gov.sk/opendatav2/Partneri(38989)"
      },
      "publication_id": "partneri:le58539:n53873",
      "retrieved_at": "2026-10-18T06:07:22Z",
      "source_record_id": "sk:kuv:179705",
      "source_url": "https://rpvs.gov.sk/opendatav2/KonecniUzivateliaVyhod(179705)"
    },
    {
      "change_kinds": [
        "owner_ceased"
      ],
      "changed_on": "2026-10-16",
      "deregistration": null,
      "owner": {
        "birth_month_year": "1972-12",
        "ceased_on": "2026-10-16",
        "country_of_residence": {
          "code": "703",
          "name": "Slovenská republika"
        },
        "is_current": false,
        "is_pep": false,
        "nationalities": [
          {
            "iso_numeric": "703",
            "name": "Slovenská republika"
          }
        ],
        "natures_of_control": null,
        "notified_on": "2021-12-21",
        "owner_id": 186266,
        "owner_kind": "person",
        "owner_name": "Martin Petruf",
        "ownership_percent_band": null,
        "residence_city": "Bratislava - mestská časť Karlova Ves",
        "source_record_id": "sk:kuv:186266",
        "source_url": "https://rpvs.gov.sk/opendatav2/KonecniUzivateliaVyhod(186266)",
        "title_after": null,
        "title_before": "Ing."
      },
      "partner": {
        "company_name": null,
        "company_registration_number": null,
        "partner_id": 4599,
        "portal_url": "https://rpvs.gov.sk/rpvs/Partner/Partner/Detail/4599",
        "register_insert_number": 4599,
        "source_url": "https://rpvs.gov.sk/opendatav2/Partneri(4599)"
      },
      "publication_id": "partneri:le58539:n53873",
      "retrieved_at": "2026-10-18T06:07:22Z",
      "source_record_id": "sk:kuv:186266",
      "source_url": "https://rpvs.gov.sk/opendatav2/KonecniUzivateliaVyhod(186266)"
    },
    {
      "change_kinds": [
        "owner_ceased"
      ],
      "changed_on": "2026-10-16",
      "deregistration": null,
      "owner": {
        "birth_month_year": "1963-03",
        "ceased_on": "2026-10-16",
        "country_of_residence": {
          "code": "703",
          "name": "Slovenská republika"
        },
        "is_current": false,
        "is_pep": false,
        "nationalities": [
          {
            "iso_numeric": "703",
            "name": "Slovenská republika"
          }
        ],
        "natures_of_control": null,
        "notified_on": "2022-02-24",
        "owner_id": 190801,
        "owner_kind": "person",
        "owner_name": "Ľubomír Šmegner",
        "ownership_percent_band": null,
        "residence_city": "Kobeliarovo",
        "source_record_id": "sk:kuv:190801",
        "source_url": "https://rpvs.gov.sk/opendatav2/KonecniUzivateliaVyhod(190801)",
        "title_after": null,
        "title_before": null
      },
      "partner": {
        "company_name": null,
        "company_registration_number": null,
        "partner_id": 18897,
        "portal_url": "https://rpvs.gov.sk/rpvs/Partner/Partner/Detail/18524",
        "register_insert_number": 18524,
        "source_url": "https://rpvs.gov.sk/opendatav2/Partneri(18897)"
      },
      "publication_id": "partneri:le58539:n53873",
      "retrieved_at": "2026-10-18T06:07:22Z",
      "source_record_id": "sk:kuv:190801",
      "source_url": "https://rpvs.gov.sk/opendatav2/KonecniUzivateliaVyhod(190801)"
    },
    {
      "change_kinds": [
        "owner_ceased"
      ],
      "changed_on": "2026-10-16",
      "deregistration": null,
      "owner": {
        "birth_month_year": "1989-03",
        "ceased_on": "2026-10-16",
        "country_of_residence": {
          "code": "703",
          "name": "Slovenská republika"
        },
        "is_current": false,
        "is_pep": false,
        "nationalities": [
          {
            "iso_numeric": "703",
            "name": "Slovenská republika"
          }
        ],
        "natures_of_control": null,
        "notified_on": "2022-02-25",
        "owner_id": 190865,
        "owner_kind": "person",
        "owner_name": "Juraj Vidor",
        "ownership_percent_band": null,
        "residence_city": "Lazany",
        "source_record_id": "sk:kuv:190865",
        "source_url": "https://rpvs.gov.sk/opendatav2/KonecniUzivateliaVyhod(190865)",
        "title_after": null,
        "title_before": null
      },
      "partner": {
        "company_name": null,
        "company_registration_number": null,
        "partner_id": 30372,
        "portal_url": "https://rpvs.gov.sk/rpvs/Partner/Partner/Detail/26865",
        "register_insert_number": 26865,
        "source_url": "https://rpvs.gov.sk/opendatav2/Partneri(30372)"
      },
      "publication_id": "partneri:le58539:n53873",
      "retrieved_at": "2026-10-18T06:07:22Z",
      "source_record_id": "sk:kuv:190865",
      "source_url": "https://rpvs.gov.sk/opendatav2/KonecniUzivateliaVyhod(190865)"
    },
    {
      "change_kinds": [
        "owner_ceased"
      ],
      "changed_on": "2026-10-16",
      "deregistration": null,
      "owner": {
        "birth_month_year": "1970-03",
        "ceased_on": "2026-10-16",
        "country_of_residence": {
          "code": "703",
          "name": "Slovenská republika"
        },
        "is_current": false,
        "is_pep": false,
        "nationalities": [
          {
            "iso_numeric": "703",
            "name": "Slovenská republika"
          }
        ],
        "natures_of_control": null,
        "notified_on": "2022-04-07",
        "owner_id": 195007,
        "owner_kind": "person",
        "owner_name": "Roman Radáči",
        "ownership_percent_band": null,
        "residence_city": "Šemša",
        "source_record_id": "sk:kuv:195007",
        "source_url": "https://rpvs.gov.sk/opendatav2/KonecniUzivateliaVyhod(195007)",
        "title_after": null,
        "title_before": null
      },
      "partner": {
        "company_name": null,
        "company_registration_number": null,
        "partner_id": 41004,
        "portal_url": "https://rpvs.gov.sk/rpvs/Partner/Partner/Detail/36452",
        "register_insert_number": 36452,
        "source_url": "https://rpvs.gov.sk/opendatav2/Partneri(41004)"
      },
      "publication_id": "partneri:le58539:n53873",
      "retrieved_at": "2026-10-18T06:07:22Z",
      "source_record_id": "sk:kuv:195007",
      "source_url": "https://rpvs.gov.sk/opendatav2/KonecniUzivateliaVyhod(195007)"
    },
    {
      "change_kinds": [
        "owner_ceased"
      ],
      "changed_on": "2026-10-15",
      "deregistration": null,
      "owner": {
        "birth_month_year": "1989-03",
        "ceased_on": "2026-10-15",
        "country_of_residence": {
          "code": "703",
          "name": "Slovenská republika"
        },
        "is_current": false,
        "is_pep": false,
        "nationalities": [
          {
            "iso_numeric": "703",
            "name": "Slovenská republika"
          }
        ],
        "natures_of_control": null,
        "notified_on": "2022-07-07",
        "owner_id": 198956,
        "owner_kind": "person",
        "owner_name": "Jozef Kužma",
        "ownership_percent_band": null,
        "residence_city": "Michalovce",
        "source_record_id": "sk:kuv:198956",
        "source_url": "https://rpvs.gov.sk/opendatav2/KonecniUzivateliaVyhod(198956)",
        "title_after": null,
        "title_before": null
      },
      "partner": {
        "company_name": null,
        "company_registration_number": null,
        "partner_id": 36565,
        "portal_url": "https://rpvs.gov.sk/rpvs/Partner/Partner/Detail/32023",
        "register_insert_number": 32023,
        "source_url": "https://rpvs.gov.sk/opendatav2/Partneri(36565)"
      },
      "publication_id": "partneri:le58539:n53873",
      "retrieved_at": "2026-10-18T06:07:22Z",
      "source_record_id": "sk:kuv:198956",
      "source_url": "https://rpvs.gov.sk/opendatav2/KonecniUzivateliaVyhod(198956)"
    },
    {
      "change_kinds": [
        "owner_ceased"
      ],
      "changed_on": "2026-10-16",
      "deregistration": null,
      "owner": {
        "birth_month_year": "1969-05",
        "ceased_on": "2026-10-16",
        "country_of_residence": {
          "code": "703",
          "name": "Slovenská republika"
        },
        "is_current": false,
        "is_pep": true,
        "nationalities": [
          {
            "iso_numeric": "703",
            "name": "Slovenská republika"
          }
        ],
        "natures_of_control": null,
        "notified_on": "2022-10-05",
        "owner_id": 202815,
        "owner_kind": "person",
        "owner_name": "Jozef Pavle",
        "ownership_percent_band": null,
        "residence_city": "Nitra",
        "source_record_id": "sk:kuv:202815",
        "source_url": "https://rpvs.gov.sk/opendatav2/KonecniUzivateliaVyhod(202815)",
        "title_after": null,
        "title_before": "Ing."
      },
      "partner": {
        "company_name": null,
        "company_registration_number": null,
        "partner_id": 19377,
        "portal_url": "https://rpvs.gov.sk/rpvs/Partner/Partner/Detail/18984",
        "register_insert_number": 18984,
        "source_url": "https://rpvs.gov.sk/opendatav2/Partneri(19377)"
      },
      "publication_id": "partneri:le58539:n53873",
      "retrieved_at": "2026-10-18T06:07:22Z",
      "source_record_id": "sk:kuv:202815",
      "source_url": "https://rpvs.gov.sk/opendatav2/KonecniUzivateliaVyhod(202815)"
    },
    {
      "change_kinds": [
        "owner_ceased"
      ],
      "changed_on": "2026-10-16",
      "deregistration": null,
      "owner": {
        "birth_month_year": "1996-01",
        "ceased_on": "2026-10-16",
        "country_of_residence": {
          "code": "203",
          "name": "Česká republika"
        },
        "is_current": false,
        "is_pep": false,
        "nationalities": [
          {
            "iso_numeric": "203",
            "name": "Česká republika"
          }
        ],
        "natures_of_control": null,
        "notified_on": "2023-02-21",
        "owner_id": 212650,
        "owner_kind": "person",
        "owner_name": "Marie Hlaváčková",
        "ownership_percent_band": null,
        "residence_city": "Přezletice",
        "source_record_id": "sk:kuv:212650",
        "source_url": "https://rpvs.gov.sk/opendatav2/KonecniUzivateliaVyhod(212650)",
        "title_after": null,
        "title_before": null
      },
      "partner": {
        "company_name": null,
        "company_registration_number": null,
        "partner_id": 9504,
        "portal_url": "https://rpvs.gov.sk/rpvs/Partner/Partner/Detail/9504",
        "register_insert_number": 9504,
        "source_url": "https://rpvs.gov.sk/opendatav2/Partneri(9504)"
      },
      "publication_id": "partneri:le58539:n53873",
      "retrieved_at": "2026-10-18T06:07:22Z",
      "source_record_id": "sk:kuv:212650",
      "source_url": "https://rpvs.gov.sk/opendatav2/KonecniUzivateliaVyhod(212650)"
    }
  ],
  "count": 20,
  "next_cursor": "212650",
  "pages_fetched": 1,
  "publication_id": "partneri:le58539:n53873",
  "retrieved_at": "2026-10-18T06:07:22Z",
  "since": "2026-10-15",
  "stream": "owners",
  "total_count": 143
}
```

### Records get

- Capability: `beneficial-owners/records_get`
- Description: One partner by its OData `partner_id` (`Partneri(<Id>)`) or by company registration number `ico` (`PartneriVerejnehoSektora?$filter=Ico eq '<ico>'`, then the partner). Owners come from `KonecniUzivateliaVyhod?$filter=Partner/Id eq <Id>` with `Adresa($expand=Stat)` so `country_of_residence` is filled; all pages are followed.
- Instructions: Detail for one partner found by records_list, records_changes or search, or for a known Slovak ICO.
- Cost: 5 credits per call
- Capability file: [Records get](https://firecrawl.dev/alexandria/agents/providers/rpvs-gov-sk/beneficial-owners/records_get)

Accepted options:
- `ico` (string): Slovak company registration number (ICO); spaces are ignored. Pattern: ^[0-9 ]{6,12}$. Example: `<ico>`
- `include_birth_date` (boolean): Also return the full `birth_date` (personal data). Off by default: only `birth_month_year` is returned. Example: `false`
- `partner_id` (number): `Partner.Id` (not the register insert number). Example: `10`

Response schema example:
```json
{
  "beneficial_owners": [
    {
      "birth_month_year": "1991-04",
      "ceased_on": "2019-04-30",
      "country_of_residence": {
        "code": "703",
        "name": "Slovenská republika"
      },
      "is_current": false,
      "is_pep": false,
      "nationalities": [
        {
          "iso_numeric": "703",
          "name": "Slovenská republika"
        }
      ],
      "natures_of_control": null,
      "notified_on": "2019-04-17",
      "owner_id": 125395,
      "owner_kind": "person",
      "owner_name": "Vladimír Jakubík",
      "ownership_percent_band": null,
      "residence_city": "Rajec",
      "source_record_id": "sk:kuv:125395",
      "source_url": "https://rpvs.gov.sk/opendatav2/KonecniUzivateliaVyhod(125395)",
      "title_after": null,
      "title_before": null
    }
  ],
  "company": {
    "address": {
      "building_number": "377",
      "city": "Rajec",
      "city_code": "SK031B517917",
      "country": null,
      "postal_code": "01501",
      "street": "Obrancov Mieru",
      "street_number": "28"
    },
    "company_name": "Vladimír Jakubík",
    "company_registration_number": "33338175",
    "entity_form": "FyzickaOsobaPodnikatel",
    "is_current": false,
    "legal_form": null,
    "source_record_id": "sk:pvs:125393",
    "valid_from": "2019-04-17T00:00:00+02:00",
    "valid_to": "2019-04-30T23:59:59.9+02:00",
    "version_id": 125393
  },
  "company_history": [
    {
      "address": {
        "building_number": "377",
        "city": "Rajec",
        "city_code": "SK031B517917",
        "country": null,
        "postal_code": "01501",
        "street": "Obrancov Mieru",
        "street_number": "28"
      },
      "company_name": "Vladimír Jakubík",
      "company_registration_number": "33338175",
      "entity_form": "FyzickaOsobaPodnikatel",
      "is_current": false,
      "legal_form": null,
      "source_record_id": "sk:pvs:125393",
      "valid_from": "2019-04-17T00:00:00+02:00",
      "valid_to": "2019-04-30T23:59:59.9+02:00",
      "version_id": 125393
    }
  ],
  "current_owner_count": 0,
  "deregistration": {
    "date": "2019-04-30T23:59:59.9+02:00",
    "note": null,
    "reason": "Dobrovolny"
  },
  "is_registered": false,
  "matched_by": "partner_id",
  "other_partner_ids": [],
  "owner_verification": null,
  "partner_id": 30064,
  "portal_url": "https://rpvs.gov.sk/rpvs/Partner/Partner/Detail/26559",
  "publication_id": "partneri:le58539:n53873",
  "register_insert_number": 26559,
  "retrieved_at": "2026-10-18T06:07:17Z",
  "source_record_id": "sk:rpvs:partner:30064",
  "source_url": "https://rpvs.gov.sk/opendatav2/Partneri(30064)"
}
```

### Records list

- Capability: `beneficial-owners/records_list`
- Description: The full current list of partners (`Partneri`) with company identity versions and the complete beneficial-owner history, 20 partners per upstream page, up to `max_pages` pages per call. The cursor pins the pass to `$filter=Id le <max partner Id at start>` and the row count of that set; every call re-reads that `$count` and fails with `upstream_error` `publication_changed` if the pinned set changed. Segment by partner Id with `id_from`/`id_to` to run a pass in parallel. About 2,700 pages for the whole register.
- Instructions: Full snapshot of every partner and owner. For one partner use records_get; for recent owner changes use records_changes.
- Cost: 5 credits per call
- Capability file: [Records list](https://firecrawl.dev/alexandria/agents/providers/rpvs-gov-sk/beneficial-owners/records_list)

Accepted options:
- `cursor` (string): `next_cursor` from the previous page. Carries the pin; cannot be combined with `id_from`/`id_to`. Pattern: ^v1:[0-9]+:[0-9]+:[0-9]+:[0-9]+:[0-9]+$. Example: `next_cursor`
- `id_from` (number): Segment start (partner Id, inclusive). Default 1. Example: `10`
- `id_to` (number): Segment end (partner Id, inclusive). Default: the highest partner Id at the start of the pass. Example: `10`
- `include_birth_date` (boolean): Also return the full `birth_date` (personal data). Off by default: only `birth_month_year` is returned. Example: `false`
- `max_pages` (number): Upstream pages (20 partners each) to follow in this call. Example: `10`

Response schema example:
```json
{
  "count": 1,
  "next_cursor": null,
  "pages_fetched": 1,
  "pinned_count": 53873,
  "pinned_max_id": 58539,
  "publication_id": "partneri:le58539:n53873",
  "records": [
    {
      "beneficial_owners": [
        {
          "birth_month_year": "1991-04",
          "ceased_on": "2019-04-30",
          "country_of_residence": null,
          "is_current": false,
          "is_pep": false,
          "nationalities": [
            {
              "iso_numeric": "703",
              "name": "Slovenská republika"
            }
          ],
          "natures_of_control": null,
          "notified_on": "2019-04-17",
          "owner_id": 125395,
          "owner_kind": "person",
          "owner_name": "Vladimír Jakubík",
          "ownership_percent_band": null,
          "residence_city": "Rajec",
          "source_record_id": "sk:kuv:125395",
          "source_url": "https://rpvs.gov.sk/opendatav2/KonecniUzivateliaVyhod(125395)",
          "title_after": null,
          "title_before": null
        }
      ],
      "company": {
        "address": {
          "building_number": "377",
          "city": "Rajec",
          "city_code": "SK031B517917",
          "country": null,
          "postal_code": "01501",
          "street": "Obrancov Mieru",
          "street_number": "28"
        },
        "company_name": "Vladimír Jakubík",
        "company_registration_number": "33338175",
        "entity_form": "FyzickaOsobaPodnikatel",
        "is_current": false,
        "legal_form": null,
        "source_record_id": "sk:pvs:125393",
        "valid_from": "2019-04-17T00:00:00+02:00",
        "valid_to": "2019-04-30T23:59:59.9+02:00",
        "version_id": 125393
      },
      "company_history": [
        {
          "address": {
            "building_number": "377",
            "city": "Rajec",
            "city_code": "SK031B517917",
            "country": null,
            "postal_code": "01501",
            "street": "Obrancov Mieru",
            "street_number": "28"
          },
          "company_name": "Vladimír Jakubík",
          "company_registration_number": "33338175",
          "entity_form": "FyzickaOsobaPodnikatel",
          "is_current": false,
          "legal_form": null,
          "source_record_id": "sk:pvs:125393",
          "valid_from": "2019-04-17T00:00:00+02:00",
          "valid_to": "2019-04-30T23:59:59.9+02:00",
          "version_id": 125393
        }
      ],
      "current_owner_count": 0,
      "deregistration": {
        "date": "2019-04-30T23:59:59.9+02:00",
        "note": null,
        "reason": "Dobrovolny"
      },
      "is_registered": false,
      "owner_verification": null,
      "partner_id": 30064,
      "portal_url": "https://rpvs.gov.sk/rpvs/Partner/Partner/Detail/26559",
      "publication_id": "partneri:le58539:n53873",
      "register_insert_number": 26559,
      "retrieved_at": "2026-10-18T06:07:12Z",
      "source_record_id": "sk:rpvs:partner:30064",
      "source_url": "https://rpvs.gov.sk/opendatav2/Partneri(30064)"
    }
  ],
  "retrieved_at": "2026-10-18T06:07:12Z",
  "segment": {
    "id_from": 30064,
    "id_to": 30064
  },
  "segment_count": 1
}
```

### Search

- Capability: `beneficial-owners/search`
- Description: Partner name search over `PartneriVerejnehoSektora/ObchodneMeno` (`contains(tolower(ObchodneMeno),'<query>')`, case-insensitive); an all-digit query is matched as an exact ICO instead. Each hit is one company identity version with its partner Id. Pages of 20 hits.
- Instructions: Find a partner's Id or ICO by company name before records_get.
- Cost: 5 credits per call
- Capability file: [Search](https://firecrawl.dev/alexandria/agents/providers/rpvs-gov-sk/beneficial-owners/search)

Accepted options:
- `current_only` (boolean): Only versions with no `PlatnostDo` (the current name/ICO of still-registered partners). Example: `false`
- `cursor` (string): Pattern: ^[0-9]+$. Example: `<cursor>`
- `query` (string, required): Company name fragment, or an ICO (digits, spaces allowed). Example: `<query>`

Response schema example:
```json
{
  "count": 4,
  "matched_on": "name",
  "next_cursor": null,
  "query": "volkswagen",
  "results": [
    {
      "company_name": "VOLKSWAGEN SLOVAKIA, a.s.",
      "company_registration_number": "35757442",
      "entity_form": "PravnickaOsoba",
      "is_current": true,
      "partner_id": 16403,
      "portal_url": "https://rpvs.gov.sk/rpvs/Partner/Partner/Detail/16222",
      "register_insert_number": 16222,
      "source_record_id": "sk:pvs:60849",
      "source_url": "https://rpvs.gov.sk/opendatav2/PartneriVerejnehoSektora(60849)",
      "valid_from": "2017-07-21T00:00:00+02:00",
      "valid_to": null
    },
    {
      "company_name": "VOLKSWAGEN Finančné služby Slovensko s.r.o.",
      "company_registration_number": "31341438",
      "entity_form": "PravnickaOsoba",
      "is_current": false,
      "partner_id": 16620,
      "portal_url": "https://rpvs.gov.sk/rpvs/Partner/Partner/Detail/16427",
      "register_insert_number": 16427,
      "source_record_id": "sk:pvs:62135",
      "source_url": "https://rpvs.gov.sk/opendatav2/PartneriVerejnehoSektora(62135)",
      "valid_from": "2017-07-22T00:00:00+02:00",
      "valid_to": "2025-04-14T23:59:59.9+02:00"
    },
    {
      "company_name": "VOLKSWAGEN Finančné služby Maklérska s.r.o.",
      "company_registration_number": "35835583",
      "entity_form": "PravnickaOsoba",
      "is_current": false,
      "partner_id": 26792,
      "portal_url": "https://rpvs.gov.sk/rpvs/Partner/Partner/Detail/24300",
      "register_insert_number": 24300,
      "source_record_id": "sk:pvs:109619",
      "source_url": "https://rpvs.gov.sk/opendatav2/PartneriVerejnehoSektora(109619)",
      "valid_from": "2018-08-11T00:00:00+02:00",
      "valid_to": "2024-08-19T23:59:59.9+02:00"
    },
    {
      "company_name": "VOLKSWAGEN Finančné služby Maklérska s.r.o.",
      "company_registration_number": "35835583",
      "entity_form": "PravnickaOsoba",
      "is_current": false,
      "partner_id": 26792,
      "portal_url": "https://rpvs.gov.sk/rpvs/Partner/Partner/Detail/24300",
      "register_insert_number": 24300,
      "source_record_id": "sk:pvs:246928",
      "source_url": "https://rpvs.gov.sk/opendatav2/PartneriVerejnehoSektora(246928)",
      "valid_from": "2024-08-20T00:00:00+02:00",
      "valid_to": "2025-04-15T23:59:59.9+02:00"
    }
  ],
  "retrieved_at": "2026-10-18T06:07:27Z",
  "total_count": 4
}
```

### Source status

- Capability: `beneficial-owners/source_status`
- Description: Cheap version check of the register: `$count` and the highest `Id` of the Partneri, PartneriVerejnehoSektora and KonecniUzivateliaVyhod entity sets (six small requests). The publisher exposes no ETag, Last-Modified, release date or hash, so `publication_id` is the Partneri pin `partneri:le<max Id>:n<count>` and `content_hash` is null.
- Instructions: Before or between records_list passes, to see whether the register moved on. In-place edits of existing rows do not change the fingerprint; use records_changes for those.
- Cost: 5 credits per call
- Capability file: [Source status](https://firecrawl.dev/alexandria/agents/providers/rpvs-gov-sk/beneficial-owners/source_status)

Accepted options:

Response schema example:
```json
{
  "content_hash": null,
  "entity_sets": [
    {
      "count": 53873,
      "max_id": 58539,
      "name": "Partneri",
      "url": "https://rpvs.gov.sk/opendatav2/Partneri"
    },
    {
      "count": 68272,
      "max_id": 298945,
      "name": "PartneriVerejnehoSektora",
      "url": "https://rpvs.gov.sk/opendatav2/PartneriVerejnehoSektora"
    },
    {
      "count": 147668,
      "max_id": 298944,
      "name": "KonecniUzivateliaVyhod",
      "url": "https://rpvs.gov.sk/opendatav2/KonecniUzivateliaVyhod"
    }
  ],
  "file_urls": [
    "https://rpvs.gov.sk/opendatav2/",
    "https://rpvs.gov.sk/opendatav2/Partneri?$expand=PartneriVerejnehoSektora($expand=PravnaForma,Adresa),KonecniUzivateliaVyhod($expand=StatnaPrislusnost,Adresa),Vymaz,OverenieIdentifikacieKUV&$filter=Id%20ge%201%20and%20Id%20le%2058539&$count=true"
  ],
  "fingerprint": "partneri:53873:58539|pvs:68272:298945|kuv:147668:298944",
  "licence_note": "The Ministry's open-data page (justice.gov.sk/sluzby/register-partnerov-verejneho-sektora/open-data/) offers this API for automated access but declares no explicit licence; the register is public by Act 315/2016 Coll. Owner rows are personal data (natural persons with birth dates and home addresses): birth dates are reduced to month/year unless include_birth_date is set, and street addresses are not returned.",
  "publication_id": "partneri:le58539:n53873",
  "published_at": null,
  "record_count": 53873,
  "retrieved_at": "2026-10-18T06:07:05Z",
  "size_bytes": null,
  "source_url": "https://rpvs.gov.sk/opendatav2/"
}
```
