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

# Retrieve FindAll Run Status

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

Retrieve a FindAll run.

## Path parameters

- `findall_id` string, required

## Headers

- `parallel-beta` string, nullable

## Response `200`

Successful Response

- FindAllRun — 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.

## 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 `status/termination_reason/anyOf[subschema #1]/` response property for the response status `200`
- **2026-01-13** `105d778ad64d` — 1 breaking, 7 info
  - the response's body type/format changed from ``/`` to `object`/`` for status `200`
  - removed `#/components/schemas/FindAllRun, #/components/schemas/FindAllPollResponse` from the response body `anyOf` list for the response status `200`
  - added the optional property `created_at` to the response with the `200` status
  - added the optional property `metadata` 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/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)