Skip to main content
GET
/
public
/
v1
/
tasks
/
{taskId}
/
runs
List task runs
curl --request GET \
  --url https://api.komos.ai/public/v1/tasks/{taskId}/runs \
  --header 'Authorization: Bearer <token>'
{
  "runs": [
    {
      "id": "220a501c-82f4-43e2-8107-3d8e0c0f4c1b",
      "taskId": "79c6b1aa-24d1-45b3-8c94-9a2e2a2f55bc",
      "status": "COMPLETED",
      "triggerType": "api",
      "timestamps": {
        "createdAt": "2025-10-13T15:02:44.812Z",
        "startedAt": "2025-10-13T15:02:47.001Z",
        "finishedAt": "2025-10-13T15:03:28.559Z"
      },
      "progress": {
        "currentStep": 5,
        "stepsTotal": 5
      },
      "inputs": {
        "url": "https://example.com/orders/48190"
      },
      "outputs": {
        "summary": "Completed order checkout scrape"
      },
      "logsUrl": "https://api.komos.ai/public/v1/task-runs/220a501c-82f4-43e2-8107-3d8e0c0f4c1b/logs",
      "error": null,
      "cancelReason": null
    },
    {
      "id": "9c77d908-7bf4-4e7f-9a20-2c5e7fdf2e94",
      "taskId": "79c6b1aa-24d1-45b3-8c94-9a2e2a2f55bc",
      "status": "PENDING",
      "triggerType": "api",
      "timestamps": {
        "createdAt": "2025-10-14T18:21:52.123Z",
        "startedAt": null,
        "finishedAt": null
      },
      "progress": null,
      "inputs": {
        "url": "https://example.com/orders/48219",
        "runHeadless": true
      },
      "outputs": {},
      "logsUrl": "https://api.komos.ai/public/v1/task-runs/9c77d908-7bf4-4e7f-9a20-2c5e7fdf2e94/logs",
      "error": null,
      "cancelReason": null
    }
  ]
}
Returns the 50 most recent runs for the given task, ordered from newest to oldest. Use this to build dashboards or confirm the run ID returned by the queue endpoint.

​
Request

​
Path parameters

  • taskId — UUID for the task whose history you need.
No query parameters are currently supported; additional values are ignored.

​
Example

curl -X GET \
  https://api.komos.ai/public/v1/tasks/4df7d6f9-56be-4f77-9b18-25ad908a20b7/runs \
  -H 'Authorization: Bearer sk_live_example'

​
Responses

  • 200 OK — Returns { "runs": Run[] } with at most 50 entries.
  • 400 Bad Request — Invalid task ID.
  • 401 Unauthorized — Missing or malformed API key.
  • 404 Not Found — The task is not visible to your organization.
Each run object matches the schema described in the introduction. Follow the logsUrl field to fetch execution logs for any run in the list.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
taskId
string<uuid>
required

UUID of the Komos task to inspect.

Response

Runs returned successfully.

​
runs
object[]
required