API dla programistów
Proste API w JSON do wywołania z własnego programu, arkusza albo systemu księgowego czy warsztatowego. Płatne działają na jednym kluczu, bezpłatne bez klucza. Nie zapisuję danych z zapytań: liczę tylko, ile razy klucz został użyty.
Dla programistów i firm z własnym systemem
Płatne, z kluczem
Kontrahenci
POST /api/v1/kontrahenci
Do 30 NIP-ów w zapytaniu: status VAT i dane z białej listy MF, czy rachunek jest w wykazie (także wirtualny), VIES, identyfikator zapytania MF.
od 49 zł netto / mies.100 NIP-ów dziennie; 149 zł do 500
Dowód rejestracyjny
POST /api/v1/dowod
Do 10 kodów Aztec z dowodów w zapytaniu: numer rejestracyjny, VIN, marka, model, pojemność, moc, pierwsza rejestracja. Bez danych właściciela.
od 49 zł netto / mies.100 odczytów dziennie; 99 zł do 500
Audyt strony i domeny
POST /api/v1/audyt
Wynik 0–100 i problemy po polsku: PageSpeed na telefonie, SEO, dane strukturalne, boty AI, przestarzały kod; domena: wygaśnięcie, MX, SPF, DMARC.
od 49 zł netto / mies.100 audytów dziennie; 149 zł do 500
Kod QR KSeF
POST /api/v1/ksef
Z pliku faktury link weryfikacyjny KSeF i gotowy kod QR w SVG do wydruku; odczyt i sprawdzenie linku z kodu na otrzymanej fakturze.
od 29 zł netto / mies.1 000 faktur dziennie; 69 zł do 3 000
Kategorie kosztów (AI)
POST /api/v1/kategorie
Do 50 pozycji z faktur kosztowych: kategoria z Twojej listy (np. kolumny KPiR) albo z domyślnej. AI tylko wybiera z listy.
od 49 zł netto / mies.500 pozycji dziennie; 149 zł do 3 000
Opisy SEO (AI)
POST /api/v1/seo
Adres strony albo do 20 produktów i usług: tytuł do 60 znaków, opis dla Google do 155, H1 i alty zdjęć. Bez zmyślonych liczb.
od 49 zł netto / mies.200 opisów dziennie; 149 zł do 1 000
Odczyt dokumentów (AI)
POST /api/v1/dokumenty
PDF albo zdjęcie faktury, paragonu, umowy czy pisma: rodzaj, wystawca, NIP, numer, daty, kwoty z kontrolą, rachunek, pozycje, tagi.
od 49 zł netto / mies.20 dokumentów dziennie; 149 zł do 100
Współrzędne i adresy
POST /api/v1/wspolrzedne · /adres
Do 10 adresów w zapytaniu: współrzędne z państwowego rejestru adresowego (GUGiK), poziom trafienia, TERYT, gmina; w drugą stronę najbliższy adres punktu.
od 49 zł netto / mies.1 000 adresów dziennie; 149 zł do 10 000
Bezpłatne, bez klucza
Walidacja numerów
/api/v1/walidacja
NIP, REGON, PESEL, IBAN (z bankiem dla polskich rachunków), KRS i VIN (producent, rok modelowy, cyfra kontrolna).
Kurs NBP do faktury
/api/v1/kurs
Kurs średni z ostatniego dnia roboczego przed datą (art. 31a ustawy o VAT), numer tabeli i kwota w złotych.
Kalendarz i terminy
/api/v1/kalendarz
Polskie święta, dni robocze w roku i termin płatności z przesunięciem z soboty i święta.
Dokumentacja i wypróbowanie w przeglądarce · Lista wszystkich adresów w JSON: GET /api/v1
Specyfikacja OpenAPI: /api/v1/openapi (do Postmana, Insomnii, generatorów klientów)
Wspólne zasady
| Co | Jak |
|---|---|
| Adres | https://odswiezona.pl/api/v1/…, tylko HTTPS, treść i odpowiedź w JSON (Content-Type: application/json) |
| Klucz | nagłówek Authorization: Bearer odsw_… (płatne API); jeden klucz może mieć dostęp do kilku API. Klucz widzisz raz, przy wydaniu; ja trzymam tylko jego skrót |
| Limity | dzienny według planu, osobno dla każdego API (odnawia się o północy czasu polskiego) oraz 20 zapytań na minutę na klucz |
| Odpowiedź | {"ok": true, …, "limit": {"dzienny": 100, "wykorzystano": 12}}; błąd: {"ok": false, "blad": "opis po polsku"} |
| Kody HTTP | 200 ok, 400 złe dane (nic nie jest liczone do limitu), 401 zły, wyłączony albo wygasły klucz, 413 za duże zapytanie, 429 limit, 502/503 chwilowa niedostępność (spróbuj ponownie za kilka minut) |
| Dane | treści zapytań i wyników (NIP-ów, rachunków, kodów, adresów, współrzędnych, faktur, pozycji, plików dokumentów) nie zapisuję ani nie loguję. Zasady usługi: warunki usług płatnych; umowę powierzenia danych akceptujesz razem z zamówieniem. |
Przykład w JavaScript
const odp = await fetch('https://odswiezona.pl/api/v1/kontrahenci', { method: 'POST', headers: { Authorization: `Bearer ${process.env.ODSWIEZONA_KLUCZ}`, 'Content-Type': 'application/json' }, body: JSON.stringify({ pozycje: [{ nip: '1133067162', rachunek: '61109010140000071219812874' }] }),});const dane = await odp.json();if (!dane.ok) throw new Error(dane.blad);console.log(dane.wyniki[0].podmiot.status_vat, dane.wyniki[0].rachunek.na_liscie);200 OK, odpowiedź skrócona
{ "ok": true, "data": "2026-10-03", "id_zapytania": "Ab1Cd-2eF3g4h", "limit": { "dzienny": 100, "wykorzystano": 1 }, "wyniki": [{ "nip": "1133067162", "podmiot": { "nazwa": "…", "status_vat": "Czynny", "regon": "…", "adres": "…", "rachunki": 1 }, "rachunek": { "na_liscie": true }, "vies": { "aktywny": true } }]}Klucza nie umieszczaj w kodzie strony ani aplikacji mobilnej: wywołuj API z serwera albo zaufanego programu.
Klucz testowy na tydzień
Napisz, do czego chcesz użyć API i które z nich Cię interesuje. Dostaniesz klucz z małym limitem do sprawdzenia w swoim programie.
Ceny netto, doliczam 23% VAT. Wolisz gotowe rozwiązanie bez programowania? Zobacz automatyzacje i raporty. Szczegóły o danych: polityka prywatności, zasady usług: warunki usług płatnych.