← Wróć do strony głównej
Współpraca B2B

Baza polskich świadczeń
dla Twojej aplikacji

117 zweryfikowanych świadczeń socjalnych, ulg podatkowych i dotacji z oficjalnych źródeł rządowych, dostępnych przez jedno wywołanie API. Twoja aplikacja pyta, my odpowiadamy, co danemu użytkownikowi przysługuje i jak to dostać.

Dla kogo to jest

Oprogramowanie kadrowe i HR

Przy onboardingu nowego pracownika Twój system może automatycznie sprawdzić, jakie świadczenia mu przysługują: świadczenie 800+ na dzieci, ulga prorodzinna w PIT, dofinansowanie do żłobka z budżetu gminy, becikowe. HR dostaje gotową listę zamiast odsyłać pracownika na rządowe strony.

Aplikacje bankowe i fintech

Klient składa wniosek kredytowy. Twoja aplikacja w tle sprawdza, na jakie regularne świadczenia się kwalifikuje: 800+, trzynasta emerytura, renta. To realny, stały dochód, który powinien wchodzić do scoringu. Dodatkowo doradztwo finansowe zyskuje nowy wymiar: "przysługuje Ci X, możesz to przeznaczyć na nadpłatę kredytu".

Ośrodki Pomocy Społecznej i NGO

Pracownik socjalny obsługuje klienta. Zamiast ręcznie sprawdzać kilkadziesiąt stron rządowych. Jedno zapytanie do API i gotowa lista świadczeń, do których dana osoba się kwalifikuje, z instrukcją gdzie i jak złożyć wniosek. Oszczędność czasu, mniej błędów, lepsza obsługa.

Jak to działa

Jeden endpoint REST: POST /api/verify. Wysyłasz profil użytkownika w formacie JSON, otrzymujesz listę świadczeń posortowaną według pewności dopasowania. Każde świadczenie zawiera kwotę, jak często jest wypłacane, jakie dokumenty są potrzebne i dokładną instrukcję składania wniosku krok po kroku.

Dopasowanie działa dwuetapowo: najpierw deterministyczny algorytm sprawdza twarde warunki (wiek, dochód, liczba dzieci itd.), a następnie model językowy AI weryfikuje przypadki graniczne i dodaje ostrzeżenia tam, gdzie kwalifikowalność nie jest jednoznaczna.

Przykładowe zapytanie
curl -X POST https://wezmezadarmo.com/api/verify \
  -H "Content-Type: application/json" \
  -H "X-API-Key: TWOJ_KLUCZ_API" \
  -d '{
    "profile": {
      "wiek": 35,
      "plec": "K",
      "stanCywilny": "malzenstwo",
      "liczbaDzieci": 2,
      "wiekDzieci": [3, 7],
      "dochodMiesiecznie": 4500,
      "dochodNaOsobe": 1500,
      "zatrudnienie": "umowa_o_prace",
      "niepelnosprawnosc": "brak",
      "wlasnosc": "mieszkanie",
      "wojewodztwo": "mazowieckie",
      "prowadzDzialalnosc": false,
      "pierwszaDzialalnosc": false,
      "ciaza": false,
      "student": false,
      "emeryt": false,
      "rolnik": false,
      "bezrobotnyZarejestrowany": false
    }
  }'
Przykładowa odpowiedź (jedno świadczenie ze skróconej listy)
{
  "results": [
    {
      "benefit": {
        "id": "800-plus",
        "nazwa": "Świadczenie wychowawcze 800+",
        "kategoria": "RODZINA",
        "kwota": "800 PLN/mies.",
        "czestotliwosc": "miesięcznie",
        "wniosek": {
          "kanal": ["EMPATIA", "ePUAP"],
          "dokumenty": ["Dowód osobisty", "Akty urodzenia dzieci"],
          "kroki": [
            "Zaloguj się do portalu Emp@tia (empatia.mrpips.gov.pl)",
            "Wybierz wniosek SW-1",
            "Wypełnij dane dzieci i konto bankowe",
            "Prześlij elektronicznie (nie musisz iść do urzędu)"
          ],
          "terminRealizacji": "do 3 miesięcy od złożenia wniosku"
        },
        "zrodloUrl": "https://www.gov.pl/web/rodzina/800plus",
        "dataWeryfikacji": "2026-05-09"
      },
      "status": "PRZYSLUGUJE",
      "confidence": "WYSOKA",
      "matchedCriteria": ["Ma 2 dzieci poniżej 18 lat"],
      "failedCriteria": [],
      "warnings": []
    }
  ],
  "aiVerified": true
}

Pola profilu użytkownika

Wszystkie pola są opcjonalne. Im więcej podasz, tym dokładniejsze dopasowanie. Minimalne zapytanie wystarczy z samym wiek i plec.

PoleTypOpis
wieknumberWiek w latach
plec"K" | "M"Płeć: K = kobieta, M = mężczyzna
stanCywilnystring"wolny" | "malzenstwo" | "rozwiedziony" | "wdowiec"
liczbaDziecinumberLiczba dzieci poniżej 18 roku życia
wiekDziecinumber[]Wiek każdego dziecka (tablica)
dochodMiesiecznienumberŁączny dochód netto gospodarstwa (PLN/mies.)
dochodNaOsobenumberDochód netto na osobę w gospodarstwie (PLN/mies.)
zatrudnieniestring"umowa_o_prace" | "dzialalnosc" | "umowa_zlecenie" | "bezrobotny" | "emeryt"
niepelnosprawnoscstring"brak" | "lekki" | "umiarkowany" | "znaczny"
wlasnoscstring"mieszkanie" | "dom" | "wynajem" | "rodzina"
wojewodztwostringNazwa województwa (małymi literami, z myślnikami)
prowadzDzialalnoscbooleanCzy prowadzi działalność gospodarczą
pierwszaDzialalnoscbooleanCzy to pierwsza działalność gospodarcza
ciazabooleanCzy w ciąży (dotyczy kobiet)
studentbooleanCzy jest studentem
emerytbooleanCzy pobiera emeryturę lub rentę
rolnikbooleanCzy jest rolnikiem ubezpieczonym w KRUS
bezrobotnyZarejestrowanybooleanCzy jest zarejestrowany w urzędzie pracy (PUP)

Co zwraca API

Każde świadczenie w odpowiedzi zawiera:

  • status"PRZYSLUGUJE" | "MOZLIWE" | "NIE_PRZYSLUGUJE" (pewność dopasowania)
  • confidence"WYSOKA" | "SREDNIA" | "NISKA" (jakość danych wejściowych)
  • matchedCriterialista warunków, które zostały spełnione
  • warningsostrzeżenia, np. "dochód blisko progu, sprawdź dokładnie"
  • wniosek.krokiinstrukcja krok po kroku jak złożyć wniosek
  • wniosek.dokumentylista wymaganych dokumentów
  • wniosek.kanalgdzie złożyć: ePUAP, Emp@tia, ZUS, urząd gminy itd.
  • zrodloUrllink do oficjalnego źródła rządowego
  • dataWeryfikacjidata ostatniej weryfikacji danych

Parametry techniczne

AutoryzacjaNagłówek X-API-Key lub Authorization: Bearer <klucz>
FormatJSON / REST (HTTPS)
CORSWłączony (możesz wywoływać z frontendu lub backendu)
Opóźnienie (p50)ok. 200 ms samo dopasowanie; ok. 1,5 s z weryfikacją AI
Dane użytkownikaNie zapisywane, przetwarzane in-memory i usuwane po odpowiedzi
Baza danychBrak po naszej stronie; żadnych kont, żadnych logów
DostępnośćVercel Edge Network (hostowany w UE)

RODO i ochrona danych

API nie przechowuje żadnych danych osobowych. Profil użytkownika wysłany w zapytaniu jest przetwarzany wyłącznie w pamięci operacyjnej serwera i usuwany natychmiast po zwróceniu odpowiedzi. Nie prowadzimy bazy użytkowników ani logów zapytań.

Dane wejściowe (wiek, dochód, sytuacja rodzinna) są danymi anonimowymi. Nie wymagamy PESEL ani żadnych danych identyfikujących. Administratorem danych osobowych końcowego użytkownika pozostaje Twoja firma jako integrator, nie przenosimy tej odpowiedzialności na siebie.

Dane dot. dochodu, sytuacji rodzinnej i niepełnosprawności mogą być uznane za dane wrażliwe w rozumieniu RODO art. 9, jeśli są powiązane z konkretną osobą po stronie integratora. Zalecamy ich anonimizację przed przesłaniem do API.

Wycena i warunki współpracy

Każde wykorzystanie API przez podmiot zewnętrzny jest uzgadniane indywidualnie. Nie ma jednej stałej stawki. Warunki zależą od charakteru organizacji, liczby zapytań miesięcznie i sposobu użycia.

Dla fundacji i organizacji pozarządowych (NGO) działających na rzecz osób wykluczonych, seniorów, osób z niepełnosprawnościami lub rodzin w trudnej sytuacji: dostęp do API może być całkowicie bezpłatny. Decyzja jest podejmowana indywidualnie po zapoznaniu się z działalnością organizacji.

Dla firm komercyjnych warunki finansowe są negocjowane w zależności od skali i przeznaczenia integracji.

Niedozwolone użycie

Korzystanie z API wezmezadarmo.com przez podmioty zewnętrzne bez uprzedniej pisemnej zgody autora jest zabronione. Dotyczy to zarówno użycia komercyjnego, jak i integracyjnego.

Zabronione jest również automatyczne pobieranie treści serwisu (web scraping, crawlowanie, skrypty masowe). Baza świadczeń, jej struktura i opisy stanowią autorskie dzieło Kamila Sobkowicza w rozumieniu ustawy o prawie autorskim i prawach pokrewnych.

Szczegółowe postanowienia zawiera Regulamin serwisu (§ 9).

Kontakt

Napisz na adres poniżej z krótkim opisem przypadku użycia i szacowaną liczbą zapytań miesięcznie. Odpisuję w ciągu jednego dnia roboczego.

Kontakt
Kamil Sobkowicz, autor projektu wezmezadarmo.com

Dokumentacja techniczna w formacie czytelnym dla modeli AI: wezmezadarmo.com/llm.md