For developersLive to evaluate

Range API

POST a GPX route and bike parameters; get segment-level energy, estimated range, charge warnings, and finish time. Built for marketplaces, navigation apps, and AI agents that need a modeled answer instead of a guess. You can run the live console on this page today.

Join the API waitlist Compare products

Pilot pricing

From $49 / mo

POST /api/calculate is public with no key. Metering and keys are waitlist.

RangeResult JSON

Live to evaluate

The endpoint is public for evaluation. Keys, quotas, and billing are on the waitlist.

Eval: Open; No key required today
Builder: $49/mo; 10k calls · planned
Scale: $299/mo; 100k calls · planned
Auth: None; Keys on waitlist

Interactive preview

Try it here

Local preview. No signup. This is not a checkout.

Live request console

Hits the real POST /api/calculate endpoint.

Speed22 km/h

Rider weight75 kg

Bike weight24 kg

Battery15 Ah

Request body

{
  "gpxContent": "<GPX…>",
  "speed": 22,
  "bikeWeight": 24,
  "riderWeight": 75,
  "startTime": "09:00",
  "batteryCapacity": 15,
  "windSpeed": 0,
  "windDirection": 0
}

Response

// Press Run to call /api/calculate with athens-glyfada.gpx

Estimated range

—km

Avg consumption

—Wh/km

Finish

—

Latency

—ms

curl

curl -X POST https://ebike-range.app/api/calculate \
  -H "Content-Type: application/json" \
  -d '{
  "gpxContent": "[GPX string]",
  "speed": 22,
  "bikeWeight": 24,
  "riderWeight": 75,
  "startTime": "09:00",
  "batteryCapacity": 15,
  "windSpeed": 0,
  "windDirection": 0
}'

Live & unauthenticated

This hits the real POST /api/calculate. No API key. No published rate limit. Do not treat eval traffic as production.

Who it is for

Marketplaces enriching listings, route apps, and anyone whose LLM currently invents e-bike range.

Listing enrichment
A marketplace runs one calculation per model × sample commute and stores km range next to the buy button.
Agent tool
An assistant calls the same endpoint instead of hallucinating “up to 120 km” from a spec sheet.

How it works

POST JSON to /api/calculate with GPX plus bike, rider, battery, and optional wind.
Receive RangeResult: estimatedRange, segment consumption, finish time, chargeWarning.
Join the waitlist for an API key, quotas, and a documented rate limit.

Pilot tiers

Not billed yet

Evaluate: Free — Public POST /api/calculate — no SLA
Builder: $49 / mo — Planned: 10k calls, API key
Scale: $299 / mo — Planned: 100k calls — no published SLA yet

What's included

Range API

POST /api/calculate: Live now
Segment energy breakdown: Live now
Charge-stop warnings: Live now
CORS for browser apps: Live now
API keys & quotas: Waitlist
Contracted uptime: Not published

Questions

Is the endpoint live today?

Yes. POST /api/calculate accepts GPX and bike fields and returns a RangeResult. There is no API key and no published rate limit yet — treat it as evaluation, not production.

Where is the OpenAPI file?

Not published yet. The request body is documented on this page and exercised in the live console. /.well-known/ai-plugin.json currently points at the calculator POST, not an OpenAPI document.

What does a response include?

estimatedRange, averageConsumption, segmentsConsumption, finishTime, totalTripTimeInSeconds, and optional chargeWarning.

Accuracy?

Same physics as the free calculator: drag, rolling resistance, gradient, motor efficiency, weather when you pass it. Typical rider reports are within a few percent on known routes — not a warranty.

When do keys ship?

With the first paid API plan. Until then the route is unauthenticated. Do not put secrets in the GPX payload; it is processed server-side and not stored as a user account.

Other lines

Same physics engine, different buyer.

WaitlistProMulti-day tours, saved bikes, and offline planningRead Pilots openShop WidgetReal-world range on your store — every bike, on rides near each shopperRead WaitlistBrandsWhite-label lineup, calibrated claims, shopper-intent analyticsRead

Ready for Range API?

The endpoint is public for evaluation. Keys, quotas, and billing are on the waitlist.

Join the API waitlist Compare products