1  get:
 2    operationId: getBlockHeader
 3    summary: Get block header
 4    description: Retrieves block header for given block id.
 5    tags:
 6      - Beacon
 7    parameters:
 8      - name: block_id
 9        in: path
10        $ref: '../../../beacon-node-oapi.yaml#/components/parameters/BlockId'
11    responses:
12      "200":
13        description: Success
14        content:
15          application/json:
16            schema:
17              title: GetBlockHeaderResponse
18              type: object
19              properties:
20                data:
21                  type: object
22                  properties:
23                    root:
24                      $ref: "../../../beacon-node-oapi.yaml#/components/schemas/Root"
25                    canonical:
26                      type: boolean
27                    header:
28                      $ref: "../../../beacon-node-oapi.yaml#/components/schemas/SignedBeaconBlockHeader"
29      "400":
30        description: "The block ID supplied could not be parsed"
31        content:
32          application/json:
33            schema:
34              allOf:
35                - $ref: "../../../beacon-node-oapi.yaml#/components/schemas/ErrorMessage"
36                - example:
37                    code: 400
38                    message: "Invalid block ID: current"
39      "404":
40        description: "Block not found"
41        content:
42          application/json:
43            schema:
44              allOf:
45                - $ref: "../../../beacon-node-oapi.yaml#/components/schemas/ErrorMessage"
46                - example:
47                    code: 404
48                    message: "Block not found"
49      "500":
50        $ref: "../../../beacon-node-oapi.yaml#/components/responses/InternalError"