Skip to main content
GET
/
search
Search entities
curl --request GET \
  --url https://api.statistics.sk/rpo/v1/search
{
  "results": [
    {
      "id": 123,
      "identifiers": [
        {
          "value": "<string>",
          "validFrom": "2023-12-25",
          "validTo": "2023-12-25"
        }
      ],
      "fullNames": [
        {
          "value": "<string>",
          "validFrom": "2023-12-25",
          "validTo": "2023-12-25"
        }
      ],
      "legalForms": [
        {
          "value": {
            "value": "<string>",
            "code": "<string>",
            "codelistCode": "<string>"
          },
          "validFrom": "2023-12-25",
          "validTo": "2023-12-25"
        }
      ],
      "establishment": "2023-12-25",
      "termination": "2023-12-25"
    }
  ],
  "license": "<string>"
}

​
Filters

All filters combine with AND logic — every filter added narrows the results.
Filter typeBehaviour
Exact matchUsed by identifier and orgUnitsIdentifier.
FulltextCase and diacritic insensitive. Minimum 3 characters.
Date rangeFormat must be YYYY-MM-DD — anything else returns 400.

​
Result limits

Search returns a maximum of 500 results with no pagination. If your query matches more than 500 entities, only the first 500 are returned — with no indication that results were truncated. Narrow your filters to stay under the limit. If you need the full register, use Local storage instead.

​
Common patterns

The fastest and most precise search. identifier is an exact match so the 3-character minimum doesn’t apply.
GET /search?identifier=31333565

GET /search?fullName=Acme&addressMunicipality=Bratislava

GET /search?establishmentAfter=2020-01-01&establishmentBefore=2020-12-31&onlyActive=true
Statutory body filters find all entities where a specific person holds a director or officer role.
GET /search?statutoryBodyFamilyName=Novak&statutoryBodyGivenName=Jan
Use dbModificationDateAfter to detect changes since a known date — useful for keeping a local copy in sync.
GET /search?dbModificationDateAfter=2025-07-01&onlyActive=true
Data refreshes nightly. Changes from the last 24 hours may not appear yet.

Query Parameters

​
identifier
string

IČO — exact match against identifiers[*].value.

​
fullName
string

Full registered name of the entity. Fulltext, min 3 characters.

Minimum string length: 3
​
legalForm
string

Legal form (e.g. s.r.o., a.s.). Fulltext, min 3 characters.

Minimum string length: 3
​
legalStatus
string

Legal status of the entity. Fulltext, min 3 characters.

Minimum string length: 3
​
addressMunicipality
string

Municipality of the registered address. Fulltext, min 3 characters.

Minimum string length: 3
​
addressStreet
string

Street of the registered address. Fulltext, min 3 characters.

Minimum string length: 3
​
establishmentAfter
string<date>

Filter entities established on or after this date. Format: YYYY-MM-DD.

​
establishmentBefore
string<date>

Filter entities established on or before this date. Format: YYYY-MM-DD.

​
terminationAfter
string<date>

Filter entities terminated on or after this date. Format: YYYY-MM-DD.

​
terminationBefore
string<date>

Filter entities terminated on or before this date. Format: YYYY-MM-DD.

​
onlyActive
boolean

When true, returns only active entities — those with no termination date.

​
dbModificationDateAfter
string<date>

Filter entities last modified on or after this date. Format: YYYY-MM-DD.

​
dbModificationDateBefore
string<date>

Filter entities last modified on or before this date. Format: YYYY-MM-DD.

​
mainActivity
string

Main economic activity. Fulltext, min 3 characters.

Minimum string length: 3
​
esa2010
string

ESA 2010 institutional classification. Fulltext, min 3 characters.

Minimum string length: 3
​
sourceRegister
string

Source register the entity is drawn from. Fulltext, min 3 characters.

Minimum string length: 3
​
stakeholderType
string

Type of interested party (e.g. shareholder, partner). Fulltext, min 3 characters.

Minimum string length: 3
​
stakeholderPersonGivenName
string

Given name of an interested party who is a natural person. Fulltext, min 3 characters.

Minimum string length: 3
​
stakeholderPersonFamilyName
string

Family name of an interested party who is a natural person. Fulltext, min 3 characters.

Minimum string length: 3
​
stakeholderCompanyName
string

Full name of a legal entity acting as an interested party. Fulltext, min 3 characters.

Minimum string length: 3
​
statutoryBodyType
string

Type of statutory body (e.g. director, board). Fulltext, min 3 characters.

Minimum string length: 3
​
statutoryBodyGivenName
string

Given name of a statutory body member who is a natural person. Fulltext, min 3 characters.

Minimum string length: 3
​
statutoryBodyFamilyName
string

Family name of a statutory body member who is a natural person. Fulltext, min 3 characters.

Minimum string length: 3
​
statutoryBodyCompanyName
string

Full name of a legal entity acting as statutory body. Fulltext, min 3 characters.

Minimum string length: 3
​
orgUnitsIdentifier
string

IČO of an organisational unit — exact match.

​
orgUnitsFullName
string

Full name of an organisational unit. Fulltext, min 3 characters.

Minimum string length: 3
​
orgUnitsStakeholderPersonGivenName
string

Given name of an interested party within an organisational unit. Fulltext, min 3 characters.

Minimum string length: 3
​
orgUnitsStakeholderPersonFamilyName
string

Family name of an interested party within an organisational unit. Fulltext, min 3 characters.

Minimum string length: 3
​
orgUnitsStakeholderCompanyName
string

Full name of a legal entity acting as interested party within an organisational unit. Fulltext, min 3 characters.

Minimum string length: 3

Response

Matching entities returned successfully.

​
results
object[]
required

Matching entities. Maximum 500 records per request.

​
license
string
required

License statement for this data.