oneapi
Sign in
Energie v1 / Sistemul energetic (SEN)

Module nomenclature

The generation sources, the interconnection points and the sign conventions.

GET
https://oneapi.ro/api/energie/v1/sen/surse

Query parameters

This route accepts no query parameters.

How it behaves

  • Fetch it once and map locally.
  • conventii is the part to read carefully: it states why a negative balance means export, why wind can be negative, and what the renewable percentage is computed against.
  • The 7 generation sources and 24 interconnection points are fixed in the source structure. If Transelectrica adds a generation type, the import stops at the balance check rather than serving incomplete data.

What it is for

  • Populate legends and filters with exactly the codes the other routes return.
  • Learn what each quantity sign means before interpreting a figure.
  • Check data coverage before requesting a series that would come back empty.

Response structure

All fields below live inside data.

FieldTypeDescription
surse_de_productie[] array The nomenclature of generation sources, with the renewable flag.
surse_de_productie[].cod string Codul sursei, așa cum apare în răspunsurile celorlalte rute.
surse_de_productie[].denumire string Denumirea lizibilă.
surse_de_productie[].regenerabila boolean Dacă intră în ponderea regenerabilelor.
puncte_de_interconexiune[] array The nomenclature of interconnection points, each with its country.
puncte_de_interconexiune[].punct string Codul punctului.
puncte_de_interconexiune[].denumire string Denumirea stației.
puncte_de_interconexiune[].tara string Țara vecină.
conventii object What every sign and every percentage in this zone means — read them before interpreting a negative balance.
conventii.sold_mw string Ce înseamnă semnul soldului.
conventii.flux_mw string Ce înseamnă semnul unui flux pe interconexiune.
conventii.eolian_mw string De ce eolianul poate fi negativ.
conventii.regenerabil_procent string Pe ce numitor se calculează procentul.
acoperire object Aceeași structură ca la /sen/serie.
observatie string Avertismentul despre observații neechidistante.
sursa object The data source, with its licence and notes.
sursa.nume string Sursa datelor.
sursa.url string Pagina sursei.
sursa.observatie string Temeiul publicării și precizarea că sursa nu publică termeni de reutilizare pentru acest flux.

Response examples

GEThttps://oneapi.ro/api/energie/v1/sen/surse
{
    "data": {
        "surse_de_productie": [
            {
                "cod": "carbune_mw",
                "denumire": "Cărbune",
                "regenerabila": false
            }
        ],
        "puncte_de_interconexiune": [
            {
                "punct": "MUKA",
                "denumire": "Mukacevo",
                "tara": "UA"
            }
        ],
        "conventii": {
            "sold_mw": "Negativ = România exportă net, pozitiv = importă net.",
            "flux_mw": "Pozitiv = import în România prin acel punct, negativ = export.",
            "eolian_mw": "Poate fi negativ: pe vânt slab, parcurile consumă din rețea. Nu e eroare și nu se trunchiază la zero.",
            "regenerabil_procent": "Ponderea hidro + eolian + fotovoltaic + biomasă în suma surselor citite de noi, nu în producția raportată — ca să rămână coerent dacă sursa adaugă un tip de producție pe care încă nu-l mapăm."
        },
        "acoperire": {
            "observatii": 13,
            "prima": "2026-09-04 11: 59: 46+03",
            "ultima": "2026-09-04 12: 13: 29+03",
            "regenerabil_mediu_procent": 69.13,
            "productie_minima_mw": 5145,
            "productie_maxima_mw": 5258,
            "consum_minim_mw": 4713,
            "consum_maxim_mw": 4817
        },
        "observatie": "Seria e formată din OBSERVAȚII, la momente neechidistante — se acumulează când rulează importul, nu la interval fix. Mediile de aici sunt medii peste observații, nu medii în timp, și NU se pot converti în energie (MWh) fără o serie la pas constant. Pentru serii regulate și istoric, sursa potrivită e ENTSO-E.",
        "sursa": {
            "nume": "Transelectrica — harta operativă a Sistemului Energetic Național",
            "url": "https://www.transelectrica.ro/",
            "observatie": "Date de transparență publicate în temeiul Regulamentului (UE) 543/2013. Transelectrica nu publică termeni de reutilizare pentru acest flux."
        }
    }
}

Error codes

CodeSlugWhen it occurs
401neautentificatToken missing, invalid, expired or revoked.
403feature_indisponibilThe current plan does not include the feature the route depends on.
422validareThe route takes no parameters apart from lang: any other parameter returns 422 instead of being ignored.
429cota_depasitaThe plan's monthly quota has been exceeded (see Retry-After).

All errors share the same shape. eroare.cod is stable and is the value you should branch on in code — not the text in mesaj, which may change.

{
    "eroare": {
        "cod": "validare",
        "mesaj": "The route takes no parameters apart from lang: any other parameter returns 422 instead of being ignored."
    }
}