📚 Dokumentacja API

Darmowe RESTful API do pobierania danych o polskich firmach. Bez limitów dla projektów open-source i startupów.

⚡ Szybki start

Bazowy URL API: https://sprawdz-firme.pl/api/v1

# Wyszukaj firmy po nazwie

curl "https://sprawdz-firme.pl/api/v1/search?query=ORLEN"

# Pobierz dane firmy po KRS

curl "https://sprawdz-firme.pl/api/v1/organizations/krs/0000028860"

🔍 Wyszukiwanie firm

GET /api/v1/search

Wyszukuj firmy po nazwie, NIP, KRS, REGON lub innych kryteriach.

Parametry:

Parametr	Typ	Opis
query	string	Nazwa firmy (częściowe dopasowanie)
nip	string	Numer NIP (10 cyfr)
krs	string	Numer KRS (10 cyfr)
regon	string	Numer REGON
pkd	string	Kod PKD (np. 62.01)
city	string	Miasto siedziby
status	string	ACTIVE, LIQUIDATION, BANKRUPTCY
page	int	Numer strony (domyślnie 1)
per_page	int	Wyników na stronę (max 100)

{
  "results": [
    {
      "id": "uuid",
      "krs": "0000028860",
      "nip": "7740001454",
      "regon": "610188201",
      "name": "ORLEN SPÓŁKA AKCYJNA",
      "legal_form": "SPÓŁKA AKCYJNA",
      "city": "PŁOCK",
      "voivodeship": "MAZOWIECKIE",
      "status": "ACTIVE",
      "registration_date": "2001-07-24"
    }
  ],
  "meta": {
    "total": 15,
    "page": 1,
    "per_page": 20,
    "pages": 1,
    "has_next": false,
    "has_prev": false
  }
}

🔄 Bezpośrednie zapytania do źródeł

Endpointy do bezpośredniego odpytywania publicznych API (bez korzystania z lokalnej bazy):

GET /api/v1/lookup/krs/{krs}

Bezpośrednie zapytanie do API KRS

GET /api/v1/lookup/nip/{nip}/vat

Sprawdź status VAT w Białej Liście

⚠️ Limity i uwagi

Brak limitów dla projektów non-profit i edukacyjnych
Dla zastosowań komercyjnych: 1000 req/dzień (kontakt w sprawie zwiększenia)
API KRS ma własne limity: ~100 req/min
Dane są cache'owane przez 24h