Legacy feed

GET /legacy

GET

/legacy

This route retains a JSON wrapper around validated RSS-shaped records. New consumers should use /v1.

Differences from /v1

Convention	Legacy behavior
Envelope	A `LegacyDocument` object containing `feed`, not a JSON:API document.
Default product	`1` (Unleaded) unless `product` is supplied.
Station fields	Hyphenated RSS fields and string prices/coordinates.
Enrichment	No provider fields or normalized station enrichment.
Expansion	`expand` is rejected, even when empty.

Complete legacy response

Captured 2026-09-30T11:42:44.733+08:00 (AWST) · HTTP 200. Historical snapshot; repeat the request for current data.

Request

curl 'https://fuelwatch.oss.bhodges.me/legacy?product=1&brand=32&suburb=PERTH%20AIRPORT&surrounding=no' \
  -H 'Accept: application/json'

Example response

{
  "feed": {
    "title": "FuelWatch Prices For PERTH AIRPORT",
    "link": "https://www.fuelwatch.wa.gov.au/",
    "description": "30/09/2026 - PERTH AIRPORT",
    "language": "en-us",
    "copyright": "Copyright 2025 FuelWatch. All Rights Reserved.",
    "lastBuildDate": "Wed, 30 Sep 2026 11:42:44 +0800",
    "ttl": "168",
    "image": {
      "url": "/fuelwatch/art/fuelwatch-logo.gif",
      "title": "FuelWatch",
      "link": "https://www.fuelwatch.wa.gov.au"
    },
    "items": [
      {
        "title": "218.7: Costco Perth Airport",
        "description": "Address: 142 Dunreath Dr, PERTH AIRPORT, Phone: (08) 9311 4700, Site features: EFTPOS, Open Mon: 06:00-21:30, Tue: 06:00-21:30, Wed: 06:00-21:30, Thu: 06:00-21:30, Fri: 06:00-21:30, Sat: 06:00-19:30, Sun: 07:00-19:00",
        "brand": "Costco",
        "date": "2026-09-30",
        "price": "218.7",
        "trading-name": "Costco Perth Airport",
        "location": "PERTH AIRPORT",
        "address": "142 Dunreath Dr",
        "phone": "+61893114700",
        "latitude": "-31.94037700",
        "longitude": "115.95186900",
        "site-features": "EFTPOS, Open Mon: 06:00-21:30, Tue: 06:00-21:30, Wed: 06:00-21:30, Thu: 06:00-21:30, Fri: 06:00-21:30, Sat: 06:00-19:30, Sun: 07:00-19:00",
        "restrictions": "Membership Required;",
        "content": "Address: 142 Dunreath Dr, PERTH AIRPORT, Phone: (08) 9311 4700, Site features: EFTPOS, Open Mon: 06:00-21:30, Tue: 06:00-21:30, Wed: 06:00-21:30, Thu: 06:00-21:30, Fri: 06:00-21:30, Sat: 06:00-19:30, Sun: 07:00-19:00",
        "contentSnippet": "Address: 142 Dunreath Dr, PERTH AIRPORT, Phone: (08) 9311 4700, Site features: EFTPOS, Open Mon: 06:00-21:30, Tue: 06:00-21:30, Wed: 06:00-21:30, Thu: 06:00-21:30, Fri: 06:00-21:30, Sat: 06:00-19:30, Sun: 07:00-19:00",
        "isoDate": "2026-09-30T00:00:00.000Z"
      }
    ]
  }
}

This is the full production response, including channel metadata and parser fields. Source descriptions/features may contain combined free text. Source/parser field presence is retained rather than expanded into the normalized DTO. Phone values are normalized to E.164 or null. The legacy parser's isoDate remains in UTC, unlike the normalized /v1 timestamps.

The six filters and their aliases work here too, but every query uses source-filtered selection and the 24-combination limit. Multi-product results contain separate station/product items with a numeric product marker; a single-product response omits that marker.

The content type is application/json;charset=UTF-8. This route does not apply /v1 JSON:API media negotiation. Success metadata is not the /v1 meta object; source-date/fetch headers remain available. Caching, ETags and HEAD work with a separate representation cache.

Errors contain an error object with code and message and use no-store. Do not deserialize them as JSON:API errors.

Migration to /v1

Read data[].attributes instead of feed.items[]; select a product explicitly if you previously relied on unleaded being the default. Read numeric price.products["1"], numeric coordinates and camelCase fields. Adopt compact codes or request expansion. Preserve source-date/validity checks and optional provider attribution.

No removal date for /legacy is declared by this source.

GET /legacy

Differences from /v1

Migration to /v1

On this page