API: sprawdź kontrahenta

Do 30 NIP-ów w jednym zapytaniu: status VAT i dane z białej listy Ministerstwa Finansów, czy rachunek jest w wykazie i czy numer VAT UE jest aktywny w VIES. Wynik w JSON, z identyfikatorem zapytania MF jako potwierdzeniem sprawdzenia.

Dla firm, biur rachunkowych i programistów

Start

49 złnetto miesięcznie

do 100 NIP-ów dziennie

Biuro

149 złnetto miesięcznie

do 500 NIP-ów dziennie

Potrzebujesz więcej albo integracji z Twoim programem (np. arkusz, system księgowy)? Napisz, wycenię.

Przykład

POST /api/v1/kontrahenci
curl https://odswiezona.pl/api/v1/kontrahenci \  -H "Authorization: Bearer odsw_TWÓJ_KLUCZ" \  -H "Content-Type: application/json" \  -d '{"pozycje": [{"nip": "1133067162", "rachunek": "61109010140000071219812874"}, {"nip": "5260250274"}]}'

200 OK, odpowiedź skrócona

{  "ok": true,  "data": "2026-10-05",  "id_zapytania": "a1b2c-3d4e5f",  "limit": { "dzienny": 100, "wykorzystano": 2 },  "wyniki": [    { "nip": "1133067162",      "podmiot": { "nazwa": "…", "status_vat": "Czynny", "regon": "…", "adres": "…", "rachunki": 1 },      "rachunek": { "na_liscie": true },      "vies": { "aktywny": true } },    { "nip": "5260250274", "podmiot": { … }, "rachunek": null, "vies": { "aktywny": true } }  ]}

Zasady

CoJak
ZapytaniePOST /api/v1/kontrahenci, JSON: pozycje (1–30, każda z nip i opcjonalnie rachunek), opcjonalnie "vies": false
Klucznagłówek Authorization: Bearer odsw_…; klucz dostajesz ode mnie, w bazie trzymam tylko jego skrót
Limitydzienny według planu (liczy się każdy NIP, odnawia się o północy) i 20 zapytań na minutę
Błędy400 złe dane (NIP i rachunek sprawdzam sumą kontrolną, zanim coś policzę), 401 zły klucz, 429 limit, 502 rejestr chwilowo niedostępny
Rachunekna_liscie: true także dla rachunków wirtualnych (sprawdzam je osobną metodą MF); null, gdy nie udało się sprawdzić

Dane

NIP-ów ani rachunków z zapytań nie zapisuję: liczę tylko, ile sprawdzeń zrobił dany klucz. Dane pochodzą z wykazu podatników VAT (wl-api.mf.gov.pl) i z VIES Komisji Europejskiej, pobieranych w chwili zapytania. Wynik ma charakter informacyjny.

Klucz testowy na tydzień

Napisz, do czego chcesz użyć API. Dostaniesz klucz z małym limitem, żeby sprawdzić je w swoim programie.

Ceny netto, doliczam 23% VAT. Pojedynczego kontrahenta sprawdzisz za darmo w przeglądarce. Szczegóły o danych: polityka prywatności.