Evaluate the route response before integrating.

The evaluation API turns coordinates or resolved addresses into an ordered route with distance, duration, and road geometry. It is rate-limited, has no service-level guarantee, and is not open for production customer data.

Evaluation environment

No API keys are issued yet. Browser calls must be same-origin; server-to-server evaluation is rate-limited. Contact MileMeld before building a dependency.

Beta access

The public evaluation does not use API keys. Production access will not open until scoped keys, quotas, idempotency, retention controls, and support are operational.

Quickstart

Send between two and twenty coordinate-backed stops. Evaluation routes return synchronously.

cURL

curl https://milemeld.com/api/v1/optimizations \
  -H "Content-Type: application/json" \
  -d '{
    "roundTrip": true,
    "stops": [
      {
        "id": "depot",
        "label": "Main depot",
        "address": "Louisville, KY",
        "coordinates": [-85.7585, 38.2527]
      },
      {
        "id": "customer-1",
        "label": "First call",
        "address": "Prospect, KY",
        "coordinates": [-85.6155, 38.3451]
      }
    ]
  }'

Response

200 OK

{
  "stops": [ /* optimized order */ ],
  "distanceMeters": 39790,
  "durationSeconds": 2534,
  "savedMeters": 3218,
  "geometry": {
    "type": "LineString",
    "coordinates": [ /* lng, lat */ ]
  },
  "engine": "osrm"
}

POST/api/v1/geocodes

Resolve an address

Returns up to five normalized matches from the configured geocoder or OpenStreetMap Nominatim. If no reliable match exists, the endpoint returns an error and never invents a pin.

Request

{
  "query": "Churchill Downs, Louisville, KY"
}

POST/api/v1/optimizations

Optimize a route

Orders 2–20 stops while keeping the first stop fixed. In one-way mode, the final stop is also fixed.

stopsStop[]Required · 2–20 coordinate-backed stops

roundTripbooleanRequired · Return to the first stop when true

GET/api/v1/usage

Read published limits

Returns the current public-beta plan name, browser allowance policy, and maximum route size. It does not return account-scoped usage.

Errors

Errors use a stable machine-readable code and a concise message suitable for logs and user interfaces. If road routing is unavailable, optimization fails without changing the submitted order.

422 Unprocessable Entity

{
  "error": {
    "code": "INVALID_STOP_COUNT",
    "message": "Submit between 2 and 20 stops during the public beta."
  }
}

INVALID_JSON Malformed request bodyINVALID_STOP Missing or invalid stop fieldsINVALID_STOP_COUNT Outside public-beta limitsRATE_LIMITED Source request limit reachedROUTER_UNAVAILABLE Road router could not return a verified route

Limits

Public evaluation: 20 stops per request
Nationwide United States road routing
Requests are rate-limited by source address
Coordinates avoid geocoding requests
No uptime or compatibility SLA during evaluation

Environments

The hosted evaluation is available without keys for low-volume testing. Do not send private customer data until production authentication and retention controls are active.

Hosted evaluationhttps://milemeld.com/api/v1

Rate limited

Local developmenthttp://localhost:3000/api/v1

Available

Next step

Try the planner before integrating.

Open MileMeld