> ## 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.
# /eth/v2/beacon/blocks/{block_id}
> Get block attestations
```bash title="Mainnet" theme={"theme":{"light":"github-light","dark":"github-dark-default"}}
curl -X GET \
"https://mainnet.ethereum.validationcloud.io/v1//eth/v2/beacon/blocks/head" \
-H "Content-Type: application/json"
```
```bash title="Testnet" theme={"theme":{"light":"github-light","dark":"github-dark-default"}}
curl -X GET \
"https://sepolia.ethereum.validationcloud.io/v1//eth/v2/beacon/blocks/head" \
-H "Content-Type: application/json"
```
## OpenAPI
````yaml nodeapi/openapi/beacon-node-oapi-v2.json GET /eth/v1/beacon/blocks/{block_id}
openapi: 3.0.3
info:
title: Eth Beacon Node API
description: >
API specification for the beacon node, which enables users to query and
participate in Ethereum 2.0 phase 0 beacon chain.
All requests by default send and receive JSON, and as such should have
either or both of the "Content-Type: application/json"
and "Accept: application/json" headers. In addition, some requests can
return data in the SSZ format. To indicate that SSZ
data is required in response to a request the header "Accept:
application/octet-stream" should be sent. Note that only a subset
of requests can respond with data in SSZ format; these are noted in each
individual request.
API endpoints are individually versioned. As such, there is no direct
relationship between all v1 endpoints, all v2 endpoints,
_etc._ and no such relationship should be inferred. All JSON responses
return the requested data under a `data` key in the top
level of their response. Additional metadata may or may not be present in
other keys at the top level of the response, dependent
on the endpoint. The rules that require an increase in version number are
as follows:
- no field that is listed in an endpoint shall be removed without an increase in the version number
- no field that is listed in an endpoint shall be altered in terms of format (_e.g._ from a string to an array) without an
increase in the version number
Note that it is possible for a field to be added to an endpoint's data or
metadata without an increase in the version number.
version: v2.3.0 - Eth2Spec v1.1.0
contact:
name: Ethereum Github
url: https://github.com/ethereum/beacon-apis/issues
license:
name: CC0-1.0
url: https://creativecommons.org/publicdomain/zero/1.0/
servers:
- url: https://mainnet.ethereum.validationcloud.io/v1//
description: Mainnet Beacon API
- url: https://sepolia.ethereum.validationcloud.io/v1//
description: Sepolia Beacon API
security: []
tags:
- name: Beacon
description: Set of endpoints to query beacon chain.
- name: Config
description: Endpoints to query chain configuration, specification, and fork schedules.
- name: Debug
description: Set of endpoints to debug chain and shouldn't be exposed publicly.
- name: Events
description: Set of endpoints to for event subscription.
- name: Node
description: Endpoints to query node related informations
- name: Validator
description: Endpoints intended for validator clients
- name: ValidatorRequiredApi
description: >
Minimal set of endpoints to enable a working validator implementation.
[Checkout validator
flow](https://github.com/ethereum/beacon-APIs/blob/master/validator-flow.md)
to learn how to use this api.
paths:
/eth/v1/beacon/blocks/{block_id}:
get:
tags:
- Beacon
summary: Get block
description: >
Returns the complete `SignedBeaconBlock` for a given block ID.
Depending on the `Accept` header it can be returned either as JSON or
SSZ-serialized bytes.
operationId: getBlock
parameters:
- required: true
name: block_id
in: path
example: head
schema:
type: string
description: >
Block identifier.
Can be one of: "head" (canonical head in node's view), "genesis",
"finalized", \, \.
responses:
'200':
description: Success
content:
application/json:
schema:
title: GetBlockResponse
type: object
properties:
data:
type: object
description: >-
The
[`SignedBeaconBlock`](https://github.com/ethereum/consensus-specs/blob/v1.0.1/specs/phase0/beacon-chain.md#signedbeaconblock)
object envelope from the CL spec.
properties:
message:
description: >-
The
[`BeaconBlock`](https://github.com/ethereum/consensus-specs/blob/v1.0.1/specs/phase0/beacon-chain.md#beaconblock)
object from the CL spec.
allOf:
- type: object
properties:
slot:
allOf:
- type: string
example: '1'
- description: The slot to which this block corresponds.
proposer_index:
allOf:
- type: string
example: '1'
- description: Index of validator in validator registry.
parent_root:
allOf:
- type: string
example: >-
0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2
pattern: ^0x[a-fA-F0-9]{64}$
- description: >-
The signing merkle root of the parent
`BeaconBlock`.
state_root:
allOf:
- type: string
example: >-
0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2
pattern: ^0x[a-fA-F0-9]{64}$
- description: >-
The tree hash merkle root of the
`BeaconState` for the `BeaconBlock`.
- type: object
properties:
body:
type: object
description: >-
The
[`BeaconBlockBody`](https://github.com/ethereum/consensus-specs/blob/v1.0.1/specs/phase0/beacon-chain.md#beaconblockbody)
object from the CL spec.
properties:
randao_reveal:
allOf:
- type: string
pattern: ^0x[a-fA-F0-9]{192}$
example: >-
0x1b66ac1fb663c9bc59509846d6ec05345bd908eda73e670af888da41af171505cc411d61252fb6cb3fa0017b679f8bb2305b26a285fa2737f175668d0dff91cc1b66ac1fb663c9bc59509846d6ec05345bd908eda73e670af888da41af171505
- description: >-
The RanDAO reveal value provided by the
validator.
eth1_data:
type: object
description: >-
The
[`Eth1Data`](https://github.com/ethereum/consensus-specs/blob/v1.0.1/specs/phase0/beacon-chain.md#eth1data)
object from the CL spec.
properties:
deposit_root:
allOf:
- type: string
example: >-
0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2
pattern: ^0x[a-fA-F0-9]{64}$
- description: Root of the deposit tree.
deposit_count:
allOf:
- type: string
example: '1'
- description: Total number of deposits.
block_hash:
allOf:
- type: string
example: >-
0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2
pattern: ^0x[a-fA-F0-9]{64}$
- description: Ethereum 1.x block hash.
graffiti:
type: string
pattern: ^0x[a-fA-F0-9]{64}$
proposer_slashings:
type: array
items:
type: object
description: >-
The
[`ProposerSlashing`](https://github.com/ethereum/consensus-specs/blob/v1.0.1/specs/phase0/beacon-chain.md#proposerslashing)
object from the CL spec.
properties:
signed_header_1:
type: object
description: >-
The
[`SignedBeaconBlockHeader`](https://github.com/ethereum/consensus-specs/blob/v1.0.1/specs/phase0/beacon-chain.md#signedbeaconblockheader)
object envelope from the CL spec.
properties:
message:
description: >-
The
[`BeaconBlockHeader`](https://github.com/ethereum/consensus-specs/blob/v1.0.1/specs/phase0/beacon-chain.md#beaconblockheader)
object from the CL spec.
allOf:
- type: object
properties:
slot:
allOf:
- type: string
example: '1'
- description: >-
The slot to which this block
corresponds.
proposer_index:
allOf:
- type: string
example: '1'
- description: >-
Index of validator in validator
registry.
parent_root:
allOf:
- type: string
example: >-
0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2
pattern: ^0x[a-fA-F0-9]{64}$
- description: >-
The signing merkle root of the parent
`BeaconBlock`.
state_root:
allOf:
- type: string
example: >-
0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2
pattern: ^0x[a-fA-F0-9]{64}$
- description: >-
The tree hash merkle root of the
`BeaconState` for the `BeaconBlock`.
- type: object
properties:
body_root:
allOf:
- type: string
example: >-
0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2
pattern: ^0x[a-fA-F0-9]{64}$
- description: >-
The tree hash merkle root of the
`BeaconBlockBody` for the `BeaconBlock`
signature:
type: string
pattern: ^0x[a-fA-F0-9]{192}$
example: >-
0x1b66ac1fb663c9bc59509846d6ec05345bd908eda73e670af888da41af171505cc411d61252fb6cb3fa0017b679f8bb2305b26a285fa2737f175668d0dff91cc1b66ac1fb663c9bc59509846d6ec05345bd908eda73e670af888da41af171505
signed_header_2:
type: object
description: >-
The
[`SignedBeaconBlockHeader`](https://github.com/ethereum/consensus-specs/blob/v1.0.1/specs/phase0/beacon-chain.md#signedbeaconblockheader)
object envelope from the CL spec.
properties:
message:
description: >-
The
[`BeaconBlockHeader`](https://github.com/ethereum/consensus-specs/blob/v1.0.1/specs/phase0/beacon-chain.md#beaconblockheader)
object from the CL spec.
allOf:
- type: object
properties:
slot:
allOf:
- type: string
example: '1'
- description: >-
The slot to which this block
corresponds.
proposer_index:
allOf:
- type: string
example: '1'
- description: >-
Index of validator in validator
registry.
parent_root:
allOf:
- type: string
example: >-
0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2
pattern: ^0x[a-fA-F0-9]{64}$
- description: >-
The signing merkle root of the parent
`BeaconBlock`.
state_root:
allOf:
- type: string
example: >-
0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2
pattern: ^0x[a-fA-F0-9]{64}$
- description: >-
The tree hash merkle root of the
`BeaconState` for the `BeaconBlock`.
- type: object
properties:
body_root:
allOf:
- type: string
example: >-
0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2
pattern: ^0x[a-fA-F0-9]{64}$
- description: >-
The tree hash merkle root of the
`BeaconBlockBody` for the `BeaconBlock`
signature:
type: string
pattern: ^0x[a-fA-F0-9]{192}$
example: >-
0x1b66ac1fb663c9bc59509846d6ec05345bd908eda73e670af888da41af171505cc411d61252fb6cb3fa0017b679f8bb2305b26a285fa2737f175668d0dff91cc1b66ac1fb663c9bc59509846d6ec05345bd908eda73e670af888da41af171505
attester_slashings:
type: array
items:
type: object
description: >-
The
[`AttesterSlashing`](https://github.com/ethereum/consensus-specs/blob/v1.0.1/specs/core/0_beacon-chain.md#attesterslashing)
object from the CL spec.
properties:
attestation_1:
type: object
description: >-
The
[`IndexedAttestation`](https://github.com/ethereum/consensus-specs/blob/v1.0.1/specs/phase0/beacon-chain.md#indexedattestation)
object from the CL spec.
properties:
attesting_indices:
type: array
maxItems: 2048
description: Attesting validator indices
items:
type: string
example: '1'
signature:
allOf:
- type: string
pattern: ^0x[a-fA-F0-9]{192}$
example: >-
0x1b66ac1fb663c9bc59509846d6ec05345bd908eda73e670af888da41af171505cc411d61252fb6cb3fa0017b679f8bb2305b26a285fa2737f175668d0dff91cc1b66ac1fb663c9bc59509846d6ec05345bd908eda73e670af888da41af171505
- description: >-
The BLS signature of the
`IndexedAttestation`, created by the
validator of the attestation.
data:
type: object
description: >-
The
[`AttestationData`](https://github.com/ethereum/consensus-specs/blob/v1.0.1/specs/phase0/beacon-chain.md#attestationdata)
object from the CL spec.
properties:
slot:
type: string
example: '1'
index:
type: string
example: '1'
beacon_block_root:
allOf:
- type: string
example: >-
0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2
pattern: ^0x[a-fA-F0-9]{64}$
- description: LMD GHOST vote.
source:
type: object
description: >-
The
[`Checkpoint`](https://github.com/ethereum/consensus-specs/blob/v1.0.1/specs/phase0/beacon-chain.md#checkpoint
properties:
epoch:
type: string
example: '1'
root:
type: string
example: >-
0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2
pattern: ^0x[a-fA-F0-9]{64}$
target:
type: object
description: >-
The
[`Checkpoint`](https://github.com/ethereum/consensus-specs/blob/v1.0.1/specs/phase0/beacon-chain.md#checkpoint
properties:
epoch:
type: string
example: '1'
root:
type: string
example: >-
0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2
pattern: ^0x[a-fA-F0-9]{64}$
attestation_2:
type: object
description: >-
The
[`IndexedAttestation`](https://github.com/ethereum/consensus-specs/blob/v1.0.1/specs/phase0/beacon-chain.md#indexedattestation)
object from the CL spec.
properties:
attesting_indices:
type: array
maxItems: 2048
description: Attesting validator indices
items:
type: string
example: '1'
signature:
allOf:
- type: string
pattern: ^0x[a-fA-F0-9]{192}$
example: >-
0x1b66ac1fb663c9bc59509846d6ec05345bd908eda73e670af888da41af171505cc411d61252fb6cb3fa0017b679f8bb2305b26a285fa2737f175668d0dff91cc1b66ac1fb663c9bc59509846d6ec05345bd908eda73e670af888da41af171505
- description: >-
The BLS signature of the
`IndexedAttestation`, created by the
validator of the attestation.
data:
type: object
description: >-
The
[`AttestationData`](https://github.com/ethereum/consensus-specs/blob/v1.0.1/specs/phase0/beacon-chain.md#attestationdata)
object from the CL spec.
properties:
slot:
type: string
example: '1'
index:
type: string
example: '1'
beacon_block_root:
allOf:
- type: string
example: >-
0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2
pattern: ^0x[a-fA-F0-9]{64}$
- description: LMD GHOST vote.
source:
type: object
description: >-
The
[`Checkpoint`](https://github.com/ethereum/consensus-specs/blob/v1.0.1/specs/phase0/beacon-chain.md#checkpoint
properties:
epoch:
type: string
example: '1'
root:
type: string
example: >-
0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2
pattern: ^0x[a-fA-F0-9]{64}$
target:
type: object
description: >-
The
[`Checkpoint`](https://github.com/ethereum/consensus-specs/blob/v1.0.1/specs/phase0/beacon-chain.md#checkpoint
properties:
epoch:
type: string
example: '1'
root:
type: string
example: >-
0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2
pattern: ^0x[a-fA-F0-9]{64}$
attestations:
type: array
items:
type: object
description: >-
The
[`Attestation`](https://github.com/ethereum/consensus-specs/blob/v1.0.1/specs/phase0/beacon-chain.md#attestation)
object from the CL spec.
properties:
aggregation_bits:
type: string
example: '0x01'
pattern: ^0x[a-fA-F0-9]+$
description: Attester aggregation bits.
signature:
allOf:
- type: string
pattern: ^0x[a-fA-F0-9]{192}$
example: >-
0x1b66ac1fb663c9bc59509846d6ec05345bd908eda73e670af888da41af171505cc411d61252fb6cb3fa0017b679f8bb2305b26a285fa2737f175668d0dff91cc1b66ac1fb663c9bc59509846d6ec05345bd908eda73e670af888da41af171505
- description: BLS aggregate signature.
data:
type: object
description: >-
The
[`AttestationData`](https://github.com/ethereum/consensus-specs/blob/v1.0.1/specs/phase0/beacon-chain.md#attestationdata)
object from the CL spec.
properties:
slot:
type: string
example: '1'
index:
type: string
example: '1'
beacon_block_root:
allOf:
- type: string
example: >-
0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2
pattern: ^0x[a-fA-F0-9]{64}$
- description: LMD GHOST vote.
source:
type: object
description: >-
The
[`Checkpoint`](https://github.com/ethereum/consensus-specs/blob/v1.0.1/specs/phase0/beacon-chain.md#checkpoint
properties:
epoch:
type: string
example: '1'
root:
type: string
example: >-
0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2
pattern: ^0x[a-fA-F0-9]{64}$
target:
type: object
description: >-
The
[`Checkpoint`](https://github.com/ethereum/consensus-specs/blob/v1.0.1/specs/phase0/beacon-chain.md#checkpoint
properties:
epoch:
type: string
example: '1'
root:
type: string
example: >-
0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2
pattern: ^0x[a-fA-F0-9]{64}$
deposits:
type: array
items:
type: object
description: >-
The
[`Deposit`](https://github.com/ethereum/consensus-specs/blob/v1.0.1/specs/phase0/beacon-chain.md#deposit)
object from the CL spec.
properties:
proof:
type: array
description: Branch in the deposit tree.
items:
allOf:
- type: string
example: >-
0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2
pattern: ^0x[a-fA-F0-9]{64}$
minItems: 32
maxItems: 32
data:
type: object
description: >-
The
[`DepositData`](https://github.com/ethereum/consensus-specs/blob/v1.0.1/specs/phase0/beacon-chain.md#depositdata)
object from the CL spec.
properties:
pubkey:
type: string
pattern: ^0x[a-fA-F0-9]{96}$
description: >-
The validator's BLS public key, uniquely
identifying them. _48-bytes, hex encoded
with 0x prefix, case insensitive._
example: >-
0x93247f2209abcacf57b75a51dafae777f9dd38bc7053d1af526f220a7489a6d3a2753e5f3e8b1cfe39b56f43611df74a
withdrawal_credentials:
allOf:
- type: string
example: >-
0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2
pattern: ^0x[a-fA-F0-9]{64}$
- description: The withdrawal credentials.
amount:
allOf:
- type: string
example: '1'
- description: Amount in Gwei.
signature:
allOf:
- type: string
pattern: ^0x[a-fA-F0-9]{192}$
example: >-
0x1b66ac1fb663c9bc59509846d6ec05345bd908eda73e670af888da41af171505cc411d61252fb6cb3fa0017b679f8bb2305b26a285fa2737f175668d0dff91cc1b66ac1fb663c9bc59509846d6ec05345bd908eda73e670af888da41af171505
- description: Container self-signature.
voluntary_exits:
type: array
items:
type: object
description: >-
The
[`SignedVoluntaryExit`](https://github.com/ethereum/consensus-specs/blob/v1.0.1/specs/phase0/beacon-chain.md#signedvoluntaryexit)
object from the CL spec.
properties:
message:
type: object
description: >-
The
[`VoluntaryExit`](https://github.com/ethereum/consensus-specs/blob/v1.0.1/specs/phase0/beacon-chain.md#voluntaryexit)
object from the CL spec.
properties:
epoch:
allOf:
- type: string
example: '1'
- description: Minimum epoch for processing exit.
validator_index:
allOf:
- type: string
example: '1'
- description: Index of the exiting validator.
signature:
type: string
pattern: ^0x[a-fA-F0-9]{192}$
example: >-
0x1b66ac1fb663c9bc59509846d6ec05345bd908eda73e670af888da41af171505cc411d61252fb6cb3fa0017b679f8bb2305b26a285fa2737f175668d0dff91cc1b66ac1fb663c9bc59509846d6ec05345bd908eda73e670af888da41af171505
signature:
type: string
pattern: ^0x[a-fA-F0-9]{192}$
example: >-
0x1b66ac1fb663c9bc59509846d6ec05345bd908eda73e670af888da41af171505cc411d61252fb6cb3fa0017b679f8bb2305b26a285fa2737f175668d0dff91cc1b66ac1fb663c9bc59509846d6ec05345bd908eda73e670af888da41af171505
application/octet-stream:
schema:
description: >-
SSZ serialized block bytes. Use Accept header to choose this
response type
'400':
description: The block ID supplied could not be parsed
content:
application/json:
schema:
allOf:
- type: object
properties:
code:
description: >-
Either specific error code in case of invalid request
or http status code
type: number
example: 404
message:
description: Message describing error
type: string
stacktraces:
description: Optional stacktraces, sent when node is in debug mode
type: array
items:
type: string
- example:
code: 400
message: 'Invalid block ID: current'
'404':
description: Block not found
content:
application/json:
schema:
allOf:
- type: object
properties:
code:
description: >-
Either specific error code in case of invalid request
or http status code
type: number
example: 404
message:
description: Message describing error
type: string
stacktraces:
description: Optional stacktraces, sent when node is in debug mode
type: array
items:
type: string
- example:
code: 404
message: Block not found
'500':
description: Beacon node internal error.
content:
application/json:
schema:
type: object
properties:
code:
description: >-
Either specific error code in case of invalid request or
http status code
type: number
example: 404
message:
description: Message describing error
type: string
stacktraces:
description: Optional stacktraces, sent when node is in debug mode
type: array
items:
type: string
example:
code: 500
message: Internal server error
deprecated: true
````
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.