KRS API by NIP
keyless REST/JSON

One GET, one JSON

The endpoint is public, the method is GET, and the ?format=json parameter returns machine-readable data (without it you get an HTML page for humans). The KRS data lives in the krs field:

curl "https://skanfirmy.pl/nip/5260250995?format=json"

The krs field gives you selected data from the current KRS extract — the KRS number, name, legal form, share capital, the representation body and rule, board functions (without names) and PKD codes:

{
  "krs": {
    "numerKRS": "0000010681",
    "nazwa": "ORANGE POLSKA SPÓŁKA AKCYJNA",
    "formaPrawna": "SPÓŁKA AKCYJNA",
    "nip": "5260250995",
    "regon": "012100784",
    "opp": false,
    "adres": "AL. JEROZOLIMSKIE 160, 02-326, WARSZAWA",
    "kapital": "3937072437,00 PLN",
    "organ": "ZARZĄD SPÓŁKI",
    "sposobReprezentacji": "PREZES ŁĄCZNIE Z CZŁONKIEM ZARZĄDU",
    "sklad": ["CZŁONEK ZARZĄDU", "..."],
    "pkdMain": [{ "code": "61.10.B", "opis": "POZOSTAŁA DZIAŁALNOŚĆ W ZAKRESIE TELEKOMUNIKACJI ..." }],
    "pkdOther": [{ "code": "78.10.Z", "opis": "..." }],
    "dataRejestracji": "02.05.2001",
    "dataOstatniegoWpisu": "24.04.2026",
    "stanZDnia": "24.04.2026",
    "dataCzasOdpisu": "25.08.2026 14:59:57"
  }
}

No API key, no sign-up

The endpoint works right away: no account to create, no API key to generate. That is a deliberate difference from commercial KRS wrappers: the goal is an integration you can wire up in a minute, including from an AI agent. A limit protects the service from abuse: at most 20 requests per 10 seconds from one IP address (above that, HTTP 429 for 10 seconds; since 25 Sep 2026). We have no daily limit of our own, but /nip first queries the VAT White List, and the Ministry of Finance API has a daily limit — once it is exhausted, /nip answers 503 with a Retry-After header. The /krs/{krs-number} endpoint queries only KRS and is not affected by that limit. The service is free of charge and meant for single lookups triggered by users or their agents, not for bulk data harvesting.

Lookup by NIP, not by KRS number

The official KRS API from the Ministry of Justice is looked up by KRS number — you need to have it from somewhere first, and the response is a full extract in an elaborate JSON structure (separate sections, divisions and entries). In practice you usually have the NIP, not the KRS number. Our endpoint takes the NIP, finds the right entry server-side, and returns a flat, ready-to-use set of fields.

What the krs field in the /nip/{nip} response returns:

If an entity is not in KRS (e.g. a sole proprietorship registered only in CEIDG), the krs field is null. In that case use the REGON register via /regon/{nip} — for a natural person it returns only the name, form, town and activity status; we do not return the PKD codes of natural persons (since 27 Sep 2026 the ceidg field of the /nip response is always null), the full entry is in CEIDG. The krsError field does not describe a missing KRS entry: it has a value (the KRS number) only when the White List gives a KRS number but the extract could not be retrieved from the KRS API (error, timeout or no extract). Since 26 Sep 2026, data on entities outside KRS — natural persons — is returned in a narrower scope (the number of bank accounts instead of the list, the town instead of the address, and since 27 Sep 2026 no REGON number or PKD codes); details in the VAT White List API and the GUS (REGON) API.

Already have the KRS number? Direct endpoint

If you know the KRS number (10 digits, leading zeros allowed), you can fetch the same data without a NIP — via GET /krs/{krs-number}. It returns JSON only: a {source, krs, checkedAt} object whose krs field has the same fields as the krs object above (legal form, share capital, representing body, representation rule, PKD codes). Handy when you already hold a KRS number from another source and don't want to go via NIP.

curl "https://skanfirmy.pl/krs/0000028860"

In Python

With the requests library it is a few lines:

import requests

def krs_data(nip: str) -> dict | None:
    r = requests.get(f"https://skanfirmy.pl/nip/{nip}?format=json", timeout=10)
    r.raise_for_status()
    return r.json().get("krs")

k = krs_data("5260250995")
if k:
    print(k["formaPrawna"], "·", k["kapital"])
    for role in k["sklad"]:
        print(" -", role)
# SPÓŁKA AKCYJNA · 3937072437,00 PLN

A NIP with an invalid checksum returns 400, and an entity that is not in KRS has krs: null — it is worth handling both instead of assuming every NIP has a court-register entry.

In JavaScript

const r = await fetch("https://skanfirmy.pl/nip/5260250995?format=json");
const { krs } = await r.json();
if (krs) {
  console.log(krs.formaPrawna, krs.kapital);
  console.log(krs.pkdMain[0].code, krs.pkdMain[0].opis);
}

In PHP

$ch = curl_init("https://skanfirmy.pl/nip/5260250995?format=json");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$krs = json_decode(curl_exec($ch), true)["krs"];
if ($krs) {
    echo $krs["formaPrawna"] . " · " . $krs["kapital"];
}

More than KRS, from one NIP

The same /nip/{nip}?format=json endpoint, besides the krs field, also returns the VAT status from the VAT taxpayer register (White List, Ministry of Finance) and the REGON number (except for natural persons) — all in one response. The other endpoints (all GET → JSON, no key):

• /nip/{nip} — VAT status + White List + KRS + REGON (except for natural persons)
• /regon/{nip} — data from the REGON register (GUS)
• /nips/{list} — several NIPs at once (comma-separated)
• /vies/{country}/{number} — EU VAT number validation (VIES, European Commission)

For AI agents, at https://skanfirmy.pl/mcp there is a Model Context Protocol (MCP) server with a sprawdz_nip tool that returns the same krs field (and several others for REGON, VIES and NIP lists), also with no key. A model-readable map of the endpoints is in llms.txt, and the full machine spec is in OpenAPI 3.1. For a lookup in the UI, use the KRS data tool.

The public endpoint vs a typical paid KRS API

Most commercial REST wrappers over KRS run on a freemium model — an account, an API key and a daily request limit on the free tier — and on top of that they look up by KRS number. This endpoint is public, free, and takes a NIP. The differences in short:

This is not the official KRS API — the data comes from the same source (the National Court Register, Ministry of Justice), just exposed with a single GET request by NIP.

Where the data comes from, and what this is not

The data comes straight from the National Court Register (KRS) kept by the Ministry of Justice. This is an independent tool; it is not the official KRS API and is not affiliated with it — it only exposes KRS data in a more convenient form. PKD codes and their descriptions are Poland's legal business classification and are returned as-is (not translated), even on this English page. The scope and freshness of the data match the KRS register.

Frequently asked questions