---
title: "The governed knowledge frontier for one subject: the registered questions OEX asked, what it could not conclude and why, the governed dependency standing in the way where every instance of its scope kind is public by nature, what class of evidence would resolve it, and which registered question logically follows. Every field is a typed governed value or a fixed catalogue constant — no model is invoked and nothing is derived from prose. NOT a task list: no identifiers to act on, no ordering that implies priority, and no endpoint accepts a report that a dependency was addressed. A dependency whose scope kind requires a per-instance publishability decision is not named, not counted and not acknowledged, so an empty unresolvedNeeds list is never evidence that none exist. evidenceRequirements are public catalogue prerequisites, not private source inventories. progress.state is inquiry_available, awaiting_evidence, complete, terminal_unknown, or refused. Stop on awaiting_evidence and resume only when admissible evidence changes. Known evaluated targets and cycles lead to blockers instead of repeated nextInquiries."
method: GET
path: "/api/v1/frontier"
---

# The governed knowledge frontier for one subject: the registered questions OEX asked, what it could not conclude and why, the governed dependency standing in the way where every instance of its scope kind is public by nature, what class of evidence would resolve it, and which registered question logically follows. Every field is a typed governed value or a fixed catalogue constant — no model is invoked and nothing is derived from prose. NOT a task list: no identifiers to act on, no ordering that implies priority, and no endpoint accepts a report that a dependency was addressed. A dependency whose scope kind requires a per-instance publishability decision is not named, not counted and not acknowledged, so an empty unresolvedNeeds list is never evidence that none exist. evidenceRequirements are public catalogue prerequisites, not private source inventories. progress.state is inquiry_available, awaiting_evidence, complete, terminal_unknown, or refused. Stop on awaiting_evidence and resume only when admissible evidence changes. Known evaluated targets and cycles lead to blockers instead of repeated nextInquiries.

`GET /api/v1/frontier`

## Request

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

## Query parameters

- `subjectKind` string, required
- `subjectId` string, required

## Response `200`

The envelope described above.

- 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

- `304`: Not modified (If-None-Match matched the data ETag).
- `400`: Invalid parameter value, with an error naming the parameter.
- `404`: Unknown id or missing required parameter, with an error hint.
- `429`: Rate limited. Retry-After and the RateLimit-Limit / RateLimit-Remaining / RateLimit-Reset headers state when to resume.

---

[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)