Get accounting unit

curl --request GET \
  --url https://www.registeruz.sk/cruz-public/api/uctovna-jednotka

{
  "id": 123,
  "ico": "<string>",
  "dic": "<string>",
  "sid": "<string>",
  "nazovUJ": "<string>",
  "ulica": "<string>",
  "mesto": "<string>",
  "psc": "<string>",
  "datumZalozenia": "<string>",
  "datumZrusenia": "<string>",
  "pravnaForma": "<string>",
  "skNace": "<string>",
  "velkostOrganizacie": "<string>",
  "druhVlastnictva": "<string>",
  "kraj": "<string>",
  "okres": "<string>",
  "sidlo": "<string>",
  "konsolidovana": true,
  "idUctovnychZavierok": [
    123
  ],
  "idVyrocnychSprav": [
    123
  ],
  "zdrojDat": "<string>",
  "datumPoslednejUpravy": "<string>",
  "stav": "<string>"
}

GET

api

uctovna-jednotka

Get accounting unit

curl --request GET \
  --url https://www.registeruz.sk/cruz-public/api/uctovna-jednotka

{
  "id": 123,
  "ico": "<string>",
  "dic": "<string>",
  "sid": "<string>",
  "nazovUJ": "<string>",
  "ulica": "<string>",
  "mesto": "<string>",
  "psc": "<string>",
  "datumZalozenia": "<string>",
  "datumZrusenia": "<string>",
  "pravnaForma": "<string>",
  "skNace": "<string>",
  "velkostOrganizacie": "<string>",
  "druhVlastnictva": "<string>",
  "kraj": "<string>",
  "okres": "<string>",
  "sidlo": "<string>",
  "konsolidovana": true,
  "idUctovnychZavierok": [
    123
  ],
  "idVyrocnychSprav": [
    123
  ],
  "zdrojDat": "<string>",
  "datumPoslednejUpravy": "<string>",
  "stav": "<string>"
}

To get an accounting unit ID, use List accounting units.

Learn more about Data access pattern used across the RÚZ API.

Common patterns

Handle deleted and non-public records

You can get three types of records, indicated by the stav value:

Type	Field value
Normal	—
Deleted	`"ZMAZANÉ"`
Non-public	`"Neverejná"`

Handling deleted and non-public records

// 1. Fetch the accounting unit by ID
const unit = await fetchUnit(id);

// 2. Handle deleted record
if (unit.stav === 'ZMAZANÉ') {
  // Do something
} 

// 3. Handle non-public record
else if (unit.stav === 'Neverejná') {
  // Do something
} 

// 4. Handle normal record
else {
  // Do something
}

Follow links to financial statements and annual reports

Use idUctovnychZavierok to fetch the entity’s statements.
Use idVyrocnychSprav to fetch the entity’s annual reports.

Fetch statements and annual reports from unit IDs

// 1. Fetch the accounting unit
const unit = await fetchUnit(336953);

// 2. Fetch the financial statements
const statements = await Promise.all(
  (unit.idUctovnychZavierok ?? []).map(id => fetchStatement(id))
);

// 2. Fetch the annual reports
const annualReports = await Promise.all(
  (unit.idVyrocnychSprav ?? []).map(id => fetchAnnualReport(id))
);

Check if a unit is still active

You can use the datumZrusenia field to check if a unit is still active. It is absent when the unit is still active and null fields are omitted from the response entirely.

Check whether the unit is still active

// 1. Fetch the accounting unit
const unit = await fetchUnit(336953);

// 2. Check if the unit is still active
const isActive = unit.datumZrusenia == null;

Resolve a classification code

Codes like pravnaForma, skNace, and druhVlastnictva are returned as raw codes. Resolve them against the codelist endpoints.

Resolve a classification code

// 1. Fetch the accounting unit
const unit = await fetchUnit(336953);

// 2. Fetch the legal forms
const legalForms = await fetchLegalForms();

// 3. Resolve the legal form
const label = legalForms.find(f => f.kod === unit.pravnaForma)?.nazov?.sk;

// 4. Log the legal form
console.log(label);

Query Parameters

integer

required

Entity identifier — obtained from an identifier list endpoint.

Response

Accounting unit returned successfully.

An accounting unit (účtovná jednotka) — the root entity in RÚZ. Links to financial statements via idUctovnychZavierok and annual reports via idVyrocnychSprav.

integer

Unique identifier.

ico

string

IČO — company registration number (8 characters).

dic

string

DIČ — tax identification number (10 characters).

sid

string

SID — statistical identifier (max 5 characters).

nazovUJ

string

Registered name.

ulica

string

Street address.

mesto

string

City.

psc

string

Postal code.

datumZalozenia

string

Date established (YYYY-MM-DD).

datumZrusenia

string

Date dissolved (YYYY-MM-DD). Absent if still active.

pravnaForma

string

Legal form code. Resolve with List legal forms.

skNace

string

SK NACE economic activity code. Resolve with List SK NACE codes.

velkostOrganizacie

string

Organisation size code. Resolve with List organisation sizes.

druhVlastnictva

string

Ownership type code. Resolve with List ownership types.

kraj

string

Region code. Resolve with List regions.

okres

string

District code. Resolve with List districts.

sidlo

string

Municipality code. Resolve with List municipalities.

konsolidovana

boolean

Whether this unit has a consolidated financial statement.

idUctovnychZavierok

integer[]

IDs of linked financial statements.

idVyrocnychSprav

integer[]

IDs of linked annual reports.

zdrojDat

string

Data source code.

datumPoslednejUpravy

string

Date last modified (YYYY-MM-DD). Used for zmenene-od filtering.

stav

string

Present only for deleted or non-public records. ZMAZANÉ for deleted, Neverejná for non-public.

List annual reports

Get financial statement

​Common patterns

Query Parameters

Response

Common patterns