Громадянство Румунії: довідник API, маршрути й приклади

A citizenship dossier by number

GET/v1/citizenship/lookup

Romanian citizenship (ANC): a dossier number in any usual spelling (`12345/RD/2022`, `12345/2022`, `dosar RD 12345 2022`) or an order (`ordin 1054/P/2025`). The state, the order, the oath day and hour, how long it has waited, the estimate with its basis, one line in the request's language, and the links to ANC's PDF and the catalog's pages. A number no list names yet gets `not_found` with its month's estimate. `as_of` is the date of ANC's data: newer lists reach Satelit only through its inbox. Numbers only: these lists hold no names. Costs 1 credit.

Кредити: 1
: З ключем

Параметри

qstringобов'язковий

Слова для пошуку.

Можливі помилки

Спробувати

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

const res = await fetch("https://api.satelit.md/v1/citizenship/lookup", {
  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/citizenship/lookup",
    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/citizenship/lookup");
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"]);

Citizenship numbers

GET/v1/citizenship/stats

The backlog per article and per registration year, the dossiers solved per month (24 months up to the newest status list), the orders ANC signed per month, the median wait to the order (orders of the year before the newest) and to the oath, the registration months the newest orders solve, the estimate's basis, the newest orders. With `month`, the estimate for the dossiers filed then. Costs 2 credits.

Кредити: 2
: З ключем

Параметри

articlestring: 11, 10, 8, 8.1необов'язковий

Only this article of Romania's citizenship law: `11` (most dossiers), `10`, `8` or `8.1`.
monthstringнеобов'язковий

The month a dossier was filed, `YYYY-MM`: adds its estimate.

Можливі помилки

Спробувати

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

const res = await fetch("https://api.satelit.md/v1/citizenship/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/citizenship/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/citizenship/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"]);

Citizenship status lists

GET/v1/citizenship/years

Every status list ANC publishes, one per article and registration year: its dossiers, how many are solved, the day of its newest copy and its page. Costs 1 credit.

Кредити: 1
: З ключем

Параметри

Без параметрів.

Можливі помилки

Спробувати

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

const res = await fetch("https://api.satelit.md/v1/citizenship/years", {
  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/citizenship/years",
    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/citizenship/years");
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 status list

GET/v1/citizenship/years/{slug}

A status list (`11-2022`): its numbers, its registration months with their medians and estimates, the terms by month, the orders that solved it, and its dossiers by number a page at a time: `after` is the last `number` of the page before, `next` is null on the last page. Costs 2 credits per 200 rows.

Кредити: 2 за кожні 200 рядків
: З ключем

Параметри

slugstringобов'язковий

Назва рецепта з адреси.
afterintegerнеобов'язковийза замовчуванням 0

Звідки продовжити: останній отриманий meta.next.
limitintegerнеобов'язковийза замовчуванням 200

Рядків у відповіді, не більше 200.

Можливі помилки

Спробувати

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

const res = await fetch("https://api.satelit.md/v1/citizenship/years/{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/citizenship/years/{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/citizenship/years/{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"]);

Citizenship orders

GET/v1/citizenship/orders

ANC's orders newest first, of an article and a period: number, date, how many dossiers and persons, ANC's PDF and the order's page. `before` is the `next` of the page before. Costs 2 credits per 50 rows.

Кредити: 2 за кожні 50 рядків
: З ключем

Параметри

articlestring: 11, 10, 8, 8.1необов'язковий

Only this article of Romania's citizenship law: `11` (most dossiers), `10`, `8` or `8.1`.
fromstringнеобов'язковий

З цієї дати, YYYY-MM-DD.
tostringнеобов'язковий

До цієї дати, YYYY-MM-DD.
beforestringнеобов'язковий

The `next` of the page before.
limitintegerнеобов'язковийза замовчуванням 50

Рядків у відповіді, не більше 200.

Можливі помилки

Спробувати

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

const res = await fetch("https://api.satelit.md/v1/citizenship/orders", {
  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/citizenship/orders",
    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/citizenship/orders");
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 citizenship order

GET/v1/citizenship/orders/{order}

An order by its slug (`1054-p-2025`, the `slug` of `/citizenship/orders`; a number as people write it goes to `/citizenship/lookup?q=ordin 1054/P/2025`): its date and article, its dossiers by registration year and domicile (annex 1 abroad, 2 in Romania), the minors it names, ANC's PDF, and its rows in its own order a page at a time (`after` is the last `seq`). Costs 2 credits per 200 rows.

Кредити: 2 за кожні 200 рядків
: З ключем

Параметри

orderstringобов'язковий

The order's slug, such as `1054-p-2025`.
afterintegerнеобов'язковийза замовчуванням 0

Звідки продовжити: останній отриманий meta.next.
limitintegerнеобов'язковийза замовчуванням 200

Рядків у відповіді, не більше 200.

Можливі помилки

Спробувати

curl "https://api.satelit.md/v1/citizenship/orders/{order}" \
  -H "Authorization: Bearer $SATELIT_KEY"

const res = await fetch("https://api.satelit.md/v1/citizenship/orders/{order}", {
  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/citizenship/orders/{order}",
    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/citizenship/orders/{order}");
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"]);

Citizenship oath days

GET/v1/citizenship/oath

The oath days ANC published, the next ones and the last ones, with how many dossiers each invites and its table, and the median wait from registration and from the order to the oath. Costs 1 credit.

Кредити: 1
: З ключем

Параметри

Без параметрів.

Можливі помилки

Спробувати

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

const res = await fetch("https://api.satelit.md/v1/citizenship/oath", {
  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/citizenship/oath",
    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/citizenship/oath");
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"]);