Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
openapi: 3.2.0
info:
title: Fuelazores Com Prices API
version: 1.0.0
contact:
name: FuelAzores
email: hello@perf.website
url: https://www.fuelazores.com/developers
license:
name: CC BY 4.0
url: https://creativecommons.org/licenses/by/4.0/
description: 'Operations tagged Prices across 2 of this provider''s published API definitions: fuelazores-com.json, fuelazores-com-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://www.fuelazores.com
security: []
tags:
- name: Prices
paths:
/api/v1/prices:
get:
operationId: get_fuel_prices
summary: Official fuel prices
description: Read the latest verified and confirmed upcoming official maximum fuel prices, effective dates, review/freshness status, and sources. Optionally choose a region and fuel.
parameters:
- name: region
in: query
required: false
schema:
type: string
enum:
- azores
- madeira
description: Region whose official maximum prices to read.
- name: fuel
in: query
required: false
schema:
type: string
enum:
- petrol95
- diesel
- agriculturalDiesel
- fishingDiesel
- marineDiesel
- markedDiesel
description: Exact regulated fuel category. Specialist fuels are not interchangeable with road diesel.
- name: format
in: query
required: false
schema:
type: string
enum:
- json
- csv
- markdown
default: json
responses:
'200':
description: Public data. Inspect freshness, coverage and review state before citing prices.
content:
application/json:
schema:
type: object
required:
- license
properties:
license:
type: object
description: Data license and the attribution to give when reusing the data.
required:
- name
- url
- attribution
properties:
name:
type: string
const: CC BY 4.0
url:
type: string
format: uri
const: https://creativecommons.org/licenses/by/4.0/
attribution:
type: string
const: FuelAzores (www.fuelazores.com)
text/csv:
schema:
type: string
text/markdown:
schema:
type: string
'400':
description: Invalid, unsupported, unknown or repeated parameters.
'404':
description: No matching article.
'429':
description: 'Shared dynamic-route limit: 120 requests/minute/IP per edge region. Honor Retry-After if present; otherwise wait at least 60 seconds. Edge response may be plain text.'
'503':
description: Upstream unavailable; retry after 60 seconds. No substitute prices are returned.
tags:
- Prices
servers:
- url: https://www.fuelazores.com
x-refined-from:
- fuelazores-com.json
- fuelazores-com-openapi.json
x-provenance:
method: harvested
publisher: FuelAzores
source: https://fuelazores.com/openapi.json
note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json);
stamped by stamp-openapi-provenance.py (roadmap#793)