API docs by Redocly

Check Petrol Fuel Reference Data API (1.0.0-preview.2)

Download OpenAPI specification:

Check Petrol API Support: tom@checkpetrol.com.au License: LicenseRef-CheckPetrol-Enterprise

AIP national TGP with GST, ATO Fuel Tax Credit and net values

Contract for Check Petrol's customer-safe Australian fuel data.

Reference data provides the Australian Institute of Petroleum (AIP) national average Terminal Gate Price (TGP), including and excluding GST; the ATO heavy vehicle Fuel Tax Credit (FTC) rate for the same period; and the net value (TGP excluding GST less FTC). Weekly and daily rows are available from 1 January 2024, as JSON or CSV.

TGP values are wholesale reference prices, not retail station averages. FTC values are official reference rates selected by date; Check Petrol does not assess eligibility or provide tax advice.

Environments

The sandbox serves the same contract, calculations and source data as production, with separate cp_test_ keys and no service-level commitment. Every response states its environment.

Methodology

Responses identify this methodology as cp-tgp-ftc-v1. All arithmetic uses base-10 decimals and rounds half-up.

  1. Daily TGP including GST is AIP's daily national average diesel TGP exactly as published (one decimal place). AIP calculates it as a volume-weighted average of capital-city terminal gate prices.
  2. Weekly TGP including GST is the mean of the daily values from Monday to Friday, rounded to one decimal place. The week is labelled by the Sunday it ends (week_ending), as in AIP's weekly reports. Any weekday AIP did not publish is listed in excluded_dates and never treated as zero. This reproduces the national average in AIP's Weekly Diesel Prices Report, which covers the same Monday to Friday.
  3. TGP excluding GST is TGP including GST divided by 1.1, rounded to two decimal places.
  4. FTC is the ATO rate for liquid fuels used in heavy vehicles travelling on public roads, in effect on each observation date. A weekly row uses the mean over its observation dates, rounded to two decimal places; rates_applied lists each rate period used.
  5. Net is TGP excluding GST minus FTC, with no further rounding, so the three published figures always reconcile.

A source correction recalculates the affected rows and increases their revision; earlier revisions are never presented as current.

Rate limits

Request limits are set per customer in the applicable service schedule. Every response reports the current window in RateLimit-* headers, and a 429 response includes Retry-After.

Compatibility

Within /v1, Check Petrol may add optional response properties, enum values, endpoints and optional query parameters. Clients must ignore unknown properties and tolerate unknown enum values. Removing or renaming a field, or changing its meaning, requires a new major version.

Reference data

AIP national TGP with GST, ATO Fuel Tax Credit and net values, plus FTC rate periods

Get weekly national TGP with GST, Fuel Tax Credit and net values

Returns one row per completed TGP week. Each row has the national average Terminal Gate Price including and excluding GST, the heavy vehicle Fuel Tax Credit for that week, and the net value (TGP excluding GST less FTC). The figures use the methodology described in the API overview.

Request a week in one of three ways:

  • No date parameters: the most recent completed week, which is the week ending on the most recent Sunday on or before today in Australia/Sydney. If that week is not yet published, the response is 503 DATA_NOT_READY with Retry-After. The API never returns an older week in its place.
  • week_ending: one specific week, identified by its Sunday.
  • from and to: every published week whose week_ending falls in the inclusive range. Use this for history and backfill.

Send Accept: text/csv to receive the same rows as CSV for bulk export. CSV columns match the JSON row fields, with observation_dates joined by ;.

Authorizations:
BearerApiKey
query Parameters
fuel_type
required
string (TgpFuelType)
Value: "diesel"

National TGP series. Further fuels may be added as new enum values.

week_ending
string <date>
Example: week_ending=2026-10-18

Sunday that ends the requested TGP week, following AIP's convention for labelling weekly reports. Cannot be combined with from or to. A date that is not a Sunday, or is after today in Australia/Sydney, is rejected with 400. A week before published coverage returns 404; a week not yet published returns 503.

from
string <date>
Example: from=2024-01-01

Inclusive start of a date range. Cannot be combined with week_ending or acquired_on. Rows outside published coverage are absent; a range that ends before coverage starts returns 404. A range spans at most 1,830 days.

to
string <date>
Example: to=2026-10-18

Inclusive end of the date range. Defaults to today in Australia/Sydney when from is sent. A future date is rejected with 400. Rows not yet published are absent; compare with coverage.

header Parameters
If-None-Match
string

ETag from a previous identical request.

Responses

Response samples

Content type
{
  • "schema_version": "1.0",
  • "request_id": "req_01K9ZB3F6M2Q8T4V7X1C5N9P0R",
  • "generated_at": "2026-10-19T03:12:44Z",
  • "environment": "production",
  • "fuel_type": "diesel",
  • "query": {
    },
  • "coverage": {
    },
  • "methodology": {
    },
  • "data": [
    ],
  • "sources": [],
  • "disclaimer": "Fuel Tax Credit values are official reference rates only; eligibility is not assessed and this response is not tax advice."
}

Get daily national TGP with GST, Fuel Tax Credit and net values

Returns one row per published AIP observation date in the inclusive from–to range. Weekends and any weekday without an AIP national value have no row; values are never filled or set to zero.

tgp_gst_inclusive is the AIP daily national average exactly as published. fuel_tax_credit is the heavy vehicle rate in effect on that date. Send Accept: text/csv for CSV.

Authorizations:
BearerApiKey
query Parameters
fuel_type
required
string (TgpFuelType)
Value: "diesel"

National TGP series. Further fuels may be added as new enum values.

from
required
string <date>
Example: from=2024-01-01

Inclusive start of the date range. Rows outside published coverage are absent; a range that ends before coverage starts returns 404. A range spans at most 1,830 days.

to
string <date>
Example: to=2026-10-18

Inclusive end of the date range. Defaults to today in Australia/Sydney when from is sent. A future date is rejected with 400. Rows not yet published are absent; compare with coverage.

header Parameters
If-None-Match
string

ETag from a previous identical request.

Responses

Response samples

Content type
{
  • "schema_version": "1.0",
  • "request_id": "req_01K9ZB4J1R7W3D5G8K2M6Q0T4V",
  • "generated_at": "2026-10-19T03:14:02Z",
  • "environment": "production",
  • "fuel_type": "diesel",
  • "query": {
    },
  • "coverage": {
    },
  • "methodology": {
    },
  • "data": [
    ],
  • "sources": [],
  • "disclaimer": "Fuel Tax Credit values are official reference rates only; eligibility is not assessed and this response is not tax advice."
}

Get Fuel Tax Credit rate periods by acquisition date or date range

Returns authoritative ATO Fuel Tax Credit rate periods. Send either acquired_on, for the rates in effect on one fuel acquisition date, or from and to, for every rate period that overlaps the inclusive range. Exactly one form is required; the request date is never used in place of an acquisition date.

Authorizations:
BearerApiKey
query Parameters
acquired_on
string <date>
Example: acquired_on=2026-10-15

Fuel acquisition date used to select the authoritative FTC effective period. Required unless from is sent; cannot be combined with from or to. A future date is rejected with 400, because rates for future dates are not authoritative until the ATO publishes them.

from
string <date>
Example: from=2024-01-01

Inclusive start of a date range. Cannot be combined with week_ending or acquired_on. Rows outside published coverage are absent; a range that ends before coverage starts returns 404. A range spans at most 1,830 days.

to
string <date>
Example: to=2026-10-18

Inclusive end of the date range. Defaults to today in Australia/Sydney when from is sent. A future date is rejected with 400. Rows not yet published are absent; compare with coverage.

use_categories
Array of strings (FtcUseCategory) unique
Items Enum: "heavy_vehicle_public_road" "other_business_use"

FTC use categories. Omit to return all rates effective on acquired_on.

header Parameters
If-None-Match
string

ETag from a previous identical request.

Responses

Response samples

Content type
application/json
{
  • "schema_version": "1.0",
  • "request_id": "string",
  • "generated_at": "2019-08-24T14:15:22Z",
  • "environment": "sandbox",
  • "data": {
    }
}