Returns all Figment validators, or a filtered subset thereof, for your organization (via API key) created through the **Create Validators** endpoint.

Use the [get-validator](https://docs.figment.io/update/reference/get-validator) endpoint if you only want information on one single validator.

Use `include_fields` to get extra information. e.g. To get the presigned exit messages for the validators, append `?include_fields=exit_message`.

A few noteworthy response fields:

- `status`: refer to the [Lifecycle of a Validator](https://docs.figment.io/docs/lifecycle-eth-validator) guide
- `status_history` returns an array of all status transitions.
- estimates for:
  - when a validator will become active (`estimated_active_at`)
  - when it will exit (`estimated_exit_at`)
  - and when the principal will be withdrawable (`estimated_withdrawal_at`)

**Note:** If you are restaking via Eigenlayer, your withdrawal address is set to your EigenPod address.

### Network

- `network`
  - string
  - enum
  - required
  - Allowed: `mainnet`, `hoodi`

### Withdrawal Address

- `withdrawal_address`
  - string
  - The validator's withdrawal address. Must be prefixed with `0x`.

### Groups

- `groups`
  - string
  - Filter using comma-separated group uuids.

### Region

- `region`
  - string
  - enum
  - The validator's geographic region. Only for Figment validators.
  - Allowed: `ca-central-1`, `eu-west-1`

### Status

- `status`
  - string
  - enum
  - The current validator's status. See [Lifecycle of a Validator](https://docs.figment.io/docs/lifecycle-eth-validator).
  - Allowed:
    - `active_ongoing`
    - `provisioned`
    - `funding_requested`
    - `deposited_not_finalized`
    - `deposited`
    - `pending_initialized`
    - `pending_queued`
    - `active_exiting`
    - `active_ongoing`
    - `active_slashed`
    - `exited_slashed`
    - `exited_unslashed`
    - `withdrawal_done`
    - `withdrawal_possible`

### Net Fee Payout Address

- `net_fee_payout_address`
  - string
  - The ETH wallet address that receives the net execution layer rewards.

### Staking Request ID

- `staking_request_id`
  - string
  - The ID associated to the request for a set of validators.

### Credentials Prefix

- `credentials_prefix`
  - string
  - enum
  - Filter for withdrawal_credentials field.
  - Allowed: `0x01`, `0x02`

### Include Fields

- `include_fields`
  - array of strings
  - A comma-separated list of additional objects to include in the response.
  - Allowed: `deposit_data`, `status_history`, `status_estimates`, `on_demand_exit`, `exit_message`, `staking_request`, `balances`

## Response Structure

### 200 Validators List

- `data`
  - array of objects
  - Each object contains:
    - `id`: string (UUID for the validator)
    - `index`: integer or null (Validator's on-chain index)
    - `network`: string (enum)
    - `pubkey`: string (the pubkey for the validator, prefixed with `0x`)
    - `withdrawal_address`: string
    - `status`: string or null (current status of the validator)
    - `withdrawal_credentials`: string or null
    - `fee_recipient_address`: string or null
    - `net_fee_payout_address`: string or null
    - `region`: string or null
    - `deposit_data`: object or null
    - `status_history`: object or null
    - `status_estimates`: object or null
    - `on_demand_exit`: object or null
    - `exit_message`: object or null
    - `staking_request`: object or null
    - `balances`: object or null

### Meta Object

- `meta`
  - pagination: object
- `pagination`
  - `current_page`: integer
  - `total_pages`: integer
  - `total_item_count`: integer

## Example Request

```bash
curl --request GET \
  --url 'https://api.figment.io/ethereum/validators?network=mainnet' \
  --header 'accept: application/json' \
  --header 'x-api-key: your-api-key-here'
```

## Example Response

```json
{
  "data": [
    {
      "id": "29d3a221-8de7-4874-9973-35ac1e70b87b",
      "network": "hoodi",
      "pubkey": "0xb121633094a5e75b886eeba797d43e80e4a6003462921f175aed2f112a460d09447f3c484f067c13b100b763070857b3",
      "withdrawal_address": "0xE40F80618324C814cD444434670a44ba4583aE38",
      "withdrawal_credentials": "0x010000000000000000000000e40f80618324c814cd444434670a44ba4583ae38",
      "net_fee_payout_address": "0xE40F80618324C814cD444434670a44ba4583aE38",
      "fee_recipient_address": "0xE40F80618324C814cD444434670a44ba4583aE38",
      "status": "deposited",
      "region": "ca-central-1",
      "index": null,
      "staking_request": {
        "id": "817c04a2-3d5b-4222-81c8-2de77f0be7db",
        "created_at": "2023-10-17T18:35:30Z"
      },
      "status_history": {
        "events": [
          {
            "status": "provisioned",
            "changed_at": "2023-10-17T18:35:31Z"
          },
          {
            "status": "deposited_not_finalized",
            "changed_at": "2023-10-17T20:38:36Z"
          },
          {
            "status": "deposited",
            "changed_at": "2023-10-17T20:51:36Z"
          }
        ]
      },
      "deposit_data": {
        "signature": "0xb7a8703d0ff4865174525c760509a18c5cdc4a321612d865b995d9ba60a9519703d3f7be1527e89041dbea886cb3b26a0d1a13976405b93301cdb16a54258ec3ac891e738ad73e68c6a6a09b286f8c8c71005eb8e55d144ee59fa7c311ac3dea",
        "figment_signature": "0x308187024201cc42b16a0264b3853e123034f21ef7fc1d75b96bc8ae13427836475838c447f90e19a8e3926fe3d20bc91da4d720f886ef3eb3f35ed164674bb6cab2c216329c2002411392c3c6a70bf5f3df0ed3d092d28dbed24933d4ab150ec1ee60cba79d72d374572a04161d5f47be6485353fd78a4c04cc4f3a7bdcc9e3ae749419cc35bc3f6a13",
        "deposit_data_root": "0x8d0b864a077b06044d2336264aaf8efbd03dd61ab0a8074bfb811b7f5c10146e",
        "deposit_message_root": "0x5163474c33dcf5b6fb0bafcaa6a1edbe264de7c9eca6dc5358bee6c21bfc2fef",
        "fork_version": "0x01017000",
        "amount": 32000000000,
        "deposit_cli_version": "2.7.0"
      },
      "status_estimates": {
        "estimated_active_at": "2023-10-18T16:21:20Z",
        "estimated_exit_at": null,
        "estimated_withdrawal_at": null
      },
      "on_demand_exit": {
        "requested_at": null,
        "approved_at": null,
        "submitted_at": null,
        "request_id": null
      },
      "exit_message": {
        "encrypted_value": null,
        "fork_version": null
      },
      "balances": {
        "actual": "0.0",
        "pending_deposit": "32.0",
        "pending_topups": "0.0",
        "pending_withdrawals": "0.0"
      }
    }
  ],
  "meta": {
    "pagination": {
      "current_page": 1,
      "total_pages": 20,
      "total_item_count": 100
    }
  }
}
```