CEPiK dla firm w 2026 — jak działa API, koszty, ograniczenia i decyzja „build vs buy"

Skąd się wzięło CEPiK 2.0 i API dla firm

Aby zrozumieć, dlaczego API pojawiło się dopiero w 2025 roku — choć baza istnieje od dekad — warto zobaczyć krótką historię.

CEPiK 1.0 ruszył w 2004 roku jako pierwsza ogólnopolska baza pojazdów i kierowców. Dane były dostępne tylko dla uprawnionych organów (Policja, ITD, KAS, sądy). Obywatele i firmy nie mieli wglądu.

CEPiK 2.0 uruchomiono w listopadzie 2017 r. — modernizacja techniczna, ale w pierwszej fazie również tylko dla instytucji. W 2020 r. ruszyła publiczna e-usługa „Sprawdź uprawnienia kierowcy" na portalu gov.pl, dostępna dla wszystkich bez logowania. Można było ręcznie sprawdzić jednego kierowcę naraz, podając imię, nazwisko i numer blankietu.

Luty 2025 — przełom. Ministerstwo Cyfryzacji we współpracy z Centralnym Ośrodkiem Informatyki uruchomiło oficjalne API CEPiK 2.0 dla firm, umożliwiające masowe i automatyczne odpytywanie bazy. Już w pierwszych tygodniach ponad 130 firm zgłosiło chęć integracji.

Co ważne — to nie jest „nieoficjalna kopia" gov.pl, ale pełnoprawne, oficjalnie wsparte API państwowe z dokumentacją techniczną i wsparciem Ministerstwa. To istotna różnica prawna i biznesowa.

Co API zwraca, a czego NIE zwraca

To jedna z najczęstszych pułapek przy planowaniu integracji. Spis dokładnie tego, co dostajesz w odpowiedzi:

Co API CEPiK zwraca

• Status dokumentu — wydany, w trakcie wymiany, zatrzymany, unieważniony
• Lista kategorii prawa jazdy (A, B, C, C+E, D itd.)
• Daty ważności poszczególnych kategorii — kluczowe dla kierowców zawodowych, gdzie kategorie wygasają częściej niż blankiet
• Seria i numer blankietu — potwierdzenie, że dane się zgadzają
• Informacja o zatrzymaniu dokumentu — najważniejszy alert

Czego API CEPiK NIE zwraca

To równie ważne — bo wiele firm planuje integrację, zakładając, że dostanie pełen profil kierowcy. Nie dostanie.

• Badania lekarskie i psychotechniczne — to dane w odrębnych rejestrach medycznych, niedostępne w CEPiK. Trzeba pilnować osobno.
• Karta kierowcy (tachograf cyfrowy) — odrębny system PWPW. CEPiK o tym nic nie wie.
• Certyfikat ADR — odrębna baza, też niedostępna w CEPiK.
• Historyczne uprawnienia — API zwraca aktualny stan, nie pełną historię (np. nie dowiesz się, czy kierowca miał kiedyś zatrzymany blankiet 3 lata temu).
• Wykroczenia i punkty karne — to inny rejestr (Krajowy Rejestr Karny / system punktów karnych Policji), nie część CEPiK.
• Dane osobowe typu PESEL, adres, telefon — API operuje tylko na trzech polach wejścia (imię, nazwisko, blankiet) i zwraca ograniczony zakres.

Wniosek operacyjny: CEPiK API rozwiązuje tylko jeden problem — pilnowanie statusu uprawnień. To dużo, ale to nie jest „kompleksowe zarządzanie kierowcami". Resztę musisz pilnować innymi narzędziami (lub w jednym, które integruje wszystko — jak RaportKierowcy.pl, gdzie API CEPiK to jeden z modułów obok terminów badań, karty kierowcy, ADR i dokumentów pojazdów).

Jak uzyskać dostęp do API — krok po kroku

Proces jest formalny, ale przyjazny. Składa się z czterech kroków:

Koszty — dokładnie ile to kosztuje

Sam dostęp do API jest bezpłatny. Państwo nie pobiera opłat ani za wniosek, ani za zapytania, ani za utrzymanie. To radykalna zmiana w stosunku do wielu europejskich odpowiedników (np. w Niemczech analogiczne usługi są płatne).

Ale „bezpłatne API" nie znaczy „bezpłatne wdrożenie". Realne koszty po stronie firmy budującej własną integrację:

W praktyce: jednorazowy koszt 15 000–60 000 zł plus 500–700 zł miesięcznie. Plus ryzyko: ktoś w zespole musi to utrzymywać, gdy programista odejdzie, gdy Ministerstwo zmieni specyfikację API, gdy zmienią się przepisy RODO.

Dla porównania usługa typu RaportKierowcy.pl: od 0 zł (plan darmowy do 10 kierowców) do 249 zł netto miesięcznie (XL, bez limitów). Bez kosztów wdrożenia, bez utrzymania i bez ryzyka.

Ograniczenia techniczne API

API jest dobrze zaprojektowane, ale ma kilka istotnych ograniczeń, o których warto wiedzieć przed wdrożeniem:

• Rate limiting — choć dokładne limity są ustalane indywidualnie z każdym integratorem, w praktyce nie powinieneś zakładać, że odpytasz CEPiK 100 000 razy na minutę. Realne tempo to setki-tysiące zapytań dziennie dla typowej firmy.
• Czas odpowiedzi — typowo poniżej 1 sekundy, ale w godzinach szczytu może być wolniej. Niewielkie znaczenie przy nocnym batchu, większe przy on-demand check.
• Format danych wejściowych — bardzo wymagający co do dokładnego brzmienia imienia i nazwiska. „Jan-Krzysztof" vs „Jan Krzysztof" — to mogą być różne wyniki. Numer blankietu też musi być w idealnym formacie (z wszystkimi separatorami).
• Brak webhooków — API jest pull-based, nie push-based. To znaczy, że Ty pytasz CEPiK, czy coś się zmieniło. CEPiK nie powiadamia Cię, kiedy kierowca tracił uprawnienia. Konsekwencja: musisz odpytywać codziennie (bądź gotowiec, który to robi za Ciebie).
• Niezgodności danych — jeśli imię w Twojej bazie różni się od oficjalnego rejestru (literówka, polskie znaki, dawne nazwisko), API zwróci błąd lub zerowy wynik. To trzeba obsłużyć w warstwie aplikacji.
• Brak fallbacku — jeśli API jest niedostępne (planowane prace, awaria), Twoja integracja po prostu nie ma jak sprawdzić. Trzeba zaplanować retry logic i obsługę błędów.

Build vs Buy — kiedy budować, kiedy korzystać z gotowca

To pytanie, które każdy fleet manager lub IT lead w firmie transportowej musi sobie postawić. Praktyczna matryca decyzyjna:

Buduj własną integrację, jeżeli:

• Masz powyżej 100 kierowców i własny zespół IT — koszt 60 000 zł rozkłada się na lata i amortyzuje;
• Już masz wewnętrzny system kadrowo-flotowy i chcesz, żeby CEPiK był dodatkowym modułem w nim, nie osobnym narzędziem;
• Twoje zleceniodawcy wymagają w SLA integracji z ich własnymi systemami (np. Amazon, DHL — mają audyt podwykonawców na poziomie API);
• Operujesz wzorcem multi-tenant (np. jako broker / agencja pracy tymczasowej dla wielu firm transportowych) — wtedy własna integracja staje się produktem, nie tylko narzędziem.

Korzystaj z gotowca, jeżeli:

• Masz poniżej 100 kierowców — ROI własnej integracji się nie spina, robocizna pochłonie 10 lat abonamentu;
• Nie masz własnego zespołu IT albo masz, ale ma ważniejsze zadania;
• Potrzebujesz nie tylko monitoringu CEPiK, ale też badań lekarskich, ADR, karty kierowcy, OC, przeglądów
• Cenisz czas wdrożenia — gotowiec rusza tego samego dnia (w RaportKierowcy.pl rejestracja + dodanie pierwszych kierowców = 15 minut), własna integracja to 6–8 tygodni;
• Chcesz przerzucić ryzyko — utrzymanie, security, RODO, zmiany w API Ministerstwa, integracja z UODO — to wszystko po stronie dostawcy gotowca.

W praktyce ~95% polskich firm transportowych mieści się w „korzystaj z gotowca". Własne integracje budują głównie giganty (Inelo, NaviExpert, GBox), lub duzi przewoźnicy z własnym IT (Raben, Schmenger, FM Polska). Dla 5–80 kierowców to po prostu nie jest opłacalne.

Co dalej z CEPiK — przewidywania na 2026–2027

Ministerstwo zapowiadało rozszerzanie funkcjonalności CEPiK 2.0. Realistyczne kierunki rozwoju, których można się spodziewać:

• Integracja z mObywatelem 2.0 — kierowca skanuje QR z prawa jazdy mObywatela, firma weryfikuje natychmiast (bez wpisywania imienia ręcznie);
• Webhooki / push notifications — gdy kierowca traci uprawnienia, CEPiK powiadamia wszystkie firmy, które zgłosiły go do monitoringu. To eliminuje opóźnienie nawet 24h przy modelu pull-based;
• Rozszerzenie zakresu danych — być może w przyszłości pojawią się informacje o badaniach lekarskich (po integracji systemu informacji medycznej z CEPiK);
• API dla danych pojazdów — analogiczne do API dla kierowców, ale dla pojazdów (status rejestracji, OC, przegląd techniczny). Aktualnie część tych danych jest dostępna w innych rejestrach państwowych, ale brakuje zunifikowanego API.

Każda z tych zmian zmniejszy lukę między „mam CEPiK API" a „mam pełną zgodność RODO + ITD + zleceniodawcy". Ale do tego czasu — odpowiednią ścieżką dla większości firm jest gotowiec, który już dziś integruje to wszystko w jednym narzędziu.