Baza wiedzy o serwisach administracji publicznej

UOKiK udostępnia publiczne API do bazy SUDOP. Pozwala ono pobierać sprawozdania o pomocy publicznej i pomocy de minimis szybciej i hurtowo – z przeglądarki, z własnego programu albo ze strony internetowej. Nie wymaga rejestracji ani klucza.

Jakie dane udostępnia API SUDOP?

• wszystkie sprawozdania o udzielonej pomocy – zarówno pomocy publicznej, jak i de minimis – z ostatnich 10 lat (od 1 stycznia roku n-10),
• przypadki pomocy wybranego beneficjenta,
• beneficjentów danego programu pomocowego,
• słowniki: formy pomocy, przeznaczenia, środki pomocowe, sektory działalności i gminy.

Jakie są adresy API?

Przykładowe zapytania UOKiK kieruje pod adres https://api-sudop.uokik.gov.pl/sudop-api/. Dokumentację interaktywną znajdziesz w Swaggerze API SUDOP, a portal deweloperski pod adresem api-sudop.uokik.gov.pl:9443/devportal/apis.

Jak wyszukać przypadki pomocy?

Zapytanie kierujesz na endpoint /api/przypadki-pomocy (lub /v1/api/przypadki-pomocy) z co najmniej jednym parametrem:

• nip-beneficjenta – NIP beneficjenta,
• nip-udzielajacego-pomocy – NIP instytucji udzielającej pomocy,
• srodek-pomocowy-numer – numer programu lub pomocy indywidualnej,
• forma-pomocy-kod – kod formy pomocy, na przykład A1.1,
• przeznaczenie-pomocy-kod – kod przeznaczenia, na przykład b1,
• sektor-dzialalnosci-kod – klasa PKD,
• gmina-siedziby-kod – kod TERYT gminy siedziby beneficjenta.

Zakres dat zawężasz parametrami dzien-udzielenia-pomocy-od i dzien-udzielenia-pomocy-do (format rrrr-mm-dd). Parametr strona pozwala pobierać kolejne paczki po 10 000 wierszy.

Przykładowe zapytania

Cała pomoc wybranego beneficjenta w latach 2023–2025 (podstaw własny NIP):

https://api-sudop.uokik.gov.pl/sudop-api/api/przypadki-pomocy?nip-beneficjenta=NIP&dzien-udzielenia-pomocy-od=2023-01-01&dzien-udzielenia-pomocy-do=2025-12-31

Regionalna pomoc inwestycyjna (b1) w ramach jednego programu:

https://api-sudop.uokik.gov.pl/sudop-api/api/przypadki-pomocy?przeznaczenie-pomocy-kod=b1&srodek-pomocowy-numer=SA.105611

Pomoc udzielona przez wybraną instytucję:

https://api-sudop.uokik.gov.pl/sudop-api/api/przypadki-pomocy?nip-udzielajacego-pomocy=NIP_INSTYTUCJI

Jak działa kolejka zapytań?

API nie zwraca wyniku od razu. Działa w trzech krokach:

1. Wysyłasz zapytanie na /api/przypadki-pomocy. Poprawne zapytanie zwraca kod 303 i nagłówek location z adresem w kolejce.
2. Odpytujesz adres kolejki (/api/kolejka/{queueId}), aż wynik będzie gotowy.
3. Pobierasz wynik z /api/wynik/{requestId}.

W przeglądarce zobaczysz komunikat o przygotowywaniu odpowiedzi (przewidywany czas około 60 sekund) – wystarczy odświeżyć stronę. Niepoprawne kryteria zwracają kod 400 z polami error-result, error-reason i error-solution, które podpowiadają, co poprawić.

Jakie są limity API?

• bez rejestracji, ale maksymalnie 15 zapytań na minutę,
• do 10 000 wierszy na stronę wyniku,
• dane z ostatnich 10 lat.

Dobra praktyka. Przy pobieraniu dużych zbiorów rób przerwy między zapytaniami, zapamiętuj wyniki lokalnie i odświeżaj je raz na dobę – baza i tak aktualizuje się tylko w nocy.

Wersja API

Endpoint /wersja zwraca numer wersji i datę modyfikacji. Warto sprawdzać go automatycznie, żeby wiedzieć, kiedy UOKiK zmienia interfejs.

Słowniki i warunki ponownego wykorzystania danych opisujemy w artykule Słowniki API SUDOP i zasady wykorzystania danych.

Stan na 11 października 2026 r. Artykuł ma charakter informacyjny i nie stanowi porady prawnej ani podatkowej. O kwalifikacji konkretnego wsparcia decyduje podmiot udzielający pomocy.

Źródła: artykuł napisany samodzielnie na podstawie informacji Urzędu Ochrony Konkurencji i Konsumentów o systemie SUDOP i API SUDOP (uokik.gov.pl/sudop, sudop.uokik.gov.pl), materiałów PARP o pomocy de minimis, rozporządzenia Komisji (UE) 2023/2831 oraz ustawy z dnia 30 kwietnia 2004 r. o postępowaniu w sprawach dotyczących pomocy publicznej.