Sudski registar API: službeni i Prometiam

Sudski registar objavljuje vlastiti otvoreni API. Ovdje je pošteno objašnjeno kada je dovoljan on, a kada je jedan standardizirani poziv po MBS-u, OIB-u ili PDV broju bolji izbor.

Službeni API Sudskog registra

Ministarstvo pravosuđa, uprave i digitalne transformacije objavljuje podatke Sudskog registra kao otvorene podatke i nudi API na sudreg-data.gov.hr. Besplatan je, a pristup se dobiva putem pristupnog tokena. Ako vam treba zapis jedne tvrtke u obliku u kojem ga vodi registar, to je najjeftinije rješenje i ne morate dalje tražiti.

Ograničenje nastaje kad hrvatske tvrtke provjeravate zajedno s partnerima iz drugih država ili kad želite stalan nadzor. Svaki registar tada ima vlastitu autentifikaciju, vlastita imena polja i vlastiti oblik odgovora. Prometiam vraća isti oblik odgovora za sve države, pa se razlikuje samo parametar country.

Što Prometiam dodaje

• Jedna shema za Hrvatsku i 28 drugih država: company_name, company_number, status, legal_form, adresa, identifiers.
• Pretraga po MBS-u, OIB-u, PDV broju ili nazivu. OIB ima kontrolnu znamenku koja se provjerava, pa pogrešan unos daje grešku 400 umjesto lažnog "nema tvrtke".
• Praćenje (POST /monitor): webhook potpisan HMAC-SHA256 pri promjeni statusa, prestanku, pogotku na sankcijskoj listi (beta) i događajima promjena u registru. Plan Professional.
• Stečajne odluke suda povezane s tvrtkom preko MBS-a, samo za tvrtke koje su još u registru.
• Jedan ključ, javne cijene i krediti: pretraga i profil tvrtke koštaju po 1 kredit, a odgovor nosi zaglavlje X-Credits-Cost.

Primjer zahtjeva

Pretraga po MBS-u vraća zapis tvrtke u polju data; isti poziv s oib=27759560625 ili vat=HR27759560625 pronalazi istu tvrtku.

# po MBS-u
curl 'https://api.prometiam.com/functions/v1/risk-api/companies/search?country=HR&company_number=080000604' \
  -H 'Authorization: Bearer rk_live_...'

# po OIB-u (kontrolna znamenka se provjerava)
curl 'https://api.prometiam.com/functions/v1/risk-api/companies/search?country=HR&oib=27759560625' \
  -H 'Authorization: Bearer rk_live_...'

# puni profil po id-u iz rezultata
curl 'https://api.prometiam.com/functions/v1/risk-api/companies/{id}' \
  -H 'Authorization: Bearer rk_live_...'

import os, requests

API = 'https://api.prometiam.com/functions/v1/risk-api'
HEAD = {'Authorization': f'Bearer {os.environ["PROMETIAM_API_KEY"]}'}

def tvrtka_po_oib(oib):
    r = requests.get(f'{API}/companies/search',
                     params={'country': 'HR', 'oib': oib}, headers=HEAD)
    r.raise_for_status()
    podaci = r.json()['data']
    return podaci[0] if podaci else None

Limiti i autentifikacija

Svaki poziv nosi zaglavlje Authorization: Bearer rk_live_.... Ograničenja po minuti ovise o paketu: Starter 60, Professional 120, Scale 300 poziva u minuti. Greške se ne naplaćuju. Skupni pozivi (POST /companies/lookup) broje svaku stavku kao jedan poziv, a prekoračenje stanja odbija se unaprijed (429 batch_exceeds_quota).

Što ne dobivate za Hrvatsku

• Samo podaci o tvrtkama: nema članova uprave ni zastupnika i nema signala usklađenosti s registrom.
• Obrti i druge fizičke osobe nikada se ne poslužuju; obuhvaćene su pravne osobe iz Sudskog registra.
• Događaji promjena u registru (naziv, status, pravni oblik, sjedište, temeljni kapital) datirani su od 30. rujna 2026.; ranijih nema.
• Financijska izvješća (GET /companies/{id}/financials, plan Scale) postoje samo za uvrštene tvrtke, iz izvješća ESEF; za ostale odgovor navodi listed_companies_only.
• PDV broj je izveden pravilom (HR + OIB), registracija nije potvrđena; potvrdite je pozivom GET /vat/HR....

Koji paket

• Starter (9,99 € mjesečno, 1.000 kredita): pretraga, profil tvrtke i provjera PDV broja.
• Professional (29,99 € mjesečno, 10.000 kredita): dodaje provjeru sankcija (beta) i webhookove za praćenje.
• Scale (99,99 € mjesečno, 50.000 kredita): dodaje financijska izvješća (u Hrvatskoj samo za uvrštene tvrtke).

Izvor: Sudski registar. Prometiam standardizira podatke i nije ovjereni izvadak iz registra.

Povezane stranice

• Prometiam na hrvatskom
• Što je Sudski registar?
• Pretraga Sudskog registra (besplatno)
• KYB provjera hrvatskih tvrtki
• Provjera dobavljača
• Praćenje stečaja

Pokreni besplatno probno razdoblje od 14 dana · Dokumentacija API-ja

Probno razdoblje traje 14 dana i uključuje 500 kredita. Kartica je obavezna, tijekom probnog razdoblja ništa se ne naplaćuje; nakon toga slijedi paket Starter (9,99 € mjesečno) ako ne otkažete.