Endpoint Documentation

Simple Current Prices

Returns simplified inland and coastal fuel prices for petrol and diesel. This endpoint is recommended for most integrations because it provides a clean and lightweight response structure.

Endpoint

GET https://fultank.co.za/fuel-api/api/simple-current.php?api_key=YOUR_API_KEY

This endpoint requires a valid FulTank Fuel API key.

Authentication

Pass your API key as the api_key query parameter.

?api_key=YOUR_API_KEY

Example Request

curl "https://fultank.co.za/fuel-api/api/simple-current.php?api_key=YOUR_API_KEY"

Example Response

{
  "success": true,
  "effective_date": "2026-07-01",
  "fuel_prices": {
    "coastal": {
      "zone": null,
      "price_basis": "official_regional_reference",
      "petrol_93": "25.15",
      "petrol_95": "25.23",
      "diesel_50ppm": "24.41",
      "diesel_500ppm": "23.91"
    },
    "inland": {
      "zone": null,
      "price_basis": "official_regional_reference",
      "petrol_93": "25.94",
      "petrol_95": "26.10",
      "diesel_50ppm": "25.17",
      "diesel_500ppm": "24.79"
    }
  },
  "usage": {
    "plan_type": "developer",
    "requests_used": 1,
    "request_limit": 100,
    "requests_remaining": 99,
    "request_period": "trial",
    "period_started_at": "2026-08-06T05:10:17+02:00",
    "period_ends_at": "2026-08-20T05:10:17+02:00"
  }
}

Response Fields

Field	Type	Description
success	boolean	Indicates whether the request succeeded.
effective_date	string	Fuel price effective date.
fuel_prices.coastal	object	Coastal fuel price data.
fuel_prices.inland	object	Inland fuel price data.
usage	object	Current plan allowance, requests used and quota-period dates.

Error Responses

{
  "success": false,
  "message": "Invalid API key."
}

Error	Description
Missing API key	No API key was supplied.
Invalid API key	API key does not exist.
Inactive API key	Account is inactive.
Request limit reached	Trial or monthly API request allowance exceeded.

Best Use Cases

Fleet Systems

Fleet Fuel Monitoring

Integrate current fuel prices into fleet management systems.

Logistics

Cost Calculations

Calculate route and operational fuel costs dynamically.

Analytics

Fuel Intelligence

Build dashboards and pricing intelligence tools.