Fuel Price API

Introduction

The Fuel Price API is a service designed to provide users with the latest fuel prices across various cities. It enables users to search and find current prices for different types of fuel available in their city, along with the date of the latest update. This project aims to enhance user engagement by offering timely and accurate fuel price information.

The API is tasked with delivering updated fuel prices for each city within a given state. To utilize this service.

Use Cases

Daily Commuter Budget Planning: The API serves daily commuters by providing up-to-date fuel prices in their city, aiding in precise budgeting for daily travel expenses. This feature is especially beneficial for individuals traveling long distances to work. Integration with personal finance applications could automate and streamline this budgeting process.
Travel Cost Estimation for Road Trippers: Targeting travelers and road trip enthusiasts, this use case allows for the estimation of total fuel expenses for journeys that span across multiple cities or states. By accessing current fuel prices for different stops along their route, travelers can effectively plan their travel budget.
Fuel Price Comparison for Delivery Businesses: Delivery businesses that operate vehicle fleets can leverage the API to compare fuel prices across various cities. This information enables these businesses to strategize fuel purchases, potentially leading to significant savings on operational costs by selecting the most economical refueling locations.
Dynamic Pricing for Ride-Sharing Services: Ride-sharing companies can utilize the API to dynamically adjust their service prices in response to current fuel costs. This capability supports the maintenance of profitability, especially during periods when fuel prices are volatile.

API

Guide to use API

To use the API, client needs to provide the state and city as input parameters. If the client provides both city and state then it would give the fuel price for that city for that state, but if the client has provided only provided state then it would return fuel price of all the cities present in that state, supported by the API.

CURL and Sample Inputs

curl --location 'https://api-preproduction.signzy.app/api/v3/live-fuel-price' \
--header 'Content-Type: application/json' \
--header 'Authorization: <auth>' \
--data '{
    "state": "maharashtra",
    "city": "mumbai"
}'

Input table

Parameter	Value	Description	Data Type
Header	Content-Type: application/json	Specifies the media type of the resource (JSON format)	String
Header	Authorization: <auth>	Authentication credentials for API access	String
data.state	maharashtra	Specifies the state parameter in the request	String
data.city	mumbai	Specifies the city parameter in the request	String

Input Scenarios

State and city are passed

Input

curl --location 'https://api-preproduction.signzy.app/api/v3/live-fuel-price' \
--header 'Content-Type: application/json' \
--header 'Authorization: <auth>' \
--data '{
    "state": "maharashtra",
    "city": "mumbai"
}'

Output

{
    "result": {
        "mumbai": {
            "date": "29-4-2024",
            "fuelPrices": {
                "datePetrol": "27/04/2024",
                "Petrol": "₹ 104.19",
                "dateDiesel": "27/04/2024",
                "Diesel": "₹ 92.13",
                "dateAutoGas": "01/07/2021",
                "AutoGas": "₹ 51.05",
                "dateCNG": "02/10/2023",
                "CNG": "₹ 76",
                "dateLPG": "01/04/2024",
                "LPG": "₹ 802.5"
            }
        }
    }
}

Only State is passed

Input

curl --location 'https://api-preproduction.signzy.app/api/v3/live-fuel-price' \
--header 'Content-Type: application/json' \
--header 'Authorization: <auth>' \
--data '{
    "state": "maharashtra",
    "city": ""
}'

Output

{
    "result": {
        "wardha": {
            "date": "29-4-2024",
            "fuelPrices": {
                "datePetrol": "27/04/2024",
                "Petrol": "₹ 101.29",
                "dateDiesel": "27/04/2024",
                "Diesel": "₹ 94.22",
                "dateLPG": "01/04/2024",
                "LPG": "₹ 891",
                "dateAutoGas": "N.A",
                "AutoGas": "N.A",
                "dateCNG": "N.A",
                "CNG": "N.A"
            }
        },
        "latur": {
            "date": "29-4-2024",
            "fuelPrices": {
                "datePetrol": "27/04/2024",
                "Petrol": "₹ 105.39",
                "dateDiesel": "27/04/2024",
                "Diesel": "₹ 91.89",
                "dateLPG": "01/04/2024",
                "LPG": "₹ 827.5",
                "dateAutoGas": "N.A",
                "AutoGas": "N.A",
                "dateCNG": "N.A",
                "CNG": "N.A"
            }
        },
        "chandrapur": {
            "date": "29-4-2024",
            "fuelPrices": {
                "datePetrol": "27/04/2024",
                "Petrol": "₹ 104.03",
                "dateDiesel": "27/04/2024",
                "Diesel": "₹ 90.6",
                "dateLPG": "01/04/2024",
                "LPG": "₹ 851.5",
                "dateAutoGas": "N.A",
                "AutoGas": "N.A",
                "dateCNG": "N.A",
                "CNG": "N.A"
            }
        },
        "ahmednagar": {
            "date": "29-4-2024",
            "fuelPrices": {
                "datePetrol": "27/04/2024",
                "Petrol": "₹ 103.86",
                "dateDiesel": "27/04/2024",
                "Diesel": "₹ 90.41",
                "dateAutoGas": "01/07/2020",
                "AutoGas": "₹ 39.58",
                "dateLPG": "01/05/2020",
                "LPG": "₹ 589",
                "dateCNG": "N.A",
                "CNG": "N.A"
            }
        },
        "thane": {
            "date": "29-4-2024",
            "fuelPrices": {
                "datePetrol": "27/04/2024",
                "Petrol": "₹ 104.3",
                "dateDiesel": "27/04/2024",
                "Diesel": "₹ 92.24",
                "dateAutoGas": "01/07/2020",
                "AutoGas": "₹ 37.29",
                "dateCNG": "08/04/2023",
                "CNG": "₹ 79",
                "dateLPG": "01/04/2024",
                "LPG": "₹ 802.5"
            }
        }
        
]

Output Table

Component	Value	Description	Data Type
result.wardha.date	"29-4-2024"	The date when the data was fetched	String
result.wardha.fuelPrices.datePetrol	"27/04/2024"	The date when the petrol price was last updated	String
result.wardha.fuelPrices.Petrol	"₹ 101.29"	The current price of petrol	String
result.wardha.fuelPrices.dateDiesel	"27/04/2024"	The date when the diesel price was last updated	String
result.wardha.fuelPrices.Diesel	"₹ 94.22"	The current price of diesel	String
result.wardha.fuelPrices.dateLPG	"01/04/2024"	The date when the LPG price was last updated	String
result.wardha.fuelPrices.LPG	"₹ 891"	The current price of LPG	String
result.wardha.fuelPrices.dateAutoGas	"N.A"	The date when the auto gas price was last updated	String
result.wardha.fuelPrices.AutoGas	"N.A"	The current price of auto gas (not available)	String
result.wardha.fuelPrices.dateCNG	"N.A"	The date when the CNG price was last updated	String
result.wardha.fuelPrices.CNG	"N.A"	The current price of CNG (not available)	String

Invalid Input Response:

{
    "error": {
        "name": "error",
        "message": "state city combination should be valid",
        "reason": "VALIDATION_ERROR",
        "type": "Bad Request",
        "statusCode": "400"
    }
}

State & cities supported list:

City	State
Port Blair	Andaman and Nicobar Islands
Anantapur	Andhra Pradesh
Chittoor	Andhra Pradesh
Eluru	Andhra Pradesh
Guntur	Andhra Pradesh
Kadapa	Andhra Pradesh
Kakinada	Andhra Pradesh
Kurnool	Andhra Pradesh
Machilipatnam	Andhra Pradesh
Nellore	Andhra Pradesh
Ongole	Andhra Pradesh
Srikakulam	Andhra Pradesh
Vijayawada	Andhra Pradesh
Vizag	Andhra Pradesh
Vizianagaram	Andhra Pradesh
Itanagar	Arunachal Pradesh
Barpeta	Assam
Dibrugarh	Assam
Golaghat	Assam
Guwahati	Assam
Jorhat	Assam
Nagaon	Assam
Nalbari	Assam
Sibsagar	Assam
Silchar	Assam
Tezpur	Assam
Araria	Bihar
Arrah	Bihar
Aurangabad	Bihar
Banka	Bihar
Begusarai	Bihar
Bettiah	Bihar
Bhagalpur	Bihar
Bihar Sharif	Bihar
Buxar	Bihar
Chapra	Bihar
Darbhanga	Bihar
Gaya	Bihar
Hajipur	Bihar
Jamui	Bihar
Jehanabad	Bihar
Katihar	Bihar
Khagaria	Bihar
Kishanganj	Bihar
Lakhisarai	Bihar
Madhepura	Bihar
Madhubani	Bihar
Motihari	Bihar
Munger	Bihar
Muzaffarpur	Bihar
Nawada	Bihar
Patna	Bihar
Purnia	Bihar
Samastipur	Bihar
Sasaram	Bihar
Sheikhpura	Bihar
Sheohar	Bihar
Sitamarhi	Bihar
Siwan	Bihar
Supaul	Bihar
Ambikapur	Chhattisgarh
Bijapur	Chhattisgarh
Bilaspur	Chhattisgarh
Dantewada	Chhattisgarh
Dhamtari	Chhattisgarh
Durg	Chhattisgarh
Jagdalpur	Chhattisgarh
Janjgir	Chhattisgarh
Jashpur	Chhattisgarh
Kanker	Chhattisgarh
Kawardha	Chhattisgarh
Korba	Chhattisgarh
Mahasamund	Chhattisgarh
Narayanpur	Chhattisgarh
Raigarh	Chhattisgarh
Raipur	Chhattisgarh
Rajnandgaon	Chhattisgarh
Surajpur	Chhattisgarh
Silvassa	Dadra and Nagar Haveli
Daman	Daman and Diu
Gurgaon	Delhi
New Delhi	Delhi
Margao	Goa
Panjim	Goa
Ahmedabad	Gujarat
Amreli	Gujarat
Anand	Gujarat
Bharuch	Gujarat
Bhavnagar	Gujarat
Bhuj	Gujarat
Dahod	Gujarat
Gandhinagar	Gujarat
Godhra	Gujarat
Himmatnagar	Gujarat
Jamnagar	Gujarat
Junagadh	Gujarat
Kheda	Gujarat
Mehsana	Gujarat
Navsari	Gujarat
Palanpur	Gujarat
Patan	Gujarat
Porbandar	Gujarat
Rajkot	Gujarat
Surat	Gujarat
Surendranagar	Gujarat
Vadodara	Gujarat
Ambala City	Haryana
Bhiwani	Haryana
Faridabad	Haryana
Fatehabad	Haryana
Hissar	Haryana
Jhajjar	Haryana
Jind	Haryana
Kaithal	Haryana
Karnal	Haryana
Kurukshetra	Haryana
Nuh	Haryana
Palwal	Haryana
Panchkula	Haryana
Panipat	Haryana
Rewari	Haryana
Rohtak	Haryana
Sirsa	Haryana
Sonepat	Haryana
Yamuna Nagar	Haryana
Bilaspur	Himachal Pradesh
Chamba	Himachal Pradesh
Hamirpur	Himachal Pradesh
Kullu	Himachal Pradesh
Mandi	Himachal Pradesh
Nahan	Himachal Pradesh
Shimla	Himachal Pradesh
Solan	Himachal Pradesh
Una	Himachal Pradesh
Anantnag	Jammu and Kashmir
Badgam	Jammu and Kashmir
Doda	Jammu and Kashmir
Jammu	Jammu and Kashmir
Kargil	Jammu and Kashmir
Kathua	Jammu and Kashmir
Kishtwar	Jammu and Kashmir
Kupwara	Jammu and Kashmir
Leh	Jammu and Kashmir
Poonch	Jammu and Kashmir
Rajauri	Jammu and Kashmir
Samba	Jammu and Kashmir
Shopian	Jammu and Kashmir
Srinagar	Jammu and Kashmir
Udhampur	Jammu and Kashmir
Bokaro	Jharkhand
Chaibasa	Jharkhand
Daltonganj	Jharkhand
Deoghar	Jharkhand
Dhanbad	Jharkhand
Dumka	Jharkhand
Garhwa	Jharkhand
Giridih	Jharkhand
Godda	Jharkhand
Gumla	Jharkhand
Hazaribagh	Jharkhand
Jamshedpur	Jharkhand
Koderma	Jharkhand
Lohardaga	Jharkhand
Pakur	Jharkhand
Ramgarh	Jharkhand
Ranchi	Jharkhand
Seraikela	Jharkhand
Bagalkot	Karnataka
Ballari	Karnataka
Belgaum	Karnataka
Bengaluru	Karnataka
Bidar	Karnataka
Chamarajanagar	Karnataka
Chickmagaluru	Karnataka
Chikkaballapura	Karnataka
Chitradurga	Karnataka
Davangere	Karnataka
Dharwad	Karnataka
Gadag	Karnataka
Gulbarga	Karnataka
Hassan	Karnataka
Haveri	Karnataka
Karwar	Karnataka
Kolar	Karnataka
Koppal	Karnataka
Mandya	Karnataka
Mangalore	Karnataka
Mysuru	Karnataka
Raichur	Karnataka
Ramanagara	Karnataka
Shimoga	Karnataka
Tumakuru	Karnataka
Udupi	Karnataka
Yadgir	Karnataka
Alappuzha	Kerala
Kakkanad	Kerala
Kalpetta	Kerala
Kannur	Kerala
Kasaragod	Kerala
Kollam	Kerala
Kottayam	Kerala
Kozhikode	Kerala
Malappuram	Kerala
Palakkad	Kerala
Pandakkal	Kerala
Pathanamthitta	Kerala
Thrissur	Kerala
Trivandrum	Kerala
Alirajpur	Madhya Pradesh
Ashoknagar	Madhya Pradesh
Balaghat	Madhya Pradesh
Barwani	Madhya Pradesh
Betul	Madhya Pradesh
Bhind	Madhya Pradesh
Bhopal	Madhya Pradesh
Burhanpur	Madhya Pradesh
Chhatarpur	Madhya Pradesh
Chhindwara	Madhya Pradesh
Damoh	Madhya Pradesh
Datia	Madhya Pradesh
Dewas	Madhya Pradesh
Dhar	Madhya Pradesh
Dindori	Madhya Pradesh
Guna	Madhya Pradesh
Gwalior	Madhya Pradesh
Harda	Madhya Pradesh
Hoshangabad	Madhya Pradesh
Indore	Madhya Pradesh
Jabalpur	Madhya Pradesh
Jhabua	Madhya Pradesh
Katni	Madhya Pradesh
Khandwa	Madhya Pradesh
Khargone	Madhya Pradesh
Mandla	Madhya Pradesh
Mandsaur	Madhya Pradesh
Morena	Madhya Pradesh
Narsinghpur	Madhya Pradesh
Neemuch	Madhya Pradesh
Panna	Madhya Pradesh
Raisen	Madhya Pradesh
Rajgarh	Madhya Pradesh
Ratlam	Madhya Pradesh
Rewa	Madhya Pradesh
Sagar	Madhya Pradesh
Satna	Madhya Pradesh
Sehore	Madhya Pradesh
Seoni	Madhya Pradesh
Shahdol	Madhya Pradesh
Shajapur	Madhya Pradesh
Sheopur	Madhya Pradesh
Shivpuri	Madhya Pradesh
Sidhi	Madhya Pradesh
Singrauli	Madhya Pradesh
Tikamgarh	Madhya Pradesh
Ujjain	Madhya Pradesh
Umaria	Madhya Pradesh
Vidisha	Madhya Pradesh
Ahmednagar	Maharashtra
Akola	Maharashtra
Alibag	Maharashtra
Amravati	Maharashtra
Aurangabad	Maharashtra
Beed	Maharashtra
Bhandara	Maharashtra
Buldhana	Maharashtra
Chandrapur	Maharashtra
Dhule	Maharashtra
Gadchiroli	Maharashtra
Gondia	Maharashtra
Hingoli	Maharashtra
Jalgaon	Maharashtra
Jalna	Maharashtra
Kolhapur	Maharashtra
Latur	Maharashtra
Mumbai	Maharashtra
Nagpur	Maharashtra
Nanded	Maharashtra
Nandurbar	Maharashtra
Nashik	Maharashtra
Navi Mumbai	Maharashtra
Osmanabad	Maharashtra
Parbhani	Maharashtra
Pimpri Chinchwad	Maharashtra
Pune	Maharashtra
Ratnagiri	Maharashtra
Sangli	Maharashtra
Satara	Maharashtra
Solapur	Maharashtra
Thane	Maharashtra
Wardha	Maharashtra
Washim	Maharashtra
Imphal	Manipur
Jowai	Meghalaya
Nongstoin	Meghalaya
Shillong	Meghalaya
Tura	Meghalaya
Aizawl	Mizoram
Dimapur	Nagaland
Kohima	Nagaland
Kanjhawala	New Delhi
Preet Vihar	New Delhi
Rajouri Garden	New Delhi
Sadar Bazar	New Delhi
Saket	New Delhi
Shahdara	New Delhi
Vasant Vihar	New Delhi
Angul	Odisha
Balangir	Odisha
Balasore	Odisha
Bargarh	Odisha
Baripada	Odisha
Bhadrak	Odisha
Bhawanipatna	Odisha
Cuttack	Odisha
Dhenkanal	Odisha
Gajapati	Odisha
Jharsuguda	Odisha
Kendujhar	Odisha
Koraput	Odisha
Malkangiri	Odisha
Nayagarh	Odisha
Phulbani	Odisha
Puri	Odisha
Rayagada	Odisha
Sambalpur	Odisha
Sundargarh	Odisha
Bhubaneswar	Orissa
Karaikal	Puducherry
Yanam	Puducherry
Amritsar	Punjab
Barnala	Punjab
Bathinda	Punjab
Faridkot	Punjab
Fazilka	Punjab
Firozpur	Punjab
Gurdaspur	Punjab
Hoshiarpur	Punjab
Jalandhar	Punjab
Kapurthala	Punjab
Ludhiana	Punjab
Mansa	Punjab
Moga	Punjab
Mohali	Punjab
Muktsar	Punjab
Pathankot	Punjab
Patiala	Punjab
Sangrur	Punjab
Shahid Bhagat Singh Nagar	Punjab
Tarn Taran Sahib	Punjab
Ajmer	Rajasthan
Alwar	Rajasthan
Banswara	Rajasthan
Baran	Rajasthan
Barmer	Rajasthan
Bharatpur	Rajasthan
Bhilwara	Rajasthan
Bikaner	Rajasthan
Bundi	Rajasthan
Chittorgarh	Rajasthan
Churu	Rajasthan
Dausa	Rajasthan
Dholpur	Rajasthan
Dungarpur	Rajasthan
Ganganagar	Rajasthan
Hanumangarh	Rajasthan
Jaipur	Rajasthan
Jaisalmer	Rajasthan
Jalore	Rajasthan
Jhunjhunu	Rajasthan
Jodhpur	Rajasthan
Karauli	Rajasthan
Kota	Rajasthan
Nagaur	Rajasthan
Pali	Rajasthan
Sawai Madhopur	Rajasthan
Sikar	Rajasthan
Sirohi	Rajasthan
Tonk	Rajasthan
Udaipur	Rajasthan
Gangtok	Sikkim
Geyzing	Sikkim
Namchi	Sikkim
Ariyalur	Tamil Nadu
Chennai	Tamil Nadu
Coimbatore	Tamil Nadu
Cuddalore	Tamil Nadu
Dharmapuri	Tamil Nadu
Dindigul	Tamil Nadu
Erode	Tamil Nadu
Kanchipuram	Tamil Nadu
Karur	Tamil Nadu
Madurai	Tamil Nadu
Nagapattinam	Tamil Nadu
Nagercoil	Tamil Nadu
Namakkal	Tamil Nadu
Ooty	Tamil Nadu
Perambalur	Tamil Nadu
Pudukkottai	Tamil Nadu
Ramanathapuram	Tamil Nadu
Salem	Tamil Nadu
Sivaganga	Tamil Nadu
Thanjavur	Tamil Nadu
Theni	Tamil Nadu
Thiruvallur	Tamil Nadu
Thoothukudi	Tamil Nadu
Tiruchirappalli	Tamil Nadu
Tirunelveli	Tamil Nadu
Tiruppur	Tamil Nadu
Tiruvannamalai	Tamil Nadu
Tiruvarur	Tamil Nadu
Vellore	Tamil Nadu
Viluppuram	Tamil Nadu
Virudhunagar	Tamil Nadu
Hyderabad	Telangana
Adilabad	Telangana
Karimnagar	Telangana
Khammam	Telangana
Mahabubnagar	Telangana
Nalgonda	Telangana
Nizamabad	Telangana
Sangareddy	Telangana
Warangal	Telangana
Agartala	Tripura
Agra	Uttar Pradesh
Akbarpur	Uttar Pradesh
Aligarh	Uttar Pradesh
Allahabad	Uttar Pradesh
Auraiya	Uttar Pradesh
Bagpat	Uttar Pradesh
Bahraich	Uttar Pradesh
Ballia	Uttar Pradesh
Balrampur	Uttar Pradesh
Banda	Uttar Pradesh
Barabanki	Uttar Pradesh
Bareilly	Uttar Pradesh
Basti	Uttar Pradesh
Bijnor	Uttar Pradesh
Budaun	Uttar Pradesh
Bulandshahr	Uttar Pradesh
Chandauli	Uttar Pradesh
Deoria	Uttar Pradesh
Etah	Uttar Pradesh
Etawah	Uttar Pradesh
Faizabad	Uttar Pradesh
Fatehpur	Uttar Pradesh
Firozabad	Uttar Pradesh
Gauriganj	Uttar Pradesh
Ghaziabad	Uttar Pradesh
Ghazipur	Uttar Pradesh
Gonda	Uttar Pradesh
Greater Noida	Uttar Pradesh
Hardoi	Uttar Pradesh
Jaunpur	Uttar Pradesh
Jhansi	Uttar Pradesh
Kannauj	Uttar Pradesh
Kanpur	Uttar Pradesh
Kasganj	Uttar Pradesh
Kaushambi	Uttar Pradesh
Kushinagar	Uttar Pradesh
Lakhimpur Kheri	Uttar Pradesh
Lalitpur	Uttar Pradesh
Lucknow	Uttar Pradesh
Maharajganj	Uttar Pradesh
Mahoba	Uttar Pradesh
Mainpuri	Uttar Pradesh
Mathura	Uttar Pradesh
Mau	Uttar Pradesh
Meerut	Uttar Pradesh
Mirzapur	Uttar Pradesh
Moradabad	Uttar Pradesh
Muzaffarnagar	Uttar Pradesh
Noida	Uttar Pradesh
Orai	Uttar Pradesh
Pilibhit	Uttar Pradesh
Pratapgarh	Uttar Pradesh
Raebareli	Uttar Pradesh
Rampur	Uttar Pradesh
Robertsganj	Uttar Pradesh
Saharanpur	Uttar Pradesh
Sant Kabir Nagar	Uttar Pradesh
Shahjahanpur	Uttar Pradesh
Sitapur	Uttar Pradesh
Sultanpur	Uttar Pradesh
Unnao	Uttar Pradesh
Varanasi	Uttar Pradesh
Almora	Uttarakhand
Dehradun	Uttarakhand
Haridwar	Uttarakhand
Nainital	Uttarakhand
New Tehri	Uttarakhand
Pithoragarh	Uttarakhand
Rudrapur	Uttarakhand
Gorakhpur	Uttarpradesh
Jyotiba Phule Nagar	Uttarpradesh
Mahamaya Nagar	Uttarpradesh
Alipore	West Bengal
Baharampur	West Bengal
Bankura	West Bengal
Barasat	West Bengal
Bardhaman	West Bengal
Cooch Behar	West Bengal
Hooghly	West Bengal
Howrah	West Bengal
Kolkata	West Bengal
Krishnanagar	West Bengal
Medinipur	West Bengal
Purulia	West Bengal
Raiganj	West Bengal
Suri	West Bengal
Tamluk	West Bengal
Chandigarh
Pondicherry

Getting help

Please feel free to contact us if you have any questions, require clarification, or have ideas for how to make the documents or any of our services better.

You can reach out to us at [email protected].