{"docsConfig":{"theme":"maple","$schema":"https://mintlify.com/docs.json","name":"Solvice Docs","description":"Solvice API documentation for cloud-native optimization solvers. Build powerful route optimization, workforce scheduling, and resource allocation solutions with our VRP, shift planning, and clustering APIs.","colors":{"primary":"#0f62fe","light":"#0f62fe","dark":"#0f62fe"},"logo":{"light":"https://mintcdn.com/solvice-68592f22/1KJ_2AIotizI1Bng/logo/light.svg?fit=max\u0026auto=format\u0026n=1KJ_2AIotizI1Bng\u0026q=85\u0026s=e93560fee320491613107060a1afc094","dark":"https://mintcdn.com/solvice-68592f22/1KJ_2AIotizI1Bng/logo/dark.svg?fit=max\u0026auto=format\u0026n=1KJ_2AIotizI1Bng\u0026q=85\u0026s=1baeb15bf7826f571444a1d6a36fb31a"},"favicon":"https://mintcdn.com/solvice-68592f22/noMIHjSWP2Tg_tTz/favicon.png?fit=max\u0026auto=format\u0026n=noMIHjSWP2Tg_tTz\u0026q=85\u0026s=beff99df9d507e0794596b5437be687f","api":{"mdx":{"auth":{"method":"key","name":"Authorization"}}},"navbar":{"links":[{"href":"mailto:support@solvice.io","label":"Support"},{"href":"https://www.solvice.io","label":"Solvice website"}],"primary":{"type":"button","label":"Dashboard","href":"https://platform.solvice.io"}},"footer":{"socials":{"website":"https://www.solvice.io","x":"https://x.com/solvice_io","github":"https://github.com/solvice","linkedin":"https://linkedin.com/company/solvice"}},"seo":{"metatags":{"og:image":"link to your default meta tag image","charset":"UTF-8","viewport":"width=device-width, initial-scale=1.0","description":"Solvice API documentation for cloud-native optimization solvers. Build powerful route optimization, workforce scheduling, and resource allocation solutions with our VRP, shift planning, and clustering APIs.","keywords":"Route Optimization, Route API, Optimization API, Workforce Scheduling, Solvice","author":"Christophe Van Huele","robots":"index, follow","googlebot":"index, follow","google":"notranslate","google-site-verification":"verification_token"},"indexing":"all"},"integrations":{"ga4":{"measurementId":"G-2L8R78J6J9"}},"banner":{"content":"Solvice VRP API v3 is in beta. General availability (GA) is planned for January 2027.","dismissible":false},"contextual":{"options":["claude","copy"],"display":"header"},"styling":{"latex":true},"navigation":{"global":{"anchors":[{"anchor":"Dashboard","icon":"book-open-cover","href":"https://platform.solvice.io"},{"anchor":"Website","icon":"planet-ringed","href":"https://www.solvice.io"},{"anchor":"Blog","icon":"newspaper","href":"https://www.solvice.io/blog/news"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"solvice-68592f22","hasAudioNarration":false,"actualSubdomain":"solvice-68592f22","customDomains":["docs.solvice.io"],"gitSource":{"type":"gitlab","owner":"solvice","repo":"solver2","projectId":44919668,"deployBranch":"main","contentDirectory":"mintlify","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae35beb9b40269dc6b4b8b0","collectionId":"524016b9-4bce-41ca-889d-c854269b0749","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae35beb9b40269dc6b4b8b0"},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"DISABLED"},"REMOVE_BRANDING":{"status":"DISABLED"}},"buildId":"6ae35beb9b40269dc6b4b8b0","clientVersion":"0.0.4021","searchFilterCounts":[{"language":"default","tag":"Guides","count":81},{"language":"default","tag":"VRP API","count":49},{"language":"default","tag":"Features","count":32},{"language":"default","tag":"Routing API","count":28},{"language":"default","tag":"API Reference","count":26},{"language":"default","tag":"Fill API","count":20},{"language":"default","tag":"Platform","count":10},{"language":"default","tag":"Examples","count":9},{"language":"default","tag":"Concepts","count":9},{"language":"default","tag":"Info","count":6}]},"assistantConfig":{"deflection":{"enabled":true,"email":"support@solvice.io","showHelpButton":true}},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"per-site-search-delta","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-private-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/fill/solution","slug":"/api-reference/fill/solution","pageMetadata":{"title":"Fill Solution","openapi":"fill GET /v2/fill/jobs/{id}/solution","description":"Contains the actual solution, once solved.","href":"/api-reference/fill/solution"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Contains the actual solution, once solved.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Fill Solution","openapi":"fill GET /v2/fill/jobs/{id}/solution","description":"Contains the actual solution, once solved.","href":"/api-reference/fill/solution"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Solution","description":"Contains the actual solution, once solved.","operationId":"getFillSolution","tags":["Info"],"parameters":["ab9d12c0-842d-4038-bab1-9af561a57555"],"responses":{"200":"91010d7e-610e-4ef2-b580-21bd4e8ff5b0"},"method":"get","type":"path","servers":["bde8538f-22cc-4d5b-8087-edfb462a71c9"],"security":["d60debd5-26d9-409a-9b0e-598902fd3f09"],"path":"/v2/fill/jobs/{id}/solution","baseUrlOptions":["https://api.solvice.io"],"title":"Solution","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"ab9d12c0-842d-4038-bab1-9af561a57555":{"name":"id","in":"path","required":true,"schema":{"type":"string","isRequired":true,"uniqueKey":"","typeLabel":"string"}}},"responses":{"91010d7e-610e-4ef2-b580-21bd4e8ff5b0":{"description":"OK","content":{"application/json":{"schema":{"type":"object","description":"Fill response from solve","properties":{"id":{"oneOf":[{"type":"string","examples":["0000-00000-00000-0000"],"description":"Id of the solve job","uniqueKey":"id.oneOf.0","typeLabel":"string"},{"type":"null","examples":["0000-00000-00000-0000"],"description":"Id of the solve job","uniqueKey":"id.oneOf.1","typeLabel":"null"}],"uniqueKey":"id","typeLabel":"string | null"},"status":{"oneOf":[{"type":"string","description":"Status of the solve job.","enum":["ERROR","QUEUED","SOLVING","SOLVED"],"example":"SOLVED","uniqueKey":"status.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","uniqueKey":"status.oneOf.1","typeLabel":"null"}],"uniqueKey":"status","typeLabel":"enum\u003cstring> | null"},"score":{"oneOf":[{"type":"object","description":"The score of a solution shows how good this solution is w.r.t all the constraints. All solvers try to maximize the score.","properties":{"hardScore":{"oneOf":[{"type":"integer","format":"int64","description":"The score of the constraints that are hard. This should be 0 in order to be feasible.","uniqueKey":"score.oneOf.0.hardScore.oneOf.0","typeLabel":"integer\u003cint64>"},{"type":"null","format":"int64","description":"The score of the constraints that are hard. This should be 0 in order to be feasible.","uniqueKey":"score.oneOf.0.hardScore.oneOf.1","typeLabel":"null"}],"uniqueKey":"score.oneOf.0.hardScore","typeLabel":"integer\u003cint64> | null"},"mediumScore":{"oneOf":[{"type":"integer","format":"int64","description":"The score of the constraints that are medium.","uniqueKey":"score.oneOf.0.mediumScore.oneOf.0","typeLabel":"integer\u003cint64>"},{"type":"null","format":"int64","description":"The score of the constraints that are medium.","uniqueKey":"score.oneOf.0.mediumScore.oneOf.1","typeLabel":"null"}],"uniqueKey":"score.oneOf.0.mediumScore","typeLabel":"integer\u003cint64> | null"},"softScore":{"oneOf":[{"type":"integer","format":"int64","description":"The score of the constraints that are soft.","uniqueKey":"score.oneOf.0.softScore.oneOf.0","typeLabel":"integer\u003cint64>"},{"type":"null","format":"int64","description":"The score of the constraints that are soft.","uniqueKey":"score.oneOf.0.softScore.oneOf.1","typeLabel":"null"}],"uniqueKey":"score.oneOf.0.softScore","typeLabel":"integer\u003cint64> | null"},"feasible":{"oneOf":[{"type":"boolean","uniqueKey":"score.oneOf.0.feasible.oneOf.0","typeLabel":"boolean"},{"type":"null","uniqueKey":"score.oneOf.0.feasible.oneOf.1","typeLabel":"null"}],"uniqueKey":"score.oneOf.0.feasible","typeLabel":"boolean | null"}},"uniqueKey":"score.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"score.oneOf.1","typeLabel":"null"}],"uniqueKey":"score","typeLabel":"object | null"},"assignments":{"oneOf":[{"type":"array","items":{"type":"object","required":["shift","from","to"],"description":"Shift assignment solution","properties":{"shift":{"type":"string","examples":["shift-1"],"description":"Shift id","isRequired":true,"uniqueKey":"assignments.oneOf.0.items.[INDEX].shift","typeLabel":"string"},"from":{"type":"string","format":"date-time","examples":["2021-01-01T08:00"],"description":"Start date-time","isRequired":true,"uniqueKey":"assignments.oneOf.0.items.[INDEX].from","typeLabel":"string\u003cdate-time>"},"to":{"type":"string","format":"date-time","examples":["2021-01-01T08:00"],"description":"End date-time","isRequired":true,"uniqueKey":"assignments.oneOf.0.items.[INDEX].to","typeLabel":"string\u003cdate-time>"},"skills":{"oneOf":[{"type":"array","examples":["[skill-1, skill-2]"],"items":{"type":"string","uniqueKey":"assignments.oneOf.0.items.[INDEX].skills.oneOf.0.items.[INDEX]","typeLabel":"string"},"description":"List of skills","uniqueKey":"assignments.oneOf.0.items.[INDEX].skills.oneOf.0","typeLabel":"string[]"},{"type":"null","examples":["[skill-1, skill-2]"],"items":{"type":"string"},"description":"List of skills","uniqueKey":"assignments.oneOf.0.items.[INDEX].skills.oneOf.1","typeLabel":"null"}],"uniqueKey":"assignments.oneOf.0.items.[INDEX].skills","typeLabel":"string[] | null"},"employee":{"oneOf":[{"type":"string","examples":["employee-1"],"description":"Employee id","uniqueKey":"assignments.oneOf.0.items.[INDEX].employee.oneOf.0","typeLabel":"string"},{"type":"null","examples":["employee-1"],"description":"Employee id","uniqueKey":"assignments.oneOf.0.items.[INDEX].employee.oneOf.1","typeLabel":"null"}],"uniqueKey":"assignments.oneOf.0.items.[INDEX].employee","typeLabel":"string | null"},"travelTimeInSeconds":{"oneOf":[{"type":"integer","format":"int64","examples":[123],"description":"Travel time in seconds","uniqueKey":"assignments.oneOf.0.items.[INDEX].travelTimeInSeconds.oneOf.0","typeLabel":"integer\u003cint64>"},{"type":"null","format":"int64","examples":[123],"description":"Travel time in seconds","uniqueKey":"assignments.oneOf.0.items.[INDEX].travelTimeInSeconds.oneOf.1","typeLabel":"null"}],"uniqueKey":"assignments.oneOf.0.items.[INDEX].travelTimeInSeconds","typeLabel":"integer\u003cint64> | null"}},"uniqueKey":"assignments.oneOf.0.items.[INDEX]","typeLabel":"object"},"description":"Actual solution: assignments per shift","uniqueKey":"assignments.oneOf.0","typeLabel":"object[]"},{"type":"null","items":{"type":"object","required":["shift","from","to"],"description":"Shift assignment solution","properties":{"shift":{"type":"string","examples":["shift-1"],"description":"Shift id"},"from":{"type":"string","format":"date-time","examples":["2021-01-01T08:00"],"description":"Start date-time"},"to":{"type":"string","format":"date-time","examples":["2021-01-01T08:00"],"description":"End date-time"},"skills":{"oneOf":[{"type":"array","examples":["[skill-1, skill-2]"],"items":{"type":"string"},"description":"List of skills"},{"type":"null","examples":["[skill-1, skill-2]"],"items":{"type":"string"},"description":"List of skills"}]},"employee":{"oneOf":[{"type":"string","examples":["employee-1"],"description":"Employee id"},{"type":"null","examples":["employee-1"],"description":"Employee id"}]},"travelTimeInSeconds":{"oneOf":[{"type":"integer","format":"int64","examples":[123],"description":"Travel time in seconds"},{"type":"null","format":"int64","examples":[123],"description":"Travel time in seconds"}]}}},"description":"Actual solution: assignments per shift","uniqueKey":"assignments.oneOf.1","typeLabel":"null"}],"uniqueKey":"assignments","typeLabel":"object[] | null"},"unassigned":{"oneOf":[{"type":"array","examples":["[shift-1]"],"items":{"type":"string","uniqueKey":"unassigned.oneOf.0.items.[INDEX]","typeLabel":"string"},"description":"Unassigned shifts","uniqueKey":"unassigned.oneOf.0","typeLabel":"string[]"},{"type":"null","examples":["[shift-1]"],"items":{"type":"string"},"description":"Unassigned shifts","uniqueKey":"unassigned.oneOf.1","typeLabel":"null"}],"uniqueKey":"unassigned","typeLabel":"string[] | null"},"unservedReasons":{"oneOf":[{"type":"object","examples":[{"shift-1":["Employee Skill Match"]}],"additionalProperties":{"type":"array","items":{"type":"string","enum":["Maximum Working Days","Minimum Working Days","Minimum Working Days for Unassigned Employees","Maximum Hours","Minimum Hours For Assigned Employees","Minimum Hours For Unassigned Employees","Earliest Shift Start","Latest Shift Start","Latest Shift End","Maximum Shift Length","DayOfWeek Working","Minimum Shift Length","Maximum Shifts On Same Day","Minimum Rest On Same Day","Employee Availability","Maximum Consecutive Working Days","Minimum Rest","Employee Working Days","No Concurrent Assignments","Shift Requirements","Linked Shifts","Employee Skill Match","Employee Critical Skill Match","Locked Assignment","Blacklist","Counter Days Worked","Counter Days Idle","Counter Hours Worked","Counter Shift Types Worked","Counter Shift Types Hours","Counter Weekends Worked","Counter Weekends Idle","Counter Max Consecutive Days","Sequence Days Worked","Sequence Days Idle","Sequence Hours Worked","Sequence Shift Types Worked","Sequence Shift Types Hours","Sequence Weekends Worked","Sequence Weekends Idle","Sequence Max Consecutive Days","Rest Minimum Duration","Rest Minimum Consecutive","Rest Before Shift","Rest After Shift","Rest Maximum Duration","Rest Total Duration","Pattern Prohibited","Shift Employee Preference","Unassigned Employee","Financial Costs per Employee","Wage Costs per Employee","Efficiency Costs per Employee","Fairness","Travel time","Travel time with availability locations","Priority","Employee Skill Match Soft","Employee Skill Level Match Soft","Pattern Preferred","Pattern Unpreferred","__unknown__"],"description":"Typed vocabulary of Fill constraints that can be violated. The `__unknown__` value is an input-only fallback used when deserializing an unrecognized constraint name; it is never returned by the solver in a response.","uniqueKey":"unservedReasons.oneOf.0.additionalProperties.items.[INDEX]","typeLabel":"enum\u003cstring>"},"uniqueKey":"unservedReasons.oneOf.0.additionalProperties","typeLabel":"enum\u003cstring>[]"},"description":"Per unassigned shift, the hard constraints blocking assignment.","uniqueKey":"unservedReasons.oneOf.0","typeLabel":"object"},{"type":"null","examples":[{"shift-1":["Employee Skill Match"]}],"additionalProperties":{"type":"array","items":{"type":"string","enum":["Maximum Working Days","Minimum Working Days","Minimum Working Days for Unassigned Employees","Maximum Hours","Minimum Hours For Assigned Employees","Minimum Hours For Unassigned Employees","Earliest Shift Start","Latest Shift Start","Latest Shift End","Maximum Shift Length","DayOfWeek Working","Minimum Shift Length","Maximum Shifts On Same Day","Minimum Rest On Same Day","Employee Availability","Maximum Consecutive Working Days","Minimum Rest","Employee Working Days","No Concurrent Assignments","Shift Requirements","Linked Shifts","Employee Skill Match","Employee Critical Skill Match","Locked Assignment","Blacklist","Counter Days Worked","Counter Days Idle","Counter Hours Worked","Counter Shift Types Worked","Counter Shift Types Hours","Counter Weekends Worked","Counter Weekends Idle","Counter Max Consecutive Days","Sequence Days Worked","Sequence Days Idle","Sequence Hours Worked","Sequence Shift Types Worked","Sequence Shift Types Hours","Sequence Weekends Worked","Sequence Weekends Idle","Sequence Max Consecutive Days","Rest Minimum Duration","Rest Minimum Consecutive","Rest Before Shift","Rest After Shift","Rest Maximum Duration","Rest Total Duration","Pattern Prohibited","Shift Employee Preference","Unassigned Employee","Financial Costs per Employee","Wage Costs per Employee","Efficiency Costs per Employee","Fairness","Travel time","Travel time with availability locations","Priority","Employee Skill Match Soft","Employee Skill Level Match Soft","Pattern Preferred","Pattern Unpreferred","__unknown__"],"description":"Typed vocabulary of Fill constraints that can be violated. The `__unknown__` value is an input-only fallback used when deserializing an unrecognized constraint name; it is never returned by the solver in a response.","uniqueKey":"unservedReasons.oneOf.1.additionalProperties.items.[INDEX]","typeLabel":"enum\u003cstring>"},"uniqueKey":"unservedReasons.oneOf.1.additionalProperties","typeLabel":"enum\u003cstring>[]"},"description":"Per unassigned shift, the hard constraints blocking assignment.","uniqueKey":"unservedReasons.oneOf.1","typeLabel":"null"}],"uniqueKey":"unservedReasons","typeLabel":"object | null"},"suggestions":{"oneOf":[{"type":"array","items":{"type":"object","required":["shift","from","to"],"description":"Shift assignment solution","properties":{"shift":{"type":"string","examples":["shift-1"],"description":"Shift id","isRequired":true,"uniqueKey":"suggestions.oneOf.0.items.[INDEX].shift","typeLabel":"string"},"from":{"type":"string","format":"date-time","examples":["2021-01-01T08:00"],"description":"Start date-time","isRequired":true,"uniqueKey":"suggestions.oneOf.0.items.[INDEX].from","typeLabel":"string\u003cdate-time>"},"to":{"type":"string","format":"date-time","examples":["2021-01-01T08:00"],"description":"End date-time","isRequired":true,"uniqueKey":"suggestions.oneOf.0.items.[INDEX].to","typeLabel":"string\u003cdate-time>"},"skills":{"oneOf":[{"type":"array","examples":["[skill-1, skill-2]"],"items":{"type":"string","uniqueKey":"suggestions.oneOf.0.items.[INDEX].skills.oneOf.0.items.[INDEX]","typeLabel":"string"},"description":"List of skills","uniqueKey":"suggestions.oneOf.0.items.[INDEX].skills.oneOf.0","typeLabel":"string[]"},{"type":"null","examples":["[skill-1, skill-2]"],"items":{"type":"string"},"description":"List of skills","uniqueKey":"suggestions.oneOf.0.items.[INDEX].skills.oneOf.1","typeLabel":"null"}],"uniqueKey":"suggestions.oneOf.0.items.[INDEX].skills","typeLabel":"string[] | null"},"employee":{"oneOf":[{"type":"string","examples":["employee-1"],"description":"Employee id","uniqueKey":"suggestions.oneOf.0.items.[INDEX].employee.oneOf.0","typeLabel":"string"},{"type":"null","examples":["employee-1"],"description":"Employee id","uniqueKey":"suggestions.oneOf.0.items.[INDEX].employee.oneOf.1","typeLabel":"null"}],"uniqueKey":"suggestions.oneOf.0.items.[INDEX].employee","typeLabel":"string | null"},"travelTimeInSeconds":{"oneOf":[{"type":"integer","format":"int64","examples":[123],"description":"Travel time in seconds","uniqueKey":"suggestions.oneOf.0.items.[INDEX].travelTimeInSeconds.oneOf.0","typeLabel":"integer\u003cint64>"},{"type":"null","format":"int64","examples":[123],"description":"Travel time in seconds","uniqueKey":"suggestions.oneOf.0.items.[INDEX].travelTimeInSeconds.oneOf.1","typeLabel":"null"}],"uniqueKey":"suggestions.oneOf.0.items.[INDEX].travelTimeInSeconds","typeLabel":"integer\u003cint64> | null"}},"uniqueKey":"suggestions.oneOf.0.items.[INDEX]","typeLabel":"object"},"description":"List of suggested shift assignments returned by suggest api call","uniqueKey":"suggestions.oneOf.0","typeLabel":"object[]"},{"type":"null","items":{"type":"object","required":["shift","from","to"],"description":"Shift assignment solution","properties":{"shift":{"type":"string","examples":["shift-1"],"description":"Shift id"},"from":{"type":"string","format":"date-time","examples":["2021-01-01T08:00"],"description":"Start date-time"},"to":{"type":"string","format":"date-time","examples":["2021-01-01T08:00"],"description":"End date-time"},"skills":{"oneOf":[{"type":"array","examples":["[skill-1, skill-2]"],"items":{"type":"string"},"description":"List of skills"},{"type":"null","examples":["[skill-1, skill-2]"],"items":{"type":"string"},"description":"List of skills"}]},"employee":{"oneOf":[{"type":"string","examples":["employee-1"],"description":"Employee id"},{"type":"null","examples":["employee-1"],"description":"Employee id"}]},"travelTimeInSeconds":{"oneOf":[{"type":"integer","format":"int64","examples":[123],"description":"Travel time in seconds"},{"type":"null","format":"int64","examples":[123],"description":"Travel time in seconds"}]}}},"description":"List of suggested shift assignments returned by suggest api call","uniqueKey":"suggestions.oneOf.1","typeLabel":"null"}],"uniqueKey":"suggestions","typeLabel":"object[] | null"},"violations":{"oneOf":[{"type":"array","items":{"type":"object","required":["name","value","level"],"description":"A constraint that is broken in the current solution with a certain value (penalty) and a certain level (hard, soft, medium).","properties":{"name":{"oneOf":[{"type":"string","examples":["maxDistance"],"description":"Name of the constraint.","isRequired":true,"uniqueKey":"violations.oneOf.0.items.[INDEX].name.oneOf.0","typeLabel":"string"},{"type":"null","examples":["maxDistance"],"description":"Name of the constraint.","isRequired":true,"uniqueKey":"violations.oneOf.0.items.[INDEX].name.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"violations.oneOf.0.items.[INDEX].name","typeLabel":"string | null"},"value":{"oneOf":[{"type":"integer","format":"int32","examples":[100],"description":"Value of the unresolved constraint. The higher, the more deviation from perfection this constraint has.","isRequired":true,"uniqueKey":"violations.oneOf.0.items.[INDEX].value.oneOf.0","typeLabel":"integer\u003cint32>"},{"type":"null","format":"int32","examples":[100],"description":"Value of the unresolved constraint. The higher, the more deviation from perfection this constraint has.","isRequired":true,"uniqueKey":"violations.oneOf.0.items.[INDEX].value.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"violations.oneOf.0.items.[INDEX].value","typeLabel":"integer\u003cint32> | null"},"level":{"oneOf":[{"type":"string","description":"Level of unresolved constraint.","enum":["HARD","SOFT","MEDIUM"],"example":"[HARD, MEDIUM, SOFT]","isRequired":true,"uniqueKey":"violations.oneOf.0.items.[INDEX].level.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","isRequired":true,"uniqueKey":"violations.oneOf.0.items.[INDEX].level.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"violations.oneOf.0.items.[INDEX].level","typeLabel":"enum\u003cstring> | null"}},"uniqueKey":"violations.oneOf.0.items.[INDEX]","typeLabel":"object"},"uniqueKey":"violations.oneOf.0","typeLabel":"object[]"},{"type":"null","items":{"type":"object","required":["name","value","level"],"description":"A constraint that is broken in the current solution with a certain value (penalty) and a certain level (hard, soft, medium).","properties":{"name":{"oneOf":[{"type":"string","examples":["maxDistance"],"description":"Name of the constraint."},{"type":"null","examples":["maxDistance"],"description":"Name of the constraint."}]},"value":{"oneOf":[{"type":"integer","format":"int32","examples":[100],"description":"Value of the unresolved constraint. The higher, the more deviation from perfection this constraint has."},{"type":"null","format":"int32","examples":[100],"description":"Value of the unresolved constraint. The higher, the more deviation from perfection this constraint has."}]},"level":{"oneOf":[{"type":"string","description":"Level of unresolved constraint.","enum":["HARD","SOFT","MEDIUM"],"example":"[HARD, MEDIUM, SOFT]"},{"type":"null"}]}}},"uniqueKey":"violations.oneOf.1","typeLabel":"null"}],"uniqueKey":"violations","typeLabel":"object[] | null"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":"0000-00000-00000-0000","status":"SOLVED","score":{"hardScore":123,"mediumScore":123,"softScore":123,"feasible":true},"assignments":[{"shift":"shift-1","from":"2021-01-01T08:00","to":"2021-01-01T08:00","skills":"[skill-1, skill-2]","employee":"employee-1","travelTimeInSeconds":123}],"unassigned":"[shift-1]","unservedReasons":{"shift-1":["Employee Skill Match"]},"suggestions":[{"shift":"shift-1","from":"2021-01-01T08:00","to":"2021-01-01T08:00","skills":"[skill-1, skill-2]","employee":"employee-1","travelTimeInSeconds":123}],"violations":[{"name":"maxDistance","value":100,"level":"[HARD, MEDIUM, SOFT]"}]}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"d60debd5-26d9-409a-9b0e-598902fd3f09":{"apikey":{"type":"apiKey","description":"Api Key based authentication (apikey)","name":"Authorization","in":"header","scopes":[]}}},"servers":{"bde8538f-22cc-4d5b-8087-edfb462a71c9":{"url":"https://api.solvice.io","description":"Production API"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","description":"Api Key based authentication (apikey)","name":"Authorization","in":"header","scopes":[]},"schema":{"title":"Authorization","type":"string","description":"Api Key based authentication (apikey)","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"apikey","name":"Authorization"}],"title":"apikey"}]},"originalFileLocation":"api-reference/fill.yaml"},"subdomain":"solvice-68592f22","siteName":"Solvice Docs","title":"Fill Solution - Solvice Docs","navMaps":{"firstHrefInVersion":{"v3":{"href":"/guides/platform/platform","matchLevel":4},"v2":{"href":"/api-reference/fill/solution","matchLevel":0}},"firstHrefInLanguage":{}},"lastModified":"2026-01-22T17:08:37.096Z","originalFileLocation":"api-reference/fill/solution.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Contains the actual solution, once solved.\">\u003cmeta data-mint-head name=\"keywords\" content=\"Route Optimization, Route API, Optimization API, Workforce Scheduling, Solvice\">\u003cmeta data-mint-head name=\"application-name\" content=\"Solvice Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003cmeta data-mint-head name=\"robots\" content=\"index, follow\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/solvice-68592f22/wZOj_k-mDHXJa5jh/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/solvice-68592f22/wZOj_k-mDHXJa5jh/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/solvice-68592f22/wZOj_k-mDHXJa5jh/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/solvice-68592f22/wZOj_k-mDHXJa5jh/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/solvice-68592f22/wZOj_k-mDHXJa5jh/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/solvice-68592f22/wZOj_k-mDHXJa5jh/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/solvice-68592f22/wZOj_k-mDHXJa5jh/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/solvice-68592f22/wZOj_k-mDHXJa5jh/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/solvice-68592f22/wZOj_k-mDHXJa5jh/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Fill Solution - Solvice Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Contains the actual solution, once solved.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Solvice Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.solvice.io/api-reference/fill/solution\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://solvice-68592f22.mintlify.app/link to your default meta tag image\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Fill Solution - Solvice Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Contains the actual solution, once solved.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://solvice-68592f22.mintlify.app/link to your default meta tag image\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/solvice-68592f22/wZOj_k-mDHXJa5jh/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Solvice Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0f62fe\">\u003cmeta data-mint-head name=\"charset\" content=\"UTF-8\">\u003cmeta data-mint-head name=\"viewport\" content=\"width=device-width, initial-scale=1.0\">\u003cmeta data-mint-head name=\"author\" content=\"Christophe Van Huele\">\u003cmeta data-mint-head name=\"googlebot\" content=\"index, follow\">\u003cmeta data-mint-head name=\"google\" content=\"notranslate\">\u003cmeta data-mint-head name=\"google-site-verification\" content=\"verification_token\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.solvice.io/api-reference/fill/solution\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/fill/solution.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.solvice.io/#organization\",\"name\":\"Solvice Docs\",\"url\":\"https://docs.solvice.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/solvice-68592f22/1KJ_2AIotizI1Bng/logo/light.svg?fit=max\u0026auto=format\u0026n=1KJ_2AIotizI1Bng\u0026q=85\u0026s=e93560fee320491613107060a1afc094\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.solvice.io#website\",\"name\":\"Solvice Docs\",\"url\":\"https://docs.solvice.io\",\"publisher\":{\"@id\":\"https://docs.solvice.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.solvice.io/api-reference/fill/solution#webpage\",\"url\":\"https://docs.solvice.io/api-reference/fill/solution\",\"name\":\"Fill Solution\",\"description\":\"Contains the actual solution, once solved.\",\"dateModified\":\"2026-01-22T17:08:37.096Z\",\"isPartOf\":{\"@id\":\"https://docs.solvice.io#website\"},\"breadcrumb\":{\"@id\":\"https://docs.solvice.io/api-reference/fill/solution#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.solvice.io/api-reference/fill/solution#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Fill API\",\"item\":\"https://docs.solvice.io/api-reference/fill/introduction\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Info\",\"item\":\"https://docs.solvice.io/api-reference/fill/status\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Fill Solution\",\"item\":\"https://docs.solvice.io/api-reference/fill/solution\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.solvice.io/api-reference/fill/solution#apireference\",\"headline\":\"Fill Solution\",\"name\":\"Fill Solution\",\"description\":\"Contains the actual solution, once solved.\",\"url\":\"https://docs.solvice.io/api-reference/fill/solution\",\"mainEntityOfPage\":{\"@id\":\"https://docs.solvice.io/api-reference/fill/solution#webpage\"},\"image\":\"https://docs.solvice.io/link%20to%20your%20default%20meta%20tag%20image\",\"dateModified\":\"2026-01-22T17:08:37.096Z\",\"publisher\":{\"@id\":\"https://docs.solvice.io/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.solvice.io#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Solvice Docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Solvice Docs","nav":{"global":{"anchors":[{"anchor":"Dashboard","icon":"book-open-cover","href":"https://platform.solvice.io"},{"anchor":"Website","icon":"planet-ringed","href":"https://www.solvice.io"},{"anchor":"Blog","icon":"newspaper","href":"https://www.solvice.io/blog/news"}]},"versions":[{"version":"v3","pages":[{"title":"v3","href":"/guides/platform/platform"}]},{"version":"v2","default":true,"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":"/guides/platform/platform"}]},{"tab":"API Reference","groups":[{"group":"VRP API","pages":[{"title":"VRP API Reference","href":"/api-reference/vrp/introduction"},{"group":"Info","pages":[{"title":"Status","openapi":"vrp GET /v2/vrp/jobs/{id}/status","href":"/api-reference/vrp/status"},{"title":"Solution","openapi":"vrp GET /v2/vrp/jobs/{id}/solution","href":"/api-reference/vrp/solution"},{"title":"Explanation","openapi":"vrp GET /v2/vrp/jobs/{id}/explanation","href":"/api-reference/vrp/explanation"}]},{"group":"Actions","pages":[{"title":"Solve VRP","openapi":"vrp POST /v2/vrp/solve","href":"/api-reference/vrp/solve"},{"title":"Evaluate VRP","openapi":"vrp POST /v2/vrp/evaluate","href":"/api-reference/vrp/evaluate"},{"title":"Suggest VRP","openapi":"vrp POST /v2/vrp/suggest","href":"/api-reference/vrp/suggest"},{"title":"Sync Solve VRP","openapi":"vrp POST /v2/vrp/sync/solve","href":"/api-reference/vrp/sync-solve"},{"title":"Sync Suggest VRP","openapi":"vrp POST /v2/vrp/sync/suggest","href":"/api-reference/vrp/sync-suggest"}]}]},{"group":"Fill API","pages":[{"title":"Fill API Reference","href":"/api-reference/fill/introduction"},{"group":"Info","pages":[{"title":"Fill Job Status","openapi":"fill GET /v2/fill/jobs/{id}/status","description":"Check whether the job is solved or not.","href":"/api-reference/fill/status"},{"title":"Fill Solution","openapi":"fill GET /v2/fill/jobs/{id}/solution","href":"/api-reference/fill/solution"},{"title":"Fill Explanation","openapi":"fill GET /v2/fill/jobs/{id}/explanation","description":"Contains the explanation, once solved.","href":"/api-reference/fill/explanation"}]},{"group":"Actions","pages":[{"title":"Solve Fill","openapi":"fill POST /v2/fill/solve","href":"/api-reference/fill/solve"}]}]}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog/vrp"}]}]}]},"title":"Fill Solution - Solvice Docs","buildId":"dpl_EnxDqhjaNc9a8MVa833TGULPd9uJ","deploymentId":"dpl_EnxDqhjaNc9a8MVa833TGULPd9uJ","dynamics":["c2aa737661","b0f84f53ff","a9bb46feb3","2b790eda92"],"chunks":["OpenApiReferenceProvider-26-lDe7V.js","utils-CWQmgYtH.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-4-Aw3rSD.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-C2zjXYA5.js","snippetPresets-DFmpFA7C.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","Page-CT9uE8Ip.js","ApiExamples-FJpQavWq.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-D_GvPF7k.js","shallow-Bs2ZB0NO.js","getApiPlaygroundDisplay-DCcqJJk-.js","CodeSnippet-DzDxawVe.js","CodeSnippets-aUr7fU-7.js","getPastedJson-Y1fKsj_I.js","icon-DI4zTsDr.js","MethodPill-C0nDlmSQ.js","DuplicateIcon-NUXbx2nQ.js","createIcon-BdTHrPAi.js","DynamicMarkdown-CtpgKJwj.js","SectionHeading-B3x35tOt.js","axios-vUo_bRtp.js","Markdown-3OmurJMP.js","clsx-DMKzROTp.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-1ms6tsT-.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-Ke9xIMFx.js"]}