Financiar v1 / Calendar

Sărbătorile legale ale unui an

Lista zilelor de sărbătoare legală (art. 139 Codul Muncii), fiecare cu una sau mai multe
sărbători — două pot cădea în aceeaşi zi. Punţile stabilite prin hotărâre de Guvern sunt alt
instrument legal şi au rută proprie: /punti?an=.

GET

https://oneapi.ro/api/financiar/v1/sarbatori

Parametri de interogare

NumeTipDescriereValori acceptate

anopțional integer | null Opţional: anul, AAAA (1990–2100). Fără el, anul curent. 1990 – 2100

Cum se comportă

Sărbătorile legale ale unui an, potrivit art. 139 din Codul Muncii.
Lista e de ZILE, iar fiecare zi poartă una SAU MAI MULTE sărbători: două pot cădea în aceeaşi dată. În 2026, 1 iunie e simultan Ziua Copilului şi a doua zi de Rusalii — de aceea anul are 16 zile de sărbătoare, dar 17 sărbători.
Cele două numere din meta (zile şi sarbatori) diferă exact prin suprapuneri; diferenţa e informaţie, nu inconsecvenţă.
În România, sărbătorile care cad sâmbătă sau duminică NU se mută în ziua lucrătoare următoare. De aceea in_weekend contează: sunt zile libere pierdute. Cifra variază mult de la an la an — 4 în 2025, 5 în 2026, 8 în 2027.
Punţile stabilite prin hotărâre de Guvern NU sunt în acest răspuns: sunt alt instrument legal, cu altă sferă de aplicare, şi au rută proprie — /punti?an=.
Paştele ortodox se calculează, nu se citeşte din tabel. Pentru anii viitori lista e o proiecţie a legislaţiei actuale.

La ce folosește

Construirea unui calendar anual al zilelor nelucrătoare.
Planificarea concediilor şi a programului de lucru.
Numărarea zilelor libere efective dintr-un an.

Structura răspunsului

CâmpTipDescriere

data.an integer Anul la care se referă datele.

data.zile[].data string

data.zile[].zi_saptamana string Ziua săptămânii, cu 1 = luni.

data.zile[].zi_saptamana_iso integer

data.zile[].in_weekend boolean true dacă sărbătoarea cade sâmbătă sau duminică — caz în care nu se mută şi nu aduce o zi liberă în plus.

data.zile[].sarbatori[] string[] Una sau mai multe sărbători care cad în ziua respectivă.

meta.zile integer Numărul de zile distincte de sărbătoare.

meta.sarbatori integer Numărul de sărbători legale. Mai mare decât zile în anii cu suprapuneri.

meta.in_zile_lucratoare string Câte sărbători cad luni–vineri, adică aduc efectiv o zi liberă.

meta.in_weekend string Câte cad sâmbătă sau duminică, deci se pierd.

meta.temei string Temeiul legal al valorilor sau al modului de calcul.

meta.nota string Precizare despre cum se citesc datele din răspuns — o capcană, o convenţie sau o limită a sursei.

Exemple de răspuns

GEThttps://oneapi.ro/api/financiar/v1/sarbatori

{
    "data": {
        "an": 2026,
        "zile": [
            {
                "data": "2026-01-01",
                "zi_saptamana": "joi",
                "zi_saptamana_iso": 4,
                "in_weekend": false,
                "sarbatori": [
                    {
                        "cod": "anul_nou_1",
                        "denumire": "Anul Nou",
                        "mobila": false
                    }
                ]
            }
        ]
    },
    "meta": {
        "zile": 16,
        "sarbatori": 17,
        "in_zile_lucratoare": 11,
        "in_weekend": 5,
        "temei": "art. 139 Codul Muncii; Paştele ortodox calculat, nu tabelat.",
        "nota": "În România, sărbătorile care cad sâmbătă sau duminică NU se mută — cele 5 din weekend sunt zile libere pierdute în 2026."
    }
}

GEThttps://oneapi.ro/api/financiar/v1/sarbatori?an=2027

{
    "data": {
        "an": 2027,
        "zile": [
            {
                "data": "2027-01-01",
                "zi_saptamana": "vineri",
                "zi_saptamana_iso": 5,
                "in_weekend": false,
                "sarbatori": [
                    {
                        "cod": "anul_nou_1",
                        "denumire": "Anul Nou",
                        "mobila": false
                    }
                ]
            }
        ]
    },
    "meta": {
        "zile": 17,
        "sarbatori": 17,
        "in_zile_lucratoare": 9,
        "in_weekend": 8,
        "temei": "art. 139 Codul Muncii; Paştele ortodox calculat, nu tabelat.",
        "nota": "În România, sărbătorile care cad sâmbătă sau duminică NU se mută — cele 8 din weekend sunt zile libere pierdute în 2027."
    }
}

GEThttps://oneapi.ro/api/financiar/v1/sarbatori?an=2024

{
    "data": {
        "an": 2024,
        "zile": [
            {
                "data": "2024-01-01",
                "zi_saptamana": "luni",
                "zi_saptamana_iso": 1,
                "in_weekend": false,
                "sarbatori": [
                    {
                        "cod": "anul_nou_1",
                        "denumire": "Anul Nou",
                        "mobila": false
                    }
                ]
            }
        ]
    },
    "meta": {
        "zile": 17,
        "sarbatori": 17,
        "in_zile_lucratoare": 10,
        "in_weekend": 7,
        "temei": "art. 139 Codul Muncii; Paştele ortodox calculat, nu tabelat.",
        "nota": "În România, sărbătorile care cad sâmbătă sau duminică NU se mută — cele 7 din weekend sunt zile libere pierdute în 2024."
    }
}

Coduri de eroare

Cod	Slug	Când apare
401	neautentificat	Token lipsă, invalid, expirat sau revocat.
403	feature_indisponibil	Planul curent nu include funcţia de care ţine ruta.
422	validare	An în afara intervalului 1990–2100 ori scris altfel decât cu 4 cifre.
429	cota_depasita	Cota lunară a planului a fost depăşită (vezi `Retry-After`).

Toate erorile au aceeași formă. eroare.cod e stabil și e cel după care trebuie să ramifici în cod — nu după textul din mesaj, care se poate schimba.

{
    "eroare": {
        "cod": "validare",
        "mesaj": "An în afara intervalului 1990–2100 ori scris altfel decât cu 4 cifre.",
        "detalii": {
            "an": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}