Bodha Route Planner REST API

The Bodha Route Planner API lets you push orders from your OMS, read optimized routes, update stop status from your own systems, and receive real-time webhook notifications when things happen.

The API is available on the Pro plan. You can manage your API keys from Settings → Developer Portal in the Bodha Route Planner dashboard.

Base URL

https://api.bodha.run/api/v1

All endpoints are prefixed with /api/v1. Responses are JSON.

Quick start

Create an API key

Go to Settings → Developer Portal and click Create key. Choose your scopes and copy the key — it’s shown only once.

Make your first request

curl -H "X-API-Key: bk_live_abc123..." \
     https://api.bodha.run/api/v1/ping

Push an order

curl -X POST https://api.bodha.run/api/v1/orders \
     -H "X-API-Key: bk_live_abc123..." \
     -H "Content-Type: application/json" \
     -d '{
       "externalOrderId": "ORD-1043",
       "recipient": { "fullName": "Jane Smith" },
       "location": {
         "address": "456 Oak Ave, San Francisco, CA 94102",
         "latitude": 37.7751,
         "longitude": -122.4193
       }
     }'

Set up a webhook

In the Developer Portal, add a webhook endpoint to get notified when routes are dispatched or stops are completed.

Resources

Resource	Description
Routes	Planned and active delivery routes
Stops	Individual delivery or pickup stops on a route
Orders	Incoming work from your OMS or integrations
Webhooks	Real-time event notifications

Overview

Routes

Stops

Orders

Webhooks

API Introduction

Bodha Route Planner REST API

Base URL

Quick start

Resources

​Bodha Route Planner REST API

​Base URL

​Quick start

​Resources

Bodha Route Planner REST API

Base URL

Quick start

Resources