---
title: "Get a list of controllers"
method: GET
path: "/controller"
tags: ["Controller"]
---

# Get a list of controllers

`GET /controller`

## Request

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

## Headers

- `X-Auth-Token` string, required

## Response `200`

Success

- RESTController
  - `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
  - `created_at` string, required
  - `started_at` string, required
  - `joined_at` string, required
  - `memory_limit` integer, required
  - `cpus` string, required
  - `cluster_ip` string, required
  - `leader` boolean, required
  - `connection_state` string, required
  - `disconnected_at` string, required
  - `orch_conn_status` string, required
  - `orch_conn_last_error` 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)