API Dokumentacija

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

Įmonių paieška

Ieškoti įmonių pagal pavadinimą arba kodą.

Parametrai

Pavyzdys

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

Atsakymas

{
  "results": [
    {
      "code": "111111111",
      "name": "UAB Maxima",
      "address": "Vilnius, Lietuva",
      "status": "Registered",
      "registrationDate": "2020-01-15"
    }
  ],
  "total": 1,
  "limit": 5,
  "offset": 0
}

Gauti įmonę pagal kodą

Gauti detalią informaciją apie įmonę pagal juridinio asmens kodą.

Pavyzdys

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

Atsakymas

{
  "code": "111111111",
  "name": "UAB Maxima",
  "address": "Vilnius, Lietuva",
  "status": "Registered",
  "registrationDate": "2020-01-15",
  "email": "info@maxima.lt",
  "phone": "+370 5 123 4567",
  "website": "https://maxima.lt"
}

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
}

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
}

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