---
title: "Get a job's status"
method: GET
path: "/v1/jobs/{id}"
tags: ["Jobs"]
---

# Get a job's status

`GET /v1/jobs/{id}`

Returns the live status of an asynchronous job — typically used to poll Codeless test/suite runs started by `POST /v1/lab/:id/trigger`, `POST /v1/lab/trigger_all`, or `POST /v1/labsuites/:id/trigger`. Once `status` is FINISHED, the response includes `success` and per-test results.

## Path parameters

- `id` integer, required

## Response `200`

Get a job's status

- TestingbotEntitiesJob — Testingbot_Entities_Job model
  - `status` string, required — Job state (QUEUED, RUNNING, FINISHED, FAILED).
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `success` boolean, required — Aggregate pass/fail across all triggered tests; null until FINISHED.
  - `test_ids` integer[], required — Test IDs spawned by this job.
  - `errors` object[], required — Per-test failure detail (step, browser, time).

## Other responses

- `401` — Authentication required
- `404` — Job not found

---

[API](https://skmtc.net/testingbot/apis/testingbot-rest-api.md) · [All operations](https://skmtc.net/testingbot/apis/testingbot-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/testingbot/testingbot-rest-api/versions/eff607a49246/schema)