API užklausos pavyzdys:
https://pr.lapas.info/jar/api.php?title=uab&addr=švenčionys&reg_from=2021-01-21

API taškas

GET /jar/api.php

Užklausos parametrai

• ids (string): Juridinių asmenų kodai, atskirti kableliais. Tik skaitmenys ir kableliai leidžiami.
• title (string): Juridinio asmens pavadinimas. Tik raidės, skaičiai, tarpai, kableliai ir brūkšneliai leidžiami.
• addr (string): Juridinio asmens adresas. Tik pilni žodžiai. Jei norite ieškoti gatvių su numeriais, apskliauskite frazę kabutėmis (pvz., "Justiniškių g. 10"). Kaimų, miestelių pavadinimai rašomi kilmininko linksniu („Stačiūnų k.“, o ne „Stačiūnai“)
• form (integer): Teisinės formos kodas, jų gavimas dokumentuotas žemiau (teisinės formos pavyzdžiai: uždaroji akcinė bendruomenė, mažoji bendrija, ir pan.).
• status (integer): Teisinio statuso kodas, jų gavimas dokumentuotas žemiau (teisinis statusas nusako juridinio asmens veikimo stadiją: bankrutuojantis, likviduojamas ir pan.).
• reg_from (date): Registravimo data, nuo (formatu Y-m-d).
• reg_to (date): Registravimo data, iki (formatu Y-m-d).
• show_l (boolean): Jei reikšmė yra 'true', bus rodomi ir išregistruoti juridiniai asmenys.
• unreg_from (date): Išregistravimo data, nuo (formatu Y-m-d).
• unreg_to (date): Išregistravimo data, iki (formatu Y-m-d).
• limit (integer): Kiek įrašų atsiųsti (<= 100, numatytoji reikšmė 20)
• page (integer): Paiešką atitikusių duomenų puslapis.

Teksto laukų turinys ieškomas neskiriant didžiųjų ir mažųjų raidžių. Galima įvesti nepilnus žodžius. Bus ieškoma visų įvestų žodžių atitikmenų.

Atsakymas

{
    "status_code": 200,
    "status_message": "Success",
    "execution_time": 0.1234,
    "data": [
        {
            "ja_kodas": "123456789",
            "ja_pavadinimas": "Įmonės pavadinimas",
            "adresas": "Adreso informacija",
            "form_pavadinimas": "Teisinė forma",
            "stat_pavadinimas": "Teisinis statusas",
            "ja_reg_data": "2023-01-01",
            "isreg_data": null
        }
    ],
    "count": {
        "returned": 1,
        "total": 1
        "page": 1,
        "limit": 100
    }
}

Objekte 'count' rodomas grąžintų įrašų skaičius ('returned'), įrašų puslapis ('page'), ir bendras užklausą atitikusių įrašų skaičius ('total'). Didžiausias galimas (ir numatytasis) grąžinamas įrašų skaičius - 100 (parametras 'limit').

Registro klasifikatoriai

Norint gauti Juridinių asmenų registro teisinių formų ir Teisinių statusų klasifikatoriaus duomenis (atskirai nuo juridinių asmenų duomenų):

• extra=forms (text `forms`): grąžina teisinių formų duomenis.
• extra=statuses (text `statuses`): grąžina teisinių statusų duomenis.

Klaidų tvarkymas

Netinkamo užklausos duomenų formato atveju (pvz., yra raidžių `ids` parametre), API grąžina `400 Bad Request` būsenos kodą su tokiu atsakymu:

{
    "status_code": 400,
    "status_message": "Blogai suformuota užklausa: nenaudotini ženklai "ids" parametre",
    "execution_time": 0.004,
    "data": []
}

Jei nerasta rezultatų, API grąžina `404 Not Found` būsenos kodą su tokiu atsakymu:

{
    "status_code": 404,
    "status_message": "Duomenų pagal užklausą rasti nepavyko",
    "execution_time": 0.0023,
    "data": []
}

Nepalaikomo užklausos metodo atveju API grąžina `405 Method Not Allowed` būsenos kodą su tokiu atsakymu:

{
    "status_code": 405,
    "status_message": "tokio metodo nėra",
    "execution_time": 0.0002,
    "data": []
}