get:
  operationId: getBlobs
  summary: Get blobs
  description: |
    Retrieves blobs for a given block id.
    Depending on `Accept` header it can be returned either as json or as bytes serialized by SSZ.

    If the `versioned_hashes` parameter is specified, only the blobs for the specified versioned hashes will be returned. Blobs are 
    returned as an ordered list matching the order of their corresponding KZG commitments in the block.

    After the Fulu fork, only supernodes (which custody all data columns) are required to return blobs. Clients may implement
    blob reconstruction logic for non-super nodes.
  tags:
    - Beacon
  parameters:
    - name: block_id
      in: path
      required: true
      $ref: "../../../beacon-node-oapi.yaml#/components/parameters/BlockId"
    - name: versioned_hashes
      in: query
      description: Array of versioned hashes for blobs to request for in the specified block. Returns all blobs in the block if not specified.
      required: false
      schema:
        type: array
        uniqueItems: true
        items:
          $ref: "../../../beacon-node-oapi.yaml#/components/schemas/VersionedHash"
  responses:
    "200":
      description: "Successful response"
      content:
        application/json:
          schema:
            title: GetBlobsResponse
            type: object
            required: [execution_optimistic, finalized, data]
            properties:
              execution_optimistic:
                $ref: "../../../beacon-node-oapi.yaml#/components/schemas/ExecutionOptimistic"
              finalized:
                $ref: "../../../beacon-node-oapi.yaml#/components/schemas/Finalized"
              data:
                $ref: "../../../beacon-node-oapi.yaml#/components/schemas/Blobs"
        application/octet-stream:
          schema:
            description: "SSZ serialized `List[Blob, MAX_BLOB_COMMITMENTS_PER_BLOCK]` bytes. Use Accept header to choose this response type"
    "400":
      description: "The block ID supplied could not be parsed"
      content:
        application/json:
          schema:
            $ref: "../../../beacon-node-oapi.yaml#/components/schemas/ErrorMessage"
          example:
            code: 400
            message: "Invalid block ID: current"
    "404":
      description: "Block not found"
      content:
        application/json:
          schema:
            $ref: "../../../beacon-node-oapi.yaml#/components/schemas/ErrorMessage"
          example:
            code: 404
            message: "Block not found"
    "406":
      $ref: "../../../beacon-node-oapi.yaml#/components/responses/NotAcceptable"
    "500":
      $ref: "../../../beacon-node-oapi.yaml#/components/responses/InternalError"