Družbe v Sloveniji vpisuje v Poslovni register Slovenije (PRS) AJPES, ključ družbe pa je matična številka. Spodaj je klic API, polja zapisa in tisto, česar odprti seznam ne vsebuje.
Prometiam je plačljiv REST API, ki podatke uradnih registrov podjetij vrača v enotni obliki. Za Slovenijo pošljete matično številko ali ime (country=SI), v odgovoru pa dobite ime družbe, matično številko, pravnoorganizacijsko obliko, naslov in stanje. Objekt podjetja je enak kot za druge države, vrednost, ki je register ne objavlja, pa je null, nikoli izpuščena.
| Polje | Pomen |
|---|---|
company_name, company_number | Ime družbe (brez oznake stečaja ali likvidacije) in matična številka, 10 mest, ki se končajo na 000 |
legal_form | Pravnoorganizacijska oblika: d.o.o., d.d., d.n.o., k.d. ali SE |
status | Samo iz oznake v imenu: v stečaju, v prisilni likvidaciji, v likvidaciji; sicer aktivna |
address, postal_code, city | Poslovni naslov: ulica in hišna številka, poštna številka in pošta |
registry_details | Registrski organ (sodišče), pošta, ime, kot ga objavlja register |
Matična številka družbe ima 10 mest: šest mest zaporedne številke, kontrolno števko in končnico 000. Sedemmestno obliko, ki jo ljudje navajajo (5043611), API prebere z dodano končnico 000. Številka z drugo končnico je poslovna enota družbe in se nikoli ne vrača; napačno oblikovana številka dobi napako 400 (validation_error). Kontrolna števka je le svetovalna, ker nekatere vpisane družbe ne ustrezajo pravilu. Davčna številka je druga številka, ki je iz matične ni mogoče izpeljati.
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.
Za Slovenijo obstajajo dogodki sprememb v registru (ime, stanje, pravnoorganizacijska oblika in naslov) in spremljanje družb (sprememba stanja, prenehanje, ujemanje s sankcijskimi seznami in ti dogodki). Dogodek je datiran, ko se sprememba prvič pojavi na seznamu, ker seznam sam ne vsebuje nobenih datumov; pred prvim nalaganjem Slovenije jih ni. Ker seznam ne vsebuje datuma izbrisa, opozorilo o prenehanju nosi datum pregleda, ki je izstop družbe s seznama prvi zaznal. Podatki se osvežijo, ko AJPES seznam ponovno objavi, približno na dva tedna.
founded_after ne najde nobene slovenske družbe in starost družbe ni na voljo.vat se zavrne, polje vat_number je null.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).
En ključ in isti klici veljajo za vse države, ki jih pokrivamo. Cene so javne: Starter 9,99 € na mesec (1.000 kreditov), Professional 29,99 € (10.000), Scale 99,99 € (50.000), Enterprise po dogovoru. Iskanje ali zapis družbe stane 1 kredit, napake so brezplačne.
Angleška različica: API za podatke o slovenskih podjetjih.
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.