v1.0Free

NIPRegon API — Dokumentacja

REST API do pobierania danych firm zarejestrowanych w Polsce. Bez autoryzacji, bez klucza API — bezplatnie dla wszystkich.

Base URL:https://api.nipregon.pl

888k+

Firm w bazie

100

Limit req/min

Brak

Autoryzacja

JSON

Format

Cennik

Free

0 z\u0142

na zawsze

\u2713 100 zapyta\u0144 / dzie\u0144
\u2713 Dane podstawowe firm
\u2713 Wyszukiwanie po NIP/REGON/KRS
\u2713 Indeksy bran\u017cowe
\u2717 Sprawozdania finansowe
\u2717 Wsparcie techniczne

Zarejestruj si\u0119

Pro

199 z\u0142

miesi\u0119cznie

\u2713 10 000 zapyta\u0144 / dzie\u0144
\u2713 Dane podstawowe + finansowe
\u2713 Historia zmian KRS
\u2713 Rachunki bankowe
\u2713 Indeksy + statystyki
\u2713 Email support

Skontaktuj si\u0119

Enterprise

Indywidualnie

dostosowane

\u2713 Bez limitu zapyta\u0144
\u2713 Pe\u0142ne dane + dokumenty
\u2713 Dedykowany endpoint
\u2713 Webhook notyfikacje
\u2713 SLA 99.9%
\u2713 Priorytetowe wsparcie

Napisz do nas

Limity zapytan

Darmowe API — limit 100 zapytan na minute per adres IP. Odpowiedz 429 Too Many Requests przy przekroczeniu. Nie wymagana rejestracja ani klucz API.

Format odpowiedzi

Wszystkie odpowiedzi zwracaja JSON. Pola null oznaczaja brak danych w rejestrach.

json

{
  "id": 674641,
  "nip": "7011218798",
  "regon": "52941694600000",
  "krs": "0001122318",
  "name": "WEBYJUICE SPOLKA Z OGRANICZONA ODPOWIEDZIALNOSCIA",
  "legal_form": "SPOLKA Z OGRANICZONA ODPOWIEDZIALNOSCIA",
  "status": "active",
  "founding_date": "2024-08-20",
  "voivodeship": "ZACHODNIOPOMORSKIE",
  "city": "SZCZECIN",
  "postal_code": "71-441",
  "street": "UL. CYFROWA",
  "building_nr": "6",
  "share_capital": null,
  "pkd": [
    { "code": "62.01.Z", "name": "Dzialalnosc zwiazana z oprogramowaniem", "primary": true }
  ],
  "officers": [
    { "full_name": "P***** S*****", "role": "CZLONEK ZARZADU", "start_date": null }
  ]
}

Endpointy

GET/v1/company/nip/{nip}

Pobierz dane firmy po numerze NIP (10 cyfr, myślniki opcjonalne).

Parametry

Nazwa	Typ	Wymagany	Opis
nip	string	tak	NIP firmy, np. 7011218798

Przyklad — curl

bash

curl -s "https://api.nipregon.pl/v1/company/nip/7011218798" | python3 -m json.tool

Przyklad — Python

python

import requests

url = "https://api.nipregon.pl/v1/company/nip/7011218798"
response = requests.get(url)
data = response.json()
print(data)

Wypróbuj

GET/v1/company/regon/{regon}

Pobierz dane firmy po numerze REGON (9 lub 14 cyfr).

Parametry

Nazwa	Typ	Wymagany	Opis
regon	string	tak	REGON firmy, np. 52941694600000

Przyklad — curl

bash

curl -s "https://api.nipregon.pl/v1/company/regon/52941694600000" | python3 -m json.tool

Przyklad — Python

python

import requests

url = "https://api.nipregon.pl/v1/company/regon/52941694600000"
response = requests.get(url)
data = response.json()
print(data)

Wypróbuj

GET/v1/company/krs/{krs}

Pobierz dane firmy po numerze KRS (10 cyfr z wiodącymi zerami).

Parametry

Nazwa	Typ	Wymagany	Opis
krs	string	tak	KRS firmy, np. 0001122318

Przyklad — curl

bash

curl -s "https://api.nipregon.pl/v1/company/krs/0001122318" | python3 -m json.tool

Przyklad — Python

python

import requests

url = "https://api.nipregon.pl/v1/company/krs/0001122318"
response = requests.get(url)
data = response.json()
print(data)

Wypróbuj

GET/v1/search

Wyszukaj firmy po nazwie. Obsługuje paginację.

Parametry

Nazwa	Typ	Wymagany	Opis
q	string	tak	Fraza wyszukiwania (min. 3 znaki)
limit	integer	nie	Wyniki na stronę (1-100, domyślnie 20)
page	integer	nie	Numer strony (domyślnie 1)

Przyklad — curl

bash

curl -s "https://api.nipregon.pl/v1/search?q=webyjuice&limit=5" | python3 -m json.tool

Przyklad — Python

python

import requests

url = "https://api.nipregon.pl/v1/search?q=webyjuice&limit=5"
response = requests.get(url)
data = response.json()
print(data)

Wypróbuj

GET/v1/company/{nip}/financials

Pobierz sprawozdania finansowe firmy (jeśli dostępne w KRS).

Parametry

Nazwa	Typ	Wymagany	Opis
nip	string	tak	NIP firmy

Przyklad — curl

bash

curl -s "https://api.nipregon.pl/v1/company/7011218798/financials" | python3 -m json.tool

Przyklad — Python

python

import requests

url = "https://api.nipregon.pl/v1/company/7011218798/financials"
response = requests.get(url)
data = response.json()
print(data)

GET/v1/company/{nip}/officers

Pobierz listę członków zarządu i prokurentów.

Parametry

Nazwa	Typ	Wymagany	Opis
nip	string	tak	NIP firmy

Przyklad — curl

bash

curl -s "https://api.nipregon.pl/v1/company/7011218798/officers" | python3 -m json.tool

Przyklad — Python

python

import requests

url = "https://api.nipregon.pl/v1/company/7011218798/officers"
response = requests.get(url)
data = response.json()
print(data)

GET/v1/stats

Statystyki całej bazy danych — liczba firm, osób, sprawozdań.

Przyklad — curl

bash

curl -s "https://api.nipregon.pl/v1/stats" | python3 -m json.tool

Przyklad — Python

python

import requests

url = "https://api.nipregon.pl/v1/stats"
response = requests.get(url)
data = response.json()
print(data)

GET/v1/voivodeships

Podział firm według województw z liczbą podmiotów.

Przyklad — curl

bash

curl -s "https://api.nipregon.pl/v1/voivodeships" | python3 -m json.tool

Przyklad — Python

python

import requests

url = "https://api.nipregon.pl/v1/voivodeships"
response = requests.get(url)
data = response.json()
print(data)

GET/health

Health check — status serwera i połączenia z bazą danych.

Przyklad — curl

bash

curl -s "https://api.nipregon.pl/health" | python3 -m json.tool

Przyklad — Python

python

import requests

url = "https://api.nipregon.pl/health"
response = requests.get(url)
data = response.json()
print(data)

Kody bledow

Kod HTTP	Znaczenie
200 OK	Zapytanie zakonczone sukcesem
404 Not Found	Firma nie znaleziona w bazie
422 Unprocessable	Nieprawidlowe parametry zapytania (np. q za krotkie)
429 Too Many Requests	Przekroczono limit 100 zapytan/minute
503 Service Unavailable	Problem z polaczeniem do bazy danych

Wróc do NIPRegon.pl Swagger UI API Status