Prices

Get current fuel price summaries without fetching every city or station and aggregating the data yourself.

Testing only. The Prices endpoints are still in active development and are not ready for production use. If you would like to test them, please contact us with your use case and feedback. We will let you know when they are production-ready.

The prices endpoints answer market-level fuel price questions. Use city, station, state, and fuel type endpoints when you need the resources themselves.

Common filters

Name
state
Type
string
Description
Filter by state id, such as wa, nsw, vic, or qld.
Name
city
Type
string
Description
Filter by city id, such as perth, sydney, or melbourne.
Name
fuel
Type
string
Description
Filter by fuel type id, such as ulp91, diesel, or lpg.
Name
limit
Type
integer
Description
Limit ranked results for cheapest and highest price endpoints.

Use either state or city, not both. The fuel filter can be combined with either geographic filter.

GET/v1/prices

Get current price summaries

Returns current aggregate price summaries for available fuel types. Use this when you need average, minimum, maximum, and range values for Australia, a state, or a city.

Optional attributes

Name
state
Type
string
Description
Return price summaries for a state.
Name
city
Type
string
Description
Return price summaries for a city.
Name
fuel
Type
string
Description
Return a summary for one fuel type.

Request

GET

/v1/prices

curl -G https://api.fuelprice.io/v1/prices \
  -H "Authorization: Bearer {token}" \
  -d state=wa \
  -d fuel=diesel

Response

{
"data": {
"scope": "state",
"state": "wa",
"currency": "AUD",
"unit": "per_litre",
"fuel_types": [
  {
    "id": "diesel",
    "name": "Diesel",
    "average": 1.821,
    "min": 1.699,
    "max": 2.099,
    "range": 0.4
  }
],
"updated_at": "2026-04-17T14:30:00Z"
}
}

GET/v1/prices/availability

Get fuel availability

Returns unavailable fuel counts for the selected scope. Use this when you need to know how much fuel data is unavailable in Australia, a state, or a city.

Optional attributes

Name
state
Type
string
Description
Return availability for a state.
Name
city
Type
string
Description
Return availability for a city.
Name
fuel
Type
string
Description
Return availability for one fuel type.

Request

GET

/v1/prices/availability

curl -G https://api.fuelprice.io/v1/prices/availability \
  -H "Authorization: Bearer {token}" \
  -d state=wa \
  -d fuel=diesel

Response

{
"data": {
"scope": "state",
"state": "wa",
"fuel_types": [
  {
    "id": "diesel",
    "name": "Diesel",
    "unavailable_count": 43
  }
],
"updated_at": "2026-04-17T14:30:00Z"
}
}

GET/v1/prices/cheapest

Get cheapest prices

Returns the cheapest current prices for a fuel type. Use this when you need the lowest priced stations for Australia, a state, or a city.

Attributes

Name
fuel
Type
string
Description
Required. Fuel type id, such as ulp91 or diesel.
Name
state
Type
string
Description
Return cheapest prices for a state.
Name
city
Type
string
Description
Return cheapest prices for a city.
Name
limit
Type
integer
Description
Limit the number of returned results.

Request

GET

/v1/prices/cheapest

curl -G https://api.fuelprice.io/v1/prices/cheapest \
  -H "Authorization: Bearer {token}" \
  -d state=wa \
  -d fuel=diesel \
  -d limit=10

Response

{
"data": [
{
  "station_id": "example-station",
  "station_name": "Example Station",
  "suburb": "Perth",
  "state": "wa",
  "fuel": "diesel",
  "price": 1.699,
  "updated_at": "2026-04-17T14:30:00Z"
}
],
"total_items": 10
}

GET/v1/prices/highest

Get highest prices

Returns the highest current prices for a fuel type. Use this when you need the most expensive stations for Australia, a state, or a city.

Attributes

Name
fuel
Type
string
Description
Required. Fuel type id, such as ulp91 or diesel.
Name
state
Type
string
Description
Return highest prices for a state.
Name
city
Type
string
Description
Return highest prices for a city.
Name
limit
Type
integer
Description
Limit the number of returned results.

Request

GET

/v1/prices/highest

curl -G https://api.fuelprice.io/v1/prices/highest \
  -H "Authorization: Bearer {token}" \
  -d state=wa \
  -d fuel=diesel \
  -d limit=10

Response

{
"data": [
{
  "station_id": "example-station",
  "station_name": "Example Station",
  "suburb": "Perth",
  "state": "wa",
  "fuel": "diesel",
  "price": 2.099,
  "updated_at": "2026-04-17T14:30:00Z"
}
],
"total_items": 10
}

Future price history

Historical aggregate price data is planned for a future endpoint.

GET /v1/prices/history

This should only be released once aggregate price snapshots are stored, so date range requests can stay fast and predictable.