---
title: "List receipt-qualified OGE 278-T transactions."
method: GET
path: "/api/v1/executive"
tags: ["Executive"]
---

# List receipt-qualified OGE 278-T transactions.

`GET /api/v1/executive`

## Request

- Base URL: `https://www.veridionmarkets.com`
- URL: `https://www.veridionmarkets.com/api/v1/executive`
- Auth: one of:
  - none
  - HTTP bearer

Reads accepted first-party temporal serving rows, preserving quarantine and supersession guards. Each transaction carries its stored transaction_id, immutable version_id, explicit veridion-executive-content-v1 content_hash_basis, exact filed range and official document URL/page/line. filed_date means OGE received date. computed_at is this response's clock, never a filing date. Receipt failures are held and counted by reason. No price, midpoint, outcome or return is exposed. Only a Developer key receives historical as_of and generation-pinned pagination (filed_date descending, observation and disclosure ID ascending). Anonymous, free and evaluator callers are bounded to the same latest 25 serving candidates BEFORE filters; held rows do not widen it. Free requests also consume the existing shared 60-request-per-IP hourly disclosure budget, including keyed free/evaluator attempts; their ordinary key minute/day caps remain enforced. Developer remains $49/month or $490/year. No raw-warehouse completeness claim is implied.

## Query parameters

- `limit` integer: Default 25 on free, 100 on Developer; free maximum 25, Developer maximum 1000.
- `cursor` string: Signed Executive snapshot cursor; Developer only. Preserve the original filters. Cursors from /disclosures are refused.
- `as_of` string, date-time: Developer only: retained point-in-time state, at or after coverage.point_in_time_floor and no later than this request.
- `filed_date` string: Exact OGE received date (YYYY-MM-DD). On free access this filters the fixed recent window, not the entire warehouse.
- `document_id` string: Exact OGE filing document identifier, case-insensitive. On free access filters only the recent window.
- `type` 'purchase' | 'sale' | 'exchange': As-filed transaction classification.

## Response `200`

A receipt-qualified page with held reasons, pinned snapshot and access window.

- ExecutivePage: Receipt-qualified Executive transaction page with response-local coverage, access and cache contracts.
  - `computed_at` string, date-time, required: This response's computation time; not a source filing or retrieval time.
  - `version` string, required: Served Disclosure API contract version, also identified by X-API-Version.
  - `coverage` object, required: Response-local qualified/held counts and the retained snapshot supporting them.
    - `rows_returned` integer, required: Count of qualified transactions returned in this response after caller filters and receipt holds; not a warehouse total.
    - `rows_held` integer, required: Count of examined page candidates held by receipt/source/identity validation; excludes unexamined later pages.
    - `held_by_reason` object, required: Per-reason count of examined candidates withheld from this response.
    - `snapshot_as_of` string, date-time, required: Exact pinned temporal snapshot instant shared with every cursor in this walk; preserves retained microseconds.
    - `snapshot_generation` integer, required: Positive retained dataset generation pinned for this response and any next page.
    - `point_in_time_floor` string, date-time, required: Earliest accepted as_of instant supported by retained disclosure history; earlier requests fail closed.
    - `basis` string, required: Scope of the accepted first-party OGE serving population, not a raw-warehouse completeness assertion.
  - `access` object, required: Verified effective history access and its bounded candidate/page/request limits.
    - `tier` 'free' | 'developer', required: Effective access mode: only Developer keys receive full history; anonymous, free and evaluator keys retain the free window.
    - `full_history` boolean, required: True only when a Developer key authorizes historical pagination and point-in-time reads.
    - `max_rows_per_request` integer, required: Allowed page size: maximum 25 for free-window callers and 1000 for Developer.
    - `window_rows` integer: Fixed global recent serving-candidate count for free-window calls,25 before filters or ID lookup; omitted for Developer.
    - `window_basis` string: How the free global recent window is selected before filters; receipt failures cannot widen it.
    - `requests_per_hour_per_ip` integer: Existing shared hourly IP disclosure-request limit, 60 for free-window callers; their key caps also remain enforced when present.
  - `cache` object, required: Executable delivery-cache contract matching this response's private no-store headers.
    - `policy` 'private-no-store', required: Caller-specific origin response is not reusable by browser or shared cache.
    - `browser_max_age_seconds` 0, required: Browser cache lifetime in seconds: zero.
    - `cdn_max_age_seconds` 0, required: Shared CDN response cache lifetime in seconds: zero.
    - `declared_max_staleness_seconds` 0, required: Response cache delivery staleness allowance in seconds: zero; source measurement instants remain distinct.
    - `age_header` unknown, required
  - `notice` string, required: Filed-range and non-recommendation notice; this endpoint excludes outcomes and returns.
  - `data` object[], required: Qualified transactions in this bounded page; held candidates are counted rather than replaced by older rows.
    - `transaction_id` string, required: Stored OGE warehouse transaction identifier extracted from the immutable oge-<id>:<generation UUID> version binding; not inferred from trade fields.
    - `disclosure_id` string, required: Stable accepted disclosure identity used by the existing /disclosures history surface.
    - `version_id` string, required: Immutable retained OGE parse-generation identity; source transaction ID followed by its stored generation UUID.
    - `content_hash` string, required: SHA256 hex over the JSON object of projected filing facts and receipt coordinates, including content_hash_basis and excluding content_hash and provenance.
    - `content_hash_basis` 'veridion-executive-content-v1', required: Fixed named hash recipe: exact served fields except content_hash and provenance. Operational retrieval, parse and observation clocks do not change filing content.
    - `filer` object, required: Official filing's filer identity; no office or ownership inference is added.
      - `id` string, required: Canonical filer identifier retained in the accepted disclosure version.
      - `name` string, required: Filer name recorded by the official OGE filing.
    - `trade_date` string, required: Transaction calendar date as recorded in the filing, YYYY-MM-DD; not the publication date.
    - `filed_date` string, required: OGE received calendar date, YYYY-MM-DD, retained from the official report; not a retrieval or signature date.
    - `asset` object, required: Filed asset identity and accepted classification, without prices or performance data.
      - `name` string, required: Filed asset description retained by the accepted source parser.
      - `ticker` string, nullable, required: Accepted source ticker or null when none is proven; no ticker is inferred from the name.
      - `type` string, required: Accepted normalized asset classification, including other when no narrower type is proven.
    - `type` 'purchase' | 'sale' | 'exchange', required: As-filed transaction classification; unsupported source types are held.
    - `amount` object, required: The amount range as filed, without an estimated or derived trade amount.
      - `range_low` number, required: Filed bounded dollar range's lower USD endpoint; not an exact trade value.
      - `range_high` number, required: Filed bounded dollar range's upper USD endpoint; not an exact trade value.
      - `currency` 'USD', required: Currency unit of both filed range endpoints: United States dollars.
      - `basis` 'bounded_range_as_disclosed', required: Both endpoints describe the filed bounded range; no midpoint, actual amount or return is exposed.
      - `verbatim_text` string, required: Amount range text retained as filed. The original filing supports the text and numerical endpoints.
    - `receipt` object, required: Exact official document and source coordinates supporting this transaction.
      - `document_id` string, required: Official OGE PAS Index document identifier, required to match the document segment in url.
      - `url` string, required: Official HTTPS OGE PDF receipt URL; document identity, page and source line are verified before exposure.
      - `page` integer, required: One-based source PDF page containing this transaction; rows without a positive page are held.
      - `line` integer, required: Positive source line number retained by the accepted parser or verified transcription; missing lines are held.
    - `provenance` object, required: Retained source-processing evidence; no clock is substituted with this response's computed_at.
      - `retrieved_at` string, required: Exact retained UTC receipt retrieval instant, preserving available microseconds; operational metadata outside content_hash.
      - `parsed_at` string, required: Exact retained UTC parse instant, preserving available microseconds; not a filing date.
      - `parser_version` string, required: Parser or verified-transcription version that produced the accepted record.
      - `first_observed_at` string, required: Exact retained UTC first-observation instant used by snapshot membership; not backdated to the trade.
      - `transcription_method` 'pdf_text_layer' | 'verified_transcription', required: Whether the accepted record came from a PDF text layer or the established verified-transcription parser.
  - `page` object, required: Bounded Developer keyset pagination; free callers cannot traverse beyond their global recent window.
    - `limit` integer, required: Requested page-size bound, applied under the verified access mode.
    - `has_more` boolean, required: Another candidate existed after this Developer page in the same pinned snapshot; always false for the fixed free window.
    - `next_cursor` string, nullable, required: Signed query-bound Executive snapshot keyset position for the next Developer page, or null; other endpoint cursors are refused.
    - `order` 'filed_date_desc', required: Filed date descending, then first observation and disclosure identity ascending; not performance ranking.
    - `snapshot_as_of` string, date-time, required: Same exact retained snapshot instant as coverage.snapshot_as_of; carried in the signed next cursor.
    - `snapshot_generation` integer, required: Same positive pinned retained dataset generation as coverage.snapshot_generation.

## Other responses

- `400`: Invalid parameter, date or cursor.
- `401`: The supplied bearer key is invalid; it is never downgraded to anonymous.
- `403`: Missing disclosure scope, or historical access without a Developer key.
- `429`: An enforced request budget was exceeded.
- `503`: Receipt/history/query/quota prerequisites could not be verified.

---

[API](https://skmtc.dev/veridionmarkets/apis/veridion-disclosure-api.md) · [All operations](https://skmtc.dev/veridionmarkets/apis/veridion-disclosure-api/llms.txt) · [OpenAPI document](https://skmtc.dev/veridionmarkets/apis/veridion-disclosure-api/revisions/af69a5d7354e?raw)