Skip to main content
POST
Withdrawals

Authorizations

Authorization
string
header
required

Authorization header with value: Bearer YOUR_TOKEN. Refer to the API Keys section to create your API key.

Body

application/json

validator and type_filter are optional in this request body

slot
Number · object
required

Specify a slot using one of the following methods.

  • Slot number
  • Consensus layer block root
  • View: "latest", "finalized"
chain
enum<string>
default:mainnet
required

The Ethereum chain to query.

Available options:
mainnet,
hoodi
cursor
string
default:""

Cursor value for pagination. See our pagination guide for more details.

page_size
integer
default:10

The number of items to return per page.

Required range: 1 <= x <= 10
validator
Indices/Pubkeys · object

validator is optional in this request body. If not provided, results will be unfiltered.

type_filter
enum<string>[] | null

Filter results by withdrawal type. Pass one or more types as an array to include withdrawals of any of the selected types; omit the field (or pass an empty array) to return all types.

The type of withdrawal:

  • manual: A voluntary withdrawal request submitted by the validator operator on the execution layer.
  • partial_sweep: An automatic partial withdrawal sweep performed by the protocol, withdrawing the balance above 32 ETH (or 2048 ETH for compounding validators) to the withdrawal address.
  • full_exit_sweep: An automatic full withdrawal sweep performed by the protocol after the validator has fully exited, withdrawing the entire balance to the withdrawal address.
  • system: A protocol-internal balance movement that is re-queued as a pending deposit rather than paid out to a withdrawal address. Occurs when a validator switches to compounding withdrawal credentials (balance above 32 ETH is removed and re-queued), and as a one-time event at the Electra fork, when validators still awaiting activation had their pending balance re-queued through the new activation queue.
Available options:
manual,
partial_sweep,
full_exit_sweep,
system

Response

Successful response.

Response containing detailed information about past or future withdrawal duties.

data
object[]
required
paging
object