lahend.ee — Estonian court decisions

Full-text search across Estonian LAW - both court decisions (civil, administrative and criminal rulings) and legislation (acts and their individual paragraphs), from Riigi Teataja, indexed by lahend.ee. Inflection-tolerant; wrap a phrase in "quotes" for an exact match. Every result carries a stable typed `id` - `ruling:<n>`, `law:<n>` or `section:<n>:<par>` - which `fetch` resolves. Use this when you need the legal position on something and do not yet know whether the answer is in a statute or in case law.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Legal terms, a case number, a party/company name, or a \"quoted phrase\"."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 25,
      "description": "Max results (default 10)."
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "total": {
      "type": "number",
      "description": "Total matching rulings."
    },
    "results": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "url": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "title",
          "url"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "total",
    "results"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Retrieve the full text + metadata for any `id` returned by `search`. Handles all three kinds: `ruling:<n>` (a court decision with its linked companies), `law:<n>` (an act in its current redaktsioon, all paragraphs) and `section:<n>:<par>` (a single paragraph - prefer this over pulling a whole act). Returns Markdown plus the canonical lahend.ee URL.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Typed id from `search`: 'ruling:1279503', 'law:12345' or 'section:12345:199'."
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    },
    "title": {
      "type": "string"
    },
    "text": {
      "type": "string",
      "description": "The full decision rendered as Markdown."
    },
    "url": {
      "type": "string"
    },
    "metadata": {
      "type": "object",
      "additionalProperties": {}
    }
  },
  "required": [
    "id",
    "title",
    "text",
    "url",
    "metadata"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Return a single § of an Estonian act, addressed the way lawyers cite it: an abbreviation and a number, e.g. abbrev='KarS', paragrahv='199', or abbrev='TsMS', paragrahv='430'. This is the precise way to answer a legal question - pulling a whole act costs thousands of tokens and buries the answer. Text comes from the act's current redaktsioon.

{
  "type": "object",
  "properties": {
    "abbrev": {
      "type": "string",
      "description": "Act abbreviation as cited: KarS, TsMS, VÕS, PankrS, RahaPTS…"
    },
    "paragrahv": {
      "type": "string",
      "description": "Paragraph number, e.g. '199'. Superscript sections are addressed as '43-1' or '43¹' (§ 43¹) - these are DIFFERENT provisions from § 43. A full citation like '§ 430 lg 1' is also accepted; the lõige is ignored. A bare second number ('43 1') is rejected as ambiguous rather than silently read as § 43."
    }
  },
  "required": [
    "abbrev",
    "paragrahv"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "found": {
      "type": "boolean"
    },
    "title": {
      "type": "string"
    },
    "text": {
      "type": "string"
    },
    "url": {
      "type": "string"
    }
  },
  "required": [
    "found"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Full-text search across the paragraphs of every in-force Estonian act (4M+ sections). Answers 'which provision governs X' directly, returning the paragraphs themselves rather than acts you then have to read. Each hit carries a `section:` id for `fetch`.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "A legal term or phrase, e.g. 'pankrotiavaldus', 'ehitusluba', 'töölepingu ülesütlemine'."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 25,
      "description": "Max results (default 8)."
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "results": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "url": {
            "type": "string"
          },
          "excerpt": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "title",
          "url",
          "excerpt"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "results"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Find Estonian acts by title or abbreviation (KarS, TsMS, VÕS…). Returns each act with a `law:` id for `fetch`, its type, issuer and whether it is still in force. Use get_law_section when you already know the paragraph you want.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Title fragment or abbreviation."
    },
    "inForceOnly": {
      "type": "boolean",
      "description": "Only acts currently in force (default true)."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 25,
      "description": "Max results (default 10)."
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "total": {
      "type": "number"
    },
    "results": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "lyhend": {
            "type": [
              "string",
              "null"
            ]
          },
          "aktLiik": {
            "type": [
              "string",
              "null"
            ]
          },
          "isInForce": {
            "type": "boolean"
          },
          "url": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "title",
          "lyhend",
          "aktLiik",
          "isInForce",
          "url"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "total",
    "results"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

List an act's redaktsioonid (consolidated versions) with their validity ranges, newest first. Use this to answer 'what did this say on date X' - Estonian law is amended constantly and the current text is often not the one that applied to the facts.

{
  "type": "object",
  "properties": {
    "abbrev": {
      "type": "string",
      "description": "Act abbreviation, e.g. 'TsMS'."
    }
  },
  "required": [
    "abbrev"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "act": {
      "type": "string"
    },
    "url": {
      "type": "string"
    },
    "versions": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "validFrom": {
            "type": [
              "string",
              "null"
            ]
          },
          "validTo": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "validFrom",
          "validTo"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "act",
    "url",
    "versions"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Given an act abbreviation and a §, return the court decisions that actually cite it, newest first, with a total count. Built from 3.05M citations extracted from the decision texts themselves. This answers 'how have the courts applied KarS § 199' - the question statute text alone cannot answer, and the reason to use lahend.ee over reading Riigi Teataja.

{
  "type": "object",
  "properties": {
    "abbrev": {
      "type": "string",
      "description": "Act abbreviation as cited: KarS, TsMS, VÕS, PankrS…"
    },
    "paragrahv": {
      "type": "string",
      "description": "Paragraph number, e.g. '199'. A full citation is accepted; the lõige is ignored."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 25,
      "description": "Max rulings returned (default 10)."
    }
  },
  "required": [
    "abbrev",
    "paragrahv"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "section": {
      "type": "string"
    },
    "totalRulings": {
      "type": "number",
      "description": "How many distinct rulings cite this §."
    },
    "rulings": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "caseNo": {
            "type": [
              "string",
              "null"
            ]
          },
          "kohus": {
            "type": [
              "string",
              "null"
            ]
          },
          "pubDate": {
            "type": [
              "string",
              "null"
            ]
          },
          "kategooria": {
            "type": [
              "string",
              "null"
            ]
          },
          "url": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "caseNo",
          "kohus",
          "pubDate",
          "kategooria",
          "url"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "section",
    "totalRulings",
    "rulings"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Given a ruling id (from `search`), list the statute paragraphs it cites, with the lõiked named and each § resolved to its act. Use it to see the legal basis of a decision without reading the whole judgment, then `fetch` a `section:` id for the provision text.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Ruling id, e.g. 'ruling:1279503'."
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "sections": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": [
              "string",
              "null"
            ]
          },
          "act": {
            "type": "string"
          },
          "paragrahv": {
            "type": "string"
          },
          "title": {
            "type": [
              "string",
              "null"
            ]
          },
          "lgs": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        },
        "required": [
          "id",
          "act",
          "paragrahv",
          "title",
          "lgs"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "sections"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

The statute paragraphs cited by the most court decisions, ranked. A map of where Estonian litigation actually happens, and a good starting point when exploring an unfamiliar area.

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "description": "How many (default 20)."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "sections": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "act": {
            "type": "string"
          },
          "paragrahv": {
            "type": "string"
          },
          "title": {
            "type": [
              "string",
              "null"
            ]
          },
          "rulings": {
            "type": "number"
          }
        },
        "required": [
          "id",
          "act",
          "paragrahv",
          "title",
          "rulings"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "sections"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Given a ruling id, return documents from Estonian public-authority document registers that name the same companies - procurement files, licences, correspondence, inspections. A court dispute and an authority's file about the same company are the two halves nobody normally sees together. Sourced from dokumendiregister.ee. This depends on the ruling having a company linked to it, which holds for about 19% of the corpus: parties are extracted from the decision text by registry code, and a judgment that names a company without its code yields no link. An empty list therefore means either no linked company or no matching documents - it is not evidence that no authority holds a file.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Ruling id, e.g. 'ruling:1279503'."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 25,
      "description": "Max documents (default 8)."
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "documents": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "title": {
            "type": [
              "string",
              "null"
            ]
          },
          "authority": {
            "type": [
              "string",
              "null"
            ]
          },
          "docType": {
            "type": [
              "string",
              "null"
            ]
          },
          "regDate": {
            "type": [
              "string",
              "null"
            ]
          },
          "company": {
            "type": [
              "string",
              "null"
            ]
          },
          "url": {
            "type": "string"
          }
        },
        "required": [
          "title",
          "authority",
          "docType",
          "regDate",
          "company",
          "url"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "documents"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Full-text ruling search with optional filters: court name, case type (civil/administrative/criminal), area of law (asja_kategooria) and a decision-date range. Returns a page of rulings with a total count. Use `list_courts` / `list_categories` to discover valid filter values. Two coverage limits worth knowing, because both are silent: - `companies` is populated on about 19% of rulings. Parties are extracted from the decision text by registry code, and many judgments name a company without ever stating its code. An EMPTY array means no code was found in the text, NOT that no company was involved. - About 26% of rulings carry no `asja_kategooria` at all, so filtering by `category` silently excludes them. Omit the filter to search the whole corpus.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Free text (or \"quoted phrase\"); omit to browse by filters alone."
    },
    "court": {
      "type": "string",
      "description": "Exact court name, e.g. 'Harju Maakohus Tallinna kohtumaja'."
    },
    "case_type": {
      "type": "string",
      "enum": [
        "civil",
        "administrative",
        "criminal"
      ]
    },
    "category": {
      "type": "string",
      "description": "Exact area of law, e.g. 'Võlaõigus'."
    },
    "date_from": {
      "type": "string",
      "description": "YYYY-MM-DD lower bound (decision date)."
    },
    "date_to": {
      "type": "string",
      "description": "YYYY-MM-DD upper bound (decision date)."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 25
    },
    "offset": {
      "type": "integer",
      "minimum": 0
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "total": {
      "type": "number"
    },
    "rulings": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "caseNo": {
            "type": "string"
          },
          "court": {
            "type": "string"
          },
          "category": {
            "type": [
              "string",
              "null"
            ]
          },
          "date": {
            "type": [
              "string",
              "null"
            ]
          },
          "companies": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "url": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "caseNo",
          "court",
          "category",
          "date",
          "companies",
          "url"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "total",
    "rulings"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Given an 8-digit Estonian registry code (registrikood), return every court decision that names that company, with its role (claimant/defendant/etc.) and the other parties. This company↔case-law join is unique to lahend.ee. Find a registry code via nimistu.ee or the nimistu MCP.

{
  "type": "object",
  "properties": {
    "reg_code": {
      "type": "string",
      "description": "8-digit Estonian company registry code, e.g. '16887028'."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    }
  },
  "required": [
    "reg_code"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "company": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "regCode": {
              "type": "string"
            },
            "name": {
              "type": "string"
            }
          },
          "required": [
            "regCode",
            "name"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    },
    "count": {
      "type": "number"
    },
    "rulings": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "caseNo": {
            "type": "string"
          },
          "court": {
            "type": "string"
          },
          "category": {
            "type": [
              "string",
              "null"
            ]
          },
          "date": {
            "type": [
              "string",
              "null"
            ]
          },
          "role": {
            "type": [
              "string",
              "null"
            ]
          },
          "url": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "caseNo",
          "court",
          "category",
          "date",
          "role",
          "url"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "company",
    "count",
    "rulings"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

All Estonian courts that have published decisions, each with its ruling count. Use a court name as the `court` filter in `search_rulings`.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "courts": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "count": {
            "type": "number"
          }
        },
        "required": [
          "name",
          "count"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "courts"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

All areas of law (asja_kategooria) present in the corpus, each with its ruling count. Use a category as the `category` filter in `search_rulings`. These counts do NOT sum to the corpus size: about 26% of rulings carry no category, so they appear in `list_courts` totals and in unfiltered search but in no category here. Filtering by category silently excludes them.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "categories": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "count": {
            "type": "number"
          }
        },
        "required": [
          "name",
          "count"
        ],
        "additionalProperties": false
      }
    },
    "uncategorised": {
      "type": "number",
      "description": "Rulings with no asja_kategooria - not reachable via the `category` filter."
    },
    "corpusTotal": {
      "type": "number"
    }
  },
  "required": [
    "categories",
    "uncategorised",
    "corpusTotal"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

The newest published rulings (by decision date), across all courts and areas of law.

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 25
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "rulings": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "caseNo": {
            "type": "string"
          },
          "court": {
            "type": "string"
          },
          "category": {
            "type": [
              "string",
              "null"
            ]
          },
          "date": {
            "type": [
              "string",
              "null"
            ]
          },
          "url": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "caseNo",
          "court",
          "category",
          "date",
          "url"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "rulings"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Search EU regulations and directives, and Court of Justice / European Court of Human Rights judgments, by Estonian title or case number. The corpus is Estonian-language throughout: 94% of the Court of Justice's output is translated into Estonian, and essentially nothing indexes it in Estonian. Returns ids usable with eu_law_fetch.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Estonian title words, or a case number such as 'C-362/14'."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 30
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "results": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "kind": {
            "type": "string"
          },
          "title": {
            "type": [
              "string",
              "null"
            ]
          },
          "url": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "kind",
          "title",
          "url"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "results"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Fetch an EU regulation or directive by CELEX (e.g. '32016R0679' for the GDPR), article by article, in Estonian. Also reports how many Estonian court decisions cite it and which articles they lean on - the part EUR-Lex cannot answer.

{
  "type": "object",
  "properties": {
    "celex": {
      "type": "string",
      "description": "CELEX number, e.g. '32016R0679'. Sector 3 acts only."
    },
    "article": {
      "type": "string",
      "description": "Return only this article, e.g. '5'."
    }
  },
  "required": [
    "celex"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "celex": {
      "type": "string"
    },
    "title": {
      "type": [
        "string",
        "null"
      ]
    },
    "url": {
      "type": "string"
    },
    "articleCount": {
      "type": "number"
    },
    "citingRulings": {
      "type": "number"
    },
    "articles": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "article": {
            "type": [
              "string",
              "null"
            ]
          },
          "title": {
            "type": [
              "string",
              "null"
            ]
          },
          "text": {
            "type": "string"
          }
        },
        "required": [
          "article",
          "title",
          "text"
        ],
        "additionalProperties": false
      }
    },
    "mostCitedArticles": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "article": {
            "type": "string"
          },
          "rulings": {
            "type": "number"
          }
        },
        "required": [
          "article",
          "rulings"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "celex",
    "title",
    "url",
    "articleCount",
    "citingRulings",
    "articles",
    "mostCitedArticles"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Given a CELEX (an act like '32016R0679', or a Court of Justice judgment like '62014CJ0362'), return the Estonian court decisions that cite it. This is the join no other source publishes: EUR-Lex knows the EU instrument, Riigi Teataja knows the Estonian decision, and nobody connects them.

{
  "type": "object",
  "properties": {
    "celex": {
      "type": "string",
      "description": "CELEX of an EU act or judgment."
    },
    "article": {
      "type": "string",
      "description": "Only decisions citing this article of the act."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    }
  },
  "required": [
    "celex"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "celex": {
      "type": "string"
    },
    "totalRulings": {
      "type": "number"
    },
    "rulings": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "caseNo": {
            "type": [
              "string",
              "null"
            ]
          },
          "kohus": {
            "type": [
              "string",
              "null"
            ]
          },
          "date": {
            "type": [
              "string",
              "null"
            ]
          },
          "article": {
            "type": [
              "string",
              "null"
            ]
          },
          "url": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "caseNo",
          "kohus",
          "date",
          "article",
          "url"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "celex",
    "totalRulings",
    "rulings"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Given an Estonian ruling id (from `search`), list the EU instruments it cites - regulations, directives and Court of Justice judgments - with the articles named where the decision names them.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Ruling id, e.g. 'ruling:1279503'."
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "cited": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "celex": {
            "type": "string"
          },
          "kind": {
            "type": "string"
          },
          "label": {
            "type": "string"
          },
          "title": {
            "type": [
              "string",
              "null"
            ]
          },
          "articles": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "url": {
            "type": "string"
          }
        },
        "required": [
          "celex",
          "kind",
          "label",
          "title",
          "articles",
          "url"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "cited"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Ranked by how many Estonian decisions cite them. A good starting point for 'which EU law actually matters in Estonian practice' - the answer is concentrated in consumer protection, jurisdiction, asylum and agriculture rather than spread evenly.

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "instruments": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "celex": {
            "type": "string"
          },
          "kind": {
            "type": "string"
          },
          "label": {
            "type": "string"
          },
          "title": {
            "type": [
              "string",
              "null"
            ]
          },
          "rulings": {
            "type": "number"
          },
          "url": {
            "type": "string"
          }
        },
        "required": [
          "celex",
          "kind",
          "label",
          "title",
          "rulings",
          "url"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "instruments"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}