---
title: "Run the Guided Business Study: Business Health, then three analytical instruments over the same evidence — Negative Space (structure that would be expected here and is not observed), Boundary Fracture (a value the business's own website publishes that never crossed into its record) and Strategic Node Finder (the single change addressing several findings at once). Every conclusion cites the evidence beneath it; one citing nothing is withheld rather than shown, and evidence OEX could not read is reported as unknown rather than as zero. Supplying website matters most here — without it there is no interface for Boundary Fracture to assess. No account, no key, nothing stored."
method: GET
path: "/api/v1/business-study"
---

# Run the Guided Business Study: Business Health, then three analytical instruments over the same evidence — Negative Space (structure that would be expected here and is not observed), Boundary Fracture (a value the business's own website publishes that never crossed into its record) and Strategic Node Finder (the single change addressing several findings at once). Every conclusion cites the evidence beneath it; one citing nothing is withheld rather than shown, and evidence OEX could not read is reported as unknown rather than as zero. Supplying website matters most here — without it there is no interface for Boundary Fracture to assess. No account, no key, nothing stored.

`GET /api/v1/business-study`

## Request

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

## Query parameters

- `name` string, required
- `website` string
- `address` string
- `category` string
- `description` string
- `phone` string
- `format` 'markdown'
- `objective` string

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