Fintor API v1

Vaše data ve Fintoru jsou dostupná i strojově — pro vlastní skripty, AI agenty i integrace. Autentizace osobním tokenem, odpovědi v JSON.

Rychlý start

V aplikaci otevřete Nastavení → API tokeny a vytvořte token (zvolte, jestli má umět jen číst, nebo i zapisovat).
Token se zobrazí jen jednou — uložte si ho do správce hesel. Fintor si ukládá pouze jeho otisk, zpětně ho nelze zobrazit.
Posílejte ho v hlavičce Authorization:

curl -H "Authorization: Bearer fnt_…" \
     https://app.fintor.cz/api/v1/me

Odpověď /api/v1/me vrátí účet, jméno tokenu, jeho oprávnění a seznam zapnutých modulů — nejrychlejší kontrola, že je token v pořádku.

Pravidla

Izolace účtu. Token vidí výhradně data svého účtu. Cizí ID vrací 404 — nikdy neprozradíme, že záznam existuje jinde.
Oprávnění. Token pro čtení zvládne jen GET; zápis (POST, PUT, DELETE) vyžaduje oprávnění „Zápis“, jinak vrátí 403.
Moduly. Endpoint vypnutého modulu vrací 403 s vysvětlením, který modul zapnout (Nastavení → Moduly).
Limit. 120 požadavků za minutu na token; při překročení 429 a hlavička Retry-After. Zbývající kredit najdete v X-RateLimit-Remaining.
Stejná pravidla jako v aplikaci. API nemá vlastní výjimky: změna nájemného zakládá novou verzi nájmu, ručně zadaná transakce přepočítá skutečnost v rozpočtu, duplicitní importy se stejně deduplikují.
Chyby. Vždy application/problem+json (RFC 7807) s poli type, title, detail; u validace navíc errors po jednotlivých polích.

Endpointy

Metoda	Cesta	Popis	Modul
GET	`/api/v1/me`	Účet, token, zapnuté moduly	—
GET	`/api/v1/transactions`	Transakce (filtry `month`, `budgetItemId`, `account`, `uncategorizedOnly`)	Finance
POST	`/api/v1/transactions`	Ruční transakce (přepočítá rozpočet)	Finance
PUT / DELETE	`/api/v1/transactions/{id}`	Úprava a smazání ruční transakce	Finance
GET	`/api/v1/budget`	Plán vs. skutečnost za měsíc	Finance
GET	`/api/v1/budget/categories`	Kategorie a položky	Finance
POST	`/api/v1/budget/categories`, `/items`	Založení kategorie / položky s plánem	Finance
GET / POST / PUT	`/api/v1/properties`	Nemovitosti včetně cash flow a equity	Nájmy
GET / POST	`/api/v1/properties/{id}/readings`	Odečty měřidel	Nájmy
GET / POST / PUT	`/api/v1/contacts`	Kontakty (nájemníci, dodavatelé)	Nájmy
GET / POST	`/api/v1/leases`	Nájmy a jejich verze	Nájmy
POST	`/api/v1/leases/{id}/versions`	Změna nájmu = nová verze	Nájmy
GET	`/api/v1/leases/{id}/ledger`	Saldo nájemného po měsících	Nájmy
GET	`/api/v1/loans`	Hypotéky a půjčky	Úvěry
GET	`/api/v1/investments`, `/fire`	Portfolio a postup k FIRE cíli	Investice

Úplný a vždy aktuální seznam včetně schémat je ve strojově čitelné OpenAPI specifikaci.

Příklad: zadání transakce

curl -X POST https://app.fintor.cz/api/v1/transactions \
     -H "Authorization: Bearer fnt_…" \
     -H "Content-Type: application/json" \
     -d '{"date":"2026-08-09","amount":-1250.00,
          "counterpartyName":"Lékárna","budgetItemId":47}'

Částka nese znaménko: výdaj záporně, příjem kladně — stejně jako v bankovních výpisech. Bez budgetItemId zůstane transakce nezařazená.

API je součástí bety. Endpointy v /api/v1 se snažíme držet zpětně kompatibilní; nekompatibilní změny by dostaly novou verzi cesty.