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

# Runs

> SDK methods for the Benchmark Runs resource.

Full concept: [Benchmark Runs](/guides/concepts/runs). REST reference: [/api-reference/resources/runs](/api-reference/resources/runs).

## Methods

```typescript theme={null}
verial.runs.list({ cursor?, limit? })
verial.runs.create({ benchmarkId })
verial.runs.get({ id })
verial.runs.complete({ id })
verial.runs.cancel({ id })
```

## Example

```typescript theme={null}
const run = await verial.runs.create({ benchmarkId: 'bench_01H...' })

while (true) {
  const latest = await verial.runs.get({ id: run.id })
  if (latest.phase === 'completed' || latest.phase === 'failed') {
    console.log('verdict:', latest.verdict, 'score:', latest.score)
    break
  }
  await new Promise((r) => setTimeout(r, 2000))
}
```