Dla firm, biur rachunkowych i programistów

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.

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

Przykład

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"}]}'

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

Co	Jak
Zapytanie	POST /api/v1/kontrahenci, JSON: pozycje (1–30, każda z nip i opcjonalnie rachunek), opcjonalnie "vies": false
Klucz	nagłówek Authorization: Bearer odsw_…; klucz dostajesz od nas, w bazie trzymamy tylko jego skrót
Limity	dzienny według planu (liczy się każdy NIP, odnawia się o północy) i 20 zapytań na minutę
Błędy	400 złe dane (NIP i rachunek sprawdzamy sumą kontrolną, zanim coś policzymy), 401 zły klucz, 429 limit, 502 rejestr chwilowo niedostępny
Rachunek	na_liscie: true także dla rachunków wirtualnych (sprawdzamy je osobną metodą MF); null, gdy nie udało się sprawdzić

Dane

NIP-ów ani rachunków z zapytań nie zapisujemy: liczymy 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.

Poproś o klucz

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