Zum Inhalt springen
Floweet
Profi-Zugang

Fuel stations

Fuel stations in France and Europe: price per fuel, services, opening hours, heavy vehicle access, and the ten cheapest stations of a department.

api.floweet.com/v1 · Contract 1.0.0-beta.1 · Beta

This documentation is written in English and French; it is shown to you in English.

Sections · Fuel stations
On this page
  1. Good to know
  2. Source and reuse
  3. The FuelStation object
  4. The FuelPrice object
  5. The CheapestStations object
  6. The FuelStationDetail object
  7. List fuel stations, filtered and sorted by name
  8. The 10 cheapest diesel stations of a French department
  9. A fuel station: brand, prices, fuels, services, opening hours

Fuel stations in France and the other markets Floweet follows (Germany, Spain, Italy): brand, address, fuels sold with the latest price of each, services, opening hours and heavy vehicle access. A third operation gives, for a French department, the ten stations where diesel is cheapest.

Good to know

  • prices is a dictionary keyed by fuel code (B7, SP95_E10, SP98, E85, GPL…): each entry holds its price in thousandths of a euro per liter and its update time. Check updatedAt: a station that stops reporting keeps its last known price.
  • The cheapest stations of a department: diesel (B7) only, prices less than 7 days old, motorway stations included and flagged by highway. Filter them out on your side if you compare town stations.
  • brand is the canonical brand, the same as in the barometer; null when no brand is recognized.
  • Listing stations and reading one need the Stations module in the organization's plan; otherwise 403 plan_required (see plans and AI).

Source and reuse

France: prix-carburants.gouv.fr (Licence Ouverte 2.0). Published prices are pump prices, before card discounts and fees.

The FuelStation object

FieldTypeDescription
idalways presentstring (uuid)
namealways presentstring
brandalways presentstring | null
cityalways presentstring | null
postalCodealways presentstring | null
countryalways presentstring
fuelsalways presentstring[]
servicesalways presentstring[]
open24halways presentboolean
pricesalways present{ [code]: FuelPrice }Latest price per fuel code.
FuelStation
{
  "id": "28898708-4170-48bb-a3f5-e9b0d5d7ee53",
  "name": "Carrefour",
  "brand": "Carrefour",
  "city": "Rambouillet",
  "postalCode": "78120",
  "country": "FR",
  "fuels": [
    "B7",
    "GPL",
    "SP95",
    "SP95_E10",
    "SP98"
  ],
  "services": [],
  "open24h": true,
  "prices": {
    "B7": {
      "price": 2409,
      "updatedAt": "2026-10-24T20:51:00+00:00"
    },
    "GPL": {
      "price": 1102,
      "updatedAt": "2026-10-24T20:51:00+00:00"
    },
    "SP95": {
      "price": 2159,
      "updatedAt": "2026-10-24T20:51:00+00:00"
    },
    "SP98": {
      "price": 2225,
      "updatedAt": "2026-10-24T20:51:00+00:00"
    },
    "SP95_E10": {
      "price": 2119,
      "updatedAt": "2026-10-24T20:51:00+00:00"
    }
  }
}

The FuelPrice object

FieldTypeDescription
pricealways presentintegerPrice in thousandths of a euro per liter (2372 = 2.372 €/L).
updatedAtalways presentstring (date-time) | null
FuelPrice
{
  "price": 2409,
  "updatedAt": "2026-10-24T20:51:00+00:00"
}

The CheapestStations object

The 10 cheapest stations of the department for diesel (B7), prices less than 7 days old.

FieldTypeDescription
resultsalways presentobject[]
results[].idalways presentstring
results[].namealways presentstring
results[].addressalways presentstring
results[].cityalways presentstring | null
results[].brandalways presentstring
results[].pricealways presentintegerPrice in thousandths of a euro per liter (2372 = 2.372 €/L).
results[].highwayalways presentboolean
results[].updatedAtalways presentstring (date-time)
CheapestStations
{
  "results": [
    {
      "id": "1852fb61-66f7-4ac0-b4a9-06efc51f883b",
      "name": "Total",
      "address": "RD.191",
      "city": "Beynes",
      "brand": "TotalEnergies",
      "price": 2225,
      "highway": false,
      "updatedAt": "2026-10-23T08:57:14+00:00"
    },
    {
      "id": "e7bb4a93-8afb-4ee3-af40-3d68ce746be7",
      "name": "MORAINVILLIERS",
      "address": "AUTOROUTE A13 - AIRE DE MORAINVILLIERS SUD",
      "city": "MORAINVILLIERS",
      "brand": "Indépendants et autres",
      "price": 2250,
      "highway": true,
      "updatedAt": "2026-10-25T23:01:00+00:00"
    },
    {
      "id": "0531352a-266d-4207-9da1-50b577aebe86",
      "name": "Relais de Guyancourt",
      "address": "10 AV DE L'EUROPE",
      "city": "Guyancourt",
      "brand": "TotalEnergies",
      "price": 2250,
      "highway": false,
      "updatedAt": "2026-10-25T23:01:00+00:00"
    }
  ]
}

The FuelStationDetail object

FieldTypeDescription
idalways presentstring (uuid)
namealways presentstring
brandalways presentstring | null
cityalways presentstring | null
postalCodealways presentstring | null
countryalways presentstring
fuelsalways presentstring[]
servicesalways presentstring[]
open24halways presentboolean
pricesalways present{ [code]: FuelPrice }Latest price per fuel code.
addressalways presentstring | null
locationalways presentobject
location.latalways presentnumber
location.lngalways presentnumber
heavyVehicleAccessalways presentboolean
openingHoursoptionalanyOpening hours as declared in the official French feed (days, always_open).
FuelStationDetail
{
  "id": "28898708-4170-48bb-a3f5-e9b0d5d7ee53",
  "name": "Carrefour",
  "brand": "Carrefour",
  "city": "Rambouillet",
  "postalCode": "78120",
  "country": "FR",
  "fuels": [
    "B7",
    "GPL",
    "SP95",
    "SP95_E10",
    "SP98"
  ],
  "services": [],
  "open24h": true,
  "prices": {
    "B7": {
      "price": 2409,
      "updatedAt": "2026-10-24T20:51:00+00:00"
    },
    "GPL": {
      "price": 1102,
      "updatedAt": "2026-10-24T20:51:00+00:00"
    },
    "SP95": {
      "price": 2159,
      "updatedAt": "2026-10-24T20:51:00+00:00"
    },
    "SP98": {
      "price": 2225,
      "updatedAt": "2026-10-24T20:51:00+00:00"
    },
    "SP95_E10": {
      "price": 2119,
      "updatedAt": "2026-10-24T20:51:00+00:00"
    }
  },
  "address": "RN10 CENTRE COMMERCIAL DU BEL AIR",
  "location": {
    "lat": 48.6250208716154,
    "lng": 1.82953830436914
  },
  "heavyVehicleAccess": false,
  "openingHours": {}
}

List fuel stations, filtered and sorted by name

GET/v1/fuel-stationsScope fuel-stations:read

Parameters

FieldInTypeDescription
limitoptionalqueryintegerfrom 1 to 100 · default 20Number of items per page (1 to 100, 20 by default).
cursoroptionalquerystringat most 400 charactersOpaque cursor: the nextCursor value of the previous page.
qoptionalquerystringat most 100 charactersName or city (contains).
fuelsoptionalquerystringComma-separated fuel codes (B7, SP95_E10, SP98, E85, GPL, GNV…).
servicesoptionalquerystringComma-separated service codes.
open24hoptionalquerystringtrue: open 24/7 only.
countryoptionalquerystringISO 3166-1 alpha-2 country code (FR, DE, ES, IT). Absent: all countries.

Response 200

OK — A page of FuelStation { data, nextCursor, hasMore }

Errors

HTTPMeaning
400Invalid request
401Missing, invalid or revoked API key
403Forbidden (scope, plan or account status)
404Resource not found
429Too many requests
500Internal error
Request
curl "https://api.floweet.com/v1/fuel-stations?fuels=B7%2CE85&country=FR" \
  -H "Authorization: Bearer $FLOWEET_API_KEY"
Response 200
{
  "data": [
    {
      "id": "28898708-4170-48bb-a3f5-e9b0d5d7ee53",
      "name": "Carrefour",
      "brand": "Carrefour",
      "city": "Rambouillet",
      "postalCode": "78120",
      "country": "FR",
      "fuels": [
        "B7",
        "GPL",
        "SP95",
        "SP95_E10",
        "SP98"
      ],
      "services": [],
      "open24h": true,
      "prices": {
        "B7": {
          "price": 2409,
          "updatedAt": "2026-10-24T20:51:00+00:00"
        },
        "GPL": {
          "price": 1102,
          "updatedAt": "2026-10-24T20:51:00+00:00"
        },
        "SP95": {
          "price": 2159,
          "updatedAt": "2026-10-24T20:51:00+00:00"
        },
        "SP98": {
          "price": 2225,
          "updatedAt": "2026-10-24T20:51:00+00:00"
        },
        "SP95_E10": {
          "price": 2119,
          "updatedAt": "2026-10-24T20:51:00+00:00"
        }
      }
    }
  ],
  "nextCursor": "eyJwIjoyLCJzIjoxfQ",
  "hasMore": true
}

The 10 cheapest diesel stations of a French department

GET/v1/fuel-stations/cheapestScope fuel-stations:read

Parameters

FieldInTypeDescription
departmentrequiredquerystringFrench department code (01 to 95, 2A, 2B).

Response 200

OK — A CheapestStations object

Errors

HTTPMeaning
400Invalid request
401Missing, invalid or revoked API key
403Forbidden (scope, plan or account status)
404Resource not found
429Too many requests
500Internal error
Request
curl "https://api.floweet.com/v1/fuel-stations/cheapest?department=78" \
  -H "Authorization: Bearer $FLOWEET_API_KEY"
Response 200
{
  "results": [
    {
      "id": "1852fb61-66f7-4ac0-b4a9-06efc51f883b",
      "name": "Total",
      "address": "RD.191",
      "city": "Beynes",
      "brand": "TotalEnergies",
      "price": 2225,
      "highway": false,
      "updatedAt": "2026-10-23T08:57:14+00:00"
    },
    {
      "id": "e7bb4a93-8afb-4ee3-af40-3d68ce746be7",
      "name": "MORAINVILLIERS",
      "address": "AUTOROUTE A13 - AIRE DE MORAINVILLIERS SUD",
      "city": "MORAINVILLIERS",
      "brand": "Indépendants et autres",
      "price": 2250,
      "highway": true,
      "updatedAt": "2026-10-25T23:01:00+00:00"
    },
    {
      "id": "0531352a-266d-4207-9da1-50b577aebe86",
      "name": "Relais de Guyancourt",
      "address": "10 AV DE L'EUROPE",
      "city": "Guyancourt",
      "brand": "TotalEnergies",
      "price": 2250,
      "highway": false,
      "updatedAt": "2026-10-25T23:01:00+00:00"
    }
  ]
}

A fuel station: brand, prices, fuels, services, opening hours

GET/v1/fuel-stations/{id}Scope fuel-stations:read

Parameters

FieldInTypeDescription
idrequiredpathstring (uuid)

Response 200

OK — A FuelStationDetail object

Errors

HTTPMeaning
400Invalid request
401Missing, invalid or revoked API key
403Forbidden (scope, plan or account status)
404Resource not found
429Too many requests
500Internal error
Request
curl "https://api.floweet.com/v1/fuel-stations/7d0c1f8e-2a4b-4c6d-9e8f-0a1b2c3d4e5f" \
  -H "Authorization: Bearer $FLOWEET_API_KEY"
Response 200
{
  "id": "28898708-4170-48bb-a3f5-e9b0d5d7ee53",
  "name": "Carrefour",
  "brand": "Carrefour",
  "city": "Rambouillet",
  "postalCode": "78120",
  "country": "FR",
  "fuels": [
    "B7",
    "GPL",
    "SP95",
    "SP95_E10",
    "SP98"
  ],
  "services": [],
  "open24h": true,
  "prices": {
    "B7": {
      "price": 2409,
      "updatedAt": "2026-10-24T20:51:00+00:00"
    },
    "GPL": {
      "price": 1102,
      "updatedAt": "2026-10-24T20:51:00+00:00"
    },
    "SP95": {
      "price": 2159,
      "updatedAt": "2026-10-24T20:51:00+00:00"
    },
    "SP98": {
      "price": 2225,
      "updatedAt": "2026-10-24T20:51:00+00:00"
    },
    "SP95_E10": {
      "price": 2119,
      "updatedAt": "2026-10-24T20:51:00+00:00"
    }
  },
  "address": "RN10 CENTRE COMMERCIAL DU BEL AIR",
  "location": {
    "lat": 48.6250208716154,
    "lng": 1.82953830436914
  },
  "heavyVehicleAccess": false,
  "openingHours": {}
}