---
type: api
title: Get coordinator candidates
description: Retrieve a list of all coordinator candidates.
url: https://www.elastic.co/elastic/docs-builder/docs/4641/api/doc/cloud-enterprise/v3/operation/operation-get-coordinator-candidates
resource: https://www.elastic.co/elastic/docs-builder/docs/4641/api/doc/cloud-enterprise/v3/operation/operation-get-coordinator-candidates
products:
  - Elastic Cloud Enterprise
---

# Get coordinator candidates

Authentication: required

## Paths

- `GET` `/platform/infrastructure/coordinators/candidates`

## Description

Retrieve a list of all coordinator candidates.

## Response

A list of all coordinator candidates.

`application/json`

- `candidates` (object[])
  Summarized information on each coordinator candidate
  - `name` (string)
    Name of this coordinator candidate.
  - `public_hostname` (string)
    Public hostname of this coordinator candidate
  - `acl` (object)
    Represents a Zookeeper ACL permission
    - `perms` (integer · format: int32)
      ZK static permissions for admin/all/create/read/write/delete
    - `scheme` (string)
      Zookeeper ACL scheme
    - `id` (string)
      Identity within provided scheme
  - `id` (integer · format: int32)
    Zookeeper server identifier corresponding to this coordinator candidate
  - `attributes` (map string to string)
    Attributes of this coordinator candidate
  - `state` (enum)
    State of the candidate
    Values: `accepted`, `pending`
## Code examples

#### curl

```curl
curl -X GET "${API_URL}/platform/infrastructure/coordinators/candidates" \
  -u "${USERNAME}:${PASSWORD}"
```

## Response examples

#### 200

`application/json`

Generated from the API spec. Values are representative. Unions use the first variant; deeply nested or large bodies may omit fields.

```json
{
  "candidates": [
    {
      "name": "string",
      "public_hostname": "string",
      "acl": {
        "perms": 0,
        "scheme": "string",
        "id": "string"
      },
      "id": 0,
      "attributes": {
        "key": "string"
      },
      "state": "accepted"
    }
  ]
}
```