Skip to main content

​
Welcome to Solvice

The Solvice Platform provides enterprise-grade optimization solvers through a simple REST API. Submit a problem, get back an optimized solution — with full explanations of every decision the solver made.

VRP Solver

Vehicle routing and fleet optimization with real-world constraints

CLUST Solver

Geographic clustering for territory and zone management

​
Getting Started

1

Create your account

Visit platform.solvice.io and sign up with your email or SSO provider.
New accounts include a 14-day free trial with full access to all solver capabilities.
2

Create an API key

Navigate to Settings → API Keys and click Create API Key.
Copy your API key immediately after creation. For security reasons, you won’t be able to view the full key again.
3

Solve a demo problem

With your API key ready, fetch a demo VRP problem and solve it in one go:
curl https://api.solvice.io/v2/vrp/demo -H "Authorization: YOUR_API_KEY" | \
curl https://api.solvice.io/v2/vrp/solve -X POST \
     -H "Authorization: YOUR_API_KEY" \
     -H "Content-Type: application/json" -d @-
The API returns a job ID. Your job appears in the dashboard Jobs section within seconds.
4

Retrieve the solution

Poll for status, then fetch the result:
curl 'https://api.solvice.io/v2/vrp/jobs/{jobId}/status' \
  -H 'Authorization: YOUR_API_KEY'

curl 'https://api.solvice.io/v2/vrp/jobs/{jobId}/solution' \
  -H 'Authorization: YOUR_API_KEY'

​
How It Works

Every solver follows the same four-step pattern: submit, monitor, retrieve, understand.
1

Submit optimization request

Send your problem data to the appropriate solver endpoint. The API immediately returns a job ID for tracking.
POST /v2/{solver}/solve
2

Monitor job progress

Poll the status endpoint to track optimization progress. Jobs transition through states: QUEUED → SOLVING → SOLVED.
GET /v2/{solver}/jobs/{jobId}/status
3

Retrieve optimized solution

Once solved, fetch your optimized solution with detailed assignments and metrics.
GET /v2/{solver}/jobs/{jobId}/solution
4

Understand decisions

Get explanations for constraint violations and optimization trade-offs.
GET /v2/{solver}/jobs/{jobId}/explanation

​
Unified API Design

Every Solvice solver follows consistent REST patterns, making integration straightforward across your entire optimization stack.

​
Solve

Submit optimization requests for processing. This is the primary endpoint for all solvers.
​
request
object
required
Solver-specific request object containing your problem definition
​
jobId
string
required
Unique identifier for tracking your optimization job
​
status
string
required
Initial job status (typically QUEUED)

​
Evaluate

Assess the quality of existing solutions without optimization.
Available for VRP solver only

​
Suggest

Get intelligent suggestions for single assignment improvements.
Available for VRP solver only

​
Authentication

All API requests require an API key in the Authorization header. See the authentication guide for setup and security best practices.

​
Asynchronous Processing

Optimization problems can take seconds to minutes depending on complexity. Asynchronous processing keeps your application responsive while the solver works. 
async function waitForSolution(jobId) {
  const maxAttempts = 60;
  const pollInterval = 5000; // 5 seconds

  for (let i = 0; i < maxAttempts; i++) {
    const status = await checkJobStatus(jobId);

    if (status === 'SOLVED') {
      return await fetchSolution(jobId);
    } else if (status === 'ERROR') {
      throw new Error('Optimization failed');
    }

    await sleep(pollInterval);
  }

  throw new Error('Optimization timeout');
}
For low-latency requirements, VRP solver offers synchronous endpoints:
POST /v2/vrp/solve/sync
POST /v2/vrp/evaluate/sync
POST /v2/vrp/suggest/sync
Synchronous endpoints have stricter size and time limits.

​
Dashboard

The Solvice Dashboard gives you real-time visibility into API keys, running jobs, solutions, and usage.
SectionWhat you’ll find
JobsAll optimization requests with status, solver type, duration, and drill-down to solution/explanation/raw JSON
API KeysCreate, revoke, and monitor keys with per-solver permissions
UsageAPI calls, solve time, and quota tracking over time
SettingsProfile, team management, billing, and notification preferences

​
Next Steps

VRP Quickstart

Solve your first routing problem

Authentication

API key setup and security best practices

SDK Libraries

Use our SDKs for faster integration

Claude & MCP

Connect AI assistants to the solver