---
title: "Read your finished results with the request revision and sources behind them"
method: GET
path: "/v1/finds/{id}/delivery"
---

# Read your finished results with the request revision and sources behind them

`GET /v1/finds/{id}/delivery`

## Request

- Base URL: `https://api.specstream.ai`
- URL: `https://api.specstream.ai/v1/finds/{id}/delivery`
- Auth: API key in header `Authorization`

## Path parameters

- `id` string, required

## Response `200`

Delivery

- object
  - `data` DeliveryProjection, required
    - `execution_manifest` ExecutionManifest
      - `version` 'evidence-bound.v1'
      - `policy_hash` string, required
      - `decision_root` string, required
      - `plan_version` string, required
      - `ast_hash` string, required
      - `registry_version` string, required
      - `decision_count` integer, required
      - `stages` object, required
      - `semantic_judgments` integer, required
      - `unavailable_judgments` integer, required
      - `qualified_matches` integer, required
      - `unknown_never_promoted` boolean, required
      - `replay_verified` boolean, required
      - `replay_scope` string, required
      - `live_sources_can_change` boolean, required
      - `sealed` boolean, required
    - `spec_version` 'delivery.v1'
    - `find_id` string, required
    - `ast_hash` string, required
    - `snapshot_id` string, required
    - `generated_at` string, date-time, required
    - `lineage` FindLineage
      - `find_id` string, required
      - `parent_find_id` string, nullable, required
      - `spec_id` string, required
      - `revision_id` string, required
      - `operation` 'find' | 'extend' | 'add_facts' | 'refresh', required
    - `rows` AcceptedRow[], required
      - `target_evidence` object, nullable
      - `worded_evidence` object, nullable
      - `lineage` MatchLineage: Evidence-bound reference within an explicitly continued customer lineage.
        - `find_id` string, required
        - `entity_id` string, required
        - `relation` 'same_public_object'
      - `spec_version` 'accepted_row.v1'
      - `entity_id` string, required
      - `ordinal` integer, required
      - `cells` RowCell[], required
        - `column_id` string, required
        - `label` string, required
        - `value` unknown, required
        - `display` string, nullable, required
        - `absence` 'Not published' | 'Couldn't check'
        - `provenance` FieldObservation
          - `entity_id` string, required
          - `field_id` string, required
          - `value` unknown, required
          - `normalized_value` string, nullable, required
          - `source` string, required
          - `source_url` string, nullable, required
          - `observed_at` string, date-time, required
          - `observation_id` string, required
          - `request_hash` string, required
          - `join_method` 'place_id' | 'registrable_domain' | 'e164_phone_locality' | 'address_name' | 'reciprocal_handle' | 'source_declared_link', required
          - `join_confidence` number, nullable
          - `null_reason` 'not_published' | 'blocked_at_source' | 'challenge_page' | 'unreadable' | 'timeout' | 'join_ambiguous' | 'predicate_unknown' | 'internal_failure', required
          - `selected` boolean
          - `value_complete` boolean, nullable
          - `source_record_id` string, nullable
          - `source_pointer` string, nullable
          - `source_response_sha256` string, nullable
          - `source_time` EvidenceTime
            - `contract` 'source-time.v1'
            - `state` 'historical_capture'
            - `captured_at` string, date-time, required
            - `retrieved_at` string, date-time, required
            - `original_url` string, nullable
            - `archive` 'commoncrawl' | 'wayback' | 'arquivo', required
        - `badges` ContactBadge[]
      - `predicates` PredicateEvidence[], required
        - `field_id` string, required
        - `op` 'count_matches' | 'contains' | 'not_contains' | 'has_any' | 'has_all' | 'has_none' | 'before' | 'after' | 'on_or_before' | 'on_or_after' | 'gt' | 'lt' | 'ne' | 'not_in' | 'gte' | 'lte' | 'eq' | 'exists' | 'class_in' | 'in', required
        - `required_value` unknown, required
        - `observed_value` unknown, required
        - `passed` boolean, required
        - `source_label` string, required
        - `source_url` string, nullable, required
        - `observed_at` string, date-time, required
        - `null_reason` 'not_published' | 'blocked_at_source' | 'challenge_page' | 'unreadable' | 'timeout' | 'join_ambiguous' | 'predicate_unknown' | 'internal_failure'
        - `source_ref` PredicateSourceRef: Pointer to a concrete fetch and native record, never a generated group source.
          - `observation_id` string, required
          - `request_hash` string, required
          - `native_record_id` string, nullable
          - `pointer` string, nullable
          - `response_sha256` string, nullable
          - `source_time` EvidenceTime
            - `contract` 'source-time.v1'
            - `state` 'historical_capture'
            - `captured_at` string, date-time, required
            - `retrieved_at` string, date-time, required
            - `original_url` string, nullable
            - `archive` 'commoncrawl' | 'wayback' | 'arquivo', required
        - `record_proof` union
          - RecordCountProof
            - `spec_version` 'record_count_proof.v1'
            - `scope` 'published_source_records'
            - `collection_complete` boolean, required
            - `members_seen` integer, required
            - `lower_bound` integer, required
            - `upper_bound` integer, nullable
            - `matching_pointers` string[], required
            - `unresolved_pointers` string[], required
            - `witnesses` RecordWitness[], required
              - …
            - `witnesses_complete` boolean, required
          - unknown
      - `match_proof` LogicalProof: A proof references evidence, never a fabricated observation for a group. True ANY requires a witnessed branch, true NOT a witnessed false child. Missing evidence stays unknown under every negation. Record-level validation additionally binds each leaf truth to its actual PredicateEvidence entry.
        - `op` 'predicate' | 'all' | 'any' | 'not', required
        - `truth` 'true' | 'false' | 'unknown', required
        - `predicate_index` integer, nullable
        - `children` unknown[]
          - unknown
      - `billable` boolean, required
      - `contact_visibility` 'full' | 'badge' | 'hidden', required
      - `locked` boolean
      - `details` RowCell[]
        - `column_id` string, required
        - `label` string, required
        - `value` unknown, required
        - `display` string, nullable, required
        - `absence` 'Not published' | 'Couldn't check'
        - `provenance` FieldObservation
          - `entity_id` string, required
          - `field_id` string, required
          - `value` unknown, required
          - `normalized_value` string, nullable, required
          - `source` string, required
          - `source_url` string, nullable, required
          - `observed_at` string, date-time, required
          - `observation_id` string, required
          - `request_hash` string, required
          - `join_method` 'place_id' | 'registrable_domain' | 'e164_phone_locality' | 'address_name' | 'reciprocal_handle' | 'source_declared_link', required
          - `join_confidence` number, nullable
          - `null_reason` 'not_published' | 'blocked_at_source' | 'challenge_page' | 'unreadable' | 'timeout' | 'join_ambiguous' | 'predicate_unknown' | 'internal_failure', required
          - `selected` boolean
          - `value_complete` boolean, nullable
          - `source_record_id` string, nullable
          - `source_pointer` string, nullable
          - `source_response_sha256` string, nullable
          - `source_time` EvidenceTime
            - `contract` 'source-time.v1'
            - `state` 'historical_capture'
            - `captured_at` string, date-time, required
            - `retrieved_at` string, date-time, required
            - `original_url` string, nullable
            - `archive` 'commoncrawl' | 'wayback' | 'arquivo', required
        - `badges` ContactBadge[]

## Other responses

- `default`: Error envelope

---

[API](https://skmtc.dev/specstream/apis/specstream-api.md) · [All operations](https://skmtc.dev/specstream/apis/specstream-api/llms.txt) · [OpenAPI document](https://skmtc.dev/specstream/apis/specstream-api/revisions/5a9f51143a13?raw)