Sign up

Guide · Slovenia · API

Slovenia company data API: look up a company by matična številka

Slovenian companies from the AJPES Business Register in the same record shape as every other country: one key, one call, the register credited. Here is the call, the fields, and what the open list does not hold.

Slovenia at a glance

Register: Business Register of Slovenia (AJPES)

Identifiers Matična številka

  • Company recordsYes
  • OfficersNo
  • Insolvency noticesIn the status only
  • Corporate eventsRegister changes
  • MonitoringYes
  • Financial statementsNo
  • VAT numberNo
  • NACE classNo
  • UpdatedWeekly

The guide below states the limits of every row. Financial statements are on the Scale plan and above; the other plans and the free trial get 10 calls a month.

Price From EUR 9.99 a month (Starter plan)

In other languagesSlovenščina

Sign up

Try Slovenia live

Look up a company in Slovenia with the shared demo key. No sign-up.

The demo key is shared and capped per page view; your own key has the limits of your plan.

The call

The same endpoint as every other live country, with country=SI. A company is found by its matična številka (10 digits ending in 000; the 7-digit form people quote is read with the 000 added) or by name:

# by matična številka
curl -H "Authorization: Bearer rk_live_..." \
  "https://api.prometiam.com/functions/v1/risk-api/companies/search?company_number=5043611000&country=SI"

# by name
curl -H "Authorization: Bearer rk_live_..." \
  "https://api.prometiam.com/functions/v1/risk-api/companies/search?name=krka&country=SI"

A value that is not shaped like a matična številka answers with a 400 validation error, and so does a number that ends in anything but 000 (that is a business unit of a company, which is never served). Spaces and hyphens are tolerated. The check digit is only advisory: some registered companies fail it, so the free identifier validator warns about it and the API does not refuse on it. The tax number (davčna številka) is a different number that the open list does not carry, so a vat search is refused.

What a record holds

FieldNotes
company_numberThe matična številka, 10 digits ending in 000.
company_nameAs the register writes it, without the bankruptcy or liquidation marker; registry_details.name_as_registered keeps the name as published.
legal_formThe register’s legal form: limited liability company (d.o.o.), joint-stock company (d.d.), general partnership (d.n.o.), limited partnership (k.d.) or European company (SE).
statusRead only from the marker AJPES adds to the name: in bankruptcy (v stečaju), in compulsory liquidation (v prisilni likvidaciji) or in liquidation (v likvidaciji). Every other company reads active, which means only that it is on the register: a company in a procedure that is not marked reads active. A company that disappears from the list shows as deregistered from the first list without it.
address, postal_code, cityThe registered address: street and house number, postal code and post town. registry_details also carries the registering court.

That is the whole record. The open list carries no founding, registration or dissolution date (so founded_after finds no Slovenian company and there is no company age), no activity code (so no NACE class), no share capital, no VAT number, no officers, no financial statements and no insolvency notices; Slovenia is not one of the markets with insolvency notices, and a bankruptcy or liquidation shows only in the status.

Register-change events and monitoring

Slovenia has register-change events and company monitoring. An event is written when the name, the status, the legal form or the address of a company changes in the list, and it is dated when the change first appears there (the list gives no dates of its own); there are none before Slovenia's first load. Monitoring alerts fire on a status change, a dissolution, a sanctions match and these events, through the same monitoring endpoints as every other country. The list gives no dissolution date, so a company that leaves it raises a dissolution alert dated by the check that first sees the exit. The data is refreshed when AJPES republishes the list, about every two weeks.

What is not in it

Only companies are served: d.o.o., d.d., d.n.o., k.d. and SE. Sole traders (s.p.) and the other natural persons in a trade, business units, branches, cooperatives, associations, institutes and public bodies are never served. There are no dates of any kind, no activity code, no share capital, no VAT number, no officers, no financial statements and no insolvency notices.

Source and related guides

Source: Poslovni register Slovenije – AJPES (the Business Register of Slovenia of the Agency of the Republic of Slovenia for Public Legal Records and Related Services), published on the Open Data Slovenia portal (OPSI, https://podatki.gov.si/dataset/9ee1a9aa-c224-4995-b2ad-3760d7af0748) under the Creative Commons Attribution 4.0 licence (https://creativecommons.org/licenses/by/4.0/). Adapted by Prometiam (status read from the name marker and the marker removed from the name, house numbers normalised).