---
title: "Stations-service les moins chères autour d’un point ou dans une commune"
method: GET
path: "/v1/fuel/stations"
tags: ["B2B (v1)"]
---

# Stations-service les moins chères autour d’un point ou dans une commune

`GET /v1/fuel/stations`

## Request

- Base URL: `https://api.vitef.com`
- URL: `https://api.vitef.com/v1/fuel/stations`
- Auth: HTTP bearer

## Query parameters

- `fuel` 'gazole' | 'sp95-e10' | 'sp98' | 'e85' | 'gplc'
- `lat` number, nullable
- `lon` number, nullable
- `insee` string: Code commune INSEE (Lyon : 69123). Avec `lat`/`lon` (centre), élargit autour si la commune a moins de 3 stations.
- `radiusKm` number
- `sort` 'price' | 'distance': `price` : les moins chères d’abord, puis les plus proches.
- `limit` integer

## Response `200`

Stations

- FuelStations
  - `fuel` FuelRef, required
    - `slug` string, required
    - `code` string, required: Code du service commun (B7, SP95_E10, SP98, E85, GPL).
    - `label` string, required
  - `scope` 'nearby' | 'city' | 'around', required: `around` : commune avec trop peu de stations, recherche élargie autour de son centre.
  - `total` integer, required
  - `summary` object, nullable, required: Sur toutes les stations trouvées (100 au plus).
    - `count` integer, required
    - `avgCents` number, required: Centimes TTC par litre (une décimale possible : 240,5).
    - `medianCents` number, required: Centimes TTC par litre (une décimale possible : 240,5).
    - `minCents` number, required: Centimes TTC par litre (une décimale possible : 240,5).
    - `maxCents` number, required: Centimes TTC par litre (une décimale possible : 240,5).
  - `stations` FuelStation[], required
    - `id` string, required
    - `name` string, nullable, required: Nom publié, sinon l’enseigne ; `null` si inconnus.
    - `brand` string, nullable, required
    - `address` string, required
    - `postcode` string, required
    - `city` string, required
    - `insee` string, nullable, required
    - `department` string, nullable, required
    - `lat` number, required
    - `lon` number, required
    - `distanceM` number, nullable, required: Distance au point recherché, en mètres (recherche de proximité).
    - `prices` object[], required
      - `fuel` string, required
      - `cents` number, required: Centimes TTC par litre (une décimale possible : 240,5).
      - `updatedAt` string, required
    - `open24h` boolean, required: La station ne ferme jamais.
    - `automat24h` boolean, required: Pompe accessible à toute heure par carte bancaire.
    - `onHighway` boolean, required
    - `services` string[], required: LAVAGE, RESTAURATION, BOUTIQUE, DOUCHE, PARKING_PL.
    - `hours` object[], nullable, required
      - `day` integer, required: 1 = lundi … 7 = dimanche.
      - `closed` boolean, required
      - `ranges` string[], required
  - `source` string, required
  - `maxAgeDays` integer, required

## Other responses

- `400`: Requête invalide
- `401`: Authentification requise ou invalide
- `402`: Crédits ou paiement requis
- `403`: Accès refusé (`insufficient_scope`, `account_suspended`, `live_not_enabled`)
- `429`: Trop de requêtes
- `500`: Erreur interne
- `502`: Service partenaire en erreur

---

[API](https://skmtc.dev/vitef/apis/api-vitef.md) · [All operations](https://skmtc.dev/vitef/apis/api-vitef/llms.txt) · [OpenAPI document](https://skmtc.dev/vitef/apis/api-vitef/revisions/7bc459d9ef90?raw)