---
title: "Poll job status"
method: GET
path: "/{env_id}/{flow_id}/{tenant}/jobs/status"
---

# Poll job status

`GET /{env_id}/{flow_id}/{tenant}/jobs/status`

## Request

- Base URL: `https://api.hotglue.com`
- URL: `https://api.hotglue.com/{env_id}/{flow_id}/{tenant}/jobs/status`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/hotglue/apis/hotglue-api/docs/:env_id/:flow_id/:tenant/jobs/status/get.ts> (a function with typed inputs; its response is checked against the schema)

Check on the status of a job using exactly one of `job_root`, `job_id`, or `external_job_id`. Read about the possible job statuses [here](/key-concepts/jobs/life-cycle).

## Path parameters

- `env_id` string, required
- `flow_id` string, required
- `tenant` string, required

## Query parameters

- `job_root` string
- `job_id` string
- `external_job_id` string

## Response `200`

200

- object
  - `job_id` string
  - `env_id` string
  - `job_name` string
  - `tenant` string
  - `started_by` string
  - `flow` string
  - `s3_root` string
  - `start_time` string
  - `state` object
  - `tap` string
  - `status` 'JOB_CREATED' | 'PROVISION_FAILED' | 'DISCOVER_STARTED' | 'DISCOVER_SUCCESS' | 'DISCOVER_FAILED' | 'SYNC_STARTED' | 'SYNC_FAILED' | 'SYNC_SUCCESS' | 'ETL_STARTED' | 'ETL_FAILED' | 'ETL_SUCCESS' | 'EXPORT_STARTED' | 'EXPORT_FAILED' | 'JOB_COMPLETED'
  - `message` string
  - `last_updated` string

## Other responses

- `400`: 400

## Changes

- **2026-11-10** `00870a66a550`: 2 warning
  - added the new `DISCOVER_SUCCESS` enum value to the `status` response property for the response status `200`
  - added the new `PROVISION_FAILED` enum value to the `status` response property for the response status `200`
- **2026-09-22** `90c0c21398cc`: 3 info
  - added the new optional `query` request parameter `external_job_id`
  - added the new optional `query` request parameter `job_id`
  - the `query` request parameter `job_root` became optional

[Operation history](https://skmtc.dev/hotglue/apis/hotglue-api/changes/:env_id/:flow_id/:tenant/jobs/status/get.md)

---

[API](https://skmtc.dev/hotglue/apis/hotglue-api.md) - [All operations](https://skmtc.dev/hotglue/apis/hotglue-api/llms.txt) - [OpenAPI document](https://skmtc.dev/hotglue/apis/hotglue-api/revisions/00870a66a550?raw)