moovexDocs
EVRP

Quickstart

Make your first EVRP API call in under 5 minutes

Quickstart

Get started with EVRP by making your first route calculation request.

Prerequisites

  • An API key (contact us at moovex.ai/contact to get access)
  • A tool to make HTTP requests (curl, Postman, or your preferred HTTP client)

Base URL

All API requests are made to:

https://routing.moovex.ai/api/v1

Authentication

Include your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Your First Request

Let's calculate a route from San Francisco to Los Angeles with a Tesla Model 3:

curl -X POST https://routing.moovex.ai/api/v1/routing/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "origin": {
      "lat": 37.7749,
      "lng": -122.4194
    },
    "destination": {
      "lat": 34.0522,
      "lng": -118.2437
    },
    "vehicle": {
      "model": "tesla_model_3_lr",
      "battery_capacity_kwh": 82,
      "current_soc_percent": 90
    },
    "preferences": {
      "min_arrival_soc_percent": 20,
      "charger_networks": ["tesla_supercharger", "electrify_america"]
    }
  }'

Response

The API returns a complete route with charging stops:

{
  "route_id": "rt_abc123",
  "status": "success",
  "summary": {
    "total_distance_km": 615,
    "total_duration_minutes": 395,
    "charging_stops": 1,
    "total_charging_time_minutes": 25
  },
  "legs": [
    {
      "type": "drive",
      "start": { "lat": 37.7749, "lng": -122.4194 },
      "end": { "lat": 35.3733, "lng": -119.0187 },
      "distance_km": 280,
      "duration_minutes": 165,
      "start_soc_percent": 90,
      "end_soc_percent": 22
    },
    {
      "type": "charge",
      "location": {
        "lat": 35.3733,
        "lng": -119.0187,
        "name": "Tesla Supercharger - Bakersfield"
      },
      "duration_minutes": 25,
      "start_soc_percent": 22,
      "end_soc_percent": 75,
      "charger_info": {
        "network": "tesla_supercharger",
        "power_kw": 250
      }
    },
    {
      "type": "drive",
      "start": { "lat": 35.3733, "lng": -119.0187 },
      "end": { "lat": 34.0522, "lng": -118.2437 },
      "distance_km": 335,
      "duration_minutes": 180,
      "start_soc_percent": 75,
      "end_soc_percent": 28
    }
  ]
}

Next Steps

Previous

EVRP Overview

Next

Vehicle Configuration

On this page