Skip to content
ActionApifyUpdated May 2026

How do I check the status of an Apify actor run?

Short answer: Drop the "ApifyGet Actor Run Status" action anywhere in your workflow, map the inputs from upstream nodes, and publish.

Inputs

The fields this action accepts.

Every field can be mapped from an upstream trigger, AI step, table row, or hard-coded literal.

FieldTypeRequiredDescription
Run ID
run_id
stringRequiredRun ID (required)
Sample request
{
"run_id": "{{trigger.run_id}}"
}
Returns
{
"data": {
"id": "run-abc",
"status": "SUCCEEDED",
"defaultDatasetId": "ds-xyz"
}
}

Use these fields in downstream nodes for routing, logging, or error handling.

Triggered by

Apps that pair well as the trigger for Get Actor Run Status.

Any of these apps can fire this action as part of a workflow.

FAQ

Questions about Get Actor Run Status.

What does the Get Actor Run Status action do in Apify?
Returns the current state of a run — RUNNING, SUCCEEDED, FAILED, or ABORTED — plus runtime stats and compute usage. Poll for completion in workflows that need to wait, or pair with the actor's webhook for push-based notification.
What inputs does Get Actor Run Status require?
Required: Run ID. Every input accepts a static value or a variable from any upstream node in your workflow.
Can I use dynamic inputs from earlier workflow nodes?
Yes. Any field on this action can pull values from upstream nodes, whether that's a form response, a trigger payload, an AI output, or a lookup result.
What happens if Apify returns an error?
The workflow pauses on the failed node, the error message is captured in the run log, and you can retry the run with one click. Auto-retry policies are configurable per workflow with exponential backoff up to 5 attempts.
Does Get Actor Run Status support batch operations?
Yes. Run Get Actor Run Status inside a Loop node to process arrays. Tiny Command handles Apify's rate limits automatically so you don't have to throttle manually.
More actions

Other Apify actions.

Send get actor run status from your workflows.

Triggered by anything in the catalog. Free tier available. No credit card.