Routestripe API
MainKnowledge BaseSupport CentreAPI Reference
MainKnowledge BaseSupport CentreAPI Reference
  1. Default module
  • Introduction
    • What Is RouteStripe
    • Quick Start Guide
    • API Parameters
  • Default module
    • Get optimized locations
      POST
  • Management API
    • Visits
      • Store Visit
      • Update Visit by field
      • Get Visit
      • Get Visits
      • Delete Visit
    • Attachments
      • Store Attachment
      • Get Attachments
      • Get Attachment Image
      • Delete Attachment
    • Warehouses
      • Store Warehouse
      • Update Warehouse by field
      • Get Warehouse
      • Get Warehouses
      • Delete Warehouse
    • Vehicles
      • Store Vehicle
      • Update Vehicle by field
      • Get Vehicle
      • Get Vehicles
      • Delete Vehicle
    • Members
      • Store Member
      • Update Member by field
      • Get Member
      • Get Members
      • Delete Member
    • Plans
      • Store Plan
      • Update Plan by field
      • Get Plan
      • Get Plans.
      • Delete Plan
    • Routes
      • Store Route
      • Update Route by field
      • Get Route
      • Get Routes
      • Delete Route
    • Companies
      • Get Company
      • Update Company by field
    • Countries
      • Get Countries
  • Webhooks
    • Webhooks & Real-time Updates
  1. Default module

Get optimized locations

POST
https://api.routestripe.com/route-matrix
This endpoint allows you to submit an optimization request using multiple variables. Here you may set up optimization coefficient, add objects with corresponding parameters, and test out the possible responses.

Request

Body Params application/json

Examples

Responses

🟢200Success
application/json
Body

🔴500Server Error
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.routestripe.com/route-matrix' \
--header 'Content-Type: application/json' \
--data-raw '{
    "fleet": {
        "99": {
            "load": 0,
            "profile": "auto",
            "shift_end": "21:00",
            "vehicle_id": 55,
            "shift_start": "08:00",
            "max_distance": 1001000,
            "speed_factor": 1,
            "start_location": {
                "id": "start_location_50.426195_30.538123",
                "lat": 50.426195,
                "lng": 30.538123,
                "name": "start_location_50.426195_30.538123"
            }
        },
        "111": {
            "load": 100,
            "profile": "auto",
            "capacity": 5,
            "shift_end": "20:11",
            "vehicle_id": 1,
            "shift_start": "13:01",
            "max_distance": 1001000,
            "speed_factor": 1,
            "start_location": {
                "id": "start_location_50.426195_30.538123",
                "lat": 50.426195,
                "lng": 30.538123,
                "name": "start_location_50.426195_30.538123"
            }
        }
    },
    "visits": {
        "562": {
            "end": "20:00",
            "load": 0,
            "type": "D",
            "start": "08:00",
            "capacity": 0,
            "duration": 5,
            "location": {
                "lat": 50.424083,
                "lng": 30.532379
            }
        },
        "563": {
            "end": "20:00",
            "load": 0,
            "type": "D",
            "start": "08:00",
            "capacity": 0,
            "duration": 5,
            "location": {
                "lat": 50.472606,
                "lng": 30.498047
            }
        },
        "822": {
            "end": "20:00",
            "load": 0,
            "type": "D",
            "start": "08:00",
            "capacity": 0,
            "duration": 5,
            "location": {
                "lat": 50.466693,
                "lng": 30.487747
            }
        }
    },
    "options": {
        "polylines": true,
        "avoid_tolls": false,
        "avoid_highways": true,
        "squash_duration": "1.00",
        "visit_balance_coefficient": 0
    },
    "country_id": 1
}'
Response Response Example
200 - Success
{
  "auth": true,
  "num_late_visits": 0,
  "num_unserved": 0,
  "solution": {
    "99": [
      {
        "distance": 0,
        "finish_time": "08:00",
        "location_id": "start_location_50.426195_30.538123",
        "arrival_time": "08:00",
        "location_name": "start_location_50.426195_30.538123"
      },
      {
        "distance": 7.281,
        "finish_time": "08:17",
        "location_id": 822,
        "arrival_time": "08:13",
        "location_name": 822
      },
      {
        "distance": 4.48,
        "finish_time": "08:31",
        "location_id": 563,
        "arrival_time": "08:27",
        "location_name": 563
      }
    ],
    "111": [
      {
        "distance": 0,
        "finish_time": "13:01",
        "location_id": "start_location_50.426195_30.538123",
        "arrival_time": "13:01",
        "location_name": "start_location_50.426195_30.538123"
      },
      {
        "distance": 2.506,
        "finish_time": "13:10",
        "location_id": 562,
        "arrival_time": "13:06",
        "location_name": 562
      }
    ]
  },
  "status": "success",
  "total_break_time": 0,
  "total_idle_time": 0,
  "total_travel_time": 26,
  "total_vehicle_overtime": 0,
  "total_visit_lateness": 0,
  "total_working_time": 41,
  "unserved": null,
  "vehicle_overtime": {
    "99": 0,
    "111": 0
  },
  "total_distance": 14.267,
  "polylines": {
    "99": [
      "orxd_Bczzfy@sDfEgEbGg@f@_DzEsIzJc`@gaAsDgJSg@{@gJvG_I~a@cj@f@oAf@oA?oA?oASoAS{@g@{@{@Sg@Sg@Rg@Rg@Ro_@rg@wGrIkHfJoAbBcBvBgTrXknAj}AwQnUcVb[_DfEsDzE{EvG{EbGwLzO_InK_{@jiAg@f@gh@fr@gJvL_{@jiAsDzEcBbB_Xr]wB~CwcArtA_DfEcBvBos@zaAcVj\\on@~_AgYbe@g@z@_IjMsDzEg@f@oAz@cBz@wBz@{J~CcLfEkCvL{@jCoArDg^zr@_InPg^bt@gEnFkCjC{EjC_DnA{Ez@{JbBg@RgEf@gJbB_NvBwVrD_Df@_DRwBRgEf@{Ef@kHz@oARcBnAcBbBwBfEcBzEg@nF_D~a@g@nFwBjRg@bBg@vBg@bB{@vBoPsDsXwG_v@cQsDSwBRg@?S?SRSRSRg@RSf@Sf@{@vL{E~f@cBzTsNr~Ag@rD?f@{@~HcBrS{Ebj@cBvQsD~a@oAjMwVrpC{@zJ{@fJ_Dn_@oFnn@SbBkCzYSjCS~C_Iv~@SnAgEfc@kHfw@g@nFg@zE?nAgJ~dASnASjCoAvLg@jHcBfOsD~a@gErb@oF~k@cG~p@g@zEg@bGcBfTc[fjDg@~C?nAcLnlAoAzOSvBsD~a@SnAg@~CcBrD{@f@oAf@_Df@sIrIoFnFsDfEoAz@sIzJoAz@wGjHcBbBkCjC{JnKkC~CsXfYsDrDoFvGo_@v`@cQvQsIrI{EnFkR~RcQvQ{JnK{EnF{m@bo@sDz@_Dg@sX_I_]wLoU{J_SkHsN{E_NgEcBg@cVg@oPS_D?{@SRrI?rNRb[f@bQf@jf@?nFRj\\Rz^RzJ?zORnUS~HSvGg@~CoAvGg@z@Sz@sXfw@cBrDkH~RwBnF_I~RoA~CsDnK_IbQcGnKgJnKgEzEcGbGkWvVsNrNwBvBoFfEwBvBgOfOSf@gc@nd@oKnKwQrSoPsl@cVs{@Sg@SkCg@?{@?{@RsD{@gaAkMoA?wQnAcBRg^zJw[nKoKrD_Dz@{J~CoAf@{TrDwQjCkHRoPR?oAf@{^RcLnAgkA_q@_D{J{@{ErDwLnA_SgE{@g@z@f@~RfEvLoAzEsDzJz@~p@~CoAfkASbLg@z^?nAnPSjHSvQkCzTsDnAg@zJ_D~C{@nKsDv[oKf^{JbBSvQoAnA?faAjMrDz@z@Sz@?f@??oZSwhA?sD?cG?kCg@wBg@wBg@cBS{@cBcB_D_DsjAc~@oAwBg@cBg@wBg@cGg@gJg@sSS_IS{ToAchASwLcBolAg@wV?sI?sIf@cGnAsIbBkHf@cBvBcLjHkWfEgOnAgEz@{Ef@gERoF?gToAwt@SwLg@sX{@kk@?wBg@cV{@s]g@{OSkMS{Eg@sl@g@sIoA{JwBsIsIc[cB{E{@_DgE{OsDoP_DoPkCgOkCoPsDgYcBsSg@wLSkHR_IRkHf@wGz@{ErDoPrNgm@vBgJz@gJbGcLRSsNkWcBsD{c@cy@gTg^gY_g@cGcL{@wBcB_D_I{Og@{@sIgO{JwQcB_DcB_DsDnFsDjHoAbB{@nAoAjCoAvBkHfO{h@~dAg@fEg@nAsIzOoAjCgc@fw@_DbGg@nAcBg@{To_@g@oAoAwBwBgEkf@{|@g@cBcB_DoAwBoAcBkCnFg^bo@oKrS{EzJcB~CwBrDsNzY{@bBoFfJ{Yjk@kCnFkHjMwe@f|@cBrDwBfEc`@bt@gOzYg@nA{@nAg@z@{@bB_IzO_DvGoFfJgE~HkWjf@_Nb[cLnUoK~R_IrNoKrSwGvLvB~CvBvGja@jp@zERfTr]~CcBbQnZoFvL"
    ],
    "111": [
      "orxd_Bczzfy@sDfEgEbGg@f@_DzEsIzJc`@gaAsDgJSg@{@gJvG_I~a@cj@jHsIjHgJzOsS~CgEni@os@v[w`@~CsDnFwG~H_IrIkHnP{Jve@gYnKwGzEkCjHoFzEwGbGkH~W{^rDoF~CrIjHvQvVnn@jCzEvB~CvB~CvVvVnKnKzTbVv[~\\jk@rl@jCjCfYzYzEnFjR~RrD~CRrIsNj_A{Jbo@{@jHsIzh@_Ifh@{@bGoAbGSbBoPzfA{@bGgOr`AwBvLoAfJcBbLoFv[_I~f@oAbLg@jCcGja@sI_D_v@oPkC{@gJwBoPsDsDwBsg@{YwB{@_SgOkCoA{c@_IcBg@fE{O"
    ]
  }
}
Modified at 2026-03-27 11:09:12
Previous
API Parameters
Next
Store Visit
Built with