List Actor runs - Automate.ax

apify.listRuns lists Apify Actor runs with resource, status, and time filters.

Example

automations/apify-list-runs.automation.ts

import { automation, onHttpRequest } from "automate.ax"
import { apify } from "automate.ax/apify"

export default automation("List Actor runs", () => {
  onHttpRequest({ scope: "automation" })

  apify.listRuns({
    actorId: "apify/web-scraper",
    status: ["SUCCEEDED", "FAILED"],
    desc: true,
    limit: 100,
  })
})

Inputs

Pass at most one of actorId or taskId. Omit both to list account-wide runs.

Field	Type	Default	Description
`actorId`	`string`	—	Limit to one Actor.
`taskId`	`string`	—	Limit to one saved task.
`status`	`ApifyJobStatus \| ApifyJobStatus[]`	—	Filter by one or more statuses.
`startedAfter`	ISO 8601 string	—	Only runs started after this time.
`startedBefore`	ISO 8601 string	—	Only runs started before this time.
`desc`	`boolean`	Provider default	Return newest runs first.
`limit`	`number`	Provider default	Page size from 1 to 1000.
`offset`	`number`	`0`	Runs to skip.

Output

Returns items plus count, total, limit, offset, and desc pagination metadata. Statuses include READY, RUNNING, SUCCEEDED, FAILED, TIMING-OUT, TIMED-OUT, ABORTING, and ABORTED.