Podatki o slovenskih podjetjih iz AJPES v enem API-ju

Prometiam je en REST API z uradnimi podatki registrov 37 držav. Za Slovenijo: zapis družbe iz Poslovnega registra Slovenije (AJPES) po matični številki ali imenu, v enaki obliki kot za vsako drugo državo.

Kaj je Prometiam

Prometiam je plačljiv REST API, ki podatke uradnih registrov podjetij vrača v enotni obliki. Za vsako državo dobite isti objekt podjetja z enakimi ključi v enakem vrstnem redu, vrednost, ki je register ne objavlja, pa je null, nikoli izpuščena. En ključ in isti klici veljajo za vse države, ki jih pokrivamo; katere so in kakšne so omejitve vsake od njih, vedno pove GET /coverage.

Kaj dobite za Slovenijo

Vir je Poslovni register Slovenije (PRS), ki ga vodi AJPES: njegov odprti seznam na portalu Odprti podatki Slovenije (OPSI). Družbo poiščete po matični številki (10 mest ali sedemmestna oblika) ali po imenu.

PoljePomen
company_name, company_numberIme družbe brez oznake stečaja ali likvidacije in matična številka, 10 mest s končnico 000
legal_formPravnoorganizacijska oblika: d.o.o., d.d., d.n.o., k.d. ali SE
statusPrebrano samo iz oznake v imenu (v stečaju, v prisilni likvidaciji, v likvidaciji), sicer active; družba, ki izgine s seznama, je deregistered
address, postal_code, cityPoslovni naslov: ulica in hišna številka, poštna številka in pošta
registry_detailsRegistrsko sodišče, ime, kot ga objavlja register (name_as_registered), in celotno besedilo pravnoorganizacijske oblike

Matično številko, polja zapisa in klic podrobno opisuje vodnik AJPES API.

Primer klica

Družba Krka po matični številki 5043611000:

curl 'https://api.prometiam.com/functions/v1/risk-api/companies/search?country=SI&company_number=5043611000' \
  -H 'Authorization: Bearer rk_live_...'

Odgovor vsebuje seznam data, vsak zapis pa polje id, s katerim GET /companies/{id} vrne celoten zapis. Sedemmestno obliko (5043611) API prebere z dodano končnico 000. Številka z drugo končnico označuje poslovno enoto in se zavrne, prav tako napačno oblikovana številka (napaka 400, validation_error); kontrolna števka je le svetovalna, ker ji nekatere vpisane družbe ne ustrezajo.

Česa API ne vrne za Slovenijo

  • Samo družbe: d.o.o., d.d., d.n.o., k.d. in SE. Samostojni podjetniki posamezniki (s.p.) in druge fizične osebe z dejavnostjo, poslovne enote, podružnice, zadruge, društva, zavodi in javni organi se nikoli ne vračajo.
  • Datumov: odprti seznam ne vsebuje datuma ustanovitve, vpisa ali izbrisa, zato iskanje founded_after ne najde nobene slovenske družbe in starost družbe ni na voljo.
  • Šifre dejavnosti, osnovnega kapitala in davčne številke: seznam jih ne vsebuje; iskanje po vat se zavrne, polje vat_number je null.
  • Poslovodstva, zastopnikov in lastnikov ter računovodskih izkazov: za Slovenijo obstaja le zapis o družbi.
  • Obvestil o insolventnosti: Slovenija ni med trgi z obvestili o insolventnosti; stečaj ali likvidacija se vidita le v stanju.
  • Stanje: prebrano samo iz oznake, ki jo AJPES doda imenu družbe v stečaju ali likvidaciji (v stečaju, v prisilni likvidaciji, v likvidaciji); vsaka druga družba je active, kar pomeni le, da je v registru. Družba v postopku brez oznake je prikazana kot aktivna.

Vir: Poslovni register Slovenije – AJPES (Poslovni register Slovenije Agencije Republike Slovenije za javnopravne evidence in storitve), objavljen na portalu Odprti podatki Slovenije (OPSI) pod licenco Creative Commons Priznanje avtorstva 4.0. Prilagodil Prometiam (stanje prebrano iz oznake v imenu in oznaka odstranjena iz imena, hišne številke normalizirane).

Kaj Prometiam ponuja za Slovenijo

  • iskanje družbe po matični številki v brskalniku, brezplačno
  • skupinsko poizvedovanje (POST /companies/lookup): do 100 številk v enem klicu, vsaka postavka stane 1 kredit
  • dogodki sprememb v registru (ime, stanje, pravnoorganizacijska oblika, naslov): GET /company-events/search?country=SI, 2 kredita na klic
  • spremljanje družb (POST /monitor): webhook sporoči spremembo stanja, prenehanje, ujemanje s seznamom sankcij in dogodke v registru
  • preverjanje številke za DDV, ki jo že imate, v sistemu VIES: GET /vat/{number}
  • preverjanje po seznamih sankcij (beta)
  • strežnik MCP (v angleščini) za asistente umetne inteligence (Claude, Cursor)
  • isti klici za druge države: dovolj je zamenjati country

Cene

Cene so javne, prodajni klic ni potreben. Starter stane 9,99 € na mesec (1.000 kreditov), Professional 29,99 € (10.000 kreditov), Scale 99,99 € (50.000 kreditov), Enterprise pa je po dogovoru. Iskanje ali zapis družbe stane 1 kredit, preverjanje po seznamih sankcij (beta) 3 kredite; odgovori z napako so brezplačni. Preizkus traja 14 dni in vključuje 500 kreditov: potrebna je plačilna kartica, med preizkusom se nič ne zaračuna, nato pa velja Starter, če ne odpoveste.

Sorodne strani

Registracija · Dokumentacija API

Preizkusno obdobje traja 14 dni in vključuje 500 kreditov. Potrebna je plačilna kartica, med preizkusom se nič ne zaračuna; nato velja paket Starter (9,99 € na mesec), če ne odpoveste.

Pogosta vprašanja

Od kod so podatki o slovenskih družbah?
Iz Poslovnega registra Slovenije, ki ga vodi AJPES, iz njegovega odprtega seznama na portalu Odprti podatki Slovenije (OPSI) pod licenco CC BY 4.0. Vir in licenca sta navedena v vsakem odgovoru API (attribution, licence).
Kako pogosto se podatki osvežijo?
Ko AJPES seznam ponovno objavi, približno vsaka dva tedna; polje data_as_of pove datum objave seznama. Dogodek spremembe je datiran, ko se sprememba prvič pojavi na seznamu, pred prvim nalaganjem Slovenije pa dogodkov ni.
Kaj pomeni stanje `active` pri slovenski družbi?
Le to, da je družba vpisana v register. Stanje se prebere samo iz oznake, ki jo AJPES doda imenu družbe v stečaju, prisilni likvidaciji ali likvidaciji, zato je družba v postopku brez take oznake prikazana kot aktivna. Družba, ki izgine s seznama, je od prvega seznama brez nje deregistered; razlog ni naveden.
Ali API vrne davčno številko, datum ustanovitve ali osnovni kapital?
Ne. Odprti seznam ne vsebuje davčne številke, datumov, šifre dejavnosti in osnovnega kapitala. Iskanje po vat se zato zavrne, vat_number je null, iskanje founded_after pa ne najde nobene slovenske družbe. Številko za DDV, ki jo že imate, lahko preverite v sistemu VIES z GET /vat/{number}.
Ali API vrne direktorje, zastopnike in lastnike?
Ne. Za Slovenijo obstaja le zapis o družbi: brez poslovodstva, zastopnikov, družbenikov in dejanskih lastnikov ter brez računovodskih izkazov in obvestil o insolventnosti.
Ali lahko preverim samostojnega podjetnika (s.p.)?
Ne. Samostojni podjetniki posamezniki in druge fizične osebe z dejavnostjo, poslovne enote, podružnice, zadruge, društva, zavodi in javni organi se nikoli ne vračajo: samo družbe (d.o.o., d.d., d.n.o., k.d. in SE).
Ali je za preizkus potrebna plačilna kartica?
Da. Preizkus traja 14 dni, vključuje 500 kreditov in zahteva plačilno kartico. Med preizkusom se nič ne zaračuna, nato pa velja Starter (9,99 € na mesec), če ne odpoveste.