Apify
List Apify Actor Runs
List runs for an actor with optional filters.
1 creditRuns in your Apify accountEndpoint
Parameters
| Name | Type | Required | Note |
|---|---|---|---|
| identifieraccount · required | account | required | — |
| actorIdstring · required | string | required | The unique identifier of the Apify Actor. Found in the Actor URL or settings page. e.g. apify/web-scraper Example: |
| limitnumber · optional | number | optional | — |
| offsetnumber · optional | number | optional | — |
| descboolean · optional | boolean | optional | When enabled, returns runs sorted by creation date with the most recent first. |
| statusstring · optional | string | optional | e.g. RUNNING, SUCCEEDED, FAILED |
Response schema
{
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"count": {
"type": "integer"
},
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"actId": {
"type": "string"
},
"status": {
"type": "string"
},
"buildId": {
"type": "string"
},
"exitCode": {
"type": "integer"
},
"startedAt": {
"type": "string"
},
"finishedAt": {
"type": "string"
},
"defaultDatasetId": {
"type": "string"
}
}
}
},
"limit": {
"type": "integer"
},
"total": {
"type": "integer"
},
"offset": {
"type": "integer"
}
}
}
}
}