eu_sanctions__search
Search EU Sanctions List
Search the EU consolidated financial sanctions list (persons and enterprises) by name or alias. Returns matching listed parties with their aliases, listing regulation, and identifying details, plus a `stale` flag when the underlying snapshot is older than the freshness window.
Parameterslimitqueryrequiredsubject_type
ua_law__search
Search Ukrainian Legislation
Search Ukrainian legislation by free text and/or metadata filters.
One entry per matching document, carrying the `nreg` `get_document_toc` takes.
Never text.
`in_force_on_date` keeps only acts the portal's own commencement and repeal
events put in force that day, dropping any act with no such event recorded.
`total` counts what it kept; `total_relation: 'gte'` marks a floor.
Parameterstextlimittopicoffsetstatustype_idin_scopein_force_on_date
ua_law__search_units
Search Legislation Provisions by Text
Find provisions by their text: which articles, points or clauses say X.
Every word of `text` must appear (quote it for an exact phrase). Searches the
text as published on `on_date` (default today); `nreg` limits it to acts. Each
hit is the smallest unit holding it, with that day's `urn`. ⟦ ⟧ in `excerpt`
mark matches, not the law's text. `amending_act` hits restate other acts.
`search` finds acts by title.
Parametersnregtextrequiredlimitoffseton_dateper_actamending_acts
ua_law__get_document
Get Legal Act Card
One act's card, by registration number. No text: use `get_document_toc` then `get_unit_fulltext`.
`urn_current_edition` is null unless an edition is in force today -- a repealed
act has none; `urn_latest_edition` is the newest text in effect today whatever
the status; `urn_next_edition`, text scheduled to take effect later.
Editions '30000101' and up await a date not yet fixed (e.g. end of martial
law) and are none of these.
Parametersnregrequiredoffsetrelation
ua_law__get_unit
Get Legal Provision Metadata
Metadata for one structural unit, addressed by its URN.
`urn` is 'urn:ua:law:{nreg}:{path}@{YYYYMMDD}'. Drop '@{YYYYMMDD}' for today's
edition; drop the path too for the whole document. Take one from a filtered
`get_document_toc` rather than building it.
A URN resolving to no unit answers 'not_found' with the nearest real units
either side and `same_segment` -- real paths ending in the segment asked for,
the hint when the right article was guessed under a wrong ancestor.
Parametersurnrequired
ua_law__get_unit_in_force
Check Provision In Force on Date
Whether one unit was legally in force on a given date.
`in_force` is true, false, or null when the corpus cannot tell. `outcome`
'deterministic' is from the portal's own events or edition history, anything
else from AI review of the text.
An undated URN asks about the provision; a dated one about that version of
its text: false once replaced (`scope` 'version', `version_in_force_urn`).
`decided_for_provision` false: the answer is the act's, possibly wrong for an
article inserted or deleted mid-life.
`source: 'no_force_event'`: none ever recorded -- read `document_status_name`.
Parametersurnrequireddaterequired
ua_law__get_unit_fulltext
Get Legal Provision Text
Unit text, paged.
Past `max_chars` it is `truncated`: pass `next_cursor` as `cursor` for more.
Pages end after a paragraph, else after a space, else mid-word (a tiny
`max_chars`). Only page 1 lists `parts`, sub-units with their own `urn`,
unless `parts_offset` is passed.
`text: null` with status 'edition_text_unavailable' (edition not stored) or
'extraction_failed' (unit not cut out) is a unit that DOES exist -- not a
repeal. No unit at that address answers 'not_found'.
Parametersurnrequiredcursormax_charsparts_offset
ua_law__get_units_fulltext
Get Several Legal Provisions' Text
Several units' text in one call: a norm and what it relies on.
`units` answers each URN in order as `get_unit_fulltext` would, sharing one
`max_chars`: a unit that does not fit is `truncated` with a `next_cursor`, and
units past the budget come back with no text. A URN matching nothing is its
own 'not_found' entry.
Parametersurnsrequiredmax_chars
ua_law__get_unit_editions
List Provision Editions
The editions on which one unit's text changed, and what changed it.
Each entry is a version: its dated `urn`, how many editions kept it, and
`amended_by`, the acts behind the change ('unit_notes': cited by the unit's
notes; 'edition_basis': the edition's basis). `removed`: the unit
disappears; `moved_from`: its address changed (`text_changed` false if only
that). A `baseline` opens the list: the first text, or with
`from_date` the text in force that day. Edition '30000101' and up
(`edition_date` null) takes effect on a date not yet fixed.
`complete: false` means `limit` cut older entries.
Parametersurnrequiredlimitto_datefrom_date
ua_law__get_document_toc
Get Legal Act Contents
One document's units in reading order -- and the article resolver: `kind='article'` with `number='626'` returns that article alone, `urn` included.
Structure only. Each entry carries the `urn` `get_unit_fulltext` takes and a
`heading`, or for a clause its opening paragraph as `lead_text` with
`text_chars` for the provision's full length.
Filter, do not page: the Civil Code is 5,431 units, 1,329 of them articles.
Parameterskindnregrequiredlimitnumberoffsetedition_date
ua_edrsr__search
Search Court Decisions (EDRSR)
Faceted full-text search over Ukrainian court decisions (ЄДРСР).
Decision text comes from `get_document`.
`doc_type_name` tells a procedural ruling (Ухвала) from a merits judgment
without fetching it.
`q` is lemmatized inside the index; do not stem it first. Integer filters OR
within, AND across.
A null `total` is the index not answering, not a no-match.
Parametersqjudgelimitoffsetstatusdate_toinstancedate_fromcourt_codecited_dokidjustice_kindcategory_code+3 more
ua_edrsr__get_document
Get Court Decision (EDRSR)
One decision: its text, its citations, its structural parts.
Text is windowed, never dumped whole. `text_window` says what came back and how
to get the rest. Citations cover that window only, with `*_outside_window`
counting the rest; repeats of one case roll up into `occurrences`.
Citations carry what was written and what it resolved to, so an unresolved one
stays visible. Join on `resolved_cause_num`, not the written number.
Parametersdoc_idrequiredoffsetsectionmax_charsinclude_html
ua_edrsr__get_court_practice
Court Practice on a Statute Article
Court practice on one statute article: which cases cite it, by court and year,
ranked highest authority first.
Spellings of one code answer alike ('ККУ', 'КК України') and mean the code in
force; `repealed_excluded` lists repealed namesakes' nregs.
`index_coverage.status` says what `total_cases` means (a real zero, or
unresolved citations); under `index_unavailable` it is null, not a count.
Parameterslimitfacet_sizeabbreviationrequiredarticle_numberrequiredclause_component
ua_edrsr__lookup_case
Look Up Court Case (EDRSR)
One case by document id or case number, with the cases related to it. Give
exactly one of `doc_id` or `cause_num`.
Highest instance first, judgments before rulings, newest first.
`related_cases` is citation-graph overlap, never semantic similarity or a
judgement on merits, and may repeat a decision from `matches`. `score` weights
each shared anchor and case by rarity, so boilerplate ranks near nothing.
`departures`/`departed_by`: Supreme Court departures read from the texts.
Parametersdoc_idoffsetcause_nummax_charsmatch_limitrelated_limit
ua_bankruptcy__search
Search Bankruptcy Announcements
Ukrainian bankruptcy and insolvency announcements (ДСА registry).
One result is one published announcement, not one case. A case accumulates
announcements as it proceeds and long-running cases have hundreds, so use
`get_case` for one case's history and current stage.
Company names are stored in full legal form and in capitals, so a distinctive
fragment of the trade name works far better than an exact name. `debtor_code` is
the reliable way to identify a party.
Parameterscourtlimitqueryoffsetcase_numberdebtor_codeannouncement_type
ua_bankruptcy__get_case
Get Bankruptcy Case
One bankruptcy case's announcement history and current procedural stage, newest
first.
`current_stage` is the most recent announcement's type. The registry publishes
no case-level status record, so the latest publication is the only statement of
where the case stands, and `debtor_code`, `debtor_name` and `court_name` are
read off that same announcement.
Check `mirror.ready` to tell "no proceedings published" apart from an unsynced
mirror.
Parameterslimitcase_numberrequired
ua_cpi_inflation__search
Search Consumer Price Index
Ukrainian consumer price index figures over a period range, newest first.
This is Derzhstat's own consumer price index, not a producer price index and not
the NBU's mixed inflation series. The distinction matters: the month-on-month
series (`base_period` PREV_MONTH) is what Article 625(2) of the Civil Code is
computed from.
An index of 100.0 means no change against its base. Omitting `base_period`
returns every base for each period, which is rarely what a calculation wants.
Parametersfreqlimitoffsetdate_todate_frombase_period
ua_debtors__search
Search Register of Debtors
Ukraine's Unified Register of Debtors (Єдиний реєстр боржників, ЄРБ): persons
with an open, unsatisfied enforcement proceeding.
An entry is dropped at the first daily sync after its proceeding closes, so "not
listed" means nothing was open as of `as_of`, never that nothing ever was. The register publishes no dates, so rows
carry none and arrive in arbitrary order.
`ua_enforcement_proceedings` also holds closed and refused proceedings.
Parametersqlimitoffsetcategorydebtor_codedebtor_kind
ua_debtors__lookup
Look Up Debtors by Proceeding
Every debtor listed under one enforcement-proceeding number.
Always a list: one proceeding can be enforced against several debtors, so a
number legitimately has several answers.
Parametersproceeding_numberrequired
ua_edr_companies__search
Search Companies (EDR)
Ukrainian legal entities in the open ЄДР extract (Єдиний державний реєстр
юридичних осіб). Legal entities only; ФОП are `search_fop`.
The open extract publishes neither the registered address (місцезнаходження)
nor КВЕД activity codes. Both were withdrawn upstream for security reasons, so
they are absent rather than lost and no response can supply them; only a paid
НАІС/Дія extract carries them.
`q` does not reach officers or founders. `lookup` returns those.
Parametersqlimitoffsetstatus
ua_edr_companies__lookup
Look Up Company (EDR)
One legal entity by ЄДРПОУ code or `record`, with its people.
`people`: founders, beneficial owners, signers and board members; the head is
the latest appointment. `company` adds termination, bankruptcy, succession,
branches and tax registration.
`history`: changes per weekly release since tracking began; `on_date`: people
then. Earlier history: paid НАІС extract only.
A code shared by several subjects returns the live one, the rest in
`other_subjects`.
No address or КВЕД codes upstream.
Parametersedrpourecordhistoryon_date
ua_edr_companies__search_fop
Search Sole Traders (EDR)
ФОП (фізичні особи-підприємці) in the open ЄДР extract, by name (ПІБ), status
and registration/termination date. Ordered by the filtered date, else `record`.
No РНОКПП, address or КВЕД upstream: namesakes cannot be told apart, so a name
hit alone does not identify a person.
Parametersqlimitoffsetstatusregistered_toterminated_toregistered_fromterminated_from
ua_edr_companies__lookup_fop
Look Up Sole Trader (EDR)
One ФОП by `record`: termination entry and reason, annulled termination,
farm-household flag, property manager, tax/ЄСВ registration.
Parametersrecordrequiredhistory
ua_enforcement_proceedings__search
Search Enforcement Proceedings
АСВП, Ukraine's register of enforcement proceedings (виконавчі провадження).
Wider than ЄРБ (`ua_debtors`): it keeps closed ('Завершено') and refused
('Відмовлено у відкритті') proceedings too. The shared key is `vp_num`.
`debtor_code` is published for legal entities only, about 9% of rows. The source
carries no identifier at all for a natural-person debtor, so a null code means
the source publishes none, not that parsing failed.
Parametersqlimitoffsetvp_numopened_todebtor_codeopened_fromproceeding_state
ua_enforcement_proceedings__lookup
Look Up Enforcement Proceeding
Every row published under one enforcement-proceeding number.
Always a list: a proceeding with several debtors is published as one row per
debtor. `matches` is capped at 200.
Parametersvp_numrequired
ofac_sanctions__search
Search OFAC Sanctions List
Search the US Treasury OFAC Specially Designated Nationals (SDN) list (individuals, entities, vessels, and aircraft) by name or alias. Returns matching listed parties with their aliases, sanctions programs, and identifying details, plus `stale`/`available` flags describing how current the underlying snapshot is.
Parameterslimitqueryrequiredsubject_type
un_sanctions__search
Search UN Sanctions List
Search the UN Security Council Consolidated Sanctions List (individuals and entities) by name or alias. Returns matching listed records with their aliases, listing regime (`un_list_type`), and identifying details, plus a `stale` flag when the underlying snapshot is older than the freshness window and a `snapshot.retrieved` flag that is false if no snapshot has ever been obtained yet.
Parameterslimitqueryrequiredrecord_typeun_list_type
uk_sanctions__search
Search UK Sanctions List
Search the UK Sanctions List (HM Treasury / FCDO consolidated financial sanctions designations) by name or alias. Returns matching designated parties with their aliases, regime, date of birth and nationality (for individuals), and the sanctions measures imposed. A `stale` flag is set when the underlying snapshot is older than the freshness window, and `retrieved` is false if no snapshot has ever been fetched yet.
Parameterslimitqueryrequiredregime
ua_echr__search
Search ECHR Case Law (HUDOC)
Search ECHR (European Court of Human Rights) case law via HUDOC, scoped to cases against Ukraine: judgments, decisions and communicated cases with application number(s), engaged articles, importance level, conclusion and a HUDOC permalink, including Ukrainian translations where HUDOC holds one. A live lookup with a short-lived cache, not a stored dataset.
Parameterslimitqueryrequiredstartarticlelanguage
ua_echr__get_case
Get ECHR Document (HUDOC)
One HUDOC document by `itemid`, adding cited Strasbourg case law, domestic law at issue, judges.
Parametersitemidrequired
ua_corruption_registry__search
Search Corruption Offenders Register
Ukraine's register of persons who committed corruption or corruption-related
offences (НАЗК).
An entry records one offender, the offence, the article they were held liable
under, the sanction, and the court decision or disciplinary decree that imposed
it. Most entries are natural persons sanctioned by a court.
`sentence_number`, where present, is the decision's ЄДРСР id, so an entry can be
checked against the decisions register itself.
This source publishes no freshness of its own, so `as_of` is mirror sync date.
Parametersqlimitoffsetdate_todate_fromentity_typepunishment_type
ua_nbu_rate__rate
Get NBU Exchange Rate
Look up the National Bank of Ukraine's official exchange rate (UAH per unit) for a currency, as of a given date or today if none is given. Supports historical dates for ЦК §533 п.2-style currency-conversion calculations, not only the current rate. Returns `available: false` with a null rate, rather than an error, when NBU has nothing published for the requested currency or date.
Parametersdatecurrencyrequired
ua_court_hearings__search
Search Court Hearing Schedules
Hearings scheduled in Ukrainian courts (Список справ, призначених до
розгляду), every court, read daily from court.gov.ua (a court listing on its
own portal instead: source=courtportal). The source lists today onward; past
hearings stay here as last listed. Needs case_number, court_code or q.
Parametersqlimitoffsetdate_todate_fromcourt_codecase_numberinclude_removed
ua_vs_digest__search
Search Supreme Court Practice Reviews
The Supreme Court's analytical publications: дайджести, огляди and узагальнення
судової практики, plus the наукові висновки НКР при ВС.
Not in ЄДРСР, which has the judgments but no positions by dispute category.
`document` returns the text, link and case numbers. `court_body` `vs` is a
cross-cutting digest of no single cassation court (a quarter of the corpus),
not a missing value.
Parametersqlimitoffsetsectionyear_todoc_kindyear_fromcourt_body
ua_vs_digest__document
Get Supreme Court Practice Review
One Supreme Court publication's extracted text, `document_url`, cited case
numbers and linked ЄДРСР `edrsr_ids` -- only this tool returns them.
These are analytical reports, not judgments, averaging ~128,000 characters, so
a window from the start is usually cover page and contents. Pass
`text_query` to open it at the passage you want. `char_count` is the full
length; `has_more` whether more follows.
`extract_status` says why there is no text: `empty` is a scan with no OCR
layer, one in nine; `failed` errored; `unsupported` is not a PDF.
Parameterstext_limittext_querydocument_idrequiredtext_offset
ua_holidays__check_date
Check Ukrainian Holiday
Whether one date is a public holiday or non-working day in Ukraine.
`is_holiday` is true, false, or **null** -- null when `covered` is false, i.e.
the mirror has not computed that year. Null is not "no": a deadline calculation
must be able to tell "this is a working day" from "this source cannot say".
`matches` carries the day with its name and verbatim statute line; a list, as a
movable feast and a dated holiday can coincide.
`is_holiday` means ст. 73 lists the day. During martial law ст. 73 does not
apply: see `martial_law.suspends_holidays`, null past the decreed end.
Parametersdaterequired
ua_lpd__search
Search Supreme Court Legal Positions
The Supreme Court's legal positions (правові позиції).
A position is an analyst's short statement of what the Court held, not a
quotation, filed under a classifier and linked to its source decisions. ЄДРСР
has the judgments, not which passage is the holding.
Hits omit the text unless `full_text`; `position` serves it. `mark`
`indented`: the position departs from (or refines) an earlier holding;
`modified`: a later decision departed from or refined it.
`norm_refs` dates each norm it quotes to the edition then in force.
Parametersqlimitdoc_idoffsetfull_textcourt_codecase_numbercategory_idjurisdiction
ua_lpd__position
Get Supreme Court Legal Position
One legal position, with its text and published markup.
Pass a search hit's `position_id`. `text` is plain, `text_html` as published.
`norm_refs` dates each statute quoted to the `ua_law` edition then in force,
with a `urn` `ua_law__get_unit_fulltext` takes, to compare with today's text.
`departs_from`/`departed_in` link departures, read from position texts;
`history` has the detail. `approved_at` is NOT a publication date: its absence
says nothing about whether a position is current.
Parametersposition_idrequired
ua_legal_indicators__get
Get Legal Indicator on Date
Value of a legal indicator in force on a date, with the act and article that set it.
nbu_discount_rate: NBU облікова ставка, % p.a., since 1992. pm_general, pm_child_under_6, pm_child_6_18, pm_able_bodied, pm_disabled: прожитковий мінімум, from 2005. min_wage_monthly (from 2009-11), min_wage_hourly (from 2010). Statutory figures are curated from the budget laws. found=false with a reason: outside coverage, next year's law not curated yet, or NBU not synced. Exchange rates: ua_nbu_rate; CPI: ua_cpi_inflation.
Parameterson_dateindicatorrequired
ua_legal_indicators__court_fee
Calculate Court Fee
Судовий збір for a claim, or an appeal/cassation against the judgment, in a civil, commercial or administrative court (ст. 4 Закону № 3674-VI). Base: able-bodied прожитковий мінімум on 1 January of the filing year (minimum wage 2011-2016). Returns amount, formula and provisions. Rates are the law's current text; an older filing may have owed another rate. Not covered (error): special claims, court orders, appeals against rulings, bankruptcy, exemptions.
Parameterscourtrequiredfilerrequiredfilingclaim_kindrequiredelectronicfiling_dateclaim_amount
catalog__search
Search Tool Catalog
Find tools left out of this list (the catalog) by topic. Each hit is a tool name and its first sentence; an empty result means no catalog tool mentions those words.
Parametersqsource
catalog__describe
Describe Catalog Tool
A catalog tool's full description and input schema, as tools/list would publish it.
Parameterstoolrequired
catalog__call
Call Catalog Tool
Run a catalog tool with its arguments. It is validated, limited, billed and answered exactly as a listed tool would be.
Parameterstoolrequiredarguments