---
title: "Read an owned retained run and evidence"
method: GET
path: "/api/v1/intelligence/runs/{runId}"
tags: ["Property Intelligence"]
---

# Read an owned retained run and evidence

`GET /api/v1/intelligence/runs/{runId}`

## Request

- Base URL: `https://propraven.com`
- URL: `https://propraven.com/api/v1/intelligence/runs/{runId}`
- Auth: HTTP bearer

Requires API-key or first-party session authentication and a current account in the default-off server cohort. Valid current membership does not require a new paid subscription. Existing API quotas still apply. Responses are private, no-store. Unknown and repeated query parameters are rejected. This contract does not indicate source activation, deployment or an SDK release. Retained objects are scoped to the current account and their creator; no caller-supplied account/user grant is accepted. Current source rights are checked for every read/use, independently of archived grants. Withdrawn rights or changed source semantics may withhold a saved result; its immutable archived payload is not rewritten.

## Path parameters

- `runId` string, required

## Query parameters

- `use` 'display' | 'export' | 'ai'

## Response `200`

Authorized result; unavailable/partial/stale states are explicit within the response. No live coverage is implied by this contract.

- IntelligenceRunDetail
  - `run` IntelligenceRun, required: Immutable descriptive calculation run with exact rational wire values. Calculation time is not source freshness. Unknown values/dates remain null.
    - `id` string, required
    - `canonical_id` string, required
    - `definition_version` string, required
    - `query` object, required
      - `as_of` string, required
      - `knowledge_cutoff` string, required
    - `computed_at` string, required
    - `evidence_ids` string[], required
    - `groups` object, required
      - `market` object[], required
        - `definition` string, required
        - `status` 'available' | 'partial' | 'insufficient_data' | 'unavailable' | 'stale' | 'error', required
        - `reasons` string[], required
        - `metrics` object, required
        - `counts` object, required
        - `exclusions` object, required
        - `evidence_ids` string[], required
        - `context` object, required
          - `input_kind` 'observed' | 'user_assumptions' | 'unavailable', required
          - `requested_scope` object, nullable, required
            - `geography` string, required
            - `property_type` string, required
            - `currency` string, required
          - `actual_scope` object, nullable, required
            - `geography` string, required
            - `property_type` string, required
            - `currency` string, required
          - `query` object, nullable, required
            - `as_of` string, required
            - `knowledge_cutoff` string, required
          - `period` union, required
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
          - `metric_periods` object, required
          - `latest_observation_at` string, nullable, required
          - `source_as_of` string, nullable, required
          - `source_vintage` string, nullable, required
          - `history_complete` boolean, nullable, required
      - `seller` object[], required
        - `definition` string, required
        - `status` 'available' | 'partial' | 'insufficient_data' | 'unavailable' | 'stale' | 'error', required
        - `reasons` string[], required
        - `metrics` object, required
        - `counts` object, required
        - `exclusions` object, required
        - `evidence_ids` string[], required
        - `context` object, required
          - `input_kind` 'observed' | 'user_assumptions' | 'unavailable', required
          - `requested_scope` object, nullable, required
            - `geography` string, required
            - `property_type` string, required
            - `currency` string, required
          - `actual_scope` object, nullable, required
            - `geography` string, required
            - `property_type` string, required
            - `currency` string, required
          - `query` object, nullable, required
            - `as_of` string, required
            - `knowledge_cutoff` string, required
          - `period` union, required
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
          - `metric_periods` object, required
          - `latest_observation_at` string, nullable, required
          - `source_as_of` string, nullable, required
          - `source_vintage` string, nullable, required
          - `history_complete` boolean, nullable, required
      - `owner` object[], required
        - `definition` string, required
        - `status` 'available' | 'partial' | 'insufficient_data' | 'unavailable' | 'stale' | 'error', required
        - `reasons` string[], required
        - `metrics` object, required
        - `counts` object, required
        - `exclusions` object, required
        - `evidence_ids` string[], required
        - `context` object, required
          - `input_kind` 'observed' | 'user_assumptions' | 'unavailable', required
          - `requested_scope` object, nullable, required
            - `geography` string, required
            - `property_type` string, required
            - `currency` string, required
          - `actual_scope` object, nullable, required
            - `geography` string, required
            - `property_type` string, required
            - `currency` string, required
          - `query` object, nullable, required
            - `as_of` string, required
            - `knowledge_cutoff` string, required
          - `period` union, required
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
          - `metric_periods` object, required
          - `latest_observation_at` string, nullable, required
          - `source_as_of` string, nullable, required
          - `source_vintage` string, nullable, required
          - `history_complete` boolean, nullable, required
      - `redevelopment` object[], required
        - `definition` string, required
        - `status` 'available' | 'partial' | 'insufficient_data' | 'unavailable' | 'stale' | 'error', required
        - `reasons` string[], required
        - `metrics` object, required
        - `counts` object, required
        - `exclusions` object, required
        - `evidence_ids` string[], required
        - `context` object, required
          - `input_kind` 'observed' | 'user_assumptions' | 'unavailable', required
          - `requested_scope` object, nullable, required
            - `geography` string, required
            - `property_type` string, required
            - `currency` string, required
          - `actual_scope` object, nullable, required
            - `geography` string, required
            - `property_type` string, required
            - `currency` string, required
          - `query` object, nullable, required
            - `as_of` string, required
            - `knowledge_cutoff` string, required
          - `period` union, required
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
          - `metric_periods` object, required
          - `latest_observation_at` string, nullable, required
          - `source_as_of` string, nullable, required
          - `source_vintage` string, nullable, required
          - `history_complete` boolean, nullable, required
  - `evidence` IntelligenceEvidence[], required
    - `id` string, required
    - `source_product` string, required
    - `source_version` string, required
    - `captured_at` string, required
    - `observed_at` string, nullable, required
    - `source_as_of` string, nullable, required
    - `source_url` string, nullable, required
    - `knowledge_basis` 'source_observed_at' | 'first_retained_capture', required
    - `effective_time_basis` 'source_event_time' | 'first_retained_capture_only', required
    - `capability` IntelligenceSourceCapability, required
      - `id` string, required
      - `version` string, required
      - `source_product` string, required
      - `source_version` string, required
      - `scope` IntelligenceScope, required
        - `geography` string, required
        - `property_type` string, required
        - `currency` string, required
      - `rights` IntelligenceRights, required
        - `version` string, required
        - `display` boolean, required
        - `derived` boolean, required
        - `cache` boolean, required
        - `retain_history` boolean, required
        - `export` boolean, required
        - `ai` boolean, required
      - `additive_components` boolean, required
      - `complete` boolean, required
      - `mature_through` string, nullable, required
      - `source_as_of` string, nullable, required
      - `stale_after` string, nullable, required
    - `assessment` IntelligenceAssessmentObservation, required
      - `source` string, required
      - `record_id` string, required
      - `version` string, required
      - `evidence_id` string, required
      - `effective_at` string, required
      - `captured_at` string, required
      - `observed_at` string, nullable, required
      - `land` string, nullable, required
      - `improvement` string, nullable, required
      - `basis` 'assessed' | 'appraised' | 'market' | 'taxable', required
      - `vintage` string, required
      - `source_product` string, required
      - `source_version` string, required
      - `component_basis_verified` boolean, required
    - `source_record` object, required
      - `assessment_year` integer, nullable, required
      - `tax_year` integer, nullable, required
      - `vintage_year` integer, nullable, required
      - `reported_total` string, nullable, required
      - `tax_amount` string, nullable, required
      - `tax_paid_amount` string, nullable, required

## Other responses

- `400`: Invalid, unknown or duplicate parameters; invalid time, source key or scenario assumptions.
- `401`: Authentication required, or supplied credential invalid. A rejected bearer does not fall back to a session.
- `402`: Existing API-key monthly quota exceeded; this feature adds no paid SKU.
- `403`: Current source rights do not permit the requested retained Intelligence use.
- `404`: Feature disabled, current account outside cohort, or requested retained object/parcel unavailable. Other creators' objects are not disclosed.
- `429`: Existing API or concurrent-request limit exceeded.
- `500`: Unexpected service failure; internal details are withheld.
- `504`: Database query timeout.

---

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