API GUS (REGON) po NIP
REST/JSON bez klucza

Jeden GET, jeden JSON

Endpoint jest publiczny, metoda GET, a parametr ?format=json zwraca dane maszynowo (bez niego dostajesz stronę HTML dla człowieka):

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

W odpowiedzi dostajesz oficjalną nazwę, numer REGON, adres siedziby i formę prawną (u osób fizycznych i spółek cywilnych od 27.09.2026 tylko nazwę, formę, miejscowość i status działalności — szczegóły niżej) — prosto z rejestru REGON prowadzonego przez GUS:

{
  "nip": "5260250995",
  "source": "regon-gus",
  "regon": "012100784",
  "dane": {
    "regon": "012100784",
    "nip": "5260250995",
    "nazwa": "ORANGE POLSKA SPÓŁKA AKCYJNA",
    "wojewodztwo": "MAZOWIECKIE",
    "powiat": "Warszawa",
    "gmina": "Ochota",
    "miejscowosc": "Warszawa",
    "kodPocztowy": "02-326",
    "ulica": "Aleje Jerozolimskie",
    "nrNieruchomosci": "160",
    "typ": "P",
    "dataZakonczenia": ""
  },
  "privacy": null,
  "checkedAt": "2026-08-23"
}

Bez klucza API, bez rejestracji, bez limitu dziennego

Endpoint działa od razu — nie musisz zakładać konta, generować klucza API ani pilnować dziennego limitu zapytań. Jedyne ograniczenie chroni serwis przed nadużyciami: najwyżej 20 zapytań na 10 sekund z jednego adresu IP (po przekroczeniu kod 429 przez 10 sekund; od 25.09.2026). To celowa różnica względem komercyjnych nakładek na GUS: chcemy, żeby integrację dało się wpiąć w minutę, także z poziomu agenta AI. Serwis jest bezpłatny i służy do pojedynczych zapytań inicjowanych przez użytkowników lub ich agentów, nie do masowego pobierania danych.

Zamiast GUS BIR SOAP

Oficjalna usługa GUS to BIR 1.1 — SOAP z sekwencją Zaloguj → DaneSzukajPodmioty → Wyloguj, identyfikatorem sesji w nagłówku, kopertami XML i odpowiedziami w formacie MTOM. Działa, ale integracja potrafi zająć popołudnie. Nasz endpoint robi to wszystko po stronie serwera i zwraca gotowy JSON — Ty wysyłasz jeden GET.

Co zwraca /regon/{nip}:

Dla jednoosobowych działalności (osoby fizyczne, typ F i LF) i spółek cywilnych (GUS zapisuje je jako typ P, więc rozpoznajemy je po nazwie: „S.C.” albo „spółka cywilna” jako ostatnie oznaczenie formy) od 27.09.2026 zwracamy w dane tylko NIP, nazwę, typ, formę (forma) i miejscowość oraz status działalności (status: active albo ended) — bez numeru REGON, adresu, gminy, powiatu, województwa i dat (RODO, zasada minimalizacji danych; od 26.09.2026 bez ulicy, numeru i kodu pocztowego). Numer REGON i pełny wpis publikuje GUS w wyszukiwarce REGON. Takie odpowiedzi mają nagłówki X-Robots-Tag: noindex i Cache-Control: private, max-age=3600. Tak samo działa narzędzie MCP sprawdz_regon, a /firma-po-regon/{regon} dla REGON-u osoby fizycznej nie zwraca żadnych danych (to byłoby ustalanie tożsamości po samym numerze) — tylko odesłanie do wyszukiwarki GUS.

W Pythonie

Z biblioteką requests całość to kilka linii:

import requests

def dane_regon(nip: str) -> dict:
    r = requests.get(f"https://skanfirmy.pl/regon/{nip}?format=json", timeout=10)
    r.raise_for_status()
    return r.json()["dane"]

d = dane_regon("5260250995")
print(d["nazwa"], "· REGON", d["regon"])
# ORANGE POLSKA SPÓŁKA AKCYJNA · REGON 012100784

Podmiot spoza rejestru zwraca 404, a NIP z błędną sumą kontrolną — 400. Warto obsłużyć oba przypadki, zamiast zakładać, że każdy NIP ma wpis.

W JavaScripcie

const r = await fetch("https://skanfirmy.pl/regon/5260250995?format=json");
if (r.ok) {
  const { dane } = await r.json();
  console.log(dane.nazwa, dane.regon);
}

W PHP

$ch = curl_init("https://skanfirmy.pl/regon/5260250995?format=json");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$dane = json_decode(curl_exec($ch), true)["dane"];
echo $dane["nazwa"] . " · REGON " . $dane["regon"];

Więcej niż REGON — jednym NIP-em

Jeśli oprócz danych GUS potrzebujesz statusu VAT i wpisu w KRS, użyj /nip/{nip}?format=json — łączy Wykaz VAT (Biała Lista, Ministerstwo Finansów), KRS i numer REGON (poza osobami fizycznymi) w jednej odpowiedzi. Pozostałe endpointy (wszystkie GET → JSON, bez klucza):

• /regon/{nip} — dane z rejestru REGON (GUS)
• /nip/{nip} — status VAT + Biała Lista + KRS + REGON (poza osobami fizycznymi)
• /nips/{lista} — wiele NIP-ów naraz (rozdzielonych przecinkami)
• /vies/{kraj}/{numer} — walidacja unijnego numeru VAT (VIES, Komisja Europejska)

Dla agentów AI pod adresem https://skanfirmy.pl/mcp stoi serwer Model Context Protocol (MCP) z narzędziem sprawdz_regon (i kilkoma innymi do NIP, KRS i VIES) — również bez klucza. Mapa endpointów dla modeli jest w llms.txt, a pełna specyfikacja maszynowa w OpenAPI 3.1. Weryfikację po NIP w interfejsie zrobisz w narzędziu REGON (GUS).

Publiczny endpoint a typowe płatne API GUS

Większość komercyjnych nakładek REST na rejestr GUS działa w modelu freemium — konto, klucz API i dzienny limit zapytań w darmowym progu. Ten endpoint jest publiczny i bezpłatny. Różnice w skrócie:

To nie jest oficjalne API GUS — dane pochodzą z tego samego źródła (rejestr REGON, usługa BIR), tylko udostępnione jednym zapytaniem GET.

Skąd pochodzą dane i czym to nie jest

Dane pochodzą wprost z rejestru REGON prowadzonego przez Główny Urząd Statystyczny (usługa BIR). To niezależne narzędzie — nie jest oficjalnym API GUS ani z nim powiązane; jedynie udostępnia jego dane w wygodniejszej formie. Zakres i aktualność danych są takie, jak w rejestrze GUS.

Najczęstsze pytania