India's #1 Fuel Price API

API Endpoints:

This documentation should help you get started with our City API. We showed how to make a request, showed sample responses for good and bad. Example codes also provided for your favourite languages. You can copy and get started with this sample code.

Endpoint Details

Method: GET
URL: https://purepriceio.com/api/v1/fuel/city/
Authentication: Required (Bearer Token)
Parameters:
- city (mandatory): city you want fuel price for.
- state (mandatory): state of the city.

Sample Response (200)

{
    "city": "Madurai",
    "state_code": "TN",
    "state_name": "Tamil Nadu",
    "current_date": "2025-01-08",
    "rates": [
        {
            "fuel": "Diesel",
            "price": 93.01
        },
        {
            "fuel": "LPG",
            "price": 844.0
        },
        {
            "fuel": "Petrol",
            "price": 101.38
        }
    ]
}

Sample Response (400)

If you pass wrong state or city. You get 400 response which contains valid city or state


    {
        "error": "Valid City is required.",
        "details": {
            "state": "TN",
            "available_cities": [
                "Ariyalur",
                "Chengalpattu",
                "Chennai",
                "Coimbatore",
                "Cuddalore",
                "Dharmapuri",
                "Dindigul",
                "Erode",
                "Kallakurichi",
                "Kanchipuram",
                "Kanyakumari",
                "Karur",
                "Krishnagiri",
                "Madurai",
                "Nagapattinam",
                "Namakkal",
                "Nilgiris",
                "Perambalur",
                "Pudukkottai",
                "Ramanathapuram",
                "Ranipet",
                "Salem",
                "Sivaganga",
                "Tenkasi",
                "Thanjavur",
                "Theni",
                "Thoothukudi (Tuticorin)",
                "Tiruchirappalli",
                "Tirunelveli",
                "Tirupathur",
                "Tiruppur",
                "Tiruvallur",
                "Tiruvannamalai",
                "Tiruvarur",
                "Vellore",
                "Viluppuram",
                "Virudhunagar",
                "Kanniyakumari",
                "Teni",
                "Thiruvarur",
                "Tiruchchirappalli",
                "Tirupur",
                "Virudunagar",
                "Ooty",
                "Nagercoil",
                "Thiruvallur",
                "Thoothukudi"
            ]
        }
    }

Sample Response (403)

Its mandatory that you pass Authorization Bearer Token in Header. If wrong token is passed or you don't pass API key, you get.


{
    "detail": "Invalid token."
}

Error Codes

Code	Message
400	Bad Request
403	Forbidden

Example Requests

curl -X GET "https://purepriceio.com/api/v1/fuel/city?city=Ramanathapuram&state=TN" \
                                        -H "Authorization: Bearer YOUR_API_KEY"

import requests
import logging

url = "https://purepriceio.com/api/v1/fuel/city"
API_KEY = "YOUR_API_KEY"
try:
    response = requests.get(
        url=url,
        params={"city": "Ramanathapuram", "state": "TN"},
        headers={"Authorization": f"Bearer {API_KEY}"},
        timeout=20,
    )
    if response.status_code == 200:
        print(response.json())
    else:
        print(f"something wrong, status_code={response.status_code}")
except Exception as e:
    logging.exception(e)

import java.net.http.*;
import java.net.URI;
import java.time.Duration;
import com.fasterxml.jackson.databind.ObjectMapper;
import java.util.Map;

public class FuelApi {
    public static void main(String[] args) {
        String url = "https://purepriceio.com/api/v1/fuel/city";
        String apiKey = "YOUR_API_KEY";

        try {
            HttpClient client = HttpClient.newBuilder()
                .connectTimeout(Duration.ofSeconds(20))
                .build();

            HttpRequest request = HttpRequest.newBuilder()
                .uri(URI.create(url + "?city=Ramanathapuram&state=TN"))
                .header("Authorization", "Bearer " + apiKey)
                .GET()
                .build();

            HttpResponse response = client.send(request, HttpResponse.BodyHandlers.ofString());

            if (response.statusCode() == 200) {
                ObjectMapper mapper = new ObjectMapper();
                Map responseData = mapper.readValue(response.body(), Map.class);
                System.out.println(responseData);
            } else {
                System.out.println("Something wrong, status_code=" + response.statusCode());
            }
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

const axios = require('axios');
const url = "https://purepriceio.com/api/v1/fuel/city";
const API_KEY = "YOUR_API_KEY";

(async () => {
    try {
    const response = await axios.get(url, {
        params: { city: "Ramanathapuram", state: "TN" },
        headers: { Authorization: `Bearer ${API_KEY}` },
        timeout: 20000
    });
    console.log(response.data);
    } catch (error) {
    console.error("Error:", error.response?.status || error.message);
    }
})();

using System;
using System.Net.Http;
using System.Threading.Tasks;
using Newtonsoft.Json;

class Program
{
    static async Task Main(string[] args)
    {
        string url = "https://purepriceio.com/api/v1/fuel/city";
        string apiKey = "YOUR_API_KEY";

        using HttpClient client = new HttpClient { Timeout = TimeSpan.FromSeconds(20) };
        client.DefaultRequestHeaders.Add("Authorization", $"Bearer {apiKey}");

        try
        {
            HttpResponseMessage response = await client.GetAsync($"{url}?city=Ramanathapuram&state=TN");
            if (response.IsSuccessStatusCode)
            {
                string responseBody = await response.Content.ReadAsStringAsync();
                var data = JsonConvert.DeserializeObject(responseBody);
                Console.WriteLine(data);
            }
            else
            {
                Console.WriteLine($"Something wrong, status_code={response.StatusCode}");
            }
        }
        catch (Exception ex)
        {
            Console.WriteLine($"Exception: {ex.Message}");
        }
    }
}


    <?php
    $url = "https://purepriceio.com/api/v1/fuel/city";
    $apiKey = "YOUR_API_KEY";

    // Set up HTTP context options with headers and timeout
    $options = [
        "http" => [
            "method" => "GET",
            "header" => "Authorization: Bearer $apiKey\r\n",
            "timeout" => 20,
        ],
    ];
    $context = stream_context_create($options);
    $urlWithParams = $url . "?city=Ramanathapuram&state=TN";

    try {
        $response = @file_get_contents($urlWithParams, false, $context);

        if ($response === FALSE) {
            // Parse the response header to get the HTTP status code
            $statusLine = $http_response_header[0] ?? "HTTP/1.1 500 Internal Server Error";
            preg_match('{HTTP\/\S*\s(\d{3})}', $statusLine, $match);
            $statusCode = $match[1] ?? 500;

            echo "Something wrong, status_code=" . $statusCode;
        } else {
            echo $response; // Print the JSON response
        }
    } catch (Exception $e) {
        error_log("Error: " . $e->getMessage());
    }
    ?>


package main

import (
	"encoding/json"
	"fmt"
	"io/ioutil"
	"net/http"
	"time"
)

func main() {
	url := "https://purepriceio.com/api/v1/fuel/city"
	apiKey := "YOUR_API_KEY"

	client := &http.Client{Timeout: 20 * time.Second}
	req, err := http.NewRequest("GET", url, nil)
	if err != nil {
		fmt.Println("Error creating request:", err)
		return
	}

	q := req.URL.Query()
	q.Add("city", "Ramanathapuram")
	q.Add("state", "TN")
	req.URL.RawQuery = q.Encode()

	req.Header.Add("Authorization", "Bearer "+apiKey)

	resp, err := client.Do(req)
	if err != nil {
		fmt.Println("Error sending request:", err)
		return
	}
	defer resp.Body.Close()

	if resp.StatusCode == 200 {
		body, _ := ioutil.ReadAll(resp.Body)
		var data map[string]interface{}
		json.Unmarshal(body, &data)
		fmt.Println(data)
	} else {
		fmt.Printf("Something wrong, status_code=%d\n", resp.StatusCode)
	}
}

This documentation should help you get started with our State API. We showed how to make a request, showed sample responses for good and bad. Example codes also provided for your favourite languages. You can copy and get started with this sample code.