---
title: stack kb elastic-agents get-fleet-agents cli command
description: Get agents Behaviour flags: --dry-run — validate all inputs and exit without performing any action 
url: https://www.elastic.co/elastic/docs-builder/docs/4120/reference/elastic-cli/cli/stack/kb/elastic-agents/get-fleet-agents
applies_to:
  - Elastic Cloud Serverless: Preview
  - Elastic Stack: Preview
---

# stack kb elastic-agents get-fleet-agents cli command
<cli-modifiers>
</cli-modifiers>

```bash
elastic stack kb elastic-agents get-fleet-agents [options]
```

Get agents
**Behaviour flags:**
`--dry-run` — validate all inputs and exit without performing any action

## Options

<definitions>
  <definition term="--page number">
    Page number
  </definition>
  <definition term="--per-page number">
    Number of results per page
  </definition>
  <definition term="--kuery string">
    A KQL query string to filter results
  </definition>
  <definition term="--show-agentless">
    When true, include agentless agents in the results
  </definition>
  <definition term="--show-inactive">
    When true, include inactive agents in the results
  </definition>
  <definition term="--with-metrics">
    When true, include CPU and memory metrics in the response
  </definition>
  <definition term="--show-upgradeable">
    When true, only return agents that are upgradeable
  </definition>
  <definition term="--get-status-summary">
    When true, return a summary of agent statuses in the response
  </definition>
  <definition term="--sort-field string">
    Field to sort results by
  </definition>
  <definition term="--sort-order enum">
    Sort order, ascending or descending
    **Values:** asc, desc
  </definition>
  <definition term="--search-after string">
    JSON-encoded array of sort values for `search_after` pagination
  </definition>
  <definition term="--open-pit">
    When true, opens a new point-in-time for pagination
  </definition>
  <definition term="--pit-id string">
    Point-in-time ID for pagination
  </definition>
  <definition term="--pit-keep-alive string">
    Duration to keep the point-in-time alive, for example, `1m`
  </definition>
  <definition term="--input-file string">
    path to a JSON file to use as command input
  </definition>
  <definition term="--dry-run">
    validate all inputs and exit without performing any action (preview changes without applying them)
  </definition>
</definitions>


## Global Options

<definitions>
  <definition term="--json">
    output as JSON
  </definition>
</definitions>