Fuel Price API

Daily India fuel prices (petrol, diesel, CNG, LPG) for 798 cities. Base URL: https://developers.highroadstudios.in/api/v1

Authentication

Developer portal uses Google Sign-In (one Free account per Google user). Your apps call the API with:

X-API-Key: fk_live_…

Create the key once at Get key.

IDs

  • state_code — GST code (J&K=1 … Goa=30 …)
  • city_code — unique 1…N (GST state order, then A→Z)
  • city_id — slug like mumbai

Prices accept either slug or numeric code: /prices/mumbai or /prices/622.

Endpoints

  • GET /cities — list cities (?state_code=27)
  • GET /states — GST states
  • GET /prices/{city} — latest fuels
  • GET /prices/{city}/history?from=&to= — history
  • GET /me — plan & quota (Google or API key)

Limits

  • Free: 1,000 / month · 10 / min · hard stop
  • Pro: 50,000 / month · 60 / min · overage
  • Business: 500,000 / month · 300 / min · overage

Upgrade from the Dashboard.

Errors

  • 401 — missing/invalid key or Google session
  • 404 — unknown city
  • 429 — rate limit or Free monthly quota