Who has cited this (citator)
cited_byRead-onlyIdempotent
Sign-in required: call connect(email) and connect_verify first (free, one email) unless this connection is already signed in. The citator (citavimo grafas): what has cited this provision (straipsnis) or ruling (nutartis) since: a reverse lookup that full-text search cannot do. Name the subject in ONE of three ways: a ruling by case_no (e3K-3-117-823/2023); a provision by act_number + pinpoint (act_number='CK', pinpoint='6.217'); or any search hit by its document_id (an article id with # needs no pinpoint). A citation string is not a parameter: split it into those parts. These are citations, not endorsements: whether the citing court agreed is not recorded.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | How many citing edges to return, default 25. `rulings_total` beside the answer is the number of distinct judgments behind it - quote that, not this. | |
| detail | No | `compact` (the default) keeps each citing edge's identity, pinpoint, court and date whole and cuts `quote` (the citing sentence) to ~300 characters, with `quote_chars` giving its full length. `full` returns every quote whole. | compact |
| case_no | No | The citator for rulings: pass the case number (e.g. `e3K-3-117-823/2023`) to list later judgments that cite it. Returns only citations strictly after the source decision date (`later_than`). Omit when you already have `document_id`. | |
| 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 | When `document_id` is the act (no `#`), names the article to ask about — `57 straipsnis` or `6.217`. Omit when you already pass a unit id. Same resolution as `read_paragraphs`. | |
| max_chars | No | A hard cap on the answer's size in characters, default 15000. Every row is first narrowed (a ~150-character excerpt), then rows are dropped from the end (the lowest-ranked) to fit, and `truncated` says how many and how to get them; data_as_of, notes and caveats are never cut. | |
| act_number | No | Alternative to `document_id` for acts: the register number (`XII-2603`) or a code abbreviation (`DK`, `CK`). Add `pinpoint` to ask about one article. Omit when you pass `case_no` for a ruling citator. | |
| court_level | No | Keep only citing rulings of these court levels (`supreme`, `appeal`, `regional`, `district`, `supreme_administrative`, `regional_administrative`, `constitutional`), counted over every citing ruling held before the list is cut: `supreme` answers 'how has the Supreme Court used this since'. | |
| document_id | No | What to ask about. An ARTICLE id (search hit `id`, with `#`) answers 'who has applied this article'. A ruling id lists later judgments that cite it. For a ruling citator from a case number, pass `case_no` instead — not both. An act id alone asks about the whole act — or pass the act id with `pinpoint` naming the article. `document.number` (`XIII-2221`) is not an id. | |
| jurisdiction | No | Which jurisdiction the id belongs to (`LT`). Omit for the account's own. |