> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blockscout.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List L2 blocks in a Scroll batch

> Retrieves L2 blocks that are bound to a specific Scroll batch number.



## OpenAPI

````yaml /openapi-specs/pro-api-v11.yaml get /v2/blocks/scroll-batch/{batch_number_param}
openapi: 3.0.0
info:
  contact:
    email: info@blockscout.com
  title: Blockscout
  version: 11.0.3
servers:
  - url: http://localhost/api
    variables: {}
security: []
tags:
  - name: blocks
  - name: transactions
  - name: addresses
  - name: internal-transactions
  - name: tokens
  - name: token-transfers
  - name: smart-contracts
  - name: config
  - name: main-page
  - name: search
  - name: stats
  - name: csv-export
  - name: account-abstraction
  - name: withdrawals
  - name: advanced-filters
  - name: arbitrum
  - name: legacy
  - name: optimism
  - name: mud
  - name: celo
  - name: scroll
  - name: zilliqa
paths:
  /v2/blocks/scroll-batch/{batch_number_param}:
    get:
      tags:
        - blocks
      summary: List L2 blocks in a Scroll batch
      description: Retrieves L2 blocks that are bound to a specific Scroll batch number.
      operationId: BlockScoutWeb.API.V2.BlockController.scroll_batch
      parameters:
        - description: API key for rate limiting or for sensitive endpoints
          in: query
          name: apikey
          required: false
          schema:
            type: string
            x-struct: null
            x-validate: null
        - description: Secret key for getting access to restricted resources
          in: query
          name: key
          required: false
          schema:
            type: string
            x-struct: null
            x-validate: null
        - description: Batch number
          in: path
          name: batch_number_param
          required: true
          schema:
            minimum: 0
            type: integer
            x-struct: null
            x-validate: null
        - description: Block number for paging
          in: query
          name: block_number
          required: false
          schema:
            minimum: 0
            type: integer
            x-struct: null
            x-validate: null
        - description: Number of items returned per page
          in: query
          name: items_count
          required: false
          schema:
            maximum: 50
            minimum: 1
            type: integer
            x-struct: null
            x-validate: null
      responses:
        '200':
          content:
            application/json:
              schema:
                additionalProperties: false
                nullable: false
                properties:
                  items:
                    items:
                      $ref: '#/components/schemas/Block'
                    nullable: false
                    type: array
                    x-struct: null
                    x-validate: null
                  next_page_params:
                    example:
                      block_number: 22566361
                      items_count: 50
                    nullable: true
                    type: object
                    x-struct: null
                    x-validate: null
                required:
                  - items
                  - next_page_params
                type: object
                x-struct: null
                x-validate: null
          description: L2 blocks in the specified Scroll batch.
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JsonErrorResponse'
          description: Unprocessable Entity
      callbacks: {}
components:
  schemas:
    Block:
      additionalProperties: false
      properties:
        arbitrum:
          additionalProperties: false
          nullable: false
          properties:
            batch_data_container:
              enum:
                - in_blob4844
                - in_calldata
                - in_celestia
                - in_anytrust
                - in_eigenda
              nullable: true
              type: string
              x-struct: null
              x-validate: null
            batch_number:
              nullable: true
              type: integer
              x-struct: null
              x-validate: null
            commitment_transaction:
              nullable: false
              properties:
                hash:
                  $ref: '#/components/schemas/FullHashNullable'
                status:
                  enum:
                    - unfinalized
                    - finalized
                  nullable: true
                  type: string
                  x-struct: null
                  x-validate: null
                timestamp:
                  $ref: '#/components/schemas/TimestampNullable'
              required:
                - hash
                - timestamp
                - status
              type: object
              x-struct: null
              x-validate: null
            confirmation_transaction:
              nullable: false
              properties:
                hash:
                  $ref: '#/components/schemas/FullHashNullable'
                status:
                  enum:
                    - unfinalized
                    - finalized
                  nullable: true
                  type: string
                  x-struct: null
                  x-validate: null
                timestamp:
                  $ref: '#/components/schemas/TimestampNullable'
              required:
                - hash
                - timestamp
                - status
              type: object
              x-struct: null
              x-validate: null
            delayed_messages:
              nullable: false
              type: integer
              x-struct: null
              x-validate: null
            l1_block_number:
              nullable: true
              type: integer
              x-struct: null
              x-validate: null
            send_count:
              nullable: true
              type: integer
              x-struct: null
              x-validate: null
            send_root:
              $ref: '#/components/schemas/FullHashNullable'
            status:
              enum:
                - Confirmed on base
                - Sent to base
                - Sealed on rollup
                - Processed on rollup
              nullable: false
              type: string
              x-struct: null
              x-validate: null
          required:
            - batch_number
            - status
            - commitment_transaction
            - confirmation_transaction
          type: object
          x-struct: null
          x-validate: null
        base_fee_per_gas:
          $ref: '#/components/schemas/IntegerStringNullable'
        burnt_fees:
          $ref: '#/components/schemas/IntegerStringNullable'
        burnt_fees_percentage:
          format: float
          nullable: true
          type: number
          x-struct: null
          x-validate: null
        difficulty:
          $ref: '#/components/schemas/IntegerStringNullable'
        gas_limit:
          $ref: '#/components/schemas/IntegerString'
        gas_target_percentage:
          format: float
          nullable: false
          type: number
          x-struct: null
          x-validate: null
        gas_used:
          $ref: '#/components/schemas/IntegerString'
        gas_used_percentage:
          format: float
          nullable: false
          type: number
          x-struct: null
          x-validate: null
        hash:
          $ref: '#/components/schemas/FullHash'
        height:
          minimum: 0
          nullable: false
          type: integer
          x-struct: null
          x-validate: null
        internal_transactions_count:
          nullable: true
          type: integer
          x-struct: null
          x-validate: null
        is_pending_update:
          nullable: false
          type: boolean
          x-struct: null
          x-validate: null
        miner:
          $ref: '#/components/schemas/Address'
        nonce:
          $ref: '#/components/schemas/HexStringNullable'
        parent_hash:
          $ref: '#/components/schemas/FullHash'
        priority_fee:
          $ref: '#/components/schemas/IntegerStringNullable'
        rewards:
          items:
            additionalProperties: false
            properties:
              address_hash:
                $ref: '#/components/schemas/AddressHash'
              reward:
                $ref: '#/components/schemas/IntegerString'
              type:
                nullable: false
                type: string
                x-struct: null
                x-validate: null
            required:
              - type
              - reward
            type: object
            x-struct: null
            x-validate: null
          nullable: false
          type: array
          x-struct: null
          x-validate: null
        size:
          nullable: false
          type: integer
          x-struct: null
          x-validate: null
        timestamp:
          $ref: '#/components/schemas/Timestamp'
        total_difficulty:
          $ref: '#/components/schemas/IntegerStringNullable'
        transaction_fees:
          $ref: '#/components/schemas/IntegerString'
        transactions_count:
          nullable: false
          type: integer
          x-struct: null
          x-validate: null
        type:
          enum:
            - block
            - uncle
            - reorg
          nullable: false
          type: string
          x-struct: null
          x-validate: null
        uncles_hashes:
          items:
            additionalProperties: false
            nullable: false
            properties:
              hash:
                $ref: '#/components/schemas/FullHash'
            required:
              - hash
            type: object
            x-struct: null
            x-validate: null
          nullable: false
          type: array
          x-struct: null
          x-validate: null
        withdrawals_count:
          minimum: 0
          nullable: true
          type: integer
          x-struct: null
          x-validate: null
      required:
        - height
        - timestamp
        - transactions_count
        - internal_transactions_count
        - miner
        - size
        - hash
        - parent_hash
        - difficulty
        - total_difficulty
        - gas_used
        - gas_limit
        - nonce
        - base_fee_per_gas
        - burnt_fees
        - priority_fee
        - uncles_hashes
        - rewards
        - gas_target_percentage
        - gas_used_percentage
        - burnt_fees_percentage
        - type
        - transaction_fees
        - withdrawals_count
        - is_pending_update
      title: Block
      type: object
      x-struct: Elixir.BlockScoutWeb.Schemas.API.V2.Block
      x-validate: null
    JsonErrorResponse:
      properties:
        errors:
          items:
            properties:
              detail:
                example: null value where string expected
                type: string
                x-struct: null
                x-validate: null
              source:
                properties:
                  pointer:
                    example: /data/attributes/petName
                    type: string
                    x-struct: null
                    x-validate: null
                required:
                  - pointer
                type: object
                x-struct: null
                x-validate: null
              title:
                example: Invalid value
                type: string
                x-struct: null
                x-validate: null
            required:
              - title
              - source
              - detail
            type: object
            x-struct: null
            x-validate: null
          type: array
          x-struct: null
          x-validate: null
      required:
        - errors
      title: JsonErrorResponse
      type: object
      x-struct: Elixir.OpenApiSpex.JsonErrorResponse
      x-validate: null
    FullHashNullable:
      nullable: true
      pattern: ^0x([A-Fa-f0-9]{64})$
      title: FullHashNullable
      type: string
      x-struct: Elixir.BlockScoutWeb.Schemas.API.V2.General.FullHashNullable
      x-validate: null
    TimestampNullable:
      format: date-time
      nullable: true
      title: TimestampNullable
      type: string
      x-struct: Elixir.BlockScoutWeb.Schemas.API.V2.General.TimestampNullable
      x-validate: null
    IntegerStringNullable:
      nullable: true
      pattern: ^-?([1-9][0-9]*|0)$
      title: IntegerStringNullable
      type: string
      x-struct: Elixir.BlockScoutWeb.Schemas.API.V2.General.IntegerStringNullable
      x-validate: null
    IntegerString:
      nullable: false
      pattern: ^-?([1-9][0-9]*|0)$
      title: IntegerString
      type: string
      x-struct: Elixir.BlockScoutWeb.Schemas.API.V2.General.IntegerString
      x-validate: null
    FullHash:
      nullable: false
      pattern: ^0x([A-Fa-f0-9]{64})$
      title: FullHash
      type: string
      x-struct: Elixir.BlockScoutWeb.Schemas.API.V2.General.FullHash
      x-validate: null
    Address:
      additionalProperties: false
      description: Address
      properties:
        ens_domain_name:
          description: ENS domain name associated with the address
          nullable: true
          type: string
          x-struct: null
          x-validate: null
        hash:
          $ref: '#/components/schemas/AddressHash'
        implementations:
          description: Implementations linked with the contract
          items:
            $ref: '#/components/schemas/Implementation'
          type: array
          x-struct: null
          x-validate: null
        is_contract:
          description: Has address contract code?
          nullable: true
          type: boolean
          x-struct: null
          x-validate: null
        is_scam:
          description: Has address scam badge?
          nullable: false
          type: boolean
          x-struct: null
          x-validate: null
        is_verified:
          description: Has address associated source code?
          nullable: true
          type: boolean
          x-struct: null
          x-validate: null
        metadata:
          allOf:
            - $ref: '#/components/schemas/Metadata'
          nullable: true
          x-struct: null
          x-validate: null
        name:
          description: Name associated with the address
          nullable: true
          type: string
          x-struct: null
          x-validate: null
        private_tags:
          description: Private tags associated with the address
          items:
            $ref: '#/components/schemas/Tag'
          type: array
          x-struct: null
          x-validate: null
        proxy_type:
          $ref: '#/components/schemas/ProxyType'
        public_tags:
          description: Public tags associated with the address
          items:
            $ref: '#/components/schemas/Tag'
          type: array
          x-struct: null
          x-validate: null
        reputation:
          description: Reputation of the address
          enum:
            - ok
            - scam
          nullable: false
          type: string
          x-struct: null
          x-validate: null
        watchlist_names:
          description: Watchlist name associated with the address
          items:
            $ref: '#/components/schemas/WatchlistName'
          type: array
          x-struct: null
          x-validate: null
      required:
        - hash
        - is_contract
        - name
        - is_scam
        - reputation
        - proxy_type
        - implementations
        - is_verified
        - ens_domain_name
        - metadata
      title: Address
      type: object
      x-struct: Elixir.BlockScoutWeb.Schemas.API.V2.Address
      x-validate: null
    HexStringNullable:
      nullable: true
      pattern: ^0x([A-Fa-f0-9]*)$
      title: HexStringNullable
      type: string
      x-struct: Elixir.BlockScoutWeb.Schemas.API.V2.General.HexStringNullable
      x-validate: null
    AddressHash:
      nullable: false
      pattern: ^0x([A-Fa-f0-9]{40})$
      title: AddressHash
      type: string
      x-struct: Elixir.BlockScoutWeb.Schemas.API.V2.General.AddressHash
      x-validate: null
    Timestamp:
      description: Block timestamp of the parent transaction.
      format: date-time
      nullable: false
      title: Timestamp
      type: string
      x-struct: Elixir.BlockScoutWeb.Schemas.API.V2.General.Timestamp
      x-validate: null
    Implementation:
      additionalProperties: false
      description: Proxy smart contract implementation
      properties:
        address_hash:
          $ref: '#/components/schemas/AddressHash'
        name:
          nullable: true
          type: string
          x-struct: null
          x-validate: null
      required:
        - address_hash
        - name
      title: Implementation
      type: object
      x-struct: Elixir.BlockScoutWeb.Schemas.API.V2.General.Implementation
      x-validate: null
    Metadata:
      additionalProperties: false
      description: Metadata struct
      properties:
        tags:
          description: Metadata tags linked with the address
          items:
            $ref: '#/components/schemas/MetadataTag'
          type: array
          x-struct: null
          x-validate: null
      required:
        - tags
      title: Metadata
      type: object
      x-struct: Elixir.BlockScoutWeb.Schemas.API.V2.Proxy.Metadata
      x-validate: null
    Tag:
      additionalProperties: false
      description: Address tag struct
      properties:
        address_hash:
          $ref: '#/components/schemas/AddressHash'
        display_name:
          nullable: false
          type: string
          x-struct: null
          x-validate: null
        label:
          nullable: false
          type: string
          x-struct: null
          x-validate: null
      required:
        - address_hash
        - display_name
        - label
      title: Tag
      type: object
      x-struct: Elixir.BlockScoutWeb.Schemas.API.V2.General.Tag
      x-validate: null
    ProxyType:
      enum:
        - eip1167
        - eip1967
        - eip1822
        - eip1967_oz
        - eip1967_beacon
        - master_copy
        - basic_implementation
        - basic_get_implementation
        - comptroller
        - eip2535
        - clone_with_immutable_arguments
        - eip7702
        - resolved_delegate_proxy
        - erc7760
      nullable: true
      title: ProxyType
      type: string
      x-struct: Elixir.BlockScoutWeb.Schemas.API.V2.General.ProxyType
      x-validate: null
    WatchlistName:
      additionalProperties: false
      description: Watchlist name struct
      properties:
        display_name:
          nullable: false
          type: string
          x-struct: null
          x-validate: null
        label:
          nullable: false
          type: string
          x-struct: null
          x-validate: null
      required:
        - display_name
        - label
      title: WatchlistName
      type: object
      x-struct: Elixir.BlockScoutWeb.Schemas.API.V2.General.WatchlistName
      x-validate: null
    MetadataTag:
      additionalProperties: false
      description: Metadata tag struct
      properties:
        meta:
          nullable: false
          type: object
          x-struct: null
          x-validate: null
        name:
          nullable: false
          type: string
          x-struct: null
          x-validate: null
        ordinal:
          nullable: false
          type: integer
          x-struct: null
          x-validate: null
        slug:
          nullable: false
          type: string
          x-struct: null
          x-validate: null
        tagType:
          nullable: false
          type: string
          x-struct: null
          x-validate: null
      required:
        - slug
        - name
        - tagType
        - ordinal
        - meta
      title: MetadataTag
      type: object
      x-struct: Elixir.BlockScoutWeb.Schemas.API.V2.Proxy.MetadataTag
      x-validate: null

````