Cetățenie română: referință API, rute și exemple

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.

Credite: 1
: Cu cheie

Parametri

qstringobligatoriu

Cuvinte de căutat.

Erori posibile

Încearcă

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.

Credite: 2
: Cu cheie

Parametri

articlestring: 11, 10, 8, 8.1opțional

Only this article of Romania's citizenship law: `11` (most dossiers), `10`, `8` or `8.1`.
monthstringopțional

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

Erori posibile

Încearcă

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.

Credite: 1
: Cu cheie

Parametri

Fără parametri.

Erori posibile

Încearcă

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.

Credite: 2 pentru fiecare 200 rânduri
: Cu cheie

Parametri

slugstringobligatoriu

Numele rețetei din adresă.
afterintegeropționalimplicit 0

De unde continui: ultimul meta.next primit.
limitintegeropționalimplicit 200

Câte rânduri pe răspuns, cel mult 200.

Erori posibile

Încearcă

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.

Credite: 2 pentru fiecare 50 rânduri
: Cu cheie

Parametri

articlestring: 11, 10, 8, 8.1opțional

Only this article of Romania's citizenship law: `11` (most dossiers), `10`, `8` or `8.1`.
fromstringopțional

De la această dată, YYYY-MM-DD.
tostringopțional

Până la această dată, YYYY-MM-DD.
beforestringopțional

The `next` of the page before.
limitintegeropționalimplicit 50

Câte rânduri pe răspuns, cel mult 200.

Erori posibile

Încearcă

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.

Credite: 2 pentru fiecare 200 rânduri
: Cu cheie

Parametri

orderstringobligatoriu

The order's slug, such as `1054-p-2025`.
afterintegeropționalimplicit 0

De unde continui: ultimul meta.next primit.
limitintegeropționalimplicit 200

Câte rânduri pe răspuns, cel mult 200.

Erori posibile

Încearcă

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.

Credite: 1
: Cu cheie

Parametri

Fără parametri.

Erori posibile

Încearcă

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"]);