Optimiciti Developer PortalOptimiciti Developer Portal
  • Pricing
  • Documentation
  • API Reference
  • Your API Key
Information
Problem
    Run an optimization modelpostReturns optimization status and results, if availablegetCancel the optimization run identified by the problemId parameterpost
Utilities
    Health Checkget
Billing
    List public plansget
History
    Get User RunspostGet Run IdspostGet Run SummariespostList Example ScenariospostGet Scenario SummariespostGet Run ResultspostGet Saved ScenariopostGet a published example scenariogetUpdate Run NamepostDelete RunpostDelete Saved ScenariopostSave ScenariopostRename ScenariopostUpdate ScenariopostClaim Anonymous Runspost
Data-processing
    Calculate a cost matrix for the given locationspostConvert To ExcelpostConvert To JSONpost
System
    Read Rootget
Optimization
    Get Run StatuspostCancel Runpost
Schemas
powered by Zuplo
Optimiciti API Specification
Optimiciti API Specification

Problem

Submit an optimization problem and follow it to completion. This is the core of the API - build your problem, submit it, poll for status, then read the optimized routes.


Run an optimization model

POST
https://api.optimiciti.com
/problem

Run the optimization model specified by the input model type and data

Run an optimization model › Request Body

The complete request payload for the /problem endpoint.
SolveRequest
userId
​string · required

The User ID

​ProblemRequest · required

The Problem object embedded within the main solve request.

exampleSlug
​string

Optional. The slug of the published example scenario this solve was loaded from (as returned by /list_examples). Published examples legitimately exceed the free tier's size limits, so sending this grants a bounded allowance sized from that example's own row counts plus a small edit margin - enough to run and tweak the demo, and never more than the named example's real size. Omit it for a user's own scenarios; an unrecognised slug is ignored.

Run an optimization model › Responses

Request accepted

RequestAccepted
problemId
​string

The unique identifier for this optimization run. You will want to store this locally so that you can use in your GET request for /problem.

POST/problem
curl https://api.optimiciti.com/problem \ --request POST \ --header 'Content-Type: application/json' \ --data '{ "userId": "userId", "problem": { "problemType": "vehicle-routing", "problemData": { "locations": [ {} ], "trips": [ {} ], "vehicles": [ {} ], "vehicleTypes": [ {} ], "travelCosts": [ {} ] }, "timeSettings": { "timeUnit": "integer", "timeFormat": null, "multipleDays": false, "dateUnit": "integer", "dateFormat": null }, "coordinateSystem": "geographic" }, "exampleSlug": "exampleSlug" }'
Example Request Body
{ "userId": "userId", "problem": { "problemType": "vehicle-routing", "problemData": { "locations": [ {} ], "trips": [ {} ], "vehicles": [ {} ], "vehicleTypes": [ {} ], "travelCosts": [ {} ] }, "timeSettings": { "timeUnit": "integer", "timeFormat": null, "multipleDays": false, "dateUnit": "integer", "dateFormat": null }, "coordinateSystem": "geographic" }, "exampleSlug": "exampleSlug" }
json
Example Responses
{ "problemId": "problemId" }
json
application/json

Returns optimization status and results, if available

GET
https://api.optimiciti.com
/problem/{problemId}

Returns the status of the optimization problem identified by the problemId parameter. If results are available, returns the results object.

Returns optimization status and results, if available › path Parameters

problemId
​string · required · explode: true

The problemId of a previously submitted problem to check the status of

Returns optimization status and results, if available › Responses

valid request

ProblemStatus
status
​string · enum · required

The status of the optimization problem identified by the problemId parameter.

Enum values:
failed
completed
running
queued
Example: completed
GET/problem/{problemId}
curl https://api.optimiciti.com/problem/:problemId
Example Responses
{ "status": "completed" }
json
application/json

Cancel the optimization run identified by the problemId parameter

POST
https://api.optimiciti.com
/problem/cancel/{problemId}

Cancel the optimization run identified by the problemId parameter. If the optimization run is already completed, this will have no effect.

Cancel the optimization run identified by the problemId parameter › path Parameters

problemId
​string · required · explode: true

The problemId of a previously submitted problem to cancel

Cancel the optimization run identified by the problemId parameter › Responses

valid request

No data returned
POST/problem/cancel/{problemId}
curl https://api.optimiciti.com/problem/cancel/:problemId \ --request POST
Example Responses
No example specified for this content type

Utilities