# Lithuanian Data Portal — documentation

> Documentation for the Lithuanian Data Portal (https://dataportal.gov.lt), run by the State Data Agency (Valstybės duomenų agentūra): a user guide to finding, reading and downloading official statistics and open data, and the reference for the portal's Data API. Every page exists in Lithuanian and English.

- Each link below is the page as Markdown. Drop the `.mdx` ending for the web page.
- The whole documentation in one file: https://guides.dataportal.gov.lt/llms-full.txt — add `?lang=lt` or `?lang=en` for one language.
- MCP server (Streamable HTTP, no sign-in): https://guides.dataportal.gov.lt/api/mcp — tools `search_docs`, `get_page` and `list_pages`.
- The portal's official statistics datasets are published in both Lithuanian and English.

## User guide (English)

- [User guide](https://guides.dataportal.gov.lt/docs/guide.mdx): How to find the information you need on the Lithuanian Data Portal and put it to use.
- [About the portal](https://guides.dataportal.gov.lt/docs/guide/about-portal.mdx): The idea and purpose of the Lithuanian Data Portal.
- [Smart search](https://guides.dataportal.gov.lt/docs/guide/smart-search.mdx): The portal search understands plain language — ask a question, not just a keyword.
- Browsing data
  - [Catalogue and filters](https://guides.dataportal.gov.lt/docs/guide/browsing-data.mdx): How to browse the data catalogue: themes, search, filters, sorting and the dataset card.
  - [The dataset page](https://guides.dataportal.gov.lt/docs/guide/browsing-data/dataset-page.mdx): What a dataset page shows: the description, publisher, citing, metadata, licence and update history.
  - [The data table](https://guides.dataportal.gov.lt/docs/guide/browsing-data/table.mdx): Exploring a dataset on the portal: views, pages, sorting, column and row filters, the structure and conventional symbols.
  - [Downloading and export](https://guides.dataportal.gov.lt/docs/guide/browsing-data/downloading.mdx): Downloading data as JSON, NDJSON, CSV, Parquet or XLSX, and the ready-made API request (cURL or Python).
- [Classifications](https://guides.dataportal.gov.lt/docs/guide/classifiers.mdx): National and international classifications on the portal.
- News and insights
  - [News and insights](https://guides.dataportal.gov.lt/docs/guide/news.mdx): Calendar, information reports and data insights — when data appears, what is new, and what the figures mean.
  - [Calendar](https://guides.dataportal.gov.lt/docs/guide/news/calendar.mdx): The publishing schedule for official statistics: how to read an entry, filter the calendar and add a release date to your own calendar.
  - [Information reports](https://guides.dataportal.gov.lt/docs/guide/news/reports.mdx): The reports that accompany new statistics: list filters, the structure of a report page, interactive charts and PDF export.
  - [Data insights](https://guides.dataportal.gov.lt/docs/guide/news/insights.mdx): Analytical comments on the latest indicators: how to read an insight, filter by topic, and how insights differ from information reports.
- [Use cases](https://guides.dataportal.gov.lt/docs/guide/use-cases.mdx): Dashboards and other data products: where to find them, how to narrow them down and open them.
- [Services](https://guides.dataportal.gov.lt/docs/guide/services.mdx): The State Data Agency's data services: what they are, who they are for and how to order them.
- Signing in and your account
  - [Signing in](https://guides.dataportal.gov.lt/docs/guide/account/sign-in.mdx): How to sign in to the portal through the e-Government Gateway, finish your first sign-in and sign out.
  - [Your account](https://guides.dataportal.gov.lt/docs/guide/account.mdx): What you can do once signed in to the portal: favourite and save data, get notifications, order services and manage your profile.
  - [Favourites and saved tables](https://guides.dataportal.gov.lt/docs/guide/account/saved-data.mdx): How to favourite a dataset and save a table with a folder, automatic updates and emails about changes.
  - [Notifications](https://guides.dataportal.gov.lt/docs/guide/account/notifications.mdx): Portal notifications in your account and email settings: which can be turned off and which are mandatory.
  - [Service orders and payments](https://guides.dataportal.gov.lt/docs/guide/account/orders.mdx): Your service applications and drafts, the steps of the order form and payments for services.
  - [Profile and sign-in history](https://guides.dataportal.gov.lt/docs/guide/account/profile.mdx): How to change your email and phone number and see the log of your sign-ins.
- [Subscription](https://guides.dataportal.gov.lt/docs/guide/subscription.mdx): How to subscribe to portal news by email.
- [Portal settings](https://guides.dataportal.gov.lt/docs/guide/portal-settings.mdx): Switching the portal language and accessibility settings.

## Data API (English)

- [Data API](https://guides.dataportal.gov.lt/docs/api.mdx): Public, read-only HTTP interface over the Lithuanian Data Portal data lake — Apache Iceberg tables and stored files, queried through Trino. No authentication is required.
- Getting started
  - [Overview](https://guides.dataportal.gov.lt/docs/api/guides/overview.mdx): What the Data API is, how data is organised into namespaces, tables and files, and a live, hands-on quickstart.
  - [Concepts](https://guides.dataportal.gov.lt/docs/api/guides/concepts.mdx): Namespaces, tables, files, Iceberg schemas and snapshots — the data model behind the Data API.
  - [Querying tables](https://guides.dataportal.gov.lt/docs/api/guides/querying.mdx): Read table rows as JSON with column selection, filtering, sorting and offset pagination — documented against the live API.
  - [Downloading data & files](https://guides.dataportal.gov.lt/docs/api/guides/downloading.mdx): Stream a whole table as NDJSON, JSON, CSV or Parquet with the export endpoint, and download stored files.
  - [Recipes](https://guides.dataportal.gov.lt/docs/api/guides/recipes.mdx): Copy-paste solutions to the tasks people actually do with the Data API — counting, filtering, paging and exporting real data.
  - [Errors](https://guides.dataportal.gov.lt/docs/api/guides/errors.mdx): HTTP status codes and the exact error response shapes the Data API returns — with an interactive lookup.
- Namespaces
  - [Retrieve namespace details or root list](https://guides.dataportal.gov.lt/docs/api/namespaces/listNamespaces.mdx): Fetches metadata for a specific namespace or lists all available root namespaces.

Behavior:
- With namespace provided: returns the specified namespace's identifier along with its immediate children, including sub-namespaces, tables, and files.
- Without namespace: returns a high-level list of all top-level root namespaces available in the catalog.

Example Usage:

```bash
curl -X GET '/namespaces'
```
  - [Retrieve namespace details](https://guides.dataportal.gov.lt/docs/api/namespaces/getNamespace.mdx): Fetches metadata for a specific namespace.

Returns the namespace identifier together with its immediate child namespaces, tables, and files.

Example Usage:

```bash
curl -X GET '/namespaces/my_org.data_warehouse'
```
- Tables
  - [Get table schema](https://guides.dataportal.gov.lt/docs/api/tables/getTableSchema.mdx): Retrieves the current logical schema of the Iceberg table.

Information provided:
- Field IDs used by Iceberg to track columns across renames.
- Data types such as string, long, struct, date, timestamp.
- Nullability for each field.

Example Usage:

```bash
curl -X GET '/namespaces/sales.emea/tables/orders/schema'
```
  - [Query table rows](https://guides.dataportal.gov.lt/docs/api/tables/queryTable.mdx): Queries table rows as JSON with optional column selection, filtering, sorting and offset pagination. Returns the matching rows plus pagination metadata: total, total_pages and current_page. The query is sent as a JSON request body — see the fields below, and the Querying guide for the full filter grammar and examples.
  - [Export table rows](https://guides.dataportal.gov.lt/docs/api/tables/exportTable.mdx): Exports the matching table rows as a downloadable file stream. Takes the same JSON query body as the query endpoint (select, filter, sort, limit, offset, exclude_nulls); the format query parameter chooses the file type (ndjson, json, csv, xlsx or parquet).
- Files
  - [Download a file from object storage](https://guides.dataportal.gov.lt/docs/api/files/downloadFile.mdx): Downloads a file from the configured object storage bucket.

Path behavior:
- namespace is treated as the logical storage prefix.
- fileName must be a single file basename and must not contain '/'.
- Content-Type and filename are forwarded from the upstream response.

Example Usage:

```bash
curl -X GET '/namespaces/org.project/files/report.pdf'
```

## AI assistants (English)

- [Using the docs with AI assistants](https://guides.dataportal.gov.lt/docs/mcp.mdx): How to connect this documentation to Claude, ChatGPT, Cursor or VS Code over MCP, so the assistant answers from the guide.

## Naudotojo vadovas (lietuvių k.)

- [Naudotojo vadovas](https://guides.dataportal.gov.lt/lt/docs/guide.mdx): Kaip susirasti reikiamą informaciją Lietuvos duomenų portale ir ja naudotis.
- [Apie portalą](https://guides.dataportal.gov.lt/lt/docs/guide/about-portal.mdx): Lietuvos duomenų portalo idėja ir paskirtis.
- [Išmanioji paieška](https://guides.dataportal.gov.lt/lt/docs/guide/smart-search.mdx): Portalo paieška supranta įprastą kalbą — klauskite, o ne tik įrašykite raktažodį.
- Duomenų naršymas
  - [Katalogas ir filtrai](https://guides.dataportal.gov.lt/lt/docs/guide/browsing-data.mdx): Kaip naršyti duomenų katalogą: temos, paieška, filtrai, rikiavimas ir rinkinio kortelė.
  - [Rinkinio puslapis](https://guides.dataportal.gov.lt/lt/docs/guide/browsing-data/dataset-page.mdx): Ką rasite duomenų rinkinio puslapyje: aprašas, teikėjas, citavimas, metaduomenys, licencija ir atnaujinimų istorija.
  - [Duomenų lentelė](https://guides.dataportal.gov.lt/lt/docs/guide/browsing-data/table.mdx): Duomenų peržiūra portale: rodiniai, puslapiai, rikiavimas, stulpelių ir eilučių filtrai, struktūra ir sutartiniai simboliai.
  - [Atsisiuntimas](https://guides.dataportal.gov.lt/lt/docs/guide/browsing-data/downloading.mdx): Duomenų atsisiuntimas JSON, NDJSON, CSV, Parquet ar XLSX formatu ir paruošta API užklausa (cURL arba Python).
- [Klasifikatoriai](https://guides.dataportal.gov.lt/lt/docs/guide/classifiers.mdx): Nacionaliniai ir tarptautiniai klasifikatoriai portale.
- Naujienos ir įžvalgos
  - [Naujienos ir įžvalgos](https://guides.dataportal.gov.lt/lt/docs/guide/news.mdx): Kalendorius, informaciniai pranešimai ir duomenų įžvalgos — kada pasirodo duomenys, kas nauja ir ką skaičiai reiškia.
  - [Kalendorius](https://guides.dataportal.gov.lt/lt/docs/guide/news/calendar.mdx): Oficialiosios statistikos leidybos tvarkaraštis: kaip skaityti įrašą, filtruoti kalendorių ir įtraukti leidybos datą į savo kalendorių.
  - [Informaciniai pranešimai](https://guides.dataportal.gov.lt/lt/docs/guide/news/reports.mdx): Pranešimai, lydintys naują statistiką: sąrašo filtrai, pranešimo puslapio sandara, interaktyvūs grafikai ir PDF eksportas.
  - [Duomenų įžvalgos](https://guides.dataportal.gov.lt/lt/docs/guide/news/insights.mdx): Analitiniai komentarai apie naujausius rodiklius: kaip skaityti įžvalgą, filtruoti pagal temą ir kuo jos skiriasi nuo informacinių pranešimų.
- [Duomenų panaudojimo atvejai](https://guides.dataportal.gov.lt/lt/docs/guide/use-cases.mdx): Švieslentės ir kiti duomenų produktai: kur juos rasti, kaip atsirinkti ir atverti.
- [Paslaugos](https://guides.dataportal.gov.lt/lt/docs/guide/services.mdx): Valstybės duomenų agentūros duomenų paslaugos: kokios jos, kam skirtos ir kaip jas užsakyti.
- Prisijungimas ir paskyra
  - [Prisijungimas](https://guides.dataportal.gov.lt/lt/docs/guide/account/sign-in.mdx): Kaip prisijungti prie portalo per El. valdžios vartus, užbaigti pirmąjį prisijungimą ir atsijungti.
  - [Paskyra](https://guides.dataportal.gov.lt/lt/docs/guide/account.mdx): Ką galima daryti prisijungus prie portalo: pamėgti ir išsaugoti duomenis, gauti pranešimus, užsakyti paslaugas ir tvarkyti profilį.
  - [Pamėgti ir išsaugoti duomenys](https://guides.dataportal.gov.lt/lt/docs/guide/account/saved-data.mdx): Kaip pamėgti duomenų rinkinį ir išsaugoti lentelę su aplanku, automatiniu atnaujinimu ir laiškais apie pokyčius.
  - [Pranešimai](https://guides.dataportal.gov.lt/lt/docs/guide/account/notifications.mdx): Portalo pranešimai paskyroje ir el. laiškų nustatymai: kuriuos galima išjungti, o kurie privalomi.
  - [Paslaugų užsakymai ir mokėjimai](https://guides.dataportal.gov.lt/lt/docs/guide/account/orders.mdx): Jūsų paslaugų paraiškos ir juodraščiai, užsakymo formos žingsniai ir mokėjimai už paslaugas.
  - [Profilis ir prisijungimų istorija](https://guides.dataportal.gov.lt/lt/docs/guide/account/profile.mdx): Kaip pakeisti el. paštą ir telefoną ir peržiūrėti savo prisijungimų žurnalą.
- [Prenumerata](https://guides.dataportal.gov.lt/lt/docs/guide/subscription.mdx): Kaip prenumeruoti portalo naujienas el. paštu.
- [Portalo nustatymai](https://guides.dataportal.gov.lt/lt/docs/guide/portal-settings.mdx): Portalo kalbos ir pritaikomumo nustatymų perjungimas.

## Duomenų API (lietuvių k.)

- [Duomenų API](https://guides.dataportal.gov.lt/lt/docs/api.mdx): Vieša, tik skaitymui skirta HTTP sąsaja Lietuvos atvirų duomenų portalo duomenų ežerui – Apache Iceberg lentelėms ir saugomiems failams. Autentifikacija nereikalinga.
- Nuo ko pradėti
  - [Apžvalga](https://guides.dataportal.gov.lt/lt/docs/api/guides/overview.mdx): Kas yra Duomenų API, kaip duomenys sudėlioti į vardų erdves, lenteles ir failus, ir interaktyvus greitas startas.
  - [Sąvokos](https://guides.dataportal.gov.lt/lt/docs/api/guides/concepts.mdx): Vardų erdvės, lentelės, failai, Iceberg schemos ir momentinės kopijos – Duomenų API duomenų modelis.
  - [Užklausos į lenteles](https://guides.dataportal.gov.lt/lt/docs/api/guides/querying.mdx): Skaitykite lentelės eilutes JSON formatu su stulpelių atranka, filtravimu, rūšiavimu ir poslinkio puslapiavimu – aprašyta pagal gyvą API.
  - [Duomenų ir failų atsisiuntimas](https://guides.dataportal.gov.lt/lt/docs/api/guides/downloading.mdx): Atsisiųskite visą lentelę kaip NDJSON, JSON, CSV ar Parquet su eksporto galiniu tašku ir atsisiųskite saugomus failus.
  - [Pavyzdžiai](https://guides.dataportal.gov.lt/lt/docs/api/guides/recipes.mdx): Kopijuojami sprendimai užduotims, kurias žmonės iš tikrųjų atlieka su Duomenų API – skaičiavimas, filtravimas, puslapiavimas ir eksportas.
  - [Klaidos](https://guides.dataportal.gov.lt/lt/docs/api/guides/errors.mdx): HTTP būsenos kodai ir tikslios Duomenų API grąžinamų klaidų struktūros – su interaktyvia peržiūra.
- Vardų erdvės
  - [Vardų erdvių sąrašas arba šaknies erdvės](https://guides.dataportal.gov.lt/lt/docs/api/namespaces/listNamespaces.mdx): Grąžina nurodytos vardų erdvės metaduomenis arba visų šaknies vardų erdvių sąrašą.
  - [Vardų erdvės duomenys](https://guides.dataportal.gov.lt/lt/docs/api/namespaces/getNamespace.mdx): Grąžina nurodytos vardų erdvės metaduomenis.
- Lentelės
  - [Gauti lentelės schemą](https://guides.dataportal.gov.lt/lt/docs/api/tables/getTableSchema.mdx): Grąžina dabartinę Iceberg lentelės loginę schemą.
  - [Užklausa į lentelės eilutes](https://guides.dataportal.gov.lt/lt/docs/api/tables/queryTable.mdx): Grąžina lentelės eilutes su nebūtinu filtravimu, rūšiavimu, puslapiavimu, stulpelių atranka ir ne-null sąlygomis. Užklausa siunčiama JSON užklausos kūne.
  - [Eksportuoti lentelės eilutes](https://guides.dataportal.gov.lt/lt/docs/api/tables/exportTable.mdx): Eksportuoja atrinktas lentelės eilutes kaip atsisiunčiamo failo srautą (ndjson, json, csv arba parquet).
- Failai
  - [Atsisiųsti failą iš objektų saugyklos](https://guides.dataportal.gov.lt/lt/docs/api/files/downloadFile.mdx): Atsisiunčia failą iš sukonfigūruotos objektų saugyklos talpyklos.

## DI asistentams (lietuvių k.)

- [Dokumentacija DI asistentams](https://guides.dataportal.gov.lt/lt/docs/mcp.mdx): Kaip prijungti šią dokumentaciją prie Claude, ChatGPT, Cursor ar VS Code per MCP, kad asistentas atsakinėtų remdamasis vadovu.