---
title: "POST-only decision endpoint for stated credentials, education, experience, driver licence, relocation radius or destination allowlist, housing and household needs, savings, and retraining time. Returns pass/conflict/unknown feasibility plus the same ordered evidence panel used by the human and MCP surfaces. Ranking uses versioned Job Bank demand and Statistics Canada wage inputs; OSINT, placeholder postings, placeholder training and synthetic market forecasts are excluded. Send Accept: text/markdown for the no-store markdown representation. Constraints stay in the request body rather than access-log-visible URLs; never cached or stored."
method: POST
path: "/api/v1/evaluate"
---

# POST-only decision endpoint for stated credentials, education, experience, driver licence, relocation radius or destination allowlist, housing and household needs, savings, and retraining time. Returns pass/conflict/unknown feasibility plus the same ordered evidence panel used by the human and MCP surfaces. Ranking uses versioned Job Bank demand and Statistics Canada wage inputs; OSINT, placeholder postings, placeholder training and synthetic market forecasts are excluded. Send Accept: text/markdown for the no-store markdown representation. Constraints stay in the request body rather than access-log-visible URLs; never cached or stored.

`POST /api/v1/evaluate`

## Request

- Base URL: `https://veilpoint.ca`
- URL: `https://veilpoint.ca/api/v1/evaluate`
- Auth: none declared

## Request body

- object
  - `credentials` string[]
  - `educationLevel` 'Secondary school' | 'Secondary plus short certificate' | 'Secondary plus trade certificate' | 'Apprenticeship or journeyperson' | 'Diploma' | 'Bachelor degree'
  - `experienceAreas` string[]
  - `licenceClass` 'None' | 'Class 5' | 'Class 3' | 'Class 1A'
  - `currentMunicipalityId` 'saskatoon' | 'regina' | 'prince-albert' | 'moose-jaw' | 'swift-current' | 'yorkton' | 'north-battleford' | 'weyburn' | 'estevan' | 'lloydminster' | 'warman' | 'martensville' | 'humboldt' | 'melfort' | 'meadow-lake' | 'melville' | 'kindersley' | 'nipawin' | 'rosetown' | 'la-ronge'
  - `allowedMunicipalityIds` string[]
  - `maximumRelocationKm` number
  - `housingBudgetMonthly` number
  - `bedroomsRequired` 'bachelor' | 'oneBedroom' | 'twoBedroom' | 'threeBedroomPlus'
  - `incomeEarners` integer
  - `householdSize` integer
  - `vehicleAvailable` boolean
  - `savingsDollars` number
  - `maximumRetrainingWeeks` number
  - `targetOccupationId` string
  - `limit` integer

## Response `200`

A private, no-store pathway evaluation envelope.

- PublicEnvelope
  - `meta` object, required
    - `platform` 'VeilPoint Opportunity Exchange', required
    - `canonical` string, uri, required
    - `retrievedAt` string, date-time, required
    - `dataStatus` string, required
    - `evidence` EvidenceSummary, required
      - `status` 'published' | 'derived' | 'mixed' | 'placeholder', required
      - `truthState` 'preview' | 'snapshot' | 'measured_aggregate' | 'mixed' | 'live' | 'metadata', required
      - `scenarioType` 'preview_scenario' | 'published_snapshot' | 'measured_aggregate' | 'mixed_evidence' | 'actionable_record' | 'observed_hiring_signal' | 'platform_metadata', required
      - `recordType` string, required
      - `isActionable` boolean, required
      - `synthetic` boolean, required
      - `confidence` 'A' | 'B' | 'C' | 'D', nullable, required
      - `sourceKinds` string[], required
      - `asOf` string, date-time, nullable, required
      - `qualification` string, required
      - `assumptions` string[], required
    - `provenance` object
    - `citeAs` string, required
  - `data` object, required

## Other responses

- `400`: Invalid constraint; no value is silently discarded.
- `404`: Unknown target occupation id.

---

[API](https://skmtc.dev/veilpoint/apis/veilpoint-opportunity-exchange-public-api.md) · [All operations](https://skmtc.dev/veilpoint/apis/veilpoint-opportunity-exchange-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/veilpoint/apis/veilpoint-opportunity-exchange-public-api/revisions/fa1381cfa886?raw)