> ## Documentation Index
> Fetch the complete documentation index at: https://developers.clay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# routines runs get

> Fetch status and results for an inline or bulk routine run.

Fetch status and results for a routine run started by [`clay routines runs start`](/cli/reference/routines-runs-start). The command first tries the inline results endpoint; if the run id is not an inline run, it falls back to the bulk results endpoint.

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
clay routines runs get <routineRunId> [--limit <n>]
```

The command auto-paginates inline results internally; cursors are not exposed in the output.

## Arguments

| Argument       | Description                                  |
| -------------- | -------------------------------------------- |
| `routineRunId` | Routine run id, e.g. `run_abc123`. Required. |

## Flags

| Flag          | Description                                                                                                        |
| ------------- | ------------------------------------------------------------------------------------------------------------------ |
| `--limit <n>` | Cap the number of inline results returned. Must be a positive integer. Ignored for bulk runs (which return a URL). |

## Output

The `mode` field discriminates inline vs. bulk; the `status` field discriminates progress vs. terminal states.

### Inline, in progress

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "routineRunId": "run_abc123",
  "mode": "inline",
  "status": "in_progress",
  "total": 100,
  "finished": 42
}
```

### Inline, complete

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "routineRunId": "run_abc123",
  "mode": "inline",
  "status": "complete",
  "total": 100,
  "finished": 100,
  "data": [
    {
      "id": "row-1",
      "status": "complete",
      "result": {}
    }
  ]
}
```

### Bulk, in progress

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "routineRunId": "run_abc123",
  "mode": "bulk",
  "status": "in_progress",
  "total": 1000,
  "finished": 250
}
```

### Bulk, complete

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "routineRunId": "run_abc123",
  "mode": "bulk",
  "status": "complete",
  "total": 1000,
  "finished": 1000,
  "resultUrl": "https://..."
}
```

Download `resultUrl` to read the JSONL results. The URL is short-lived.

### Bulk, validation failed

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "routineRunId": "run_abc123",
  "mode": "bulk",
  "status": "validation_failed",
  "error": {
    "message": "Input validation failed",
    "totalInvalidRows": 3,
    "details": [
      {
        "lineNumber": 12,
        "field": "inputs.domain",
        "message": "Required"
      }
    ]
  }
}
```

## Errors

| Code        | Exit | Notes                               |
| ----------- | ---- | ----------------------------------- |
| `not_found` | 6    | No inline or bulk run with that id. |

## Examples

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
clay routines runs get run_abc123 | jq -r '.status'
clay routines runs get run_abc123 | jq -r '.mode'
clay routines runs get run_abc123 --limit 10 | jq '.data | length'
```