{"uid":"cap_lW5ZP2YjgZOw6Vl1BAKSC","slug":"blockscout-block-withdrawals-api-236199da","name":"Blockscout Block Withdrawals API","description":"Explore crypto activities with Blockscout's multichain search. Find transactions, addresses, tokens, and dapps across top blockchain networks — your go-to explorer for cross-chain blockchain data","url":"https://api.blockscout.com/%7Bchain_id%7D/api/v2/blocks/%7Bblock_hash_or_number_param%7D/withdrawals","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"pathParams":{"type":"object","properties":{"chain_id":{"type":"string"},"block_hash_or_number_param":{"type":"string"}}},"queryParams":{"type":"object","properties":{"index":{"type":"integer"},"items_count":{"type":"integer"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"items":[{"index":0,"amount":"string","receiver":{"hash":"string","name":"string","is_scam":true,"metadata":{},"proxy_type":"string","reputation":"string","is_contract":true,"is_verified":true,"public_tags":[{"label":"string","address_hash":"string","display_name":"string"}],"private_tags":[{"label":"string","address_hash":"string","display_name":"string"}],"ens_domain_name":"string","implementations":[{"name":"string","address_hash":"string"}],"watchlist_names":[{"label":"string","display_name":"string"}]},"timestamp":"string","block_number":0,"validator_index":0}],"next_page_params":{}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_EWKUU_yCMcU2-NcXK6lF2","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves a paginated list of beacon chain withdrawals for a specific block on a given blockchain network","exampleAgentPrompt":"Can you pull up all the beacon chain withdrawals for block 19500000 on Ethereum using Blockscout's multichain explorer?","exampleUseCases":[{"title":"Track validator withdrawal payouts in a block","prompt":"Show me all the validator withdrawals that happened in Ethereum block 19500000 — I want to see the receiver addresses, amounts, and validator indices."},{"title":"Audit beacon chain withdrawals for a known block hash","prompt":"I have a block hash 0xabc123... on Ethereum mainnet — can you fetch all the withdrawal events from that block using Blockscout so I can see who received ETH and how much?"},{"title":"Monitor large withdrawals across a block","prompt":"For chain ID 1 and block number 20000000, get me the full list of beacon chain withdrawals — I need the amounts, timestamps, and receiver details to check for unusually large payouts."}],"resultDescription":"Returns a paginated list of beacon chain withdrawal objects, each containing the withdrawal index, amount, receiver address details (including hash, name, scam flag, contract status, ENS domain, proxy type, public/private tags), block number, validator index, and timestamp. Also returns next_page_params for pagination.","failureModes":["Invalid chain_id returns 404 or empty response","Non-existent block hash or number returns 404","Block with no withdrawals returns empty items array","Invalid pagination parameters may cause unexpected truncation","Rate limiting or payment failure returns 402 or 429","Unsupported chain_id may return an error or unsupported response"],"whenToPreferThis":"Use this endpoint when you need structured, paginated withdrawal data for a specific block on a supported blockchain network via Blockscout. Prefer this over generic RPC calls when you need enriched receiver metadata (ENS names, scam flags, tags, contract status) alongside withdrawal amounts. Ideal for analytics, auditing, or monitoring beacon chain staking withdrawals block by block.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-10T00:54:44.067Z","isFirstParty":false}