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

# Fetch progress and results for a routine run

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

## Request

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

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

## Path parameters

- `routine_run_id` string, required

## Query parameters

- `cursor` string
- `limit` integer

## Response `200`

200

- RunResultsComplete
  - `cursor` string
  - `data` RunResultItem[], required
    - `error` object
      - `message` string, required
    - `id` string, required
    - `result` object
    - `status` 'complete' | 'failed', required
  - `finished` number, 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-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`

[Operation history](https://skmtc.dev/clay/apis/clay-public-api/changes/routines/run/: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)