Liigu sisu juurde
Kodaniku Kratt

Kohalik omavalitsus

Tartu dokumendiregister

Tartu linna õigusaktid, päevakorrad, protokollid, lepingud ja kirjavahetus.

Tartu dokumendiregister (info.raad.tartu.ee) hoiab linna õigusakte, haldusakte, päevakordi, protokolle, lepinguid, kirjavahetust, käskkirju, stenogramme ja ehitusdokumente, igaüht oma vaates. Otsida saab sõna, fraasi või tüvega ja tulemused tulevad uuemad ees, kuni tuhat vastet korraga. Eraisikute nimed kirjavahetuses võivad olla lühendatud initsiaalideks ja piiratud juurdepääsuga dokumendi sisu ei avaldata.

Mida su agent peab oskama

GETPiisab lehe tõmbamisest. Kõik vajalikud päringud on tavalised HTTPS-päringud. Iga agent, kes oskab veebilehe alla laadida, saab selle juhendi läbi teha.

Milline agent selle läbi teeb

Juhend ise

Inglise keeles, sest seda loeb mudel.

Tartu Document Register

Access

  • Register chooser: https://info.raad.tartu.ee/dhs.nsf/dokreg?readform
  • Public HTML backed by Lotus Notes views; no login is required.
  • The old webaktid.nsf route redirects to the same document-register splash page and is not a separate source.

Retrieve

Fetch the chooser and select the view matching the record type. Direct view prefixes are:

  • koik - all records
  • oigusaktid - legal acts
  • haldusaktid - permits, precepts, and other decisions
  • paevakorrad - agendas
  • protokollid - minutes
  • lepingud - contracts
  • skirjad / vkirjad - incoming / outgoing correspondence
  • kaskkirjad - administrative orders
  • Stenogrammid - meeting transcripts
  • epd - construction-related documents

Each search view starts with this query string:

?SearchView&Count=100&Start=1&SearchOrder=4&SearchMax=1000

A plain GET with &Query= searches it — no browser session, no form POST (verified 2026-08-01 across koik, oigusaktid, lepingud, paevakorrad, skirjad, epd, Stenogrammid):

https://info.raad.tartu.ee/dhs.nsf/oigusaktid?SearchView&Count=100&Start=1&SearchOrder=4&SearchMax=1000&Query=raieluba

Query is Domino full-text syntax: a bare word; several words, where a space is an implicit AND (detailplaneering Annelinn and detailplaneering AND Annelinn both return the same 2 documents); a "quoted phrase"; a trailing wildcard (raie* → 188). Estonian letters work percent-encoded. Page with Start=101, which the register's own pager links.

Search results are newest first, return at most 1,000 matches, and show 100 rows per page.

Result columns differ per view and must be read from the header row, not by position: oigusaktid is Väljaandja / Dokumendi liik / Kuupäev / Nr / Pealkiri, lepingud is Kuupäev / Number / Linna pool / Teine osapool / Lühikirjeldus, paevakorrad is Istungi kp / Pidaja / Koht, and Stenogrammid leaves its last column unlabelled. Row links are written as http:// and must be requested as https://.

Return

  • Preserve the document type, registry number, title/summary, issuer or correspondent, registration/adoption date, access status, detail URL, attached full-text links, search filters, and retrieval time.
  • Keep restricted records in the result only when their public metadata is relevant; do not claim access to restricted full text.

Limits

  • Physical-person names in correspondence may be reduced to initials.
  • Search fields differ by document type, so choose the view before forming the query.
  • A view fetched without &Query= answers HTTP 200 with its search form — 15,518 bytes, no error, and no count line. That is a request that never searched, and reporting it as "Tartu holds nothing" is the wrong answer this source produces most easily.
  • The register caps a wide search: over the ceiling it writes üle N dokumendi instead of a number. Report that as at least N.

Verify

  • Require HTTP 200 HTML whose title is Dokumendiregister.
  • Require chooser links for oigusaktid, paevakorrad, protokollid, and lepingud; the bare dhs.nsf splash page is not a successful data response.
  • A search only ran if the response carries Otsingutingimustele vastas <N> dokumenti (or 1 dokument, or üle N dokumendi when capped — note the genitive drops the t). vastas 0 dokumenti, muutke otsingutingimusi is a real, empty result. No such line at all means the search was never run.

Known-good acceptance check, run against the live register by scripts/check-sources.mjs (issue #82):

GET https://info.raad.tartu.ee/dhs.nsf/oigusaktid?SearchView&Count=100&Start=1&SearchOrder=4&SearchMax=1000&Query=raieluba
expect /Otsingutingimustele vastas\s+(üle\s+)?\d+\s+dokumen[dt]/
expect /\/dhs\.nsf\/web\/viited\//
# 129 documents on 2026-08-01, the first being "Ropka tn 2 ehitusloa andmine"
# (Korraldus 116, 02.02.2021, TLVK2021020200116). The counter is the same view
# with the Query dropped: HTTP 200, the search form, and no count line at all.
counter GET https://info.raad.tartu.ee/dhs.nsf/oigusaktid?SearchView&Count=100&Start=1&SearchOrder=4&SearchMax=1000

Module API

tartuDocuments(query, {view, start, count}) -> {source, page, view, query, ran, totals, columns, rows, note} tartuDocument(refOrUrl) -> {source, page, ref, title, fields, files, note}