---
title: "Show workload"
method: GET
path: "/workload/{id}"
tags: ["Workload"]
---

# Show workload

`GET /workload/{id}`

## Request

- Base URL: `/v1` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/v1/workload/{id}`
- Auth: none declared. Required headers: `X-Auth-Token`
- TypeScript: <https://skmtc.dev/neuvector/apis/neuvector-api/docs/workload/:id/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `id` string, required

## Headers

- `X-Auth-Token` string, required

## Response `200`

Success

- RESTWorkloadDetailData
  - `workload` RESTWorkloadDetail, required
    - `id` string, required
    - `name` string, required
    - `display_name` string, required
    - `platform_role` string, required
    - `domain` string, required
    - `state` string, required
    - `service` string, required
    - `service_group` string, required
    - `share_ns_with` string
    - `policy_mode` string
    - `scan_summary` RESTScanBrief
      - `status` string, required
      - `high` integer, required
      - `medium` integer, required
      - `result` string, required
      - `scanned_timestamp` integer, required
      - `scanned_at` string, required
      - `base_os` string, required
      - `scanner_version` string, required
      - `cvedb_create_time` string, required
    - `host_name` string, required
    - `host_id` string, required
    - `enforcer_id` string, required
    - `image` string, required
    - `network_mode` string, required
    - `privileged` boolean, required
    - `cap_quarantine` boolean, required
    - `created_at` string, required
    - `started_at` string, required
    - `finished_at` string, required
    - `running` boolean, required
    - `secured_at` string, required
    - `exit_code` integer, required
    - `interfaces` object, required
      - `key` string
      - `value` RESTIPAddr[]
        - `ip` string, required
        - `ip_prefix` integer, required
        - `gateway` string, required
    - `ports` RESTWorkloadPorts[], required
      - `ip_proto` integer, required
      - `port` integer, required
      - `host_ip` string, required
      - `host_port` integer, required
    - `labels` object, required
      - `key` string
      - `value` string
    - `applications` string[], required
    - `memory_limit` integer, required
    - `cpus` string, required
    - `groups` string[], required
    - `app_ports` object, required
      - `key` string
      - `value` string
    - `children` RESTWorkloadDetail[], required

---

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