Flow Diesel Prices API

1. Get a key

Sign in with your email at https://app.valverideflow.com/developers, accept the API Terms, and create a key. The key starts with vrf_dev_ and is shown once. New accounts start with a one-time $20 signup credit. When it is used up, pick a monthly plan in the dashboard. Checkout asks you to agree to the Terms of Service and API Terms first.

2. Authenticate

Send the key on every request:

Authorization: Bearer vrf_dev_YOUR_KEY

3. Endpoints

GET /api/v1/prices/station/{id}

The diesel price at one truck stop. The id is a public station id (pf_ followed by 16 hex characters), as returned by the near endpoint. Query: include_estimated (default true).

curl -H "Authorization: Bearer vrf_dev_YOUR_KEY" https://app.valverideflow.com/api/v1/prices/station/pf_0123456789abcdef

GET /api/v1/prices/near

Truck stops near a point, nearest first. Query: lat and lng (required), radius in miles (default 10, up to 50), limit (default 50, up to 100), include_estimated (default true).

curl -H "Authorization: Bearer vrf_dev_YOUR_KEY" "https://app.valverideflow.com/api/v1/prices/near?lat=32.78&lng=-96.80&radius=25"

Response fields

Each price has station_id, source (always ValveRide Flow), brand, name, city, state, lat, lng, price (USD per gallon), confidence (0 to 1), estimated (true when no recent posted price exists) and observed_at.

4. MCP

The same data is available to AI agents as the diesel_price_station and diesel_prices_near tools on the ValveRide Flow MCP server at https://app.valverideflow.com/api/mcp, with the same key and plan.

5. Errors

• 401 unauthorized: missing or invalid key.
• 402 subscription_inactive: the monthly plan is cancelled or unpaid.
• 403 forbidden_endpoint: the endpoint is not on your plan.
• 403 station_cap_reached: the key reached its monthly distinct station limit.
• 429 rate_limited: too many requests. Slow down and retry.
• 503 price_api_disabled: temporarily unavailable. Retry after the Retry-After header.