Otwarte API
bezpłatne · klucz darmowy z konta · JSONX-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"