{"schemaVersion":"1.1","service":{"name":"BizGov — baza polskich firm","description":"Dane o polskich spółkach z KRS: dane rejestrowe, kontakty, powiązania osobowe, sprawozdania finansowe i odpisy. Wyszukiwanie po KRS, NIP, REGON, nazwie i województwie.","homepage":"https://biz-gov.com","documentation":null,"openapi":null,"termsOfService":"https://biz-gov.com/regulamin","apiTerms":"https://biz-gov.com/regulamin-api"},"authentication":{"scheme":"header","header":"X-API-Key","description":"Klucz przekazywany w nagłówku X-API-Key. Wydaje go KAŻDE zalogowane konto — dostęp do API nie jest pozycją pakietu, tylko produktem rozliczanym za użycie. Bez pokrycia kosztu zasoby płatne zwracają 402 z listą wariantów w polu `accepts`.","obtainAt":"https://biz-gov.com/konto","maxKeysPerAccount":10},"pricing":{"currency":"PLN","model":"pay-per-use","unit":"Jedna firma odsłonięta z pełnymi danymi w miesiącu kalendarzowym. Nie liczba żądań: ta sama firma odpytana ponownie w tym samym miesiącu jest darmowa, razem z jej grafem powiązań, finansami i odpisami.","note":"Ceny netto. Wyszukiwanie jest bezpłatne i zwraca wyniki z ukrytymi kontaktami — płaci się za odsłonięcie firmy, nie za pozycję na liście.","apiRates":[{"tier":"free","pricePerCompany":"0.23"},{"tier":"pro","pricePerCompany":"0.17"},{"tier":"enterprise","pricePerCompany":"0.15"}],"topUpAmounts":["50.00","100.00","250.00","500.00"],"plans":[{"id":"free","name":"Free","tier":"free","monthly":"0.00","yearly":"0.00","companiesPerMonth":10,"apiPricePerCompany":"0.23"},{"id":"basic_monthly","name":"Pro (miesięczny)","tier":"pro","monthly":"129.00","yearly":null,"companiesPerMonth":null,"apiPricePerCompany":"0.17"},{"id":"basic_annual_sub","name":"Pro (roczny)","tier":"pro","monthly":null,"yearly":"1290.00","companiesPerMonth":null,"apiPricePerCompany":"0.17"},{"id":"basic_annual_once","name":"Pro (roczny, jednorazowo)","tier":"pro","monthly":null,"yearly":"1290.00","companiesPerMonth":null,"apiPricePerCompany":"0.17"},{"id":"enterprise","name":"Enterprise","tier":"enterprise","monthly":"299.00","yearly":"2990.00","companiesPerMonth":null,"apiPricePerCompany":"0.15"}]},"endpoints":[{"method":"GET","path":"/api/agent/manifest","description":"Ten dokument.","requiresPayment":false,"rateLimit":{"requests":30,"windowSeconds":60}},{"method":"GET","path":"/api/agent/companies/{krs}","description":"Pełny raport firmy po numerze KRS. Odsłonięcie firmy jest płatne raz na miesiąc kalendarzowy — z puli planu albo z kredytów API, zależnie od sposobu uwierzytelnienia.","requiresPayment":true,"rateLimit":{"requests":60,"windowSeconds":60},"params":[{"name":"krs","in":"path","type":"string","required":true,"description":"Numer KRS, 10 cyfr. Myślniki, spacje i wiodące zera są normalizowane, więc „0000-277 084” i „277084” trafiają w ten sam podmiot.","example":"0000277084"}]},{"method":"GET","path":"/api/companies/search","description":"Wyszukiwarka firm (KRS, NIP, REGON, nazwa, województwo). Bezpłatna; zwraca wyniki z ukrytymi danymi kontaktowymi.","requiresPayment":false,"rateLimit":{"requests":120,"windowSeconds":60},"notes":["Wymagane jest CO NAJMNIEJ JEDNO z: krs, nip, regon, nazwa (albo alias name), province. Samo województwo wystarczy; sama nazwa też. Bez żadnego z nich zapytanie zwraca 400.","Wyszukiwanie nie zużywa limitu firm ani kredytów — płatne jest dopiero odsłonięcie konkretnej firmy przez /api/agent/companies/{krs}.","BEZ nagłówka X-API-Key strona wyników jest ograniczona do 20 pozycji, a stronicowanie do 50 stron; odpowiedź niesie wtedy pola wiersza listy, bez tabel powiązanych (osoby, oddziały, wpisy rejestru). Klucz wydaje każde konto, także darmowe.","Lista NIGDY nie niesie pełnego rekordu firmy — pełne dane wydaje wyłącznie /api/agent/companies/{krs}, po jednej firmie na żądanie."],"params":[{"name":"nazwa","in":"query","type":"string","required":false,"description":"Fragment nazwy podmiotu. Alias: `name`.","example":"Orlen"},{"name":"name","in":"query","type":"string","required":false,"description":"Angielski alias `nazwa`. Podanie obu naraz: wygrywa `nazwa`.","example":"Orlen"},{"name":"krs","in":"query","type":"string","required":false,"description":"Dokładny numer KRS, 10 cyfr.","example":"0000277084"},{"name":"nip","in":"query","type":"string","required":false,"description":"Dokładny NIP, 10 cyfr.","example":"7740001454"},{"name":"regon","in":"query","type":"string","required":false,"description":"Dokładny REGON, 9 lub 14 cyfr.","example":"610188201"},{"name":"province","in":"query","type":"string","required":false,"description":"Województwo, np. „mazowieckie”. Wielkość liter bez znaczenia.","example":"mazowieckie"},{"name":"county","in":"query","type":"string","required":false,"description":"Powiat.","example":"płocki"},{"name":"municipality","in":"query","type":"string","required":false,"description":"Gmina.","example":"Płock"},{"name":"city","in":"query","type":"string","required":false,"description":"Miejscowość.","example":"Warszawa"},{"name":"pkd","in":"query","type":"string","required":false,"description":"Kod PKD lub jego prefiks, np. „64” albo „64.91”.","example":"64.91"},{"name":"companyTypes","in":"query","type":"string","required":false,"description":"Formy prawne po przecinku, np. „SP_ZOO,SA”.","example":"SP_ZOO,SA"},{"name":"onlyWithEmail","in":"query","type":"boolean","required":false,"description":"Tylko podmioty z adresem e-mail. Wartości: `true` / `false`.","example":"true"},{"name":"excludeInactive","in":"query","type":"boolean","required":false,"description":"Pomiń podmioty wykreślone i w likwidacji.","example":"true"},{"name":"page","in":"query","type":"integer","required":false,"description":"Numer strony, od 1.","example":"1"},{"name":"pageSize","in":"query","type":"integer","required":false,"description":"Rozmiar strony, 1–500. Domyślnie ustala serwer.","example":"100"}]}],"payment":{"supported":["account","api-credits","subscription"],"planned":[{"scheme":"x402","status":"not_enabled","description":"Rozliczenie per-żądanie stablecoinem (HTTP 402) bez człowieka w pętli. Stawka za firmę już istnieje — brakuje wyłącznie onboardingu machine payments po stronie konta rozliczeniowego."},{"scheme":"mpp","status":"not_enabled","description":"Machine Payments Protocol — zapłata kartą przez shared payment token, bez człowieka w pętli."}],"challengeStatus":402,"description":"Zasoby płatne odpowiadają kodem 402 i listą wariantów w polu `accepts`. Dziś każdy wariant wymaga jednorazowego działania człowieka (założenie konta, doładowanie portfela, zakup planu); potem klucz API działa bez interakcji."},"contact":"https://biz-gov.com/konto/enterprise"}