---
title: "Fetch progress and results for a batch run"
method: GET
path: "/routines/run-batch/{routine_run_id}/results"
tags: ["routines"]
---

# Fetch progress and results for a batch run

`GET /routines/run-batch/{routine_run_id}/results`

## Request

- Base URL: `https://api.clay.com/public/v0`
- URL: `https://api.clay.com/public/v0/routines/run-batch/{routine_run_id}/results`
- Auth: API key in header `clay-api-key`

Returns current status and results for an asynchronous batch routine run.

## Path parameters

- `routine_run_id` string, required

## Response `200`

200

- union
  - BatchResultsValidationFailed
    - `error` BatchValidationError, required
      - `details` BatchValidationErrorDetail[], required
        - `field` string, required
        - `line_number` number, required
        - `message` string, required
      - `message` string, required
      - `total_invalid_rows` number, required
    - `routine_run_id` string, required
    - `status` 'validation_failed', required
  - BatchResultsProcessingFailed
    - `error` object, required
      - `message` string, required
    - `routine_run_id` string, required
    - `status` 'processing_failed', required
  - BatchResultsComplete
    - `finished` number, required
    - `result_url` string, uri, required
    - `routine_run_id` string, required
    - `status` 'complete', required
    - `total` number, required

## Other responses

- `202`: 202
- `400`: 400
- `401`: 401
- `404`: 404
- `429`: 429

## Changes

- **2026-08-08** `c1f3cd4d89da`: 1 breaking
  - added `#/components/schemas/BatchResultsProcessingFailed` to the response body `oneOf` list for the response status `200`
- **2026-07-31** `881a05e984ea`: 1 breaking, 1 warning, 1 info
  - for the `path` request parameter `routine_run_id`, the minLength was increased from `0` to `1`
  - for the `path` request parameter `routine_run_id`, the maxLength was set to `64`
  - added the non-success response with the status `400`
- **2026-07-26** `3b86731e7a59`: 1 breaking, 1 info
  - added `#/components/schemas/BatchResultsValidationFailed, #/components/schemas/BatchResultsComplete` to the response body `oneOf` list for the response status `200`
  - removed `#/components/schemas/BatchResultsValidationFailed, #/components/schemas/BatchResultsComplete` from the response body `anyOf` list for the response status `200`

[Operation history](https://skmtc.dev/clay/apis/clay-public-api/changes/routines/run-batch/:routine_run_id/results/get.md)

---

[API](https://skmtc.dev/clay/apis/clay-public-api.md) - [All operations](https://skmtc.dev/clay/apis/clay-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/clay/apis/clay-public-api/revisions/583f58ced7f1?raw)