Гражданство Румынии: справочник 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"]);