Objekt entity

GET /v1/entities/{tax_number} vrne en objekt entity na davčno številko. Polja na vrhu odražajo primarno registracijo; vse registracije so v registrations[].

{
  "object": "entity",
  "tax_number": "19000006",
  "vat_id": "SI19000006",
  "type": "legal_entity",
  "status": "active",
  "status_flags": [],
  "name": "GASILSKA OPREMA VZOREC, D.O.O.",
  "legal_form": "d.o.o.",
  "registration_number": "9000000000",
  "registration_number_short": "9000000",
  "foreign_registry_id": null,
  "address": {
    "raw": "VZORČNA ULICA 9, 1000 LJUBLJANA",
    "street": "VZORČNA ULICA", "house_number": "9",
    "postal_code": "1000", "city": "LJUBLJANA", "country": "SI"
  },
  "activity": { "code": "46.690", "label_sl": "Nespecializirana trgovina na debelo", "version": "SKD2025" },
  "vat": { "registered": true, "registered_on": "2013-04-23", "scope_code": null, "group_id": null, "source": "furs_po" },
  "vat_revocations": [],
  "tax_office": { "code": "08", "name": "FU Ljubljana" },
  "registrations": [],
  "first_seen_on": "2026-10-19",
  "last_seen_on": "2026-10-19",
  "deactivated_on": null,
  "source": {
    "dataset": "furs_po", "as_of": "2026-10-19", "attribution": "Vir: FURS",
    "url": "https://www.fu.gov.si/e_storitve/seznami_davcnih_zavezancev/"
  }
}

Polja

Polje	Tip	Opis
object	"entity"	diskriminator
tax_number	string, 8 števk	davčna številka
vat_id	string	SI + davčna; obstaja tudi, če subjekt ni zavezanec za DDV (glej vat.registered)
type	enum	legal_entity, sole_proprietor (s.p.), other_self_employed (druge fizične osebe z dejavnostjo, ki niso s.p.)
status	enum	active ali inactive (ni več na seznamu FURS)
status_flags	enum[]	in_bankruptcy, in_liquidation. Hevristika iz naziva, ne uradni podatek.
name	string	naziv, kot ga objavi FURS
legal_form	string | null	razbrana pravna oblika: d.o.o., d.d., k.d., d.n.o., so.p., z.b.o., zavod, društvo, ustanova, s.p., …
registration_number	string | null	10-mestna matična (s pripono enote)
registration_number_short	string | null	prvih 7 števk
foreign_registry_id	string | null	za tuje subjekte: identifikator v tujem registru
address	objekt	raw je izvirni zapis FURS; ostala polja so razčlenjena
activity	objekt | null	šifra SKD 2025 z oznako
vat	objekt	glej spodaj
vat_revocations	objekt[]	odvzemi ID za DDV po uradni dolžnosti (list: mt ali np, ceased_on)
tax_office	objekt | null	pristojni finančni urad
registrations	objekt[]	za fizične osebe: ena na matično (631 oseb ima dve)
first_seen_on, last_seen_on, deactivated_on	datum	kdaj smo zapis prvič/zadnjič videli in kdaj je izginil
source	objekt	seznam, datum vira, pripis in URL
match	objekt	samo pri iskanju: score, matched_on

vat

Polje	Opis
registered	ali je davčna številka identificirana za DDV na dan source.as_of. Za fizične osebe izhaja iz seznama FO.
registered_on	datum identifikacije
scope_code	P (ni zavezanec po 76.a členu ZDDV-1), O (posebna ureditev, občasni prevoz potnikov), S (skupina DDV), Č (član skupine DDV) ali null
group_id	davčna številka skupine DDV za člane skupine
source	furs_po ali furs_fo

Po matični in ID za DDV

• GET /v1/entities/by-registration-number/{reg} vrne seznam (list), ker ima ena 7-mestna matična lahko več enot.
• GET /v1/entities/by-vat/{vat_id} vrne 404 not_vat_registered, če subjekt obstaja, a ni zavezanec za DDV.
• GET /v1/vat/validate/{vat_id} za fizične osebe brez zapisa DEJ vrne entity_ref: null in brez imena.

Finančni povzetek (include=financials_latest)

GET /v1/entities/{tax_number}?include=financials_latest doda polje financials_latest: zadnje letno poročilo podjetja pri AJPES (čisti prihodki od prodaje, čisti poslovni izid, povprečno število zaposlenih, sredstva, kapital, v EUR) z izvorom obeh izkazov in navedbo vira »Vir: AJPES (www.ajpes.si), CC BY 4.0; izračuni maticna.si«. Na voljo od paketa Starter naprej; na paketu Hobi vrne 403 plan_upgrade_required (0 enot). Stane +1 enoto, ko povzetek vrnemo; za samostojne podjetnike (s.p.) in podjetja brez objavljenega poročila je null in ne stane nič dodatno. Več let in vse postavke: Finančni podatki.