> ## Documentation Index
> Fetch the complete documentation index at: https://docs.validationcloud.io/llms.txt
> Use this file to discover all available pages before exploring further.

# platform.getPendingValidators

List the validators in the pending validator set of the specified Subnet. Each validator is not currently validating the Subnet but will in the future.

This method will use `10` [Compute Units](/nodeapi/about/billing).

***

## Reference: [Here](https://build.avax.network/docs/rpcs/p-chain)

## **Parameters**

* `nodeIDs` - \[]string - (optional) a list of the nodeIDs of pending validators to request. If omitted, all pending validators are returned. If a specified nodeID is not in the set of pending validators, it will not be included in the response.
* `subnetID` (optional) The subnet whose current validators are returned. If omitted, returns the current validators of the Primary Network.

## Returns

* `delegators` - object
  * `txID` - string - the validator transaction.
  * `startTime` - string - the Unix time when the validator starts.
  * `endTime` - string - the Unix time when the validator stops.
  * `stakeAmount` - string - (optional) the amount of nAVAX this validator staked. Omitted if subnetID is not the Primary Network.
  * `nodeID` - string - (optional) the validating node’s node ID.
* validators - object
  * weight - string - (optional) the validator’s weight when sampling validators. Omitted if subnetID is the Primary Network.
  * connected - bool - (optional) if the node is connected.
  * nodeID - string - (optional) the validator’s node ID.
  * stakeAmount - string - (optional) the amount of nAVAX this validator staked. Omitted if subnetID is not the Primary Network.
  * endTime - string - the Unix time when the validator stops validating the Subnet.
  * startTime - string - the Unix time when the validator starts validating the Subnet.
  * txID - string - the validator transaction.

```json theme={"theme":{"light":"github-light","dark":"github-dark-default"}}
// Result
{
  "jsonrpc": "2.0",
  "result": {
    "validators": [
      {
        "txID": "2NNkpYTGfTFLSGXJcHtVv6drwVU2cczhmjK2uhvwDyxwsjzZMm",
        "startTime": "1600368632",
        "endTime": "1602960455",
        "stakeAmount": "200000000000",
        "nodeID": "NodeID-5mb46qkSBj81k9g9e4VFjGGSbaaSLFRzD",
        "delegationFee": "10.0000",
        "connected": false
      }
    ],
    "delegators": [
      {
        "txID": "Bbai8nzGVcyn2VmeYcbS74zfjJLjDacGNVuzuvAQkHn1uWfoV",
        "startTime": "1600368523",
        "endTime": "1602960342",
        "stakeAmount": "20000000000",
        "nodeID": "NodeID-7Xhw2mDxuDS44j42TCB6U5579esbSt3Lg"
      }
    ]
  },
  "id": 1
}
```

<CodeGroup>
  ```bash title="mainnet" theme={"theme":{"light":"github-light","dark":"github-dark-default"}}
  curl https://mainnet.avalanche.validationcloud.io/v1/<YOUR_API_KEY_HERE>/ext/bc/P \
      -X POST \
      -H "Content-Type: application/json" \
      -d '{
      "jsonrpc": "2.0",
      "method": "platform.getPendingValidators",
      "params": {},
      "id": 1
  }'
  ```

  ```bash title="testnet" theme={"theme":{"light":"github-light","dark":"github-dark-default"}}
  curl https://fuji.avalanche.validationcloud.io/v1/<YOUR_API_KEY_HERE>/ext/bc/P \
      -X POST \
      -H "Content-Type: application/json" \
      -d '{
      "jsonrpc": "2.0",
      "method": "platform.getPendingValidators",
      "params": {},
      "id": 1
  }'
  ```
</CodeGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.