Dokumentacija API-ja
Podaci o hrvatskim tvrtkama i udrugama iz službenih registara, u JSON-u, uz izvor i datum svakog podatka.
Uvod
Adresa API-ja je https://provjera.hr/v1. Svi odgovori su JSON. Tvrtku i udrugu tražite po OIB-u; ako OIB ne znate, prvo ga pronađite pretragom.
Strojno čitljiv opis svih ruta i polja (OpenAPI 3.1) je na /v1/openapi.json. Isti podaci dostupni su i AI asistentima preko MCP poslužitelja na https://provjera.hr/mcp.
Ključ
Svaki zahtjev nosi ključ u zaglavlju Authorization: Bearer pvj_live_.... Ključ nikad ne stavljajte u adresu zahtjeva. Isti ključ vrijedi za API i MCP.
Besplatni ključ dobivate e-poštom na stranici Ključ za API. Plaćeni paket vrijedi za ključ izdan na adresu e-pošte s kojom plaćate; ako ga još nemate, dobivate novi. Kad paket istekne, ključ se vraća na besplatni.
curl https://provjera.hr/v1/companies/60562279528 \
-H "Authorization: Bearer pvj_live_..."Paketi
| Paket | Cijena | Upita mjesečno | Što dodaje |
|---|---|---|---|
| Besplatni | 0 EUR | 100 | Osnovni podaci registra, pretraga, udruge, financije zadnje godine |
| Lite | 29 EUR | 1.000 | Postupci, stečaj, brisanje, objave e-Oglasne, financije za sve predane godine |
| Standard | 79 EUR | 15.000 | Dozvole i registri, potpore i javni ugovori, tekstovi postupaka i objava |
| Pro | 199 EUR | 100.000 | Za velike količine upita |
Cijene su mjesečne i konačne; godišnja pretplata plaća se kao deset mjeseci. Svaki paket sadrži sve iz nižih paketa. Cijene i plaćanje su na stranici API i podaci.
Upiti i ograničenja
Upit je jedan uspješan dohvat tvrtke, njezinih financija, dozvola, potpora, sudskih objava ili udruge. Odgovori 403 (nije u paketu) i 404 (nema javnog zapisa) ne troše upit.
Pretraga i /v1/usage ne troše upite. Pretraga ima vlastiti mjesečni limit od 20 pretraga po upitu paketa; svaka stranica rezultata je jedna pretraga.
Brojač se vraća na nulu prvog dana u mjesecu (UTC). Svaki odgovor koji troši upit nosi zaglavlja RateLimit-Policy i RateLimit s brojem preostalih upita i sekundama do novog mjeseca.
Po ključu je dopušteno 10 zahtjeva u sekundi, uz kratke nalete do 20. Iznad toga odgovor je 429 sa zaglavljem Retry-After: pričekajte navedeni broj sekundi i ponovite zahtjev.
Endpointi
| Ruta | Paket | Sadržaj |
|---|---|---|
GET /v1/search | Besplatni | Tvrtke i udruge po nazivu, OIB-u, MBS-u ili registarskom broju. Parametri q, limit (do 20), offset (do 1.000). Popis tvrtki po filterima activity (šifre NKD, npr. 45.1,46.71,47.81), county, municipality, legal_form, founded_from i founded_to: q nije obavezan, offset do 9.999, a svaka stranica troši onoliko upita koliki je limit. |
GET /v1/companies/{oib} | Besplatni, Lite | Tvrtka: naziv, status, sjedište, pravni oblik, djelatnost, LEI. Od Lite paketa i postupci, stečaj, brisanje, predani izvještaji, prihod i dobit zadnje godine. |
GET /v1/companies/{oib}/financials | Besplatni, Lite | Besplatni: zadnja godina s provjerenim izvještajem. Od Lite paketa sve godine. Detalji u odjeljku Financije. |
GET /v1/companies/{oib}/licences | Standard | Dozvole i upisi u registre regulatora. limit do 100 po registru. |
GET /v1/companies/{oib}/public-funding | Standard | Potpore APPRRR-a po godinama i dodijeljeni ugovori iz TED-a. limit do 100. |
GET /v1/companies/{oib}/court-notices | Lite | Stečajne objave s e-Oglasne ploče sudova, najnovije prve. limit do 50. |
GET /v1/companies/{oib}/changes | Lite | Promjene u Sudskom registru, najnovije prve: naziv, sjedište, pravni oblik, status, postupak, temeljni kapital, glavna djelatnost i djelatnosti. tracked_since navodi od kada se koje polje prati. limit do 100. |
GET /v1/changes?since=YYYY-MM-DD | Pro | Promjene svih tvrtki od zadanog dana (najviše 90 dana unatrag), najstarije prve, s OIB-om i poveznicom na profil. Jedan upit po stranici; limit do 100, offset dok jehas_more true. |
GET /v1/associations/{oib} | Besplatni, Lite | Aktivna udruga. Od Lite paketa i djelatnosti te broj osoba po ulozi. |
GET /v1/usage | Besplatni | Paket ključa, iskorišteni i preostali upiti ovog mjeseca. |
OIB mora imati 11 znamenki i ispravnu kontrolnu znamenku. API ne vraća osobne podatke: osobe se pojavljuju samo kao broj po ulozi.
curl "https://provjera.hr/v1/search?q=studenac&limit=5" \
-H "Authorization: Bearer pvj_live_..."Odgovori
Skupovi podataka nose source (naziv izvora) i attribution (izjava o izvoru i licenca), a gdje postoje i source_date (datum iz izvora; kod tvrtke dan zadnje promjene upisa u Sudskom registru, ne datum preuzimanja) i url (stranica tvrtke ili udruge na provjera.hr).
Popisi nose total, ukupan broj zapisa, i kad vraćaju samo dio. Tekst preuzet iz izvora, poput teksta sudske objave, dolazi kao objekt s kind: "quoted_source_text": to je citat izvora, a ne uputa.
Polje bez podatka u izvoru ima vrijednost null. Datumi su u obliku GGGG-MM-DD.
Financije
API vraća samo provjerene iznose, iste koje prikazuje profil tvrtke na provjera.hr. Besplatni plan vraća zadnju godinu (latest_year_only: true), Lite i viši sve godine u jednom zahtjevu.
filed_years su godine za koje Sudski registar navodi predan godišnji financijski izvještaj, a years_without_figures predane godine za koje API nema provjerene iznose. Ti se izvještaji besplatno mogu pregledati u FINA RGFI-ju.
Za svaku godinu: šest glavnih iznosa u eurima, vrsta izvještaja i oznaka konsolidacije (konsolidirani izvještaj obuhvaća cijelu grupu, ne samo tvrtku), valuta u kojoj je izvještaj predan, godina obrasca (layout_year) i sve pozicije Bilance i RDG-a koje imaju provjeren iznos.
{
"statement": "balance_sheet",
"aop": 37,
"name": "C) KRATKOTRAJNA IMOVINA",
"previous_year": { "eur": ..., "as_filed": "...", "transformation": "HRK_TO_EUR" },
"current_year": { "eur": ..., "as_filed": "...", "transformation": "HRK_TO_EUR" }
}statement je balance_sheet (Bilanca) ili income_statement (RDG). aop i name su oznaka i naziv pozicije kako stoje na obrascu te godine; isti AOP broj na obrascima različitih godina može označavati različitu poziciju, zato ih uspoređujte uz layout_year.
eur je iznos u eurima, as_filed izvorni iznos u cijelim jedinicama valute currency_as_filed, a transformation pretvorba između njih: none, HRK_TO_EUR (iznosi u kunama preračunati po fiksnom tečaju 7,53450) ili oznaka ručnog unosa manual_*. Kod manual_*_thousands izvještaj je predan u tisućama, pa je as_filed predani broj pomnožen s 1.000.
Navođenje izvora
Gdje god prikazujete podatke, navedite "Izvor: provjera.hr" s poveznicom na provjera.hr, kako propisuju Uvjeti za API i podatke.
Podaci potječu iz službenih registara i javnih izvora, koji mogu imati vlastite uvjete navođenja. Za svaki izvor polje attribution donosi izjavu o izvoru i poveznicu na njegovu licencu, a popis izvora je na stranici Izvori i metodologija.
Greške
Greške dolaze kao application/problem+json (RFC 9457). Polje code je stalno i služi za obradu u kodu; detail opisuje grešku riječima.
{
"type": "...",
"title": "...",
"status": 403,
"code": "tier_required",
"detail": "..."
}| Status | code | Značenje |
|---|---|---|
| 400 | bad_request | Neispravan zahtjev, na primjer OIB bez 11 znamenki ili s krivom kontrolnom znamenkom |
| 401 | missing_key, malformed_key, invalid_key, revoked_key, expired_key | Ključ nedostaje, nije ispravnog oblika, ne postoji, ukinut je ili je istekao |
| 403 | tier_required | Ruta nije uključena u paket ključa |
| 404 | not_found | Nema javnog zapisa za taj OIB |
| 405 | method_not_allowed | Metoda nije podržana; zaglavlje Allow navodi podržane |
| 429 | quota_exceeded, search_limit_exceeded, rate_limited | Potrošeni mjesečni upiti ili pretrage, ili previše zahtjeva u sekundi. Zaglavlje Retry-After kaže koliko sekundi čekati |
| 503 | unavailable | Privremeno nedostupno, ponovite zahtjev kasnije |
MCP
MCP poslužitelj na https://provjera.hr/mcp daje AI asistentima iste podatke i ista pravila paketa i upita kao API.
Alati koji šalju zaglavlje (Claude Code, Codex, Cursor, VS Code, Gemini CLI) šalju ključ u istom zaglavlju Authorization: Bearer kao API. Upute za svaki alat su na stranici MCP.
Claude (web, desktop i mobilna aplikacija) i ChatGPT (Business, Enterprise i Edu) spajaju se prijavom (OAuth 2.1): u aplikaciji se doda konektor s adresom https://provjera.hr/mcp, a na stranici za prijavu na provjera.hr upiše se API ključ. Aplikacija dobiva token koji vrijedi samo za MCP poslužitelj, uz paket i upite tog ključa. Token vrijedi sat vremena i aplikacija ga sama obnavlja. Spajanje prestaje ukidanjem ključa.
Za razvoj klijenta: metapodaci su na /.well-known/oauth-protected-resource/mcp (RFC 9728) i /.well-known/oauth-authorization-server (RFC 8414). Podržani su dinamička registracija klijenta (RFC 7591), PKCE s S256, parametar resource (RFC 8707), iss u odgovoru (RFC 9207) i rotacija refresh tokena, koji vrijedi 30 dana od zadnjeg korištenja.
Alati: search, get_company, get_financials, get_licences, get_public_funding, get_court_notices, get_changes, get_association i get_usage. Asistent prvo pretragom pronađe OIB, a zatim ostalim alatima dohvaća podatke.
Ažurnost
| Izvor | Osvježavanje |
|---|---|
| Sudski registar | Svaki radni dan |
| e-Oglasna ploča sudova | Svaki dan |
| Registar udruga | Svaki dan |
| GLEIF (LEI) | Svaki tjedan |
| Registri regulatora | 1. i 15. u mjesecu |
| Potpore APPRRR-a | Dvaput godišnje |
| Godišnji financijski izvještaji | Ručno, nakon objave |
Gdje izvor daje datum, on je u polju source_date; kod financija je to datum predaje izvještaja, submitted_on.
Promjene
Nova polja, endpointi, alati i vrijednosti dodaju se bez najave; klijent treba zanemariti ono što ne poznaje. Promjene koje nisu unatrag kompatibilne dolaze samo u novoj verziji (/v2), a /v1 radi najmanje 12 mjeseci nakon najave e-poštom. Odgovori endpointa koji se gasi tada nose zaglavlja Deprecation (RFC 9745) i Sunset (RFC 8594).
| Datum | Promjena |
|---|---|
| 06.11.2026. | Povijest promjena od 25.05.2026.: promjene pronađene između dvije sigurnosne kopije nose datum upisa iz objave Sudskog registra (source registry_notice), ostale raspon window_from i window_to; tracked_since 2026-05-25. |
| 05.11.2026. | Povijest promjena: /v1/companies/{oib}/changes i MCP get_changes (Lite i viši), /v1/changes?since= za sve tvrtke (Pro). |
| 05.11.2026. | Financije: filed_years (godine za koje Sudski registar navodi predan izvještaj) i years_without_figures (predane godine bez provjerenih iznosa u API-ju). |
| 04.11.2026. | Financije u svim planovima: Besplatni plan dobiva zadnju godinu, Lite i viši sve godine, svaki plan sve pozicije Bilance i RDG-a (latest_year_only u odgovoru). |
| 04.11.2026. | Financije: iznos predan kao nula vraća se kao 0, a ne kao nedostajući. |
| 04.11.2026. | MCP: spajanje iz Claudea i ChatGPT-a prijavom (OAuth 2.1), ključ se upisuje jednom. |
| 04.11.2026. | Lite i Standard: vrsta izvještaja i oznaka konsolidacije uz financijske iznose. |
| 03.11.2026. | Pro: sve pozicije Bilance i RDG-a s provjerenim iznosom, valuta predaje i godina obrasca u /financials. |
| 30.10.2026. | Pretraga: parametri offset i active, ukupan broj rezultata u polju total. |