South African fuel price data is strictly regulated, updating on the first Wednesday of every calendar month based on official government gazettes. For developers, fleet managers, analysts, and enterprise platforms building financial systems or logistics software, integrating accurate fuel figures requires a reliable, well-structured data feed.
This fuel price API documentation hub provides technical specifications, schema definitions, coverage details, and methodology guidelines for accessing verified South African petrol, diesel, and paraffin pricing datasets. Whether you are seeking direct programmatic integration via our fuel price data API or evaluating data fields for custom applications, this guide covers the core structures needed to query and process official fuel metrics.
Fuel Price API Documentation Overview
South Africa operates under a regulated fuel pricing model administered by the Department of Mineral Resources and Energy (DMRE) / Department of Mineral Resources and Petroleum (DMPR). Retail petrol prices are fixed by law across specific magisterial zones, whereas wholesale diesel prices serve as maximum indicators before retail markup.
Because retail petrol prices are uniform within designated geographic zones, developers do not need station-level web scraping for official fuel rates. Instead, applications rely on standardized monthly gazetted rates and daily Basic Fuel Price (BFP) over/under-recovery indicators released by the Central Energy Fund (CEF).
Current Official Benchmark Context
- Primary Fuel Grades: 93 Unleaded Petrol (ULP), 95 Unleaded Petrol (ULP), Diesel 50ppm, Diesel 500ppm, Illuminating Paraffin.
- Geographic Zones: Inland (e.g., Gauteng, Zone 9C benchmark) vs. Coastal (e.g., Western Cape/KZN, Zone 1A benchmark).
- Official Benchmark Rate (Inland 95 ULP):
[RXX.XX / c/l](Effective: [Effective Date]) - Official Benchmark Rate (Coastal 95 ULP):
[RXX.XX / c/l](Effective: [Effective Date])
Note: Official values are published in cents per litre (c/l) and Rand per litre (R/l). To check the latest consumer-facing figures before integrating datasets, review petrol price today or perform instant trip budgeting with our calculate fuel costtool.
Available Endpoints and Data Fields
The API is structured around RESTful design principles, delivering JSON-formatted responses with explicit data types, ISO 8601 timestamps, and standardized unit parameters (c/l or R/l).
Available Endpoints
GET /v1/prices/latestReturns the current active gazetted fuel prices across all official fuel grades and geographic zones (Inland and Coastal).GET /v1/prices/historicalRetrieves archived monthly adjustments by year, month, or custom date range, allowing financial modeling against historical price trends.GET /v1/indicators/dailyProvides unadjusted daily Basic Fuel Price (BFP) over- and under-recovery figures from the CEF, useful for tracking midpoint monthly variance trends before official announcements.GET /v1/breakdown/currentDelivers a granular breakdown of the fuel price stack, including the General Fuel Levy (GFL), Road Accident Fund (RAF) levy, Slate balance, wholesale margins, retail margins, and transport tariffs.
Data Fields
Responses from our petrol price API docs endpoints return a consistent JSON payload structure. Key attributes in the standard response object include:
JSON
{
"status": "success",
"effective_date": "2026-07-01",
"currency": "ZAR",
"zone": "inland",
"zone_code": "9C",
"data": {
"fuel_grade": "95_ulp",
"retail_price_cents": 2450.00,
"retail_price_rand": 24.50,
"unit": "c/l",
"price_change_cents": -15.00,
"price_change_direction": "decrease",
"breakdown": {
"basic_fuel_price": 1120.50,
"fuel_levy": 396.00,
"raf_levy": 218.00,
"wholesale_margin": 85.20,
"retail_margin": 240.30,
"slate_levy": 0.00,
"transport_cost": 62.00
}
},
"source": "DMPR Gazetted Schedule",
"last_updated": "2026-07-01T00:01:00Z"
}
Every field is validated against gazetted schedules prior to release to ensure absolute operational fidelity for downstream enterprise integrations.
Coverage by Fuel Type, Province and Month
South African fuel pricing is categorized by fuel type and geographic transport zones rather than municipal borders:
Geographic Zone Coverage
- Inland Pricing (Zone 9C Benchmark): Applies to Gauteng, Free State, Mpumalanga, Limpopo, North West, and parts of the Northern and Eastern Cape. Includes pipeline and road rail transport tariffs added to the coastal base price.
- Coastal Pricing (Zone 1A Benchmark): Applies to coastal port cities including Cape Town, Durban, Gqeberha, and East London. Represents the base landed import price without inland rail/pipeline transport additions.
Fuel Grade Coverage
- 93 Octane Unleaded Petrol (ULP & LRP): Inland standard grade.
- 95 Octane Unleaded Petrol (ULP): Standard coastal grade, premium inland grade.
- Diesel 50ppm & 500ppm: Wholesale benchmark rates (retail prices for diesel are unregulated and set by individual service stations).
- Illuminating Paraffin: Maximum wholesale and retail price structures.
Historical Depth
The API maintains complete historical records spanning monthly price adjustments from prior years to the present. To explore broader context on long-term data structures, consult our national repository for fuel price data South Africa.
Update Frequency and Source Methodology
Understanding when and how data updates occur is critical for automated scheduling and cron-job execution.
Update Frequency
- Monthly Official Adjustments: Updated on the first Wednesday of every month at 00:01 SAST following official government gazettes.
- Daily BFP Indicators: Updated on official business days following the release of daily over/under-recovery tracking files by the Central Energy Fund (CEF).
Source Methodology & Verification Hierarchy
Data integrity relies on a strict source hierarchy:
- Primary Source (Official Monthly Rates): Department of Mineral Resources and Energy (DMRE/DMPR) gazetted price adjustments and official executive press releases.
- Secondary Source (Mid-month Tracking Indicators): Central Energy Fund (CEF) daily working tables reflecting international product prices (Med/Gulf Coast) and the ZAR/USD exchange rate.
- Validation Steps: Every automated import undergoes a two-step validation process (automated schema verification followed by secondary sanity checks) before updating the production endpoint.
Note: Daily BFP indicators reflect directional estimates and over/under-recovery trends. They do not constitute a confirmed price change until officially announced by the DMPR.
Example API Use Cases
Integrating programmatic fuel price data enables automation across various technical and commercial environments:
Use Cases
- Fleet & Logistics Operations: Automated calculations for mileage reimbursement, driver fuel allowances, and dynamic route profitability analysis based on current inland versus coastal diesel rates.
- ERP & Accounting Systems: Synchronizing monthly enterprise expenditure budgets with official gazetted fuel rate changes, eliminating manual entry for finance teams.
- Media & Digital Publishers: Powering real-time fuel widgets, news ticker graphics, and regional price comparison tables for consumer audiences.
- E-Commerce & Delivery Platforms: Dynamically adjusting delivery surcharge rates based on real-time monthly fuel price indexes.
- Calculators & Consumer Tools: Supporting interactive tools where end-users can calculate fuel cost for specific vehicles and travel routes.
Access, Licensing and Contact CTA
Access to our programmatic endpoints is provided via API key authentication (Bearer token or header key). Request limits, quota tiers, and SLA guarantees are aligned with organizational data requirements.
Trial and Contact CTA
To integrate live fuel data streams into your application, review our commercial structures or sign up for an access token:
- Explore flexible developer and enterprise plans on our API Pricing page.
- Request an integration key or evaluation account via API Signup.
- For custom enterprise requirements, bulk historical datasets, or dedicated SLA contracts, contact our data engineering team through our primary fuel price data API portal.
Frequently Asked Questions
What should users expect from the fuel price API documentation page?
This documentation page provides technical clarity on endpoint availability, JSON payload structures, geographic coverage, update schedules, and source verification methodologies. It serves as an integration reference for developers, analysts, and enterprise platforms.
Which sources should the page reference?
All official fuel pricing figures reference gazetted schedules from the South African Department of Mineral Resources and Energy (DMRE/DMPR). Daily midpoint tracking indicators reference official working data provided by the Central Energy Fund (CEF).
Who is this page for?
This documentation is built for developers, system architects, finance managers, fleet operators, and data analysts requiring programmatic access to verified South African fuel pricing datasets.
What is the next action?
Developers and commercial teams looking to integrate fuel pricing data should visit the API Pricing guide to evaluate tier limits, or submit an application through API Signup to receive an authentication key.