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

# Get coordinator candidates

## Paths

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

## Description

Retrieve a list of all coordinator candidates.

## Authentication

- Basic: `Authorization: Basic <credentials>`
- Api key: `Authorization: <value>`

## 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}"
```