Historical Fuel Price API | South Africa Fuel Prices

The Historical Fuel Price API provides automated, developer-ready access to official South African petrol and diesel price history. Sourced directly from the Department of Mineral and Petroleum Resources (DMPR / DMRE) monthly pricing schedules, the API delivers structured JSON data covering inland and coastal fuel prices across all major fuel types—including 93 ULP, 95 ULP, 50ppm Diesel, and 500ppm Diesel. Built for developers, fleet managers, fintech platforms, and logistics companies, it eliminates manual spreadsheet updates by delivering reliable, programmatically accessible fuel tariff history for enterprise applications, financial auditing, and route cost modeling.

What Is the Historical Fuel Price API?

In South Africa, fuel prices are strictly regulated by the national government and adjusted on the first Wednesday of every month. These price decisions depend on international refined petroleum product prices, the Rand/US Dollar (ZAR/USD) exchange rate, and local levies such as the General Fuel Levy, RAF Levy, and Slate Levy. Because pricing differs between Inland regions (such as Gauteng) and Coastal ports (such as Cape Town and Durban) due to transport tariffs, tracking fuel trends programmatically requires a clean, structured data stream.

The Historical Fuel Price API translates complex, multi-year government fuel schedules into a RESTful JSON endpoint. Developers and enterprise systems can query historical data by date, region, and fuel type to analyze historical price trends, automate expense validation, or power consumer-facing calculators.

Key Features & Data Coverage

1. Comprehensive Fuel Grade Coverage

The API tracks every major regulated fuel type distributed across South African service stations:

Unleaded Petrol (93 ULP & 95 ULP): Official monthly retail pump prices.
Lead Replacement Petrol (93 LRP & 95 LRP): Historical schedules for legacy fuel categories.
Low-Sulfur Diesel (50ppm / 0.005%): Wholesale and indicator pricing for modern diesel engines and commercial transport.
Standard Diesel (500ppm / 0.05%): Commercial and agricultural wholesale prices.
Illuminating Paraffin: Maximum Single National Retail Price (SMNRP) historical data.

2. Regional Price Differentiation

Fuel pricing in South Africa is split into regional price zones:

Inland (Zone 9C / Gauteng / Reef): Factoring in pipeline and rail transport tariffs from coastal refineries.
Coastal (Cape Town, Port Elizabeth, East London, Durban): Base port pricing without inland transport surcharges.

3. Multi-Year Historical Archives

Access month-by-month fuel price records spanning back several years. Each record captures:

Effective Date: Exact date of the monthly price change.
Price Per Litre: Figures expressed in South African Rand (ZAR).
Month-on-Month Difference: Net increase or decrease in Rand and cents compared to the preceding period.
Region Indicator: Geographic zone tag (inland or coastal).

Technical Integration & Sample Payload

The Historical Fuel Price API follows standard REST principles, returning lightweight JSON payloads with HTTP status codes and API key header authentication.

Sample API JSON Response

JSON

{
  "status": "success",
  "data": {
    "effective_date": "2026-08-05",
    "region": "inland",
    "currency": "ZAR",
    "unit": "litre",
    "prices": {
      "petrol_93_ulp": 25.42,
      "petrol_95_ulp": 25.58,
      "diesel_50ppm": 26.90,
      "diesel_500ppm": 26.16,
      "illuminating_paraffin": 20.37
    },
    "adjustments": {
      "petrol_95_ulp_change": -0.52,
      "diesel_50ppm_change": 1.23
    }
  }
}

Key Technical Specs

Protocol: HTTPS RESTful JSON
Authentication: API Key via HTTP Header (X-API-Key)
Response Time: < 100ms average latency
Uptime Target: 99.9% availability
Client Compatibility: Python, Node.js, PHP, C# / .NET, Java, Go, cURL, and no-code tools (Zapier, Make).

Primary Business Use Cases

Fleet & Logistics Management

Commercial transport operators use historical fuel price data to reconcile fuel card transactions against official regulated rates for any past month. By referencing exact historical fuel tariffs, fleet managers can audit invoices, verify supplier surcharges, and compute precise cost-per-kilometer metrics across different routes.

ERP & Enterprise Financial Systems

Integrating the API directly into Enterprise Resource Planning (ERP) platforms allows finance teams to automate monthly fuel budget adjustments, perform historical cost-variance analyses, and streamline tax reporting without manual data entry.

Travel & Delivery Cost Calculators

Logistics platforms, courier service providers, and rideshare applications use the API to power real-time and historical trip calculators. Users can estimate route costs based on the exact fuel price active on the day of travel.

Financial Modeling & Economic Research

Analysts and researchers leverage multi-year fuel price datasets to model inflationary pressures, correlate fuel fluctuations with local commodity prices, and evaluate macro-economic trends in South Africa.

Frequently Asked Questions (FAQs)

1. How often is the Historical Fuel Price API updated?

The API is updated monthly, immediately following the official fuel price announcements by the Department of Mineral and Petroleum Resources (DMPR). New fuel prices in South Africa typically come into effect on the first Wednesday of every calendar month.

2. Does the API cover both Inland and Coastal fuel prices?

Yes. The API provides separate datasets for Inland (Gauteng / Reef) and Coastal regions, accounting for the official transport tariff differentials applied to petrol and diesel across South Africa.

3. What fuel types are included in the historical API endpoint?

The API dataset includes 93 Unleaded Petrol (ULP), 95 Unleaded Petrol (ULP), 50ppm Diesel, 500ppm Diesel, and Illuminating Paraffin. Historical records also cover legacy fuel grades such as Lead Replacement Petrol (LRP) where applicable.

4. How far back does the historical fuel price data go?

The API archive contains multi-year historical fuel price records, allowing developers and analysts to query month-by-month national pricing trends stretching back over several years.

5. What format is returned by the API?

The API returns responses in standard JSON format, formatted with clear key-value pairs representing effective dates, fuel grades, price per litre in Rand (ZAR), and month-on-month adjustments.

6. Can I use the Historical Fuel Price API in commercial applications?

Yes. Commercial licenses are available for businesses, SaaS platforms, fleet providers, and enterprise software systems needing automated fuel price data feeds.