How to get a list of fuel stations
This section provides an example of a request for a list of fuel stations within a specified geometry.
Note
This example uses a HERE API key to authenticate your request. For the available authentication options, see the Identity and Access Management Developer Guide.
User story
You want to obtain a list of fuel stations along a planned travel route.
Request Summary
Request
This code block demonstrates the complete request.
https://fuel.hereapi.com/v3/stations
?in=corridor:BF05xgKuy2xCx9B7vUl0OhnR54EqSzpEl-HxjD3pBiGnyGi2CvwFsgD3nD4vB6e;r=50
&apiKey=\{YOUR\_API\_KEY\}Response
The response to the request contains:
- a list of stations that fit the specified criteria with additional details
This is the example response in JSON format:
{
"total": 6,
"limit": 50,
"count": 6,
"stations": [
{
"id": "276u337p-0459b81bdc8744b98ffa193b96897e5e",
"modified": "2026-06-10T04:30:00.000Z",
"timeZone": "Europe/Berlin",
"name": "ARAL",
"brand": "Aral",
"brandIcon": "https://fuel.hereapi.com/static/brand/icon/48/generic.png",
"open24x7": true,
"address": {
"label": "Scharnweberstr. 12-13, Berlin, 13405",
"countryCode": "DEU",
"state": "Berlin",
"city": "Berlin",
"district": "Reinickendorf",
"street": "Scharnweberstr. 12-13",
"postalCode": "13405"
},
"contacts": {
"phones": [
{
"value": "+49304964005",
"label": "PHONE"
}
],
"faxes": [
{
"value": "+49304960435",
"label": "FAX"
}
]
},
"position": {
"lat": 52.563374,
"lng": 13.329887
},
"access": {
"lat": 52.56336,
"lng": 13.32981
},
"prices": [
{
"price": 2.029,
"fuelType": "55",
"unit": "l",
"currency": "EUR",
"modified": "2026-06-11T05:40:36.000Z"
},
{
"price": 1.759,
"fuelType": "1",
"unit": "l",
"currency": "EUR",
"modified": "2026-06-11T07:07:06.000Z"
},
{
"price": 2.169,
"fuelType": "40",
"unit": "l",
"currency": "EUR",
"modified": "2026-06-11T05:40:36.000Z"
},
{
"price": 1.869,
"fuelType": "53",
"unit": "l",
"currency": "EUR",
"modified": "2026-06-11T07:07:06.000Z"
},
{
"price": 1.809,
"fuelType": "54",
"unit": "l",
"currency": "EUR",
"modified": "2026-06-11T07:07:06.000Z"
}
],
"stationDetails": {
"openingHours": {
"regularSchedule": [
{
"days": [
"mo",
"tu",
"we",
"th",
"fr",
"sa",
"su"
],
"periods": [
{
"from": "00:00:00",
"to": "24:00:00"
}
]
}
]
},
"restrictedAccess": false,
"accessibilities": [
"Vertical clearance 4 m",
"Suitable for cars",
"Suitable for medium trucks",
"Suitable for large trucks"
]
}
]
}
For more details about responses to this type of request refer to Fuel Stations Response.