Electra Fork Requirement

This endpoint requires a state from the Electra fork or later (slot >= 11649024). The pending_partial_withdrawals field does not exist in pre-Electra state schemas (Phase0, Altair, Bellatrix, Capella, Deneb). Querying a state prior to Electra will return a 400 error.

Path Parameters

state_id

string

REQUIRED

The state identifier. It can be one of: head (canonical head in node's view), genesis, finalized, justified, slot, or stateRoot (hex encoded stateRoot with 0x prefix)

Returns

version

string

(Optional) The specification version of the Beacon API response (e.g., electra)

execution_optimistic

boolean

True if the response references an unverified execution payload. The optimistic information may be invalidated at a later time. If the field is not present, assume the false value

finalized

boolean

Indicates whether the response data is finalized

data

array

List of pending partial withdrawal entries for the given state

validator_index

string

The index of the validator requesting the partial withdrawal

amount

string

The withdrawal amount (in Gwei)

withdrawable_epoch

string

The epoch at which the partial withdrawal becomes withdrawable

Request

1
curl -X GET "https://docs-demo.quiknode.pro/eth/v1/beacon/states/head/pending_partial_withdrawals" \
2
  -H "Content-Type: application/json" \
3
  -H "Accept: application/json"

1
curl -X GET "https://docs-demo.quiknode.pro/eth/v1/beacon/states/head/pending_partial_withdrawals" \
2
  -H "Content-Type: application/json" \
3
  -H "Accept: application/json"

1
async function main() {
2
    const response = await fetch('https://docs-demo.quiknode.pro/eth/v1/beacon/states/head/pending_partial_withdrawals', {
3
        method: 'GET',
4
        headers: {'Content-Type': 'application/json', 'Accept': 'application/json'}
5
    })
6
    const data = await response.json()
7
    console.log(data)
8
}
9

10
main()

1
async function main() {
2
    const response = await fetch('https://docs-demo.quiknode.pro/eth/v1/beacon/states/head/pending_partial_withdrawals', {
3
        method: 'GET',
4
        headers: {'Content-Type': 'application/json', 'Accept': 'application/json'}
5
    })
6
    const data = await response.json()
7
    console.log(data)
8
}
9

10
main()

1
import requests
2
import json
3

4
url = "https://docs-demo.quiknode.pro/eth/v1/beacon/states/head/pending_partial_withdrawals"
5

6
headers = {
7
  'Content-Type': 'application/json',
8
  'Accept': 'application/json'
9
}
10

11
response = requests.request("GET", url, headers=headers)
12

13
print(response.text)

1
import requests
2
import json
3

4
url = "https://docs-demo.quiknode.pro/eth/v1/beacon/states/head/pending_partial_withdrawals"
5

6
headers = {
7
  'Content-Type': 'application/json',
8
  'Accept': 'application/json'
9
}
10

11
response = requests.request("GET", url, headers=headers)
12

13
print(response.text)

1
require "uri"
2
require "json"
3
require "net/http"
4

5
uri = URI("https://docs-demo.quiknode.pro/eth/v1/beacon/states/head/pending_partial_withdrawals")
6

7
request = Net::HTTP::Get.new(uri)
8
request["Content-Type"] = "application/json"
9
request["Accept"] = "application/json"
10

11
response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
12
  http.request(request)
13
end
14

15
puts response.body

1
require "uri"
2
require "json"
3
require "net/http"
4

5
uri = URI("https://docs-demo.quiknode.pro/eth/v1/beacon/states/head/pending_partial_withdrawals")
6

7
request = Net::HTTP::Get.new(uri)
8
request["Content-Type"] = "application/json"
9
request["Accept"] = "application/json"
10

11
response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
12
  http.request(request)
13
end
14

15
puts response.body

Response

1
{
2
  "execution_optimistic": false,
3
  "finalized": false,
4
  "data": [
5
    {
6
      "validator_index": "1084521",
7
      "amount": "1000000000",
8
      "withdrawable_epoch": "350375"
9
    }
10
  ]
11
}

1
{
2
  "execution_optimistic": false,
3
  "finalized": false,
4
  "data": [
5
    {
6
      "validator_index": "1084521",
7
      "amount": "1000000000",
8
      "withdrawable_epoch": "350375"
9
    }
10
  ]
11
}

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free