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

> ## Agent Instructions
> Automate.ax automations are TypeScript programs.
> Use Bun for installation and command examples.
> Use Automate.ax for the product name and automate.ax for the package, CLI, and domain.
> Treat documented public APIs as current; do not invent transitional or deprecated names.

# Get Actor run

> Gets the current state and storage IDs for one Apify Actor run.

`apify.getRun` gets the current state and storage IDs for one Apify Actor run.

## Example

```ts automations/apify-get-run.automation.ts theme={null}
import { automation, onHttpRequest } from "automate.ax"
import { apify } from "automate.ax/apify"

export default automation("Get Actor run", () => {
  onHttpRequest({ scope: "automation" })

  apify.getRun({ runId: "run-id" })
})
```

## Inputs

`runId` is the Actor run ID.

## Output

Returns the Actor run, including status, Actor and task IDs, build ID, default dataset, key-value store and request queue IDs, timestamps, exit code, statistics, and usage.

This read is safe to retry. The action fails when the run does not exist or the connected token cannot read it.