The entity object

GET /v1/entities/{tax_number} returns one entity object per tax number. The top-level fields reflect the primary registration; all registrations are in 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/"
  }
}

Fields

Field	Type	Description
object	"entity"	discriminator
tax_number	string, 8 digits	tax number (davčna številka)
vat_id	string	SI + tax number; present even when the entity is not VAT-registered (see vat.registered)
type	enum	legal_entity, sole_proprietor (s.p.), other_self_employed (other natural persons carrying out an activity who are not s.p.)
status	enum	active or inactive (no longer on the FURS list)
status_flags	enum[]	in_bankruptcy, in_liquidation. A heuristic based on the name, not official data.
name	string	name as published by FURS
legal_form	string | null	parsed legal form: 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-digit registration number (with the unit suffix)
registration_number_short	string | null	the first 7 digits
foreign_registry_id	string | null	for foreign entities: the identifier in the foreign register
address	object	raw is the original FURS string; the other fields are parsed
activity	object | null	SKD 2025 activity code with its label
vat	object	see below
vat_revocations	object[]	VAT ID revocations ex officio (list: mt or np, ceased_on)
tax_office	object | null	the competent tax office
registrations	object[]	for natural persons: one per registration number (631 persons have two)
first_seen_on, last_seen_on, deactivated_on	date	when we first/last saw the record and when it disappeared
source	object	list, source date, attribution and URL
match	object	search only: score, matched_on

vat

Field	Description
registered	whether the tax number is identified for VAT as of source.as_of. For natural persons it comes from the FO list.
registered_on	date of identification
scope_code	P (not a taxable person under Article 76.a of ZDDV-1), O (special scheme, occasional passenger transport), S (VAT group), Č (VAT group member) or null
group_id	tax number of the VAT group, for group members
source	furs_po or furs_fo

By registration number and VAT ID

• GET /v1/entities/by-registration-number/{reg} returns a list (list), because one 7-digit registration number can have several units.
• GET /v1/entities/by-vat/{vat_id} returns 404 not_vat_registered when the entity exists but is not VAT-registered.
• GET /v1/vat/validate/{vat_id} returns entity_ref: null and no name for natural persons without a DEJ record.

Financial summary (include=financials_latest)

GET /v1/entities/{tax_number}?include=financials_latest adds financials_latest: the newest AJPES annual report of a company (revenue, net profit, average employees, total assets, equity, in EUR) with the provenance of both statements and the attribution “Vir: AJPES (www.ajpes.si), CC BY 4.0; izračuni maticna.si”. Starter plan and up; on Hobby it returns 403 plan_upgrade_required (0 units). It costs +1 unit when a summary is returned; for sole proprietors (s.p.) and companies without a published report it is null and costs nothing extra. Several years and all figures: Financial statements.