Regmio API dokumentācija

Regmio API dod jūsu sistēmām tos pašus uzņēmumu datus, ko redzat regmio.eu: Latvijas, Igaunijas un Lietuvas uzņēmumus no oficiālajiem reģistriem, PVN pārbaudi VIES sistēmā, uzraudzības sarakstu un konstatēto izmaiņu plūsmu. Tas ir vienkāršs REST API ar JSON atbildēm, un tas ir iekļauts Bizness plānā bez papildu maksas.

Ātrais sākums

1. Piesakieties Regmio ar aktīvu Bizness plānu un atveriet Mans konts → API atslēgas.
2. Izveidojiet atslēgu (piemēram, "Grāmatvedība") un nokopējiet to — tā tiek parādīta tikai vienreiz.
3. Veiciet pirmo pieprasījumu:

curl https://api.regmio.eu/v1/companies/40003032949 \
  -H "Authorization: Bearer rg_live_JUSU_ATSLEGA"

Mašīnlasāmā specifikācija (OpenAPI 3.1) ir pieejama https://api.regmio.eu/v1/openapi.json — to var importēt Postman, Insomnia vai koda ģeneratorā.

Autentifikācija

Atslēgu sūtiet galvenē Authorization:

Authorization: Bearer rg_live_…

Der arī galvene X-Api-Key: rg_live_…. Glabājiet atslēgas slepenībā: tikai savā serverī, nekad tīmekļa lapā vai mobilajā lietotnē. Katram lietotājam var būt līdz 5 atslēgām. Atslēgu, kas vairs nav vajadzīga vai varētu būt nonākusi svešās rokās, jebkurā brīdī var dzēst kontā — tā uzreiz pārstāj darboties.

API darbojas, kamēr ir aktīvs jūsu Bizness plāns (komandas dalībniekiem — kamēr aktīvs komandas īpašnieka plāns).

Adrese, formāts un valoda

• Bāzes adrese: https://api.regmio.eu/v1
• Visas atbildes ir JSON (UTF-8); dati ir laukā data.
• Datumi ir ISO 8601 formātā ar laika joslu, piem. 2026-11-06T08:15:00+00:00.
• Parametrs lang nosaka tekstu valodu (statusu nosaukumi, izmaiņu apraksti, kļūdu ziņojumi): en (noklusējums), lv, ru, et, lt, fi.

Limiti

Katrā atbildē ir galvenes X-RateLimit-Limit un X-RateLimit-Remaining. Pārsniedzot limitu, saņemsiet HTTP 429 ar galveni Retry-After (sekundes). Pašreizējo patēriņu rāda GET /me.

Pieprasījumi

{id} ir reģistrācijas numurs: Latvija — 11 cipari, Igaunija — 8 cipari, Lietuva — 9 cipari. Valsts tiek noteikta automātiski; ja vajag, pievienojiet ?country=LV|EE|LT.

Meklēšana

curl "https://api.regmio.eu/v1/search?q=Latvenergo&lang=lv" -H "Authorization: Bearer $REGMIO_KEY"

{
  "data": [
    {
      "country": "LV",
      "regcode": "40003032949",
      "name": "Akciju sabiedrība \"Latvenergo\"",
      "type": "Akciju sabiedrība",
      "address": "Rīga, Pulkveža Brieža iela 12",
      "registered": "1991-10-08",
      "status": "active",
      "status_label": "Reģistrēts"
    }
  ],
  "count": 1
}

status: active — reģistrēts; closed — likvidēts, reorganizēts vai darbība izbeigta; warn — piem., notiek likvidācija vai maksātnespēja. Meklēšana neskaitās profilu limitā. Neobligātais country atlasa rezultātus pēc valsts.

Uzņēmuma profils

curl "https://api.regmio.eu/v1/companies/40003032949?lang=lv" -H "Authorization: Bearer $REGMIO_KEY"

Objektā data ir tā pati informācija, kas profilā vietnē:

Saraksti ir tukši, ja reģistrs attiecīgos datus nepublicē (piemēram, Lietuvas atvērtajos datos nav visu amatpersonu vārdu). Personas kodi tiek rādīti tikai tādā apjomā, kādā tos publicē reģistrs. Riska indekss ir indikatīvs un nav kredītreitings vai juridisks atzinums.

PVN pārbaude (VIES)

curl https://api.regmio.eu/v1/companies/40003032949/vat -H "Authorization: Bearer $REGMIO_KEY"

{
  "data": {
    "country": "LV",
    "regcode": "40003032949",
    "vat_number": "LV40003032949",
    "valid": true,
    "name": "AS LATVENERGO",
    "address": "PULKVEŽA BRIEŽA IELA 12, RĪGA, LV-1230",
    "service_available": true,
    "checked_at": "2026-11-06T08:15:00+01:00"
  }
}

Pārbaude notiek reāllaikā Eiropas Komisijas VIES sistēmā. Ja VIES īslaicīgi nav pieejams, service_available ir false — mēģiniet vēlāk.

Uzraudzība

Regmio katru rītu pārbauda uzraudzītos uzņēmumus pēc jaunākajiem reģistru datiem. E-pasta paziņojumi darbojas atbilstoši jūsu konta iestatījumiem; API tās pašas izmaiņas dod caur /changes.

Pievienot vienu uzņēmumu:

curl -X POST https://api.regmio.eu/v1/watchlist \
  -H "Authorization: Bearer $REGMIO_KEY" -H "Content-Type: application/json" \
  -d '{"id": "40003032949"}'

Pievienot sarakstu (līdz 300 numuriem):

curl -X POST https://api.regmio.eu/v1/watchlist \
  -H "Authorization: Bearer $REGMIO_KEY" -H "Content-Type: application/json" \
  -d '{"ids": ["40003032949", "10137319", "110053842"]}'

{ "data": { "added": ["40003032949", "10137319"], "already": [], "not_found": ["110053842"], "over_limit": [] } }

Atbilde ir 201, ja pievienots vismaz viens uzņēmums, citādi 200. Saraksts: GET /watchlist. Noņemt: DELETE /watchlist/LV/40003032949.

Izmaiņu plūsma

curl "https://api.regmio.eu/v1/changes?since=2026-11-01T00:00:00Z&lang=lv" -H "Authorization: Bearer $REGMIO_KEY"

{
  "data": [
    {
      "country": "LV",
      "regcode": "40003032949",
      "name": "Akciju sabiedrība \"Latvenergo\"",
      "kind": "officer_added",
      "title": "Jauna amatpersona",
      "detail": "Jānis Bērziņš",
      "level": "medium",
      "detected_at": "2026-11-05T05:12:40+00:00"
    }
  ],
  "count": 1
}

Izmaiņas sakārtotas no jaunākās; limit 1–500 (noklusējums 100). Ieteikums: pieprasiet reizi dienā pēc 08:00 (Rīgas laiks) un kā since norādiet jaunākās jau saņemtās izmaiņas detected_at.

kind vērtības: name, status, address, officer_added, officer_removed, owner_added, owner_removed, risk, flag_added, flag_removed, vat_on, vat_off, debt, report, removed. level: high, medium, info, ok.

Kļūdas

{ "error": { "code": "not_found", "message": "Uzņēmums ar šādu reģistrācijas numuru nav atrasts." } }

POST /watchlist validācijas kļūdām ir formāts {"message": "…", "errors": {"lauks": ["…"]}}.

Koda piemēri

Python

import requests

API = "https://api.regmio.eu/v1"
HEADERS = {"Authorization": "Bearer rg_live_JUSU_ATSLEGA"}

r = requests.get(f"{API}/companies/40003032949", headers=HEADERS, params={"lang": "lv"}, timeout=30)
r.raise_for_status()
company = r.json()["data"]
print(company["name"], company["status"]["label"], company["risk"]["level"])

PHP

$ch = curl_init('https://api.regmio.eu/v1/companies/40003032949?lang=lv');
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER => ['Authorization: Bearer rg_live_JUSU_ATSLEGA'],
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
]);
$company = json_decode(curl_exec($ch), true)['data'];
echo $company['name'];

JavaScript (Node.js 18+)

const res = await fetch('https://api.regmio.eu/v1/search?q=Latvenergo', {
  headers: { Authorization: `Bearer ${process.env.REGMIO_KEY}` },
});
const { data } = await res.json();
console.log(data.map(c => `${c.regcode} ${c.name}`));

Excel (Power Query) — Dati → Iegūt datus → No citiem avotiem → Tukšs vaicājums → Papildu redaktors:

let
    Source = Json.Document(Web.Contents("https://api.regmio.eu/v1/watchlist?lang=lv",
        [Headers = [Authorization = "Bearer rg_live_JUSU_ATSLEGA"]])),
    Table = Table.FromRecords(Source[data])
in
    Table

Privātums un noteikumi

• API ir paredzēts savu sadarbības partneru un klientu pārbaudei. Datu tālākpārdošana, konkurējošas datubāzes veidošana vai reģistru masveida lejupielāde nav atļauta (sk. Lietošanas noteikumus).
• Regmio neveido meklēšanas vēsturi: limitu uzskaitei glabājam tikai atvērto profilu reģistrācijas numurus un dzēšam tos pēc 35 dienām. Vairāk — Privātuma politikā.
• Dati nāk no oficiālajiem atvērtajiem reģistriem un tiek atjaunināti katru dienu; juridiski vai finansiāli nozīmīgiem lēmumiem informāciju pārbaudiet arī oficiālajā reģistrā.

Atbalsts un izmaiņas

Jautājumi un ieteikumi: [email protected]. Versija v1 saglabās atpakaļsaderību: varam pievienot jaunus laukus un pieprasījumus, bet esošos nedzēsīsim un nepārdēvēsim bez jaunas versijas un iepriekšēja paziņojuma e-pastā.