# NextBillion.ai API

**Canonical:** https://apis.io/apis/nextbillion-ai/nextbillion-ai-api/  
**Provider:** NextBillion.ai — https://apis.io/providers/nextbillion-ai/  
**Base URL:** https://api.nextbillion.io  
**Documentation:** https://docs.nextbillion.ai/routing/directions-api

NextBillion.ai API is one of 2 APIs that [NextBillion.ai](https://apis.io/providers/nextbillion-ai/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 5 JSON Schema definitions. The published artifact set on APIs.io includes an OpenAPI specification and 5 JSON Schemas.

NextBillion.ai API as documented publicly: 18 operations. Contract generated from the documentation by API Evangelist (2026-10-13); not the provider's own document.

## Operations (18)

| Method | Path | Summary |
|---|---|---|
| GET | `/directions/json` | Directions Flexible API |
| POST | `/directions/json` | Directions Flexible API |
| GET | `/distancematrix/json` | Distance Matrix API Synchronous |
| POST | `/distancematrix/json` | Distance Matrix API Synchronous |
| POST | `/hos/trip-plan` | POST /hos/trip-plan |
| GET | `/isochrone/json` | GET /isochrone/json |
| POST | `/mdm/create` | POST /mdm/create |
| GET | `/mdm/status` | Use this method to retrieve the Distance Matrix solution link for the tasks created using either of the Asynchronous Distance Matrix POST methods. |
| GET | `/navigation` | Navigation API |
| POST | `/navigation` | Navigation API |
| GET | `/navigation/json` | Navigation API |
| POST | `/navigation/json` | POST /navigation/json |
| POST | `/optimization/driver-assignment/v1` | The Driver Assignment API’s synchronous method caters to quick, near real‑time assignment requirements. |
| GET | `/optimization/driver-assignment/v1/async` | To obtain the calculated assignment solution, you must provide the specific id that was generated and returned after submitting the initial POST request. |
| POST | `/optimization/driver-assignment/v1/async` | POST /optimization/driver-assignment/v1/async |
| POST | `/optimization/re_optimization` | Re-optimize An Existing Solution |
| POST | `/optimization/v2` | Build an Optimization Request |
| GET | `/optimization/v2/result` | Retrieve Optimized Solution |

## Machine-readable artifacts (6)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/nextbillion-ai/refs/heads/main/openapi/_ae-authored/nextbillion-ai-openapi-generated.yml
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/nextbillion-ai/refs/heads/main/json-schema/nextbillion-ai-post-navigation-request-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/nextbillion-ai/refs/heads/main/json-schema/nextbillion-ai-get-mdm-status-response-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/nextbillion-ai/refs/heads/main/json-schema/nextbillion-ai-get-navigation-json-response-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/nextbillion-ai/refs/heads/main/json-schema/nextbillion-ai-get-navigation-response-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/nextbillion-ai/refs/heads/main/json-schema/nextbillion-ai-post-navigation-response-schema.json

## Other NextBillion.ai APIs (1)

- [NextBillion AI API](https://apis.io/apis/nextbillion-ai/nextbillion-ai-api-2/)

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/nextbillion-ai/nextbillion-ai-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/nextbillion-ai/.