---
title: "Batch IČO lookup — up to 100 per request"
method: POST
path: "/v1/lookup/batch"
tags: ["lookup"]
---

# Batch IČO lookup — up to 100 per request

`POST /v1/lookup/batch`

## Request

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

Bulk variant of GET /v1/lookup/{ico} for KYC/batch jobs. Max 100 IČOs per request. Mixes cache hits and misses transparently — response order matches request order.

## Request body

- object
  - `icos` string[], required

## Response `200`

Batch results — one entry per requested IČO, in order

- object
  - `results` union[], required
    - union
      - 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.
      - object
        - `ico` string, required
        - `found` false, required
  - `cached` integer, required: How many results were served from cache
  - `fetched` integer, required: How many required a fresh DB query

## Other responses

- `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)