Read a provision or paragraphs
read_paragraphsRead-onlyIdempotent
Sign-in required: call connect(email) and connect_verify first (free, one email) unless this connection is already signed in. Read a document by its own structure: give a pinpoint (straipsnis) like '6.38' for one article, or from_unit and count to page through it. On a ruling (nutartis / sprendimas), pass ruling_part=disposition to read only the operative order (rezoliucinė dalis). Never by character offset. document_id is required and comes from a result: a search hit's id (an article id with # opens at that article) or document.id; a case number or an act number is not an id (find it with search_practice / search_law first). Page size is count; there is no limit or max_chars here.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| lang | No | Which language version to read, as a two-letter code (`lt`, `en`, `fr`), for a document held in several languages; `<id>@en` in `document_id` does the same. Omit for the default version: Lithuanian where held, else the source language. Pinpoints are the same in every language; the answer names the language served and the others held. | |
| count | No | How many paragraphs to return, default 5. The Civil Code runs to 1.7 million characters, so read in pages rather than asking for everything. | |
| voice | No | On a ruling only: return only the paragraphs in this voice - `court` (the court alone speaking, including its restatements of earlier rulings; `court_own` without them; `court_interpretation` its interpretation only), `party` (a party's argument or the question its appeal raises), `lower_court`, `institution`, `opinion`, or one voice name. Every paragraph of a ruling carries `voice` either way; a paragraph with more than one speaker is `mixed`, with each fragment's voice. | |
| article | No | Jump to an article by its number alone: `57`, `6.217`. Same effect as `pinpoint` with less typing — pass one or the other, not both naming different articles. | |
| on_date | No | On an act's article: `YYYY-MM-DD` - also return the article AS WORDED on that date (`wording_on_date`, with the edition's validity window and link), for facts that happened years ago. `paragraphs` stay the current text. | |
| section | No | On a ruling only: the numbered section(s) the court prints - `IV` for section IV, `IV+` (or `nuo IV`) for it and every later one. Combines with ruling_part: ruling_part=`reasoning`, section=`IV+` reads only the court's reasoning from section IV on, in one call. | |
| session | No | The `session` value the sign-in returned. Pass it on every call in this conversation, so the sign-in survives however this client handles connections; omit it when the user connected with Sign in (OAuth) or a key. | |
| pinpoint | No | Jump to a location by name, as a lawyer writes it: `6.217 straipsnis`, `13 straipsnis. 2 dalis`. Omit when the id already names the place. | |
| from_unit | No | Continue from this unit number, taken from `next_from_unit` in the previous answer. That is how paging works here; there is no cursor. | |
| document_id | Yes | What to read: the `id` of a search hit - an article id (containing `#`) opens at that article and reads on - or the whole document's id to start at the top. | |
| ruling_part | No | On a ruling only: return paragraphs from one section — `recital` (case history and parties' arguments under nustatė), `reasoning` (konstatuoja) or `disposition` (nutaria — the operative order). Omit for statutes. | |
| jurisdiction | No | Which jurisdiction the id belongs to (`LT`). Omit for the account's own. |