---
title: "Return status of a worker process"
method: GET
path: "/workers/{workerId}"
tags: ["Workers", "Method GET"]
---

# Return status of a worker process

`GET /workers/{workerId}`

Returns status of a particular worker process.

## Query parameters

- `fields` string

## Response `200`

Success

- NginxWorker — Statistics per each worker process.
  - `id` integer — The ID of the worker process.
  - `pid` integer — The PID identifier of the worker process used by the operating system.
  - `connections` object — The number of accepted, dropped, active, and idle connections per worker process.
    - `accepted` integer — The total number of client connections accepted by the worker process.
    - `dropped` integer — The total number of client connections dropped by the worker process.
    - `active` integer — The current number of active client connections that are currently being handled by the worker process.
    - `idle` integer — The number of idle client connections that are currently being handled by the worker process.
  - `http` object
    - `requests` object — The total number of client requests handled by the worker process.
      - `total` integer — The total number of client requests received by the worker process.
      - `current` integer — The current number of client requests that are currently being processed by the worker process.

## Other responses

- `404` — Worker not found (*WorkerNotFound*), unknown version (*UnknownVersion*)

---

[API](https://skmtc.dev/nginx/apis/nginx-plus-rest-api.md) · [All operations](https://skmtc.dev/nginx/apis/nginx-plus-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/nginx/nginx-plus-rest-api/revisions/533ae7834228/schema)