---
title: "IČO autofill lookup — minimal payload"
method: GET
path: "/v1/lookup/{ico}"
tags: ["lookup"]
---

# IČO autofill lookup — minimal payload

`GET /v1/lookup/{ico}`

## Request

- Base URL: `https://api.orsf.sk`
- URL: `https://api.orsf.sk/v1/lookup/{ico}`
- Auth: none declared

Ultra-fast lookup for exactly one job: autofilling a form or invoice with a company's identification data — name, address, DIČ (tax ID), IČ DPH (VAT ID), legal form, status. Payload is ~99% smaller than GET /v1/companies/{ico} (no roles/filings/activities). Redis-cached 24h — server response typically 1-50ms. Anonymous access allowed (rate-limited); Bearer token raises quota and unlocks the full address for sole traders (GDPR gate, see addressLocked).

## Path parameters

- `ico` string, required

## Response `200`

Lookup result

- LookupResponse
  - `ico` string, required
  - `dic` string, nullable
  - `icDph` string, nullable
  - `name` string, required
  - `legalForm` string, nullable
  - `status` string, nullable
  - `establishedOn` string, date, nullable
  - `dissolvedOn` string, date, nullable
  - `address` object, required
    - `street` string, nullable, required
    - `city` string, nullable, required
    - `psc` string, nullable, required
    - `country` string, required
  - `isVatPayer` boolean, required
  - `register` string, nullable
  - `nace` string, nullable
  - `fetchedAt` string, date-time, required
  - `sources` string[], required
  - `addressLocked` boolean: True if street/psc are hidden by the GDPR address gate (anon + sole trader). Sign in for full address.

## Other responses

- `404`: Resource not found
- `429`: Too many requests — see Retry-After header

---

[API](https://skmtc.dev/orsf/apis/orsf-api-open-register-of-slovak-companies.md) · [All operations](https://skmtc.dev/orsf/apis/orsf-api-open-register-of-slovak-companies/llms.txt) · [OpenAPI document](https://skmtc.dev/orsf/apis/orsf-api-open-register-of-slovak-companies/revisions/21d1be487652?raw)