Carburanti v1 / Carburanti

Module nomenclature

The products with their units and the countries in the series, each with the period it covers.

GET

https://oneapi.ro/api/carburanti/v1/produse

Query parameters

This route accepts no query parameters.

How it behaves

Fetch it once and map locally. This is the response that tells you which values are valid for produs and tara everywhere in the module.
in_litri says whether the product has a per-litre price. Fuel oil is published per tonne and cannot be converted — density is not a constant we may assume.
Country coverage is not uniform: Romania starts in 2008, most start in 2005, and the United Kingdom stops in 2020.
moneda_curenta is the currency of the country latest week. Older rows of a country that adopted the euro remain in the currency of that time.

What it is for

Populate a product or country dropdown with exactly the values the rest of the routes accept.
Find out when data starts for a country before requesting a series that would come back empty.
Check a product unit, so you do not ask for "per litre" where the price is per tonne.

Response structure

All fields below live inside data.

FieldTypeDescription

produse[].cod string Valoarea de folosit în parametrul produs.

produse[].denumire string Denumirea lizibilă.

produse[].unitate string 1000l sau t.

produse[].in_litri boolean Dacă produsul are preț pe litru.

tari[].cod string Valoarea de folosit în parametrul tara.

tari[].moneda_curenta string Moneda ultimei săptămâni raportate de țară.

tari[].prima_saptamana string Prima săptămână cu date.

tari[].ultima_saptamana string Ultima săptămână cu date.

tari[].inregistrari integer Câte rânduri de preț are țara în total.

pseudo_coduri[] array Codes that look like products but are not: total or metadata rows from the bulletin. They are listed so they are not mistaken for real products.

pseudo_coduri[].cod string EU sau EA.

pseudo_coduri[].denumire string Ce reprezintă pseudo-codul.

sursa object Sursa și licența.

Response examples

GEThttps://oneapi.ro/api/carburanti/v1/produse

{
    "data": {
        "produse": [
            {
                "cod": "benzina95",
                "denumire": "Benzină Euro-super 95",
                "unitate": "1000l",
                "in_litri": true
            }
        ],
        "tari": [
            {
                "cod": "AT",
                "moneda_curenta": "EUR",
                "prima_saptamana": "2005-01-03",
                "ultima_saptamana": "2026-09-14",
                "inregistrari": 4239
            }
        ],
        "pseudo_coduri": [
            {
                "cod": "EU",
                "denumire": "Media Uniunii Europene"
            }
        ],
        "sursa": {
            "nume": "European Commission — Weekly Oil Bulletin (DG ENER)",
            "licenta": "CC BY 4.0 (Decizia 2011/833/UE)",
            "observatie": "Prețuri medii naționale raportate de statele membre pentru săptămâna indicată, nu prețuri per stație de alimentare."
        }
    }
}

Error codes

Code	Slug	When it occurs
401	neautentificat	Token missing, invalid, expired or revoked.
403	feature_indisponibil	The current plan does not include the feature the route depends on.
422	validare	The route takes no parameters apart from `lang`: any other parameter returns 422 instead of being ignored.
429	cota_depasita	The 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."
    }
}