---
title: "Read all retained research results"
method: GET
path: "/research/jobs/{job_id}/results"
tags: ["Research Jobs"]
---

# Read all retained research results

`GET /research/jobs/{job_id}/results`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/research/jobs/{job_id}/results`
- Auth: API key in header `x-api-key`

Returns the complete owner-scoped retained result prefix up to a consistent manifest sequence. Before a valid report or structured result exists, returns `ready=false` with `partial=true` and any retained evidence.

## Path parameters

- `job_id` string, required

## Headers

- `x-api-key` string, required

## Response `200`

Research results or a partial result projection

- ResearchjobsResearchResultsResponseDoc
  - `code` integer
  - `data` ResearchjobsResearchResult
    - `claims` RetrievaltypesClaim[]
      - `claim_id` string
      - `evidence_ids` string[]
      - `support_status` 'supported' | 'conflicting' | 'unverified'
      - `text` string
    - `coverage` RetrievaltypesSourceCoverage[]
      - `corpus_revision` string
      - `failure` RetrievaltypesFailure
        - `message` string
        - `reason` 'invalid_url' | 'unsupported_content_type' | 'blocked' | 'not_found' | 'rate_limited' | 'timeout' | 'upstream_error' | 'internal_error' | 'out_of_scope' | 'robots_disallowed' | 'duplicate' | 'limit_reached' | 'unsupported_filter' | 'unknown_source' | 'idempotency_conflict' | 'invalid_cursor' | 'result_expired' | 'full_text_unavailable' | 'budget_exhausted'
        - `retry_after_seconds` integer
        - `retryable` boolean
      - `indexed_at` string
      - `retrieved_at` string
      - `source_id` string
      - `status` 'ok' | 'failed' | 'not_indexed' | 'unsupported'
    - `evidence` RetrievaltypesEvidence[]
      - `content_sha256` string
      - `evidence_id` string
      - `passage` RetrievaltypesPassage
        - `locator` RetrievaltypesPassageLocator
          - `anchor` string
          - `end_byte` integer
          - `end_line` integer
          - `heading` string
          - `page` integer
          - `start_byte` integer
          - `start_line` integer
        - `passage_id` string
        - `score` number
        - `text` string
      - `retrieved_at` string
      - `revision` string
      - `source_id` string
      - `source_kind` 'web' | 'paper' | 'developer'
      - `title` string
      - `url` string
    - `job_id` string
    - `partial` boolean
    - `ready` boolean
    - `report_markdown` string
    - `result_kind` 'evidence_only' | 'report' | 'structured'
    - `searches` ResearchjobsSearchRecord[]
      - `hits` ResearchjobsSearchRecordHit[]
        - `snippet` string
        - `source_id` string
        - `title` string
        - `url` string
      - `query` string
      - `source_id` string
      - `source_kind` 'web' | 'paper' | 'developer'
    - `snapshot_sequence` integer
    - `source_snapshot` ResearchjobsSourceSnapshot
      - `registry_revision` string
      - `scope` 'web' | 'papers' | 'developer' | 'mixed'
      - `sources` ResearchjobsSourceGeneration[]
        - `generation_id` string
        - `kind` 'web' | 'paper' | 'developer'
        - `source_id` string
        - `source_revision` string
    - `structured_data` object
    - `usage` RetrievaltypesUsage
      - `browser_renders` integer
      - `credits_charged` integer
      - `credits_released` integer
      - `credits_reserved` integer
      - `fetch_attempts` integer
      - `fetched_urls` integer
      - `input_tokens` integer
      - `output_tokens` integer
      - `search_requests` integer
      - `settlement_pending` boolean
    - `warnings` RetrievaltypesWarning[]
      - `code` 'source_failed' | 'source_not_indexed' | 'discovery_truncated' | 'ranking_window_limit' | 'imprecise_date_excluded' | 'content_unavailable' | 'cached_source_stale'
      - `message` string
      - `source_id` string
  - `msg` string

## Other responses

- `401`: Authentication required
- `404`: Research job not found

---

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