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: Gas Quebec public Health API
version: 1.6.0
summary: Live Quebec fuel prices (regular, premium, diesel) by station, city, and region.
description: 'Public, unauthenticated read API behind gasquebec.ca. All prices are in Canadian cents per litre (¢/L). Data is sourced from Régie Essence Québec (Régie de l''énergie du Québec) and must be attributed as: "Fuel-price data from Régie Essence Québec (Régie de l''énergie du Québec), presented by Gas Quebec (gasquebec.ca)". Wherever API data is displayed publicly (a website, an app''s public screens, a widget on a public page), that credit must include a visible link to https://www.gasquebec.ca/ or to the page of the city the data covers. Every data response carries a ready-to-use `attribution` field ({ url, text, html }, French and English) and a `Link: ; rel="describedby"` header. Copy-paste snippet: `Prix : Régie de l''énergie du Québec, via Gas Québec` (EN: `Prices: Régie de l''énergie du Québec, via Gas Quebec`). Private use (Home Assistant, personal widgets, scripts) is exempt from the link. Every endpoint is rate-limited to 120 requests/minute per IP and returns 429 with a Retry-After header when exceeded.'
termsOfService: https://www.gasquebec.ca/en/terms
contact:
url: https://www.gasquebec.ca/contact
license:
name: CC BY 4.0 (Gas Quebec original content only; underlying price facts remain subject to the Régie's terms)
url: https://creativecommons.org/licenses/by/4.0/
servers:
- url: https://www.gasquebec.ca
tags:
- name: Health
paths:
/api/health:
get:
operationId: getHealth
summary: API liveness/status
responses:
'200':
description: Service is up
content:
application/json:
schema:
type: object
properties:
status:
type: string
const: ok
service:
type: string
time:
type: string
format: date-time
tags:
- Health