Quickstart

Quickstart

Get up and running in under a minute. No API key required for read endpoints.

Pick a town

The API covers 224+ towns across Kenya. Fetch the full list at any time:

curl https://api.fuelkenya.com/v1/towns

Response (truncated):

["Bungoma", "Eldoret", "Kisumu", "Mombasa", "Nairobi", "Nakuru", ...]

Fetch the latest prices

Get the current cycle prices for a specific town. Town names are case-insensitive.

curl "https://api.fuelkenya.com/v1/prices/latest?town=Nairobi"

Response:

[
  {
    "id": 1042,
    "town": "Nairobi",
    "super_petrol": 214.03,
    "diesel": 199.73,
    "kerosene": 196.53,
    "valid_from": "2026-06-15",
    "valid_to": "2026-07-14"
  }
]

Fetch price history

Pull up to 12 previous pricing cycles for trend analysis:

curl "https://api.fuelkenya.com/v1/prices?town=Nairobi&limit=12"

Results are returned newest-first. Use offset for pagination.

Language examples

# Latest prices — all towns
curl https://api.fuelkenya.com/v1/prices/latest
 
# Latest prices — specific town
curl "https://api.fuelkenya.com/v1/prices/latest?town=Mombasa"
 
# Price history — last 6 cycles
curl "https://api.fuelkenya.com/v1/prices?town=Kisumu&limit=6"
⚠️

Rate limit — public endpoints allow 60 requests per minute per IP. Cache responses locally rather than polling; prices only change on the 14th of each month.

Next steps

OverviewAuthentication