---
title: "Get a list of enforcers"
method: GET
path: "/enforcer"
tags: ["Enforcer"]
---

# Get a list of enforcers

`GET /enforcer`

## Request

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

## Headers

- `X-Auth-Token` string, required

## Response `200`

Success

- RESTAgentsData
  - `enforcers` RESTAgent[], required
    - `id` string, required
    - `name` string, required
    - `display_name` string, required
    - `host_name` string, required
    - `host_id` string, required
    - `version` string, required
    - `labels` object, required
      - `key` string
      - `value` string
    - `domain` string, required
    - `pid_mode` string, required
    - `network_mode` string, required
    - `created_at` string, required
    - `started_at` string, required
    - `joined_at` string, required
    - `memory_limit` integer, required
    - `cpus` string, required
    - `cluster_ip` string, required
    - `connection_state` string, required
    - `disconnected_at` string, 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)