> For the complete documentation index, see [llms.txt](https://docs.dbnl.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dbnl.com/v0.20.x/using-distributional/python-sdk/sdk-functions/run/get_run.md).

# get\_run

<pre class="language-python"><code class="lang-python">dbnl.get_run(
    *,
    run_id: str,
) -> <a data-footnote-ref href="#user-content-fn-1">Run</a>:
</code></pre>

## Parameters

<table><thead><tr><th width="207">Arguments</th><th>Description</th></tr></thead><tbody><tr><td><code>run_id</code></td><td>The ID of the dbnl <a href="/pages/QtYyvw16aMflnd2CNWFJ">Run</a>. Run ID starts with the prefix <code>run_</code> . Run ID can be found at the Run detail page. An error will be raised if there does not exist a Run with the given <code>run_id</code>.</td></tr></tbody></table>

## Returns

<table><thead><tr><th width="208">Type</th><th>Description</th></tr></thead><tbody><tr><td><a href="/pages/QtYyvw16aMflnd2CNWFJ">Run</a></td><td>The dbnl Run with the given ID.</td></tr></tbody></table>

## Examples

```python
import dbnl
dbnl.login()


proj1 = dbnl.get_or_create_project(name="test_p1")
runcfg1 = dbnl.create_run_config(project=proj1, columns=[{"name": "error", "type": "float"}])
run1 = dbnl.create_run(project=proj1, run_config=runcfg1)

# Retrieving the Run by ID
run2 = dbnl.get_run(run_id=run1.id)
assert run1.id == run2.id

# DBNLRunNotFoundError: A DBNL Run with id run_0000000 does not exist.
run3 = dbnl.get_run(run_id="run_0000000")
```

[^1]: [Run](/v0.20.x/using-distributional/python-sdk/sdk-objects/run.md)