API Documentation
REST API endpoints for Tanzania fuel prices. All endpoints are open and free to use.
Base URL
/api/v1
All requests return JSON and do not require authentication. The ingestion endpoints are private and not listed here.
Latest Prices
GET /prices/latestRetrieves the most recent approved fuel prices for all regions across Tanzania.
Search Prices
GET /prices
Filter prices. Supports query parameters for targeted data retrieval.
Query Params: ?region=Dar es Salaam
Historical Prices
GET /prices/history
Retrieves the complete historical pricing data for a specific region.
Query Params: ?region=Arusha
Compare Regions
GET /prices/compare
Compare the latest prices across multiple specified regions simultaneously.
Query Params: ?regions=Mwanza,Dodoma,Tanga
National Stats
GET /statsCalculates national aggregates including average, maximum, and minimum prices across the country.
Regional Rankings
GET /rankingsReturns all regions ranked from cheapest to most expensive for all fuel types.
Market Trends
GET /trendsProvides month-over-month percentage change metrics for fuel prices across all regions.