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

# Get coordinator candidates

## Paths

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

- [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

Retrieve a list of all coordinator candidates.

## Response

A list of all coordinator candidates.

`application/json`

- `candidates` ([] CoordinatorCandidateInfo)
  Summarized information on each coordinator candidate
  - `name` (string)
    Name of this coordinator candidate.
  - `public_hostname` (string)
    Public hostname of this coordinator candidate
  - `acl` ({} ZkAcl)
    Represents a Zookeeper ACL permission
    - `perms` (integer)
      ZK static permissions for admin/all/create/read/write/delete
    - `scheme` (string)
      Zookeeper ACL scheme
    - `id` (string)
      Identity within provided scheme
  - `id` (integer)
    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

#### Console

```console
GET /platform/infrastructure/coordinators/candidates
```

#### curl

```curl
curl -X GET "/platform/infrastructure/coordinators/candidates"
```