> ## Documentation Index
> Fetch the complete documentation index at: https://slovakapi.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Local storage

> Build a local copy of the full RPO register and keep it up to date.

***

## Choose a method

RPO supports local copies by downloading the full register as compressed JSON files. Use it when you need the full register in your own system or want to process many entities at once.

| Use case                                        | Best choice   |
| ----------------------------------------------- | ------------- |
| Look up a single entity by IČO                  | REST API      |
| Fetch one entity on demand                      | REST API      |
| Build a  local copy of the entire register      | Local storage |
| Process many entities at once                   | Local storage |
| Build a search index or analytics pipeline      | Local storage |
| Keep your local copy of the register up to date | Local storage |

## Find the export files

All files are publicly available at:

```
https://frkqbrydxwdp.compat.objectstorage.eu-frankfurt-1.oraclecloud.com/susr-rpo/
```

No authentication required.

***

## Understand the export

The export is published in two batch types:

### Init batch

A full snapshot of the register. Use this to build your initial baseline.

| Field            | Value                                       |
| ---------------- | ------------------------------------------- |
| File prefix      | `batch-init/`                               |
| Filename pattern | `init_yyyy-mm-dd_nnn.json.gz`               |
| Update frequency | Monthly, on the first Saturday of the month |

```text Example init batch files theme={null}
batch-init/init_2025-07-05_001.json.gz
batch-init/init_2025-07-05_002.json.gz
...
batch-init/init_2025-07-05_022.json.gz
```

### Daily batch

Incremental updates containing records added or changed since the previous day.

| Field            | Value                       |
| ---------------- | --------------------------- |
| File prefix      | `batch-daily/`              |
| Filename pattern | `actual_yyyy-mm-dd.json.gz` |
| Update frequency | Daily                       |

```text Example daily batch files theme={null}
batch-daily/actual_2025-07-06.json.gz
batch-daily/actual_2025-07-07.json.gz
...
batch-daily/actual_2025-07-15.json.gz
```

### File contents

Each file contains compressed JSON records shaped like the [Detail API](/rpo/api-reference/get-entity-detail) response, including identifiers, names, addresses, legal form, legal status, activities, stakeholders, statutory bodies, and organization units.

Two fields present in the live API are not included in export files:

* `dbModificationDate`
* `license`

***

## Build your local copy

<Steps>
  <Step title="Download the latest init batch">
    Start with the newest init batch. This is your complete baseline.

    ```bash theme={null}
    curl -O "https://frkqbrydxwdp.compat.objectstorage.eu-frankfurt-1.oraclecloud.com/susr-rpo/batch-init/init_2025-07-05_001.json.gz"
    ```
  </Step>

  <Step title="Decompress and parse">
    Each file is gzip-compressed. Decompress and stream the JSON records.

    ```bash theme={null}
    gunzip -c init_2025-07-05_001.json.gz | head -n 5
    ```
  </Step>

  <Step title="Load into your storage">
    Insert or upsert records into your database, warehouse, or search index. The record shape follows the [Detail API](/rpo/api-reference/get-entity-detail) response, so the API reference is useful here.
  </Step>

  <Step title="Keep it up to date">
    Once your baseline is loaded, apply daily batches to keep your copy current.

    ```bash theme={null}
    curl -O "https://frkqbrydxwdp.compat.objectstorage.eu-frankfurt-1.oraclecloud.com/susr-rpo/batch-daily/actual_2025-07-06.json.gz"
    ```
  </Step>
</Steps>

***

## Review limits

* Export batches are retained for **45 days only** — download files before they expire.
* Data refreshes overnight — recent changes may not appear for up to **24 hours**.
* Beneficial owner data is not publicly exposed without demonstrating legitimate interest.

***

## See more

<CardGroup cols={2}>
  <Card title="Getting started" icon="rocket" href="/rpo/getting-started/overview">
    New to RPO? Start here before diving into the export.
  </Card>

  <Card title="Data models" icon="layers" href="/rpo/concepts/data-models">
    Types, fields, and the conventions that apply across the entire API.
  </Card>

  <Card title="Search API reference" icon="search" href="/rpo/api-reference/search-entities">
    Detailed specification of the `/search` endpoint.
  </Card>

  <Card title="Detail API reference" icon="list-tree" href="/rpo/api-reference/get-entity-detail">
    Detailed specification of the `/detail` endpoint.
  </Card>
</CardGroup>
