---
title: "FindAll Run Result"
method: GET
path: "/v1beta/findall/runs/{findall_id}/result"
tags: ["FindAll"]
---

# FindAll Run Result

`GET /v1beta/findall/runs/{findall_id}/result`

Retrieve the FindAll run result at the time of the request.

## Path parameters

- `findall_id` string, required

## Headers

- `parallel-beta` string, nullable

## Response `200`

Successful Response

- FindAllRunResult — Complete FindAll search results. Represents a snapshot of a FindAll run, including run metadata and a list of candidate entities with their match status and details at the time the snapshot was taken.
  - `run` FindAllRun, required — FindAll run object with status and metadata.
    - `findall_id` string, required — ID of the FindAll run.
    - `status` FindAllRunStatus, required — Status object for FindAll run.
      - `status` 'queued' | 'action_required' | 'running' | 'completed' | 'failed' | 'cancelling' | 'cancelled', required — Status of the FindAll run.
      - `is_active` boolean, required — Whether the FindAll run is active
      - `metrics` FindAllCandidateMetrics, required — Metrics object for FindAll run.
        - `generated_candidates_count` integer — Number of candidates that were selected.
        - `matched_candidates_count` integer — Number of candidates that evaluated to matched.
      - `termination_reason` 'low_match_rate' | 'match_limit_met' | 'candidates_exhausted' | 'user_cancelled' | 'error_occurred' | 'timeout' | 'insufficient_funds', nullable — Reason for termination when FindAll run is in terminal status.
    - `generator` 'base' | 'core' | 'pro' | 'preview', required — Generator for the FindAll run.
    - `metadata` object, nullable — Metadata for the FindAll run.
    - `created_at` string, nullable — Timestamp of the creation of the run, in RFC 3339 format.
    - `modified_at` string, nullable — Timestamp of the latest modification to the FindAll run result, in RFC 3339 format.
  - `candidates` FindAllCandidate[], required — All evaluated candidates at the time of the snapshot.
    - `candidate_id` string, required — ID of the candidate.
    - `name` string, required — Name of the candidate.
    - `url` string, required — URL that provides context or details of the entity for disambiguation.
    - `description` string, nullable — Brief description of the entity that can help answer whether entity satisfies the query.
    - `match_status` 'generated' | 'matched' | 'unmatched' | 'discarded', required — Status of the candidate. One of generated, matched, unmatched, discarded.
    - `output` object, nullable — Results of the match condition evaluations for this candidate. This object contains the structured output that determines whether the candidate matches the overall FindAll objective.
    - `basis` FieldBasis[], nullable — List of FieldBasis objects supporting the output.
      - `field` string, required — Name of the output field.
      - `citations` Citation[] — List of citations supporting the output field.
        - `title` string, nullable — Title of the citation.
        - `url` string, required — URL of the citation.
        - `excerpts` string[], nullable — Excerpts from the citation supporting the output. Only certain processors provide excerpts.
      - `reasoning` string, required — Reasoning for the output field.
      - `confidence` string, nullable — Confidence level for the output field. Only certain processors provide confidence levels.
  - `last_event_id` string, nullable — ID of the last event of the run at the time of the request. This can be used to resume streaming from the last event.

## Other responses

- `422` — Validation Error

## Changes

- **2026-06-08** `973957d74ceb` — 1 info
  - `header` request parameter `parallel-beta` was deprecated
- **2026-04-21** `57e1c56be094` — 2 info
  - api tag `FindAll` added
  - api tag `FindAll API (Beta)` removed
- **2026-03-09** `970b780e8649` — 1 warning
  - added the new `insufficient_funds` enum value to the `run/status/termination_reason/anyOf[subschema #1]/` response property for the response status `200`
- **2026-01-13** `105d778ad64d` — 1 breaking, 7 info
  - the `run` response's property type/format changed from ``/`` to `object`/`` for status `200`
  - added the optional property `run/created_at` to the response with the `200` status
  - added the optional property `run/metadata` to the response with the `200` status
  - added the optional property `run/modified_at` to the response with the `200` status
  - …4 more
- **2025-11-13** `70ca78f3dbac` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/parallel-web/apis/parallel-api/changes/v1beta/findall/runs/:findall_id/result/get.md)

---

[API](https://skmtc.dev/parallel-web/apis/parallel-api.md) · [All operations](https://skmtc.dev/parallel-web/apis/parallel-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/parallel-web/parallel-api/revisions/1595294c8795/schema)