Skip to main content
GET
/
entity
/
{id}
Get entity detail
curl --request GET \
  --url https://api.statistics.sk/rpo/v1/entity/{id}
{
  "id": 123,
  "dbModificationDate": "2023-12-25",
  "identifiers": [
    {
      "value": "<string>",
      "validFrom": "2023-12-25",
      "validTo": "2023-12-25"
    }
  ],
  "fullNames": [
    {
      "value": "<string>",
      "validFrom": "2023-12-25",
      "validTo": "2023-12-25"
    }
  ],
  "alternativeNames": [
    {
      "value": "<string>",
      "validFrom": "2023-12-25",
      "validTo": "2023-12-25"
    }
  ],
  "addresses": [
    {
      "formatedAddress": "<string>",
      "validFrom": "2023-12-25",
      "validTo": "2023-12-25",
      "street": "<string>",
      "regNumber": 123,
      "buildingNumber": "<string>",
      "postalCodes": [
        "<string>"
      ],
      "municipality": {
        "value": "<string>",
        "code": "<string>",
        "codelistCode": "<string>"
      },
      "country": {
        "value": "<string>",
        "code": "<string>",
        "codelistCode": "<string>"
      },
      "district": {
        "value": "<string>",
        "code": "<string>",
        "codelistCode": "<string>"
      },
      "buildingIndex": "<string>"
    }
  ],
  "legalForms": [
    {
      "value": {
        "value": "<string>",
        "code": "<string>",
        "codelistCode": "<string>"
      },
      "validFrom": "2023-12-25",
      "validTo": "2023-12-25"
    }
  ],
  "establishment": "2023-12-25",
  "termination": "2023-12-25",
  "activities": [
    {
      "economicActivityDescription": "<string>",
      "validFrom": "2023-12-25",
      "validTo": "2023-12-25",
      "suspendedFrom": "2023-12-25",
      "suspendedTo": "2023-12-25"
    }
  ],
  "statutoryBodies": [
    {
      "stakeholderType": {
        "value": "<string>",
        "code": "<string>",
        "codelistCode": "<string>"
      },
      "statutoryBodyMember": {
        "value": "<string>",
        "code": "<string>",
        "codelistCode": "<string>"
      },
      "validFrom": "2023-12-25",
      "validTo": "2023-12-25",
      "address": {
        "formatedAddress": "<string>",
        "validFrom": "2023-12-25",
        "validTo": "2023-12-25",
        "street": "<string>",
        "regNumber": 123,
        "buildingNumber": "<string>",
        "postalCodes": [
          "<string>"
        ],
        "municipality": {
          "value": "<string>",
          "code": "<string>",
          "codelistCode": "<string>"
        },
        "country": {
          "value": "<string>",
          "code": "<string>",
          "codelistCode": "<string>"
        },
        "district": {
          "value": "<string>",
          "code": "<string>",
          "codelistCode": "<string>"
        },
        "buildingIndex": "<string>"
      },
      "personName": {
        "formatedName": "<string>",
        "givenNames": [
          "<string>"
        ],
        "familyNames": [
          "<string>"
        ],
        "givenFamilyNames": [
          "<string>"
        ],
        "prefixes": [
          {
            "value": "<string>",
            "code": "<string>",
            "codelistCode": "<string>"
          }
        ],
        "postfixes": [
          {
            "value": "<string>",
            "code": "<string>",
            "codelistCode": "<string>"
          }
        ]
      },
      "identifier": "<string>",
      "fullName": "<string>",
      "establishment": "2023-12-25",
      "termination": "2023-12-25"
    }
  ],
  "stakeholders": [
    {
      "stakeholderType": {
        "value": "<string>",
        "code": "<string>",
        "codelistCode": "<string>"
      },
      "validFrom": "2023-12-25",
      "validTo": "2023-12-25",
      "address": {
        "formatedAddress": "<string>",
        "validFrom": "2023-12-25",
        "validTo": "2023-12-25",
        "street": "<string>",
        "regNumber": 123,
        "buildingNumber": "<string>",
        "postalCodes": [
          "<string>"
        ],
        "municipality": {
          "value": "<string>",
          "code": "<string>",
          "codelistCode": "<string>"
        },
        "country": {
          "value": "<string>",
          "code": "<string>",
          "codelistCode": "<string>"
        },
        "district": {
          "value": "<string>",
          "code": "<string>",
          "codelistCode": "<string>"
        },
        "buildingIndex": "<string>"
      },
      "personName": {
        "formatedName": "<string>",
        "givenNames": [
          "<string>"
        ],
        "familyNames": [
          "<string>"
        ],
        "givenFamilyNames": [
          "<string>"
        ],
        "prefixes": [
          {
            "value": "<string>",
            "code": "<string>",
            "codelistCode": "<string>"
          }
        ],
        "postfixes": [
          {
            "value": "<string>",
            "code": "<string>",
            "codelistCode": "<string>"
          }
        ]
      },
      "identifier": "<string>",
      "fullName": "<string>",
      "establishment": "2023-12-25",
      "termination": "2023-12-25"
    }
  ],
  "legalStatuses": [
    {
      "value": {
        "value": "<string>",
        "code": "<string>",
        "codelistCode": "<string>"
      },
      "validFrom": "2023-12-25",
      "validTo": "2023-12-25"
    }
  ],
  "otherLegalFacts": "<array>",
  "authorizations": "<array>",
  "equities": {
    "shares": "<unknown>",
    "deposits": "<unknown>"
  },
  "sourceRegister": {},
  "predecessors": "<array>",
  "successors": "<array>",
  "statisticalCodes": {},
  "organizationUnits": "<array>",
  "license": "<string>"
}

​
Parameters

By default the response includes only current field values.
ParameterWhen present
showHistoricalData=trueIncludes past entries for all timed fields.
showOrganizationUnits=trueIncludes the entity’s organisational units.
Only the literal string true is accepted — 1, yes, and other truthy values silently evaluate to false.

​
Working with timed fields

Most array fields are time-scoped — the current value is always the entry with no validTo. 
// Current name
const name = entity.fullNames.find(e => !e.validTo)?.value;

// Current address
const address = entity.addresses.find(a => !a.validTo);
console.log(address?.formatedAddress);

​
Common patterns

Returns current field values only.
GET /entity/12345678
Includes all historical entries for timed fields — past names, addresses, legal forms, and more.
GET /entity/12345678?showHistoricalData=true

GET /entity/12345678?showOrganizationUnits=true
termination is absent when the entity is still active — null fields are omitted from the response entirely.
const isActive = entity.termination == null;

const current = entity.statutoryBodies.filter(b => !b.validTo);

current.forEach(b => {
  const name = b.personName?.formatedName ?? b.fullName;
  console.log(name);
});

Path Parameters

​
id
integer<int64>
required

Unique entity identifier — obtained from a search result.

Query Parameters

​
showHistoricalData
boolean

When true, includes historical entries for all timed fields — entries where validTo is set.

​
showOrganizationUnits
boolean

When true, includes the entity's organisational units in the response.

Response

Full entity record returned successfully.

Full entity record as returned by the detail endpoint.

​
id
integer<int64>

Unique entity identifier.

​
dbModificationDate
string<date>

Date this record was last updated in the database. Format: YYYY-MM-DD. Note: data refreshes nightly — recent changes may lag up to 24 hours.

​
identifiers
object[]

IČO history. The current IČO is the entry with no validTo.

​
fullNames
object[]

Registered name history. The current name is the entry with no validTo.

​
alternativeNames
object[]

Alternative name history.

​
addresses
object[]

Registered address history. The current address is the entry with no validTo.

​
legalForms
object[]

Legal form history from codelist CL000056.

​
establishment
string<date>

Date the entity was established.

​
termination
string<date> | null

Date the entity was dissolved. Absent if still active.

​
activities
object[]

Registered economic activities. Each activity can be active, suspended, or deregistered independently.

​
statutoryBodies
object[]

Persons or organisations authorised to act on behalf of the entity.

​
stakeholders
object[]

Persons or organisations with a formal relationship to the entity — shareholders, partners, members, and similar.

​
legalStatuses
object[]

Legal status history from codelist CL010108.

​
otherLegalFacts
array

Other legal facts recorded against the entity.

​
authorizations
array

Authorisations to act on behalf of the entity.

​
equities
object

Share capital information including shares and deposits.

​
sourceRegister
object

The source register this entity's data is drawn from, from codelist CL010112.

​
predecessors
array

Legal predecessors of this entity.

​
successors
array

Legal successors of this entity.

​
statisticalCodes
object

Statistical classification codes including economic activity (CL005205) and ESA 2010 sub-sector (CL010010).

​
organizationUnits
array

Organisational units (branches). Only included when showOrganizationUnits=true.

​
license
string

License statement for this data.