Lookup

GET /v1/lookup/{id} by IČO, DIČ or IČ DPH, and what each section of the answer means.

GET /v1/lookup/{id}

id is an IČO (8 digits), a DIČ (10 digits) or an IČ DPH (SK + 10 digits). Anything else is 400 invalid_identifier.

Looked up by	Returns
IČO	One subject.
DIČ	The subject with that DIČ. A natural person without an IČO gets only `taxpayer` (DIČ, name, municipality), and only for an authenticated key on an instance without anonymous access.
IČ DPH	Every subject registered under it: one, or several for a VAT group.

Example

{
  "type": "ico",
  "subjects": [
    {
      "ico": "99900001",
      "identity": {
        "state": "present",
        "source": { "dataset": "rpo", "asOf": "2026-11-10", "version": "4f2a…", "stale": false },
        "name": "Zlatá Rybka, s.r.o.",
        "kind": "legal_person",
        "legalForm": "Spoločnosť s ručením obmedzeným",
        "establishedOn": "2020-01-01",
        "active": true,
        "address": { "street": "Testovacia", "buildingNumber": "1/1", "postalCode": "999 99", "municipality": "Fiktívne Mesto", "country": "Slovenská republika" },
        "registrations": [
          { "register": "Obchodný register", "registerCode": "1", "office": "Okresný súd Fiktívny", "number": "Sro/1/F", "validFrom": "2020-01-01", "name": "Zlatá Rybka, s.r.o.", "active": true }
        ],
        "icoChecksumValid": true
      },
      "tax": { "state": "present", "source": { "dataset": "ds_dsrdp", "asOf": "2026-11-10", "version": "…", "stale": false }, "dic": "2099900001" },
      "vat": {
        "state": "present",
        "source": { "dataset": "ds_dphs", "asOf": "2026-11-10", "version": "…", "stale": false },
        "icDph": "SK2099900001", "paragraph": "§4", "payer": true, "registeredOn": "2020-08-01", "payerFrom": "2020-08-01"
      },
      "risk": { "state": "present", "source": { "dataset": "ds_iz_ran,ds_dphz,ds_dphv,ds_dpho", "asOf": "2026-11-10", "stale": false }, "reliabilityIndex": "spoľahlivý" }
    }
  ],
  "attribution": ["Register právnických osôb, Ministerstvo vnútra SR, CC BY 4.0", "Zdroj údajov: Finančná správa SR"]
}

The highlighted lines are the ones to read first: each section’s state and source (how sure the answer is and as of when), the VAT paragraph with payer, and the attribution you must show with the data.

Sections

Section	Source	Holds
`identity`	RPO	Display name, kind, legal form, dates, address, every registration, the IČO check-digit warning.
`tax`	`ds_dsrdp`	DIČ.
`vat`	`ds_dphs`	IČ DPH, paragraph, payer, dates. See VAT status.
`risk`	`ds_iz_ran`, `ds_dphz`, `ds_dphv`, `ds_dpho`	Reliability index and risk-list entries.

Each section has a state (present, absent, unknown) and a source with the dataset, its asOf date, changedAt, a content version and a stale flag. See Freshness and certainty.

The register entry on documents

identity.registrations[] gives the court and the oddiel/vložka (Commercial Register) or the office and the number (Trade Register), so a consumer can pre-fill a supplier’s legal line. Let the user confirm it. Building the genitive form of the court name and the exact wording is the consumer’s job.

Status codes

Code	When
`200`	Found (some sections may be `unknown` or `stale`).
`400`	Not an identifier.
`403`	A natural person by DIČ on an instance with anonymous access.
`404`	Not found, and every consulted source is fresh.
`503`	Not found while a source is stale (`source_stale`), or the mirror is not built yet (`bootstrapping`).