---
type: api
title: Get proxies
description: Retrieves an overview of all proxies.
url: https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/cloud-enterprise/operation/operation-get-proxies
resource: https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/cloud-enterprise/operation/operation-get-proxies
products:
  - Elastic Cloud Enterprise
---

# Get proxies

## Paths

- `GET` `/platform/infrastructure/proxies`

- [Basic auth](/elastic/docs-builder/docs/4371/api/doc/cloud-enterprise/authentication#basicauth)
- [Api key auth](/elastic/docs-builder/docs/4371/api/doc/cloud-enterprise/authentication#apikey)

## Description

Retrieves an overview of all proxies.

## Response

An overview of all proxies.

`application/json`

- `proxies_count` (integer)
  Number of proxies
- `settings` ({} ProxiesSettings)
  > WARNING
> This object is deprecated and scheduled to be removed in the next major version.
  - `expected_proxies_count` (integer)
    Expected number of proxies
  - `signature_secret` (string)
    Secret string for signature generation
  - `signature_valid_for_millis` (integer)
    Signature validity in milliseconds
  - `http_settings` ({} ProxiesHttpSettings)
    > WARNING
> This object is deprecated and scheduled to be removed in the next major version.
    - `disconnected_cutoff` (integer)
      Cutoff interval after disconnection in milliseconds
    - `minimum_proxy_services` (integer)
      Minimum number of proxy instances
    - `sso_settings` ({} ProxiesSSOSettings)
      > WARNING
> This object is deprecated and scheduled to be removed in the next major version.
      - `max_age` (integer)
        Maximum age of single-sign-on token in milliseconds
      - `sso_secret` (string)
        Secret string for single-sign-on
      - `cookie_name` (string)
        Name of the HTTP cookie used for single-sign-on
      - `dont_log_requests` (boolean)
        If true, don't log requests
      - `default_redirect_path` (string)
        Default path where users are redirected after a successful single-sign-on
      - `maintenance_bypass_cookie_name` (string)
        Name of the cookie that bypasses maintenance
    - `dashboards_base_url` (string)
      Base URL for the dashboard
    - `cookie_secret` (string)
      Secret string for the HTTP cookie
    - `user_cookie_key` (string)
      User key for the HTTP cookie
- `proxies` ([] ProxyInfo)
  Proxies
  - `proxy_id` (string)
    The proxy identifier
  - `runner_id` (string)
    Identifier of the runner for the proxy
  - `host_ip` (string)
    IP of the host the proxy runs on
  - `public_hostname` (string)
    Public hostname of the host the proxy runs on
  - `metadata` (object)
    Arbitrary metadata associated with the proxy
  - `healthy` (boolean)
    Specifies if the proxy is healthy
  - `zone` (string)
    The zone.
  - `allocations` ([] ProxyAllocationInfo)
    Allocation information by type.
    - `allocations_type` (enum)
      The type of proxy allocations
      Values: `elasticsearch`, `kibana`, `apm`, `integrations_server`, `appsearch`, `enterprise_search`
    - `counts` ({} ProxyAllocationCounts)
      The number of proxy allocations.
      - `allocations` (integer)
        The allocations count.
      - `connectors` (integer)
        The connector count.
## Code Examples

#### Console

```console
GET /platform/infrastructure/proxies
```

#### curl

```curl
curl -X GET "/platform/infrastructure/proxies"
```