API Reference

Overview

The EVRP API provides EV-optimized route planning with intelligent charging stop recommendations.

Base URLs

Environment	URL
Production	`https://routing.moovex.ai/api/v1`
Staging	`https://routing.staging.moovex.ai/api/v1`

Authentication

All requests require a Bearer token:

Authorization: Bearer YOUR_API_KEY

Endpoints

Resource	Description
Generate Route	Calculate EV-optimized route synchronously
Generate Route Async	Calculate route asynchronously
Get Route Result	Retrieve async route result

Data Types

Location

interface Location {
  lat: number;
  lng: number;
  name?: string;
  address?: string;
}

Vehicle

interface Vehicle {
  model?: string;
  custom_profile?: {
    battery_capacity_kwh: number;
    consumption_wh_per_km: { city: number; highway: number; combined: number };
    max_charge_rate_kw: number;
  };
  current_soc_percent: number;
}

Preferences

interface Preferences {
  charging_strategy?: 'minimum' | 'balanced' | 'comfortable';
  min_arrival_soc_percent?: number;
  optimize_for?: 'time' | 'cost' | 'comfort';
}

Error Codes

Code	Status	Description
`invalid_location`	400	Invalid origin or destination
`unreachable`	400	No route possible
`invalid_vehicle`	400	Invalid vehicle config
`auth_failed`	401	Invalid API key
`rate_limited`	429	Too many requests

On this page