API ir MCP dokumentacija

Bazinis adresas: https://apibase.lt/api/pirkimai/. Atsakymai – JSON (UTF-8). Raktas siunčiamas antraštėje X-Api-Key: vp_…, arba Authorization: Bearer vp_…, arba parametru ?key=vp_…. Nemokamą raktą su 100 užklausų gausite čia. OpenAPI aprašas: openapi.json.

Duomenys – aktyvūs Lietuvos viešieji pirkimai iš Europos TED ir viešojo CVP IS sąrašo. Prie kiekvieno įrašo yra nuoroda į originalų skelbimą.

REST API

Būsena: GET v1/status

Nemokama, rakto nereikia. Rodo aktyvių pirkimų skaičių pagal šaltinį, duomenų atnaujinimo laiką ir kainas.

curl "https://apibase.lt/api/pirkimai/v1/status"
{"ok":true,"active_tenders":{"ted":123,"cvpis":456},
 "data":{"ted_updated":"…","cvpis_updated":"…","exported":"…","note":"…"},"pricing":{…}}

Paieška: GET v1/tenders

1 užklausa. Parametrai (visi nebūtini):

curl -H "X-Api-Key: vp_…" "https://apibase.lt/api/pirkimai/v1/tenders?cpv=72&region=LT011&limit=2"

{"total":37,"count":2,"offset":0,
 "items":[{"id":"cvpis:10556371","source":"cvpis","title":"…","buyer":"…",
   "deadline":"2026-12-05T08:00:00Z","published":"2026-11-18","value":120000,"currency":"EUR",
   "cpv":["72000000"],"cpv_names":["IT paslaugos: konsultavimas, programinės įrangos kūrimas, internetas ir pagalba"],
   "region":[{"nuts":"LT011","name":"Vilniaus apskritis"}],
   "contract_type":"services","procedure":"…","status":"…",
   "url":"https://…","notice_pdf":"…","ted_url":null,"active":true,
   "first_seen":"…","updated":"…","description":"…"}],
 "data":{…},"requests_remaining":98,"plan":"free"}

Terminas (deadline) grąžinamas ISO formatu UTC laiku. Atsakyme taip pat yra antraštė X-Requests-Remaining.

Vienas pirkimas: GET v1/tenders/{id}

1 užklausa. id – iš paieškos rezultato, pvz., cvpis:10556371 arba ted:787554-2023. Grąžinamas pilnas aprašymas.

curl -H "X-Api-Key: vp_…" "https://apibase.lt/api/pirkimai/v1/tenders/cvpis:10556371"

Pokyčiai: GET v1/changes

1 užklausa. Parametrai: since (pvz., 2026-11-20T00:00:00Z) arba cursor (iš ankstesnio atsakymo), nebūtini cpv ir limit (iki 100). Kiekvienas įrašas turi lauką change: new, updated arba closed.

curl -H "X-Api-Key: vp_…" "https://apibase.lt/api/pirkimai/v1/changes?since=2026-11-20T00:00:00Z&cpv=72"
{"items":[{"change":"new","id":"ted:787554-2023", …}],"next_cursor":"…","has_more":false}

CPV paieška: GET v1/cpv?q=…

Nemokama. Randa CPV kodą pagal pavadinimą (lietuvių ar anglų kalba).

curl "https://apibase.lt/api/pirkimai/v1/cpv?q=programin"
{"items":[{"code":"72000000","name_lt":"…","name_en":"…","n":123}]}

Rakto būsena: GET v1/key

Nemokama. Grąžina id, plan (free | monthly), free_left, monthly_used, monthly_quota, plan_until, used_total, created, subscribe (prenumeratos mokėjimo nuoroda) ir pricing.

curl -H "X-Api-Key: vp_…" "https://apibase.lt/api/pirkimai/v1/key"

Klaidos ir limitai

MCP serveris

Adresas: https://apibase.lt/api/pirkimai/mcp (Streamable HTTP, be sesijos, JSON). Raktas – Authorization: Bearer vp_…. Klientams, kurie negali nustatyti antraščių, tinka ?key=vp_… adrese. Be rakto – 10 iškvietimų per dieną.

Įrankiai:

# Claude Code
claude mcp add --transport http lt-procurement https://apibase.lt/api/pirkimai/mcp --header "Authorization: Bearer vp_..."

// Claude Desktop, Cursor ir kt. (mcp.json)
{"mcpServers":{"lt-procurement":{"url":"https://apibase.lt/api/pirkimai/mcp",
  "headers":{"Authorization":"Bearer vp_..."}}}}

// Jei klientas negali nustatyti antraščių
{"mcpServers":{"lt-procurement":{"url":"https://apibase.lt/api/pirkimai/mcp?key=vp_..."}}}

Kaina

Sąlygos ir privatumas

Šaltiniai