Ładuję wyniki…
Serwis informacyjny na otwartych danych rejestrów publicznych RODO Regulamin
Firmogram

Otwarte API

bezpłatne · klucz darmowy z konta · JSON
Endpointy zwracają JSON i wymagają nagłówka X-API-Key — klucz generujesz bezpłatnie w Moje konto (fair-use: kesz serwerowy 24 h dla białej listy, rate-limit wobec rejestrów publicznych stosujemy po naszej stronie). Specyfikacja OpenAPI do importu w kreatorze GPT: /openapi.json. Podłącz Firmogram do Claude lub ChatGPT w 2 minuty — zobacz Firmogram dla asystentów AI.

GET /api/search?q= — wyszukiwanie

Wykrywa automatycznie typ identyfikatora (NIP z sumą kontrolną, KRS, REGON) lub szuka po nazwie. Nazwy szukane są w rejestrze KRS, a przy małej liczbie wyników dodatkowo w pełnym rejestrze (Wyszukiwarka PRS) — pole source wskazuje pochodzenie.

curl "https://firmogram.pl/api/search?q=7792420298"

GET /api/search?q= — wyszukiwanie

Wykrywa automatycznie typ zapytania: identyfikator (NIP z sumą kontrolną, KRS, REGON), kod PKD (np. 62.01.Z — wyszukiwanie działalności), nazwisko osoby w organach (dane zanonimizowane — dopasowanie po pierwszej literze i długości; wyniki w polu persons) albo nazwę (rejestr KRS + pełny rejestr, pole source).

curl "https://firmogram.pl/api/search?q=62.01.Z"     # PKD
curl "https://firmogram.pl/api/search?q=Kowalski"   # nazwisko (pole persons)

GET /api/firma/{krs} — pełny profil

Dane odpisu aktualnego KRS + wspólnicy z udziałami + zarząd + PKD + wynik ryzyka. Podmioty nieuwzględnione w serwisie pobierane są na żywo z KRS.

curl "https://firmogram.pl/api/firma/0000019636"

GET /api/firma/{krs}/historia — historia wpisów

Chronologia wpisów z odpisu pełnego KRS: daty, opisy, sygnatury sądów, uprawomocnienia. Kesz 24 h. Działa też dla podmiotów wykreślonych z rejestru.

curl "https://firmogram.pl/api/firma/0000033391/historia"

GET /api/firma/{krs}/odpis — surowy odpis (open data)

Odpis aktualny dokładnie w formie zwróconej przez KRS Open API (JSON źródłowy, do audytu i dalszego przetwarzania).

curl "https://firmogram.pl/api/firma/0000033391/odpis"

GET /api/vat/{nip} — biała lista VAT

Status VAT + zweryfikowane rachunki bankowe (wykaz podatników VAT, MF). Walidacja NIP po stronie serwisu. Odpowiedź zawiera requestId (potwierdzenie zapytania z MF) oraz metadane zrodlo, dane_z_dnia, source_effective_at (dzień weryfikacji VAT). Kesz serwerowy 24 h.

curl "https://firmogram.pl/api/vat/5260001246"

GET /api/vies/{kraj}/{vat} — VAT-UE

Wynik zawiera requestDate źródła oraz metadane zrodlo, dane_z_dnia. Wynik VIES ma charakter informacyjny — przy wątpliwościach zweryfikuj u krajowych służb (obsługa błędów serwisu: HTTP 502 z komunikatem). Kesz 6 h.

curl "https://firmogram.pl/api/vies/DE/811215769"

Kody odpowiedzi i metadane (od v1.45)

Błędy HTTP zwracają spójny JSON: {"status": "error", "code": <kod>, "message": "<komunikat>"} (pole error zachowane dla zgodności wstecz). Komunikaty: 400 — nieprawidłowy parametr; 401 — wymagana autoryzacja lub nieprawidłowy klucz; 404 — brak podmiotu/zasobu; 429 — limit zapytań wyczerpany; 502 — serwis źródłowy nie odpowiada; 503 — serwis źródłowy chwilowo niedostępny lub moduł wyłączony. Dane z odpowiedzi noszą metadane zrodlo (rejestr źródłowy), source_fetched_at (czas pobrania) i source_effective_at (stan danych u źródła) — traktuj je jako informacyjne i weryfikuj u źródła (ograniczenia odpowiedzialności).

GET /api/crbr/{nip} — beneficjenci rzeczywisti (CRBR)

Zgłoszenia z Centralnego Rejestru Beneficjentów Rzeczywistych (MF): aktualne zgłoszenie + historia, obywatelstwo, państwo zamieszkania i uprawnienia beneficjentów. Bez numerów PESEL i dat urodzenia. Kesz 7 dni; odpowiedź z nagłówkiem X-Data-Source: CRBR (Ministerstwo Finansów).

curl "https://firmogram.pl/api/crbr/5252255601"

GET /api/zdarzenia?limit=&krs= — strumień zdarzeń

Zmiany rejestrowe z biuletynów KRS; filtrowanie po podmiocie parametrem krs.

curl "https://firmogram.pl/api/zdarzenia?limit=20"

GET /api/kraz?q= — rejestr agencji zatrudnienia (KRAZ)

Numer wpisu do KRAZ, NIP lub nazwa agencji; dla numeru dołącza bieżący status z rejestru (kesz 24 h).

curl "https://firmogram.pl/api/kraz?q=20741"
curl "https://firmogram.pl/api/kraz?q=Praca+Plus"

GET /api/licencje?q= — licencje transportowe (GITD)

Numer licencji na przewóz rzeczy (TU-) lub osób (OU-) albo nazwa przewoźnika; zbiór odświeżany z danegovych zbiorów GITD co 30 dni.

curl "https://firmogram.pl/api/licencje?q=TU-047218"

GET /api/biuletyn/{data} · GET /api/stats

Surowy biuletyn dzienny KRS (lista podmiotów zmienionych YYYY-MM-DD) oraz statystyki serwisu.

curl "https://firmogram.pl/api/biuletyn/2026-11-03"