Dla programistów i firm z własnym systemem
API
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 zapisujemy danych z zapytań: liczymy tylko, ile razy klucz został użyty.
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
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
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; my trzymamy 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 albo wyłączony 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, faktur, pozycji) nie zapisujemy ani nie logujemy. Umowę powierzenia danych podpisujemy razem z umową na API |
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);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.
Poproś o klucz testowyCeny netto, doliczamy 23% VAT. Wolisz gotowe rozwiązanie bez programowania? Zobacz automatyzacje i raporty. Szczegóły o danych: polityka prywatności.