---
title: "Get worker daemon status"
method: GET
path: "/jobs/worker_status"
tags: ["Jobs"]
---

# Get worker daemon status

`GET /jobs/worker_status`

Check if the background job worker daemon is running by checking PID and heartbeat files

## Response `200`

successful operation

- WorkerStatusResponse
  - `status` string
  - `worker` WorkerStatus
    - `is_running` boolean — Whether the worker process is running
    - `is_alive` boolean — Whether the worker is alive (based on heartbeat)
    - `pid_file_exists` boolean — Whether PID file exists
    - `heartbeat_file_exists` boolean — Whether heartbeat file exists
    - `heartbeat_age_seconds` integer — Age of last heartbeat in seconds
    - `pid_data` object — PID file data
      - `pid` integer
      - `worker_id` string
      - `started_at` string
      - `poll_interval` integer
    - `heartbeat_data` object — Heartbeat file data
      - `worker_id` string
      - `pid` integer
      - `timestamp` integer
      - `datetime` string
    - `active_worker_count` integer — Number of active workers (jobs currently being processed)
    - `active_worker_ids` string[] — List of active worker IDs

## Other responses

- `400` — Bad request

---

[API](https://skmtc.net/worldbank/apis/metadata-editor-jobs-api.md) · [All operations](https://skmtc.net/worldbank/apis/metadata-editor-jobs-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/worldbank/metadata-editor-jobs-api/revisions/7f334b22fc50/schema)