Skip to main content

Documentation Index

Fetch the complete documentation index at: https://slovakapi.dev/llms.txt

Use this file to discover all available pages before exploring further.

​
What are codelists?

Categorical fields like legal form, legal status, and municipality return a coded value rather than a plain string. Each coded value has the same shape: 
{
  "value": "spoločnosť s ručením obmedzeným",
  "code": "112",
  "codelistCode": "CL000056"
}
  • value — human-readable label in Slovak. Use for display.
  • code — stable entry key. Use for storing, filtering, and comparing.
  • codelistCode — identifies which codelist this value belongs to.
Most codelists are published by the Statistical Office of the Slovak Republic (ŠÚR). UCE and STA are maintained by the Ministry of Interior and are not publicly available in the same way.

​
Why codes matter

Codes are stable keys that never change — the human-readable label can. A field value might get a wording update, a typo fix, or a punctuation change in the source data. The code behind it won’t. Two situations where this matters:
  • Storing or comparing data. Always store the code, not the label. Matching on a label that could silently change will eventually break.
  • Building in another language. Use the code as a key into your own translation table instead of parsing Slovak strings.
code can be an empty string when no matching codelist entry exists. Always guard against "" before using it as a lookup key.

​
Codelist reference

CodeDescriptionResolves field
CL000025Municipalityaddress.municipality
CL000056Legal formlegalForms[].value
CL000062Title before namepersonName.prefixes[]
CL000063Title after namepersonName.postfixes[]
CL000083Currency unitequities
CL000086Countryaddress.country
CL005205Economic activitystatisticalCodes
CL010010ESA 2010 institutional sub-sectorstatisticalCodes
CL010108Legal statuslegalStatuses[].value
CL010109Type of interested partystakeholders[].stakeholderType
CL010110Type of organisational unitorganizationUnits
CL010111Type of shareequities.shares
CL010112Source registersourceRegister
CL010113Type of statutory bodystatutoryBodies[].stakeholderType
CL010141City quarteraddress.district
CL010470Role in collective statutory bodystatutoryBodies[].statutoryBodyMember
UCEMunicipality (Ministry of Interior)address.municipality, address.district
STACountry (Ministry of Interior)address.country

​
Resolving a code

Match on both code and codelistCode to avoid false positives — the same code string can appear in different codelists with different meanings. 
// Resolve the current legal form label
const form = entity.legalForms.find(f => !f.validTo);
console.log(form?.value.value); // "spoločnosť s ručením obmedzeným"

// Filter by a specific code
const isSro = entity.legalForms
  .filter(f => !f.validTo)
  .some(f =>
    f.value.codelistCode === "CL000056" &&
    f.value.code === "112"
  );

​
Dual codelists on address fields

municipality, district, and country can reference entries from either a Statistical Office or a Ministry of Interior codelist, depending on which source register the entity comes from. Always check codelistCode before doing a lookup.
FieldStatistical OfficeMinistry of Interior
municipalityCL000025UCE
districtCL010141UCE
countryCL000086STA
if (address.municipality.codelistCode === "CL000025") {
  // Statistical Office codelist
} else if (address.municipality.codelistCode === "UCE") {
  // Ministry of Interior codelist
}