---
type: api
title: Get proxy health
description: > WARNING
url: https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/cloud-enterprise/v4/operation/operation-get-proxies-health
resource: https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/cloud-enterprise/v4/operation/operation-get-proxies-health
products:
  - Elastic Cloud Enterprise
---

# Get proxy health

## Paths

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

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

## Description

> WARNING
> This endpoint is deprecated and scheduled to be removed in the next major version.

Get the health status of all proxies.

## Query String Parameters

- `expect_status` (string)
  The expected status

## Responses

#### `200`

Returns health information on all the proxies

`application/json`

- `observed_proxies_count` (integer)
  Total number of proxies
- `expected_proxies_count` (integer)
  Expected minimum number of proxies
- `allocations` ([] ProxiesAllocationsInfo)
  Allocations for proxies
  - `allocations_type` (string)
    The type of proxy allocations (e.g. Elasticsearch, Kibana, APM)
  - `max_allocations` (integer)
    The maximum number of allocations
  - `proxies_at_max_allocations` (integer)
    The number of proxies that have the maximum number of allocations
- `filtered_groups` ([] ProxiesFilteredGroupHealth)
  Filtered groups of proxies with associated status
  - `group` ({} ProxiesFilteredGroup)
    A set of proxy filters with an expected number of matching proxies.
    - `id` (string)
      Identifier of the filtered group of proxies
    - `filters` ([] ProxiesFilter)
      Filters to be matched
      - `key` (string)
        Key of the proxy metadata item to be matched
      - `value` (string)
        Value of the proxy metadata item to be matched
    - `expected_proxies_count` (integer)
      Expected minimum number of proxies matching all filters in this group
  - `observed_proxies_count` (integer)
    The number of proxies that match all of the filters in the group
  - `status` (string)
    "Health status for this filtered group. One of "Green", "Yellow" or "Red"
- `status` (string)
  "Health status for all proxies. One of "Green", "Yellow" or "Red"
#### `417`

The health status is worse than the expected one.

`application/json`

- `observed_proxies_count` (integer)
  Total number of proxies
- `expected_proxies_count` (integer)
  Expected minimum number of proxies
- `allocations` ([] ProxiesAllocationsInfo)
  Allocations for proxies
  - `allocations_type` (string)
    The type of proxy allocations (e.g. Elasticsearch, Kibana, APM)
  - `max_allocations` (integer)
    The maximum number of allocations
  - `proxies_at_max_allocations` (integer)
    The number of proxies that have the maximum number of allocations
- `filtered_groups` ([] ProxiesFilteredGroupHealth)
  Filtered groups of proxies with associated status
  - `group` ({} ProxiesFilteredGroup)
    A set of proxy filters with an expected number of matching proxies.
    - `id` (string)
      Identifier of the filtered group of proxies
    - `filters` ([] ProxiesFilter)
      Filters to be matched
      - `key` (string)
        Key of the proxy metadata item to be matched
      - `value` (string)
        Value of the proxy metadata item to be matched
    - `expected_proxies_count` (integer)
      Expected minimum number of proxies matching all filters in this group
  - `observed_proxies_count` (integer)
    The number of proxies that match all of the filters in the group
  - `status` (string)
    "Health status for this filtered group. One of "Green", "Yellow" or "Red"
- `status` (string)
  "Health status for all proxies. One of "Green", "Yellow" or "Red"
## Code Examples

#### Console

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

#### curl

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