search
Search legal documents with hybrid semantic + keyword matching.
Covers 18M+ documents: case law, legislation, and doctrine across 110+ countries.
Set namespace to "case_law", "legislation", or "doctrine". Use discover_countries
first if you're unsure which country codes are available.
Args:
query: Natural language search query.
namespace: Collection to search — "case_law", "legislation", or "doctrine".
top_k: Number of results (1-100).
alpha: Semantic vs keyword weight (1.0=pure semantic, 0.0=pure keyword).
country: Filter by ISO country codes, e.g. ["FR", "DE"].
court_tier: Filter by court tier (1=supreme, 2=appellate, 3=first instance).
jurisdiction: Filter by jurisdiction name (e.g. "civil", "criminal").
subdivision: Filter by geographic subdivision (ISO 3166-2), e.g. "DE-BY", "US-CA".
date_start: Start date filter (YYYY-MM-DD).
date_end: End date filter (YYYY-MM-DD).
language: Filter by language code, e.g. "fr", "de".
get_document
Retrieve a full legal document by its source and source_id.
Returns the complete text, metadata, and all available fields.
Use source and source_id values from search results.
Args:
source: Source identifier, e.g. "FR/Judilibre", "DE/BVerfG".
source_id: Document identifier within the source.
resolve_reference
Resolve a loose legal reference to the exact document(s).
Given an informal citation like "art. 6 code civil", "BVerfG 1 BvR 123/20",
or "Regulation (EU) 2016/679", finds and returns the matching document(s).
This is NOT a search — it resolves a specific citation to the exact record.
Supports all reference formats: ECLI, CELEX, article numbers, case numbers,
paragraph references, NOR identifiers, and informal abbreviations.
Args:
reference: Legal reference string (e.g., "art. 6 code civil", "ECLI:FR:CCASS:2006:CO00559").
hint_country: Optional ISO country code to narrow resolution (e.g., "FR").
hint_type: Optional type hint: "legislation" or "case_law".
discover_countries
List all available countries with their document counts and source counts.
Returns country codes (ISO 2-letter), number of case law / legislation /
doctrine sources, and total document counts. Use this to find valid country
codes before searching.
discover_sources
List all data sources available for a specific country.
Returns source IDs, data types, court names, tiers, document counts,
and date ranges. Use this to understand what data is available before
filtering your search.
Args:
country_code: ISO 2-letter country code, e.g. "FR", "DE", "EU".
report_source_issue
Report an issue with a data source.
Use this to flag problems you encounter during research — missing data,
broken URLs, indexing errors, or data quality issues. Reports are reviewed
by the platform maintainer. Requires authentication (free — does not
count against your usage quota).
Args:
source: Source identifier, e.g. "FR/Judilibre", "AT/RIS".
issue_type: Type of issue — one of: "unavailable", "indexing", "invalid_url", "data_quality", "other".
description: Free-text description of the problem.