Optimize Engine
  1. Optimization
Optimize Engine
  • Health
    • Check health
      GET
  • Optimization
    • Optimize Sync Process
      POST
    • Optimization Engine Asynchronous Process
      POST
    • Get Optimization Status
      GET
  • Authentication
    • User Login
      POST
    • User Logout
      POST
    • User Logout All
      POST
  • Schemas
    • Schemas
      • Configuration
      • Location
      • Vehicle
      • Job
      • OptimizeRequest
      • Summary
      • Stop
      • Route
      • OptimizeResponse
      • Error
      • OptimizationCreateResponse
      • OptimizationStatusResponse
      • LoginRequest
      • LoginResponse
  1. Optimization

Optimization Engine Asynchronous Process

POST
/api/v1.0/optimization
Submit problem and then get the job id for further checking

Request

Authorization
JWT Bearer
Add the parameter
Authorization
to Headers
Example:
Authorization: ********************
or
Body Params application/jsonRequired

Examples

Responses

🟢201Created
application/json
Optimization job created successfully
Body

🟠400Bad Request
🟠401Unauthorized
🔴500Server Error
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST '/api/v1.0/optimization' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "configuration": {
        "objective": "minimize_cost"
    },
    "locations": [
        {
            "id": "warehouse_intirub_halim",
            "lat": -6.2536,
            "lon": 106.8842,
            "type": "WAREHOUSE",
            "operational_hours": [
                {
                    "start": "2025-09-14T07:00:00+07:00",
                    "end": "2025-09-14T12:00:00+07:00"
                }
            ],
            "timezone": "Asia/Jakarta"
        }
    ],
    "vehicles": [
        {
            "id": "van_001",
            "start_location_id": "warehouse_intirub_halim",
            "end_location_id": "warehouse_intirub_halim",
            "capacities": {
                "weight": 300000
            },
            "available_time_windows": [
                {
                    "start": "2025-09-14T08:00:00+07:00",
                    "end": "2025-09-14T17:00:00+07:00"
                }
            ],
            "fixed_cost": 200,
            "cost_per_distance": 2.5,
            "cost_per_time": 0.5,
            "skills": [
                "refrigerated",
                "hazmat_certified"
            ]
        }
    ],
    "jobs": [
        {
            "id": "pickup_wh_intirub_halim",
            "type": "DELIVERY",
            "location_id": "warehouse_intirub_halim",
            "demands": {
                "weight": 120000,
                "volume": 2.5,
                "pallets": 4
            },
            "time_window": {
                "start": "2025-09-14T12:00:00+07:00",
                "end": "2025-09-14T16:00:00+07:00"
            },
            "service_time": 60,
            "required_skills": [
                "refrigerated"
            ],
            "priority": 1,
            "predecessor_job_ids": [
                "job_123"
            ]
        }
    ]
}'
Response Response Example
201 - Example 1
{
    "optimization_id": "a1b2-c3d4-e5f6",
    "status": "PENDING",
    "estimated_completion_time": "2025-09-05T19:59:14+07:00",
    "estimated_duration": 300
}
Modified at 2025-09-25 12:17:15
Previous
Optimize Sync Process
Next
Get Optimization Status
Built with