# Retrieve all network nodes including appliances and agents with filtering options

List both appliances and agents.

---

Requires nodes::read permission.

Endpoint: GET /node
Version: 1.0.0
Security: JWTAuthorizer

## Query parameters:

  - `cluster` (string)
    When provided, limit the nodes to members of the cluster. Should be the full cluster FQDN, e.g., mycluster.trustgrid.io.

  - `tags` (string)
    Comma-separated key:value pairs for tag filtering, e.g., location:Austin,device:Trustgrid.

  - `projection[]` (array)
    List of fields to return from the API. Supports nested fields and anything in the Node schema. Each field should be listed individually, e.g., projection[]=online&projection[]=uid.

---

If using curl, the -g flag will automatically escape the brackets for you.

## Response 200 fields (application/json):

  - `cluster` (string)
    Cluster FQDN
    Example: "mycluster.trustgrid.io"

  - `config` (object)
    Node config

  - `name` (string)
    Node name
    Example: "mynode"

  - `online` (boolean)
    True when the node is connected to the control plane

  - `shadow` (object)
    Node shadow

  - `state` (string)
    Node state
    Enum: "ACTIVE", "INACTIVE"

  - `tags` (object)
    Node tags

  - `type` (string)
    Device type
    Enum: "Agent", "Appliance"

  - `uid` (string)
    Node ID
    Example: "19084f81-5668-41ee-adbe-295e4c65531a"