Autentifikacija#

Visi API užklausos reikalauja API rakto. Pridėkite jį kaip x-api-key header:

curl -H "x-api-key: your_api_key_here" \
  https://api.jars.lt/api/v1/companies/search?q=UAB

Bazinis URL#

Visi API endpoint'ai prasideda:

https://api.jars.lt/api/v1

Estijos duomenims taip pat galite naudoti:

https://api.jars.ee/api/v1

https://api.jars.lv/api/v1

Naudojant api.jars.ee, numatytoji šalis yra Estija (ee). Per api.jars.lv — Latvija (lv). Per api.jars.lt numatytoji šalis yra Lietuva (lt).

Node.js SDK#

Oficialus TypeScript/JavaScript SDK patogiai integracijai su JARS.LT API.

Diegimas

npm install @jars-lt/sdk

Naudojimas

import { JarsClient } from '@jars-lt/sdk';

const client = new JarsClient({
  apiKey: 'your_api_key_here'
});

// Search Lithuanian companies
const companies = await client.searchCompanies({ q: 'UAB Maxima' });

// Search Estonian companies
const eeCompanies = await client.searchCompanies({ q: 'Bolt', country: 'ee' });

// Search Latvian companies
const lvCompanies = await client.searchCompanies({ q: 'ELKO', country: 'lv' });

// Get company by code
const company = await client.getCompany('123456789');

// Get Estonian company
const eeCompany = await client.getCompany('14532901', { country: 'ee' });

// Get Latvian company
const lvCompany = await client.getCompany('40003129564', { country: 'lv' });

// Get company financial reports
const financials = await client.getCompanyFinancials('123456789');

// Search addresses (Lithuania only)
const addresses = await client.searchAddresses({ q: 'vilnius gedimino' });

// Normalize address (with typos)
const normalized = await client.normalizeAddress('gedimno pr 28 vilnus');

// Check workday
const workday = await client.checkWorkday('2024-12-25');

// Add workdays
const result = await client.addWorkdays('2024-01-15', 5);

MCP (Model Context Protocol)#

JARS.LT palaiko Model Context Protocol (MCP) — atvirą standartą, leidžiantį AI asistentams sąveikauti su išoriniais duomenų šaltiniais. Naudokite mūsų MCP endpointą norėdami tiesiogiai iš ChatGPT, Claude ir kitų AI įrankių gauti Lietuvos ir Estijos įmonių duomenis.

Funkcijos

• Ieškoti įmonių pagal pavadinimą arba registracijos kodą
• Gauti išsamią įmonės informaciją ir finansines ataskaitas
• Užklausti ekonominę statistiką ir reitingus
• Normalizuoti ir ieškoti adresų

Endpointas

https://api.jars.lt/mcp

Claude Desktop / Claude Code konfigūracija

Pridėkite šį kodą į savo Claude konfigūracijos failą:

{
  "mcpServers": {
    "jars": {
      "url": "https://api.jars.lt/mcp",
      "headers": {
        "x-api-key": "your_api_key_here"
      }
    }
  }
}

OAuth 2.0 autentifikacija

AI klientams, palaikantiems OAuth (pvz., ChatGPT), naudokite standartinius OAuth atradimo endpointus:

• /.well-known/oauth-authorization-server
• /.well-known/oauth-protected-resource

Palaikome dinaminę klientų registraciją (RFC 7591), leidžiančią AI klientams automatiškai registruotis be rankinio konfigūravimo.

Prieinami įrankiai

Specifikacija

Įmonių paieška#

Ieškoti įmonių pagal pavadinimą arba kodą. Palaiko Lietuvos ir Estijos įmones.

Parametrai

Pavyzdys

# Search Lithuanian companies (default on api.jars.lt)
curl -H "x-api-key: your_api_key_here" \
  "https://api.jars.lt/api/v1/companies/search?q=Maxima&limit=5"

# Search Estonian companies
curl -H "x-api-key: your_api_key_here" \
  "https://api.jars.lt/api/v1/companies/search?q=Bolt&country=ee"

# Estonian search via api.jars.ee (country=ee by default)
curl -H "x-api-key: your_api_key_here" \
  "https://api.jars.ee/api/v1/companies/search?q=Bolt"

# Search Latvian companies
curl -H "x-api-key: your_api_key_here" \
  "https://api.jars.lt/api/v1/companies/search?q=ELKO&country=lv"

# Latvian search via api.jars.lv (country=lv by default)
curl -H "x-api-key: your_api_key_here" \
  "https://api.jars.lv/api/v1/companies/search?q=ELKO"

Atsakymas

{
  "results": [
    {
      "code": "123456789",
      "name": "UAB Pavyzdys",
      "address": "Gedimino pr. 1, Vilnius",
      "legalForm": "UAB",
      "status": "ACTIVE",
      "registrationDate": "2020-01-15T00:00:00.000Z"
    }
  ],
  "total": 1,
  "limit": 5,
  "offset": 0
}

Gauti įmonę pagal kodą#

Gauti detalią informaciją apie įmonę pagal registro kodą. Grąžina įmonės duomenis, naujausią finansinę ataskaitą, EVRK kodą ir PVM informaciją. Palaiko Lietuvos ir Estijos įmones.

Parametrai

Pavyzdys

# Lithuanian company
curl -H "x-api-key: your_api_key_here" \
  "https://api.jars.lt/api/v1/companies/111111111"

# Estonian company
curl -H "x-api-key: your_api_key_here" \
  "https://api.jars.lt/api/v1/companies/14532901?country=ee"

# Estonian company via api.jars.ee (country=ee by default)
curl -H "x-api-key: your_api_key_here" \
  "https://api.jars.ee/api/v1/companies/14532901"

# Latvian company
curl -H "x-api-key: your_api_key_here" \
  "https://api.jars.lt/api/v1/companies/40003129564?country=lv"

# Latvian company via api.jars.lv (country=lv by default)
curl -H "x-api-key: your_api_key_here" \
  "https://api.jars.lv/api/v1/companies/40003129564"

Atsakymas

Grąžina pilnus įmonės duomenis su latestFinancials (naujausia finansinė ataskaita). Lietuvos įmonėms grąžina EVRK kodą ir PVM informaciją. Estijos įmonėms grąžina naudos gavėjus.

{
  "code": "123456789",
  "name": "UAB Pavyzdys",
  "address": "Gedimino pr. 1, Vilnius",
  "legalForm": "UAB",
  "legalFormCode": "124",
  "status": "ACTIVE",
  "registrationDate": "2020-01-15T00:00:00.000Z",
  "capital": 10000,
  "currency": "EUR",
  "pvmCode": "LT123456789",
  "pvmRegistered": true,
  "evrkId": "62.01",
  "evrkName": "Computer programming activities",
  "evrkSection": "J",
  "latestFinancials": {
    "companyCode": "123456789",
    "year": 2024,
    "periodStart": "2024-01-01T00:00:00.000Z",
    "periodEnd": "2024-12-31T00:00:00.000Z",
    "balance": {
      "equity": 150000,
      "longTermAssets": 80000,
      "shortTermAssets": 120000,
      "liabilities": 50000,
      "totalAssets": 200000
    },
    "profitLoss": {
      "revenue": 500000,
      "profitBeforeTax": 75000,
      "netProfit": 60000
    }
  }
}

Gauti įmonės finansinius rodiklius#

Gauti įmonės finansinius rodiklius (balansas ir pelno/nuostolių ataskaita) pagal metus. Palaiko Lietuvos ir Estijos įmones.

Parametrai

Pavyzdys

# Lithuanian company financials
curl -H "x-api-key: your_api_key_here" \
  "https://api.jars.lt/api/v1/companies/123456789/financials"

# Get specific year
curl -H "x-api-key: your_api_key_here" \
  "https://api.jars.lt/api/v1/companies/123456789/financials?year=2024"

# Estonian company financials
curl -H "x-api-key: your_api_key_here" \
  "https://api.jars.lt/api/v1/companies/14532901/financials?country=ee"

# Estonian company via api.jars.ee
curl -H "x-api-key: your_api_key_here" \
  "https://api.jars.ee/api/v1/companies/14532901/financials"

# Latvian company financials
curl -H "x-api-key: your_api_key_here" \
  "https://api.jars.lt/api/v1/companies/40003129564/financials?country=lv"

# Latvian company via api.jars.lv
curl -H "x-api-key: your_api_key_here" \
  "https://api.jars.lv/api/v1/companies/40003129564/financials"

Atsakymas

Grąžina finansinius rodiklius: nuosavą kapitalą, turtą, įsipareigojimus, pajamas ir pelną.

{
  "companyCode": "123456789",
  "companyName": "UAB Pavyzdys",
  "financials": [
    {
      "companyCode": "123456789",
      "year": 2024,
      "periodStart": "2024-01-01T00:00:00.000Z",
      "periodEnd": "2024-12-31T00:00:00.000Z",
      "balance": {
        "equity": 150000,
        "longTermAssets": 80000,
        "shortTermAssets": 120000,
        "liabilities": 50000,
        "totalAssets": 200000
      },
      "profitLoss": {
        "revenue": 500000,
        "profitBeforeTax": 75000,
        "netProfit": 60000
      }
    }
  ],
  "availableYears": [2024, 2023, 2022]
}

Gauti naudos gavėjus#

Gauti įmonės naudos gavėjus pagal registro kodą.

Parametrai

Pavyzdys

# Estonian company beneficiaries
curl -H "x-api-key: your_api_key_here" \
  "https://api.jars.ee/api/v1/companies/14532901/beneficiaries"

# Or via api.jars.lt with country parameter
curl -H "x-api-key: your_api_key_here" \
  "https://api.jars.lt/api/v1/companies/14532901/beneficiaries?country=ee"

Atsakymas

{
  "companyCode": "14532901",
  "beneficiaries": [
    {
      "name": "Markus Villig",
      "sharePercent": 75,
      "countryCode": "EE",
      "countryName": "Eesti"
    },
    {
      "name": "Martin Villig",
      "sharePercent": 25,
      "countryCode": "EE",
      "countryName": "Eesti"
    }
  ]
}

Gauti SODRA duomenis#

Gauti įmonės SODRA duomenis: apdraustųjų skaičių, vidutinį darbo užmokestį, skolų informaciją ir mėnesinę istoriją.

Parametrai

Pavyzdys

curl -H "x-api-key: your_api_key_here" \
  "https://api.jars.lt/api/v1/companies/123456789/sodra"

Atsakymas

Grąžina naujausius SODRA duomenis ir mėnesinę istoriją su apdraustųjų skaičiumi ir vidutiniu darbo užmokesčiu.

{
  "companyCode": "123456789",
  "companyName": "UAB Pavyzdys",
  "sodra": {
    "latestMonth": "2025-12",
    "latestNumInsured": 45,
    "latestAvgWage": 2850.50,
    "municipality": "Vilniaus m. sav.",
    "debt": {
      "total": 0,
      "sodra": 0,
      "other": 0
    },
    "monthlyData": [
      {
        "month": "2025-12",
        "numInsured": 45,
        "avgWage": 2850.50
      },
      {
        "month": "2025-11",
        "numInsured": 44,
        "avgWage": 2800.00
      }
    ]
  }
}

Adresų paieška#

Ieškoti gatvių, gyvenviečių ir savivaldybių. Palaiko kelių žodžių paiešką (pvz., "kaunas basanavi" arba "vilnius centro").

Parametrai

Pavyzdys

curl -H "x-api-key: your_api_key_here" \
  "https://api.jars.lt/api/v1/addresses/search?q=kaunas+basanavi&limit=5"

Atsakymas

Rezultatai grupuojami pagal tipą: gatvės, gyvenvietės, savivaldybės. Kiekviena grupė turi atitinkamus vietos duomenis.

{
  "streets": [
    {
      "code": 1231645,
      "name": "J. Basanavičiaus",
      "typeAbbr": "al.",
      "settlementId": "58437361-d62a-4714-9b74-f07ae0b9d66b",
      "buildings": [
        { "number": "3", "postalCode": "LT-50282" },
        { "number": "4", "postalCode": "LT-50290" }
      ],
      "settlement": {
        "name": "Kaunas",
        "typeAbbr": "m."
      }
    }
  ],
  "settlements": [],
  "municipalities": [],
  "total": 1,
  "limit": 5,
  "offset": 0
}

Normalizuoti adresą#

Konvertuoti laisvos formos adreso eilutę (su galimomis klaidomis) į struktūrizuotus adreso komponentus. Naudoja fuzzy atitikimą rašybos klaidoms tvarkyti.

Užklausos turinys

Pavyzdys

curl -X POST -H "x-api-key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"address": "gedimno pr 28 vilnus", "limit": 3}' \
  https://api.jars.lt/api/v1/addresses/normalize

Atsakymas

Grąžina atitinkančius adresus su pasitikėjimo balais. Didesnis balas rodo geresnį atitikimą.

{
  "results": [
    {
      "confidence": 0.87,
      "formatted": "Gedimino pr. 28, Vilnius, Vilniaus m. sav., LT-01104",
      "components": {
        "street": { "code": 105641, "name": "Gedimino", "type": "prospektas", "typeAbbr": "pr." },
        "building": { "number": "28", "postalCode": "LT-01104" },
        "settlement": { "code": 101580, "name": "Vilnius", "type": "miestas", "typeAbbr": "m." },
        "municipality": { "code": 58, "name": "Vilniaus m.", "typeAbbr": "sav." },
        "county": { "code": 9, "name": "Vilniaus" },
        "postalCode": "LT-01104"
      }
    }
  ],
  "query": "gedimno pr 28 vilnus",
  "parsed": {
    "tokens": ["gedimno", "vilnus"],
    "building": "28",
    "streetType": "pr."
  }
}

Gauti vietovę pagal pašto kodą#

Gauti apskritį, savivaldybę, gyvenvet ę ir gatves pagal pašto indeksą. Palaiko 5 skaitmenų formatą (pvz., "54306" arba "LT-54306").

Parametrai

Pavyzdys

curl -H "x-api-key: your_api_key_here" \
  https://api.jars.lt/api/v1/addresses/postal/54306

Atsakymas

Grąžina visos gatvės su šiuo pašto kodu, kartu su gyvenvietės, savivaldybės ir apskrities informacija.

{
  "postalCode": "LT-54306",
  "streets": [
    {
      "code": 1873961,
      "name": "Viesulo",
      "type": "gatvė",
      "typeAbbr": "g."
    }
  ],
  "settlement": {
    "code": 88888,
    "name": "Kaunas",
    "type": "miestas",
    "typeAbbr": "m."
  },
  "municipality": {
    "code": 15,
    "name": "Kauno m."
  },
  "county": {
    "code": 4,
    "name": "Kauno"
  }
}

Patikrinti darbo dieną#

Patikrinti, ar konkreti data yra darbo diena Lietuvoje. Grąžina informaciją apie savaitgalius ir Lietuvos valstybines šventes.

Parametrai

Pavyzdys

curl -H "x-api-key: your_api_key_here" \
  "https://api.jars.lt/api/v1/workdays/check?date=2024-12-25"

Atsakymas

{
  "date": "2024-12-25",
  "dayOfWeek": "Wednesday",
  "isWorkday": false,
  "isWeekend": false,
  "isHoliday": true,
  "holidayName": "Kalėdos",
  "holidayNameEn": "Christmas Day"
}

Pridėti darbo dienas#

Pridėti darbo dienų skaičių prie nurodytos datos, praleidžiant savaitgalius ir Lietuvos valstybines šventes. Palaiko neigiamas reikšmes atimti darbo dienas.

Parametrai

Pavyzdys

curl -H "x-api-key: your_api_key_here" \
  "https://api.jars.lt/api/v1/workdays/add?date=2024-12-20&days=5"

Atsakymas

{
  "startDate": "2024-12-20",
  "workdaysAdded": 5,
  "resultDate": "2024-12-30",
  "resultIsWorkday": true,
  "skippedDays": [
    { "date": "2024-12-21", "reason": "weekend" },
    { "date": "2024-12-22", "reason": "weekend" },
    { "date": "2024-12-25", "reason": "holiday", "holidayName": "Kalėdos" },
    { "date": "2024-12-26", "reason": "holiday", "holidayName": "Antra Kalėdų diena" },
    { "date": "2024-12-28", "reason": "weekend" },
    { "date": "2024-12-29", "reason": "weekend" }
  ]
}

Infliacijos duomenys#

Gauti agreguotus infliacijos ir ekonominius rodiklius Lietuvai: SVKI (vartotojų kainos), GKI (gamintojų kainos), nedarbo lygį ir kainų pokyčius pagal kategorijas. Duomenų šaltinis — Eurostat. Autentifikacija nereikalinga.

Parametrai

Pavyzdys

curl https://api.jars.lt/api/v1/statistics/inflation?from=2020

Atsakymas

Grąžina SVKI mėnesinį indeksą/pokyčius, metinius vidurkius, kategorijų detales (maistas, energija, transportas, būstas), GKI ir nedarbą. SVKI reikšmės naudoja 2015=100 bazę.

{
  "hicp": {
    "monthly": [
      { "date": "2020-01", "year": 2020, "month": 1, "index": 107.4, "yoy": 2.3, "mom": -0.5 }
    ],
    "annual": [
      { "year": 2020, "avgIndex": 108.4, "avgRate": 1.1 }
    ]
  },
  "categories": {
    "latest": {
      "date": "2025-12",
      "items": {
        "total": { "index": 131.2, "yoy": 2.1, "name": "All items" },
        "food": { "index": 139.8, "yoy": 1.5, "name": "Food and non-alcoholic beverages" }
      }
    },
    "timeSeries": [
      { "date": "2020-01", "total": 2.3, "food": 3.1, "energy": -1.2, "transport": 0.5, "housing": 1.8 }
    ]
  },
  "ppi": {
    "monthly": [{ "date": "2020-01", "index": 98.2, "yoy": -2.1 }]
  },
  "unemployment": {
    "monthly": [{ "date": "2020-01", "rate": 6.4 }]
  },
  "meta": {
    "lastUpdate": "2025-12-15T10:00:00Z",
    "latestDataPoint": "2025-12",
    "source": "Eurostat",
    "availableYears": [1996, 1997, "...", 2025]
  }
}

Gauti statistiką#

Gauti savo API rakto statistiką ir likutį.

Pavyzdys

curl -H "x-api-key: your_api_key_here" \
  https://api.jars.lt/api/v1/usage

Atsakymas

rateLimit nurodo maksimalų užklausų per sekundę skaičių.

{
  "dataDelay": 0,
  "limit": 50000,
  "plan": "PROFESSIONAL",
  "rateLimit": 300,
  "remaining": 49997,
  "requestCount": 3,
  "resetDate": "2025-11-10T14:20:13.260Z",
  "webhooksEnabled": true
}

Sąskaitų sąrašas#

Gauti visų prenumeratos sąskaitų sąrašą. Apima mokėjimo būseną, sumas ir nuorodas į PDF/UBL formatus.

Pavyzdys

curl -H "x-api-key: your_api_key_here" \
  https://api.jars.lt/api/v1/invoices

Atsakymas

{
  "invoices": [
    {
      "stripeInvoiceId": "in_1abc...",
      "number": "INV-0091",
      "status": "paid",
      "currency": "EUR",
      "subtotal": 500,
      "tax": 105,
      "total": 605,
      "created": "2026-02-12T07:46:18.000Z",
      "paidAt": "2026-02-12T07:46:21.000Z",
      "customerName": "UAB Example",
      "customerEmail": "info@example.lt",
      "customerTaxId": "LT123456789",
      "stripeHostedInvoiceUrl": "https://invoice.stripe.com/...",
      "stripeInvoicePdfUrl": "https://pay.stripe.com/.../pdf"
    }
  ],
  "count": 1
}

Gauti sąskaitą#

Gauti išsamią informaciją apie konkrečią sąskaitą pagal Stripe ID.

Pavyzdys

curl -H "x-api-key: your_api_key_here" \
  https://api.jars.lt/api/v1/invoices/in_1abc123

Atsisiųsti sąskaitą (UBL)#

Atsisiųsti sąskaitą UBL 2.1 XML formatu, atitinkančiu Peppol BIS Billing 3.0 standartą.

Pavyzdys

curl -H "x-api-key: your_api_key_here" \
  https://api.jars.lt/api/v1/invoices/in_1abc123/ubl

Atsakymas

Grąžina XML dokumentą su Content-Type: application/xml

<?xml version="1.0" encoding="UTF-8"?>
<Invoice xmlns="urn:oasis:names:specification:ubl:schema:xsd:Invoice-2"
         xmlns:cac="urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-2"
         xmlns:cbc="urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2">
  <cbc:CustomizationID>urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:billing:3.0</cbc:CustomizationID>
  <cbc:ProfileID>urn:fdc:peppol.eu:2017:poacc:billing:01:1.0</cbc:ProfileID>
  <cbc:ID>INV-0091</cbc:ID>
  <cbc:IssueDate>2026-02-12</cbc:IssueDate>
  <cbc:InvoiceTypeCode>380</cbc:InvoiceTypeCode>
  <cbc:DocumentCurrencyCode>EUR</cbc:DocumentCurrencyCode>
  <cac:AccountingSupplierParty>...</cac:AccountingSupplierParty>
  <cac:AccountingCustomerParty>...</cac:AccountingCustomerParty>
  <cac:TaxTotal>...</cac:TaxTotal>
  <cac:LegalMonetaryTotal>...</cac:LegalMonetaryTotal>
  <cac:InvoiceLine>...</cac:InvoiceLine>
</Invoice>

Rate Limits#

API užklausų limitai priklauso nuo jūsų plano:

• Nemokamas: 100 užklausų per mėnesį
• Pradedantysis: 5,000 užklausų per mėnesį
• Profesionalus: 50,000 užklausų per mėnesį
• Enterprise: 1,000,000 užklausų per mėnesį

Viršijus limitą, gausite 429 Too Many Requests atsakymą.

Klaidų kodai#