Court hearings: API reference, routes and examples

Courts and their seats

GET/v1/courts/courts

Every court of Moldova (district courts, courts of appeal, the Supreme Court of Justice) and its seats, with slugs for the other court routes and whether the crawl has read it. Costs 1 credit.

Credits: 1
: With a key

Parameters

No parameters.

Possible errors

Try it

curl "https://api.satelit.md/v1/courts/courts" \
  -H "Authorization: Bearer $SATELIT_KEY"

const res = await fetch("https://api.satelit.md/v1/courts/courts", {
  headers: { Authorization: `Bearer ${process.env.SATELIT_KEY}` },
});
const { data, meta } = await res.json();
console.log(data, meta.credits);

import json, os, urllib.request

req = urllib.request.Request(
    "https://api.satelit.md/v1/courts/courts",
    headers={"Authorization": f"Bearer {os.environ['SATELIT_KEY']}"},
)
with urllib.request.urlopen(req) as res:
    body = json.load(res)
print(body["data"], body["meta"]["credits"])

<?php
$ch = curl_init("https://api.satelit.md/v1/courts/courts");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ["Authorization: Bearer " . getenv("SATELIT_KEY")],
]);
$body = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($body["data"]);

Court cases by name or number

GET/v1/courts/search

The cases of a person or a company (every word of `q` among the parties, in any order, diacritics and Russian spellings folded), or by a case number (any part from its start) or an 8-digit PIGD number (the same dispute in every instance). Newest first. Names as the courts publish them. Costs 3 credits per 20 rows.

Credits: 3 for every 20 rows
: With a key

Parameters

qstringrequired

Words to search for.
courtstringoptional

A court or seat: its slug from `/courts/courts`, or its name in any language.
kindstring: civil, penal, contrav, admin, otheroptional

Only this category.
perintegeroptionaldefault 20

Rows per page, at most 20.

Possible errors

Try it

curl "https://api.satelit.md/v1/courts/search" \
  -H "Authorization: Bearer $SATELIT_KEY"

const res = await fetch("https://api.satelit.md/v1/courts/search", {
  headers: { Authorization: `Bearer ${process.env.SATELIT_KEY}` },
});
const { data, meta } = await res.json();
console.log(data, meta.credits);

import json, os, urllib.request

req = urllib.request.Request(
    "https://api.satelit.md/v1/courts/search",
    headers={"Authorization": f"Bearer {os.environ['SATELIT_KEY']}"},
)
with urllib.request.urlopen(req) as res:
    body = json.load(res)
print(body["data"], body["meta"]["credits"])

<?php
$ch = curl_init("https://api.satelit.md/v1/courts/search");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ["Authorization: Bearer " . getenv("SATELIT_KEY")],
]);
$body = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($body["data"]);

A day's hearings

GET/v1/courts/hearings

The hearings of one day, of one court or seat or of every court, by id: `after` the last answer's `next` for the next rows. Each with its case. Costs 2 credits per 50 rows.

Credits: 2 for every 50 rows
: With a key

Parameters

courtstringoptional

A court or seat: its slug from `/courts/courts`, or its name in any language.
datestringoptionaldefault today

The day, YYYY-MM-DD.
kindstring: civil, penal, contrav, admin, otheroptional

Only this category.
afterintegeroptionaldefault 0

Where to continue: the last meta.next you received.
perintegeroptionaldefault 50

Rows per page, at most 20.

Possible errors

Try it

curl "https://api.satelit.md/v1/courts/hearings" \
  -H "Authorization: Bearer $SATELIT_KEY"

const res = await fetch("https://api.satelit.md/v1/courts/hearings", {
  headers: { Authorization: `Bearer ${process.env.SATELIT_KEY}` },
});
const { data, meta } = await res.json();
console.log(data, meta.credits);

import json, os, urllib.request

req = urllib.request.Request(
    "https://api.satelit.md/v1/courts/hearings",
    headers={"Authorization": f"Bearer {os.environ['SATELIT_KEY']}"},
)
with urllib.request.urlopen(req) as res:
    body = json.load(res)
print(body["data"], body["meta"]["credits"])

<?php
$ch = curl_init("https://api.satelit.md/v1/courts/hearings");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ["Authorization: Bearer " . getenv("SATELIT_KEY")],
]);
$body = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($body["data"]);

One case

GET/v1/courts/case

A case by its number or PIGD: its hearings in order with the result, the judge and the room, its decisions with the court's own PDF link (never stored here), and the same dispute in the other instances. Costs 1 credit.

Credits: 1
: With a key

Parameters

numberstringrequired

The case number, its PIGD or its page link on satelit.md.
courtstringoptional

A court or seat: its slug from `/courts/courts`, or its name in any language.

Possible errors

Try it

curl "https://api.satelit.md/v1/courts/case" \
  -H "Authorization: Bearer $SATELIT_KEY"

const res = await fetch("https://api.satelit.md/v1/courts/case", {
  headers: { Authorization: `Bearer ${process.env.SATELIT_KEY}` },
});
const { data, meta } = await res.json();
console.log(data, meta.credits);

import json, os, urllib.request

req = urllib.request.Request(
    "https://api.satelit.md/v1/courts/case",
    headers={"Authorization": f"Bearer {os.environ['SATELIT_KEY']}"},
)
with urllib.request.urlopen(req) as res:
    body = json.load(res)
print(body["data"], body["meta"]["credits"])

<?php
$ch = curl_init("https://api.satelit.md/v1/courts/case");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ["Authorization: Bearer " . getenv("SATELIT_KEY")],
]);
$body = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($body["data"]);

One judge's load

GET/v1/courts/judges/{slug}

A judge's year (hearings by category, postponement rate, median days to a decision, rank among the busiest), today, the next working day, this week, the next 14 days, and the agenda of a day. Costs 1 credit.

Credits: 1
: With a key

Parameters

slugstringrequired

The recipe name in the address.

Possible errors

Try it

curl "https://api.satelit.md/v1/courts/judges/{slug}" \
  -H "Authorization: Bearer $SATELIT_KEY"

const res = await fetch("https://api.satelit.md/v1/courts/judges/{slug}", {
  headers: { Authorization: `Bearer ${process.env.SATELIT_KEY}` },
});
const { data, meta } = await res.json();
console.log(data, meta.credits);

import json, os, urllib.request

req = urllib.request.Request(
    "https://api.satelit.md/v1/courts/judges/{slug}",
    headers={"Authorization": f"Bearer {os.environ['SATELIT_KEY']}"},
)
with urllib.request.urlopen(req) as res:
    body = json.load(res)
print(body["data"], body["meta"]["credits"])

<?php
$ch = curl_init("https://api.satelit.md/v1/courts/judges/{slug}");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ["Authorization: Bearer " . getenv("SATELIT_KEY")],
]);
$body = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($body["data"]);

Court figures

GET/v1/courts/stats

What happens in the courts now (today, this week, this month by court and seat), what is rising, the busiest judges and the categories they hear, postponements and how long a case takes. Read from tables the crawl keeps as it reads: an answer takes milliseconds. Every view says its period and the coverage of the crawl. Costs 2 credits.

Credits: 2
: With a key

Parameters

viewstring: now, trends, judges, durationsoptionaldefault now

now, trends, judges or durations.
courtstringoptional

A court or seat: its slug from `/courts/courts`, or its name in any language.
kindstring: civil, penal, contrav, admin, otheroptional

Only this category.
periodstring: today, tomorrow, week, month, 30d, yearoptionaldefault month

judges: today, tomorrow, week, month, 30d (the last 30 days) or year (the last 365 days).
daysintegeroptionaldefault 28

How many days back. Cut at the plan's limit.
limitintegeroptionaldefault 10

Rows per answer, at most 200.

Possible errors

Try it

curl "https://api.satelit.md/v1/courts/stats" \
  -H "Authorization: Bearer $SATELIT_KEY"

const res = await fetch("https://api.satelit.md/v1/courts/stats", {
  headers: { Authorization: `Bearer ${process.env.SATELIT_KEY}` },
});
const { data, meta } = await res.json();
console.log(data, meta.credits);

import json, os, urllib.request

req = urllib.request.Request(
    "https://api.satelit.md/v1/courts/stats",
    headers={"Authorization": f"Bearer {os.environ['SATELIT_KEY']}"},
)
with urllib.request.urlopen(req) as res:
    body = json.load(res)
print(body["data"], body["meta"]["credits"])

<?php
$ch = curl_init("https://api.satelit.md/v1/courts/stats");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ["Authorization: Bearer " . getenv("SATELIT_KEY")],
]);
$body = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($body["data"]);