maticna.si API

maticna.si je REST API za vse slovenske davčne zavezance s seznamov FURS: pravne osebe, samostojne podjetnike (s.p.) in druge fizične osebe z dejavnostjo, s statusom DDV, odvzemi identifikacijskih številk in skupinami DDV. Podatke osvežimo isti dan, ko jih FURS objavi.

curl https://api.maticna.si/v1/entities/80267432 \
  -H "Authorization: Bearer $MATICNA_KEY"

Hiter začetekKljuč in prvi klic v dveh minutah: curl, JS, PHP, Python, C#.

API referencaVse končne točke iz openapi.json, s primeri zahtev in odgovorov.

Objekt entityPolje za poljem: tip, status, DDV, odvzemi, registracije.

NapakeRFC 9457 problem+json in stran za vsako kodo.

MCP strežnikRegister v Claude, Cursor, VS Code in agentih. Isti ključi in enote kot REST.

Osnovna pravila

Osnovni URL: https://api.maticna.si/v1. Samo HTTPS.
JSON v snake_case z diskriminatorjem object (entity, list, vat_check, …). Nove vrednosti naštevnih tipov se lahko pojavijo kadarkoli; vaša koda jih mora prenesti.
Glave na vsakem odgovoru: X-Request-Id, X-Data-As-Of (datum vira FURS), X-Data-Version.
Pripis vira: source.attribution oziroma meta.attribution je vedno Vir: FURS.
Različice: znotraj /v1 samo združljive (dodajajoče) spremembe. Nezdružljive gredo v /v2 z vsaj 12 meseci prekrivanja in glavama Deprecation/Sunset.
Jezik: imena polj in code napak so angleški; title in detail sledita Accept-Language: sl|en.

Končne točke

Metoda in pot	Namen	Enote
`GET /v1/entities/{tax_number}`	Zavezanec po davčni številki (sprejme tudi `SI…`)	1
`GET /v1/entities/by-registration-number/{reg}`	Po matični (7 ali 10 števk), vrne seznam	1
`GET /v1/entities/by-vat/{vat_id}`	Po ID za DDV	1
`POST /v1/entities/lookup`	Do 100 mešanih ID-jev v enem klicu (od paketa Starter)	1 na različen ID
`GET /v1/entities?q=…`	Iskanje in filtriranje	1 na stran
`GET /v1/autocomplete?q=…`	Samodokončanje (javni ključi dovoljeni)	0,25
`GET /v1/vat/validate/{vat_id}`	Preverjanje ID za DDV	1
`GET /v1/tax-number/validate/{n}`	Mod-11 in prisotnost v registru	1
`GET /v1/reference/{activity-codes,tax-offices,legal-forms,postal-codes}`	Šifranti	0
`GET /v1/meta/status`	Svežina podatkov po seznamih	0
`GET /v1/usage`	Poraba in kvota	0
`GET /v1/openapi.json`	Specifikacija	0

Sledenje spremembam (od paketa Growth): GET /v1/changes in GET /v1/entities/{tax}/history, glej Spremembe in zgodovina. Opazovani subjekti in podpisani webhooki (od paketa Starter): Opazovani subjekti, Webhooki.

Vir: FURS · neuradni vir, ni uradni izpis · Pogoji · Zasebnost · maticna.si