---
title: "List L2 transactions in a Scroll batch"
method: GET
path: "/{chain_id}/api/v2/transactions/scroll-batch/{batch_number_param}"
tags: ["transactions"]
---

# List L2 transactions in a Scroll batch

`GET /{chain_id}/api/v2/transactions/scroll-batch/{batch_number_param}`

Retrieves L2 transactions bound to a specific Scroll batch number.

## Path parameters

- `batch_number_param` integer, required
- `chain_id` string, required

## Query parameters

- `items_count` integer
- `block_number` integer
- `index` integer

## Response `200`

Scroll batch transactions.

- object
  - `items` TransactionResponse[], required
    - `arbitrum` object
      - `batch_data_container` string, nullable
      - `batch_number` integer, nullable
      - `commitment_transaction` object
        - `hash` string, nullable, required
        - `status` 'unfinalized' | 'finalized', nullable, required
        - `timestamp` string, date-time, nullable, required
      - `confirmation_transaction` object
        - `hash` string, nullable, required
        - `status` 'unfinalized' | 'finalized', nullable, required
        - `timestamp` string, date-time, nullable, required
      - `contains_message` 'incoming' | 'outcoming', nullable
      - `gas_used_for_l1` string, required
      - `gas_used_for_l2` string, required
      - `message_related_info` object
        - `associated_l1_transaction_hash` string, nullable
        - `message_id` integer
        - `message_status` 'Syncing with base layer' | 'Relayed' | 'Settlement pending' | 'Waiting for confirmation' | 'Ready for relay'
      - `network_fee` string, required
      - `poster_fee` string, required
      - `status` 'Confirmed on base' | 'Sent to base' | 'Sealed on rollup' | 'Processed on rollup'
    - `authorization_list` SignedAuthorization[], nullable, required
      - `address_hash` string, required
      - `authority` string, required
      - `chain_id` integer, required
      - `nonce` string, required
      - `r` string, required
      - `s` string, required
      - `status` 'ok' | 'invalid_chain_id' | 'invalid_signature' | 'invalid_nonce', nullable, required
      - `v` integer, required
    - `base_fee_per_gas` string, nullable, required
    - `block_number` integer, nullable, required
    - `confirmation_duration` integer[], required — Array of time intervals in milliseconds. Can be empty [] (no info), single value [interval] (means that the transaction was confirmed within {interval} milliseconds), or two values [short_interval, long_interval] (means that the transaction's confirmation took from {short_interval} to {long_interval} milliseconds)
    - `confirmations` integer, required
    - `created_contract` Address, required — Address
      - `ens_domain_name` string, nullable, required — ENS domain name associated with the address
      - `hash` string, required
      - `implementations` Implementation[], required — Implementations linked with the contract
        - `address_hash` string, required
        - `name` string, nullable, required
      - `is_contract` boolean, nullable, required — Has address contract code?
      - `is_scam` boolean, required — Has address scam badge?
      - `is_verified` boolean, nullable, required — Has address associated source code?
      - `metadata` Metadata, required — Metadata struct
        - `tags` MetadataTag[], required — Metadata tags linked with the address
          - `meta` object, nullable, required
          - `name` string, required
          - `ordinal` integer, required
          - `slug` string, required
          - `tagType` 'name' | 'generic' | 'classifier' | 'information' | 'note' | 'protocol', required
      - `name` string, nullable, required — Name associated with the address
      - `private_tags` Tag[] — Private tags associated with the address
        - `address_hash` string, required
        - `display_name` string, required
        - `label` string, required
      - `proxy_type` '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' | 'minimal_proxy', nullable, required
      - `public_tags` Tag[] — Public tags associated with the address
        - `address_hash` string, required
        - `display_name` string, required
        - `label` string, required
      - `reputation` 'ok' | 'scam', required — Reputation of the address
      - `watchlist_names` WatchlistName[] — Watchlist name associated with the address
        - `display_name` string, required
        - `label` string, required
    - `decoded_input` DecodedInput, required
      - `method_call` string, nullable, required
      - `method_id` string, nullable, required
      - `parameters` object[], required
        - `name` string
        - `type` string
        - `value` union
          - object
          - union[]
            - union
              - …
          - string
    - `exchange_rate` string, nullable, required
    - `fee` Fee, required
      - `type` 'maximum' | 'actual', required
      - `value` string, nullable, required
    - `fhe_operations_count` integer, required — Number of FHE (Fully Homomorphic Encryption) operations in the transaction
    - `from` Address, required — Address
      - `ens_domain_name` string, nullable, required — ENS domain name associated with the address
      - `hash` string, required
      - `implementations` Implementation[], required — Implementations linked with the contract
        - `address_hash` string, required
        - `name` string, nullable, required
      - `is_contract` boolean, nullable, required — Has address contract code?
      - `is_scam` boolean, required — Has address scam badge?
      - `is_verified` boolean, nullable, required — Has address associated source code?
      - `metadata` Metadata, required — Metadata struct
        - `tags` MetadataTag[], required — Metadata tags linked with the address
          - `meta` object, nullable, required
          - `name` string, required
          - `ordinal` integer, required
          - `slug` string, required
          - `tagType` 'name' | 'generic' | 'classifier' | 'information' | 'note' | 'protocol', required
      - `name` string, nullable, required — Name associated with the address
      - `private_tags` Tag[] — Private tags associated with the address
        - `address_hash` string, required
        - `display_name` string, required
        - `label` string, required
      - `proxy_type` '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' | 'minimal_proxy', nullable, required
      - `public_tags` Tag[] — Public tags associated with the address
        - `address_hash` string, required
        - `display_name` string, required
        - `label` string, required
      - `reputation` 'ok' | 'scam', required — Reputation of the address
      - `watchlist_names` WatchlistName[] — Watchlist name associated with the address
        - `display_name` string, required
        - `label` string, required
    - `gas_limit` string, required
    - `gas_price` string, nullable, required
    - `gas_used` string, nullable, required
    - `has_error_in_internal_transactions` boolean, nullable, required
    - `hash` string, required
    - `historic_exchange_rate` string, nullable, required
    - `is_pending_update` boolean, nullable, required
    - `max_fee_per_gas` string, nullable, required
    - `max_priority_fee_per_gas` string, nullable, required
    - `method` string, nullable, required — Method name or hex method id
    - `nonce` integer, required
    - `position` integer, nullable, required
    - `priority_fee` string, nullable, required
    - `raw_input` string, required
    - `result` union, required
      - 'pending' | 'awaiting_internal_transactions' | 'success' | 'dropped/replaced'
      - string — Error message
    - `revert_reason` union, required
      - DecodedInput
        - `method_call` string, nullable, required
        - `method_id` string, nullable, required
        - `parameters` object[], required
          - `name` string
          - `type` string
          - `value` union
            - object
            - union[]
              - …
            - string
      - object
        - `raw` union, required
          - string
          - string
    - `status` 'ok' | 'error', nullable, required
    - `timestamp` string, date-time, nullable, required
    - `to` Address, required — Address
      - `ens_domain_name` string, nullable, required — ENS domain name associated with the address
      - `hash` string, required
      - `implementations` Implementation[], required — Implementations linked with the contract
        - `address_hash` string, required
        - `name` string, nullable, required
      - `is_contract` boolean, nullable, required — Has address contract code?
      - `is_scam` boolean, required — Has address scam badge?
      - `is_verified` boolean, nullable, required — Has address associated source code?
      - `metadata` Metadata, required — Metadata struct
        - `tags` MetadataTag[], required — Metadata tags linked with the address
          - `meta` object, nullable, required
          - `name` string, required
          - `ordinal` integer, required
          - `slug` string, required
          - `tagType` 'name' | 'generic' | 'classifier' | 'information' | 'note' | 'protocol', required
      - `name` string, nullable, required — Name associated with the address
      - `private_tags` Tag[] — Private tags associated with the address
        - `address_hash` string, required
        - `display_name` string, required
        - `label` string, required
      - `proxy_type` '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' | 'minimal_proxy', nullable, required
      - `public_tags` Tag[] — Public tags associated with the address
        - `address_hash` string, required
        - `display_name` string, required
        - `label` string, required
      - `reputation` 'ok' | 'scam', required — Reputation of the address
      - `watchlist_names` WatchlistName[] — Watchlist name associated with the address
        - `display_name` string, required
        - `label` string, required
    - `token_transfers` TokenTransfer[], nullable, required
      - `block_hash` string, required
      - `block_number` integer, required
      - `from` Address, required — Address
        - `ens_domain_name` string, nullable, required — ENS domain name associated with the address
        - `hash` string, required
        - `implementations` Implementation[], required — Implementations linked with the contract
          - `address_hash` string, required
          - `name` string, nullable, required
        - `is_contract` boolean, nullable, required — Has address contract code?
        - `is_scam` boolean, required — Has address scam badge?
        - `is_verified` boolean, nullable, required — Has address associated source code?
        - `metadata` Metadata, required — Metadata struct
          - `tags` MetadataTag[], required — Metadata tags linked with the address
            - `meta` object, nullable, required
            - `name` string, required
            - `ordinal` integer, required
            - `slug` string, required
            - `tagType` 'name' | 'generic' | 'classifier' | 'information' | 'note' | 'protocol', required
        - `name` string, nullable, required — Name associated with the address
        - `private_tags` Tag[] — Private tags associated with the address
          - `address_hash` string, required
          - `display_name` string, required
          - `label` string, required
        - `proxy_type` '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' | 'minimal_proxy', nullable, required
        - `public_tags` Tag[] — Public tags associated with the address
          - `address_hash` string, required
          - `display_name` string, required
          - `label` string, required
        - `reputation` 'ok' | 'scam', required — Reputation of the address
        - `watchlist_names` WatchlistName[] — Watchlist name associated with the address
          - `display_name` string, required
          - `label` string, required
      - `log_index` integer, required
      - `method` string, nullable, required — Method name or hex method id
      - `timestamp` string, date-time, nullable, required
      - `to` Address, required — Address
        - `ens_domain_name` string, nullable, required — ENS domain name associated with the address
        - `hash` string, required
        - `implementations` Implementation[], required — Implementations linked with the contract
          - `address_hash` string, required
          - `name` string, nullable, required
        - `is_contract` boolean, nullable, required — Has address contract code?
        - `is_scam` boolean, required — Has address scam badge?
        - `is_verified` boolean, nullable, required — Has address associated source code?
        - `metadata` Metadata, required — Metadata struct
          - `tags` MetadataTag[], required — Metadata tags linked with the address
            - `meta` object, nullable, required
            - `name` string, required
            - `ordinal` integer, required
            - `slug` string, required
            - `tagType` 'name' | 'generic' | 'classifier' | 'information' | 'note' | 'protocol', required
        - `name` string, nullable, required — Name associated with the address
        - `private_tags` Tag[] — Private tags associated with the address
          - `address_hash` string, required
          - `display_name` string, required
          - `label` string, required
        - `proxy_type` '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' | 'minimal_proxy', nullable, required
        - `public_tags` Tag[] — Public tags associated with the address
          - `address_hash` string, required
          - `display_name` string, required
          - `label` string, required
        - `reputation` 'ok' | 'scam', required — Reputation of the address
        - `watchlist_names` WatchlistName[] — Watchlist name associated with the address
          - `display_name` string, required
          - `label` string, required
      - `token` Token, required — Token struct
        - `address_hash` string, required
        - `bridge_type` 'omni' | 'amb', nullable — Type of bridge used for this bridged token
        - `circulating_market_cap` string, nullable, required
        - `circulating_supply` string, nullable, required
        - `decimals` string, nullable, required
        - `exchange_rate` string, nullable, required
        - `foreign_address` string, nullable
        - `holders_count` string, nullable, required
        - `icon_url` string, uri, nullable, required
        - `name` string, nullable, required
        - `origin_chain_id` string, nullable
        - `reputation` 'ok' | 'scam', nullable, required — Reputation of the token
        - `symbol` string, nullable, required
        - `total_supply` string, nullable, required
        - `type` 'ERC-20' | 'ERC-721' | 'ERC-1155' | 'ERC-404' | 'ERC-7984', required
        - `volume_24h` string, nullable, required
      - `token_type` 'ERC-20' | 'ERC-721' | 'ERC-1155' | 'ERC-404' | 'ERC-7984', required
      - `total` union, required
        - TotalERC721
          - `token_id` string, nullable, required
          - `token_instance` TokenInstance, required
            - `animation_media_type` 'image' | 'video' | 'html', nullable — Media type category of the token instance animation URL
            - `animation_url` string, uri, nullable, required
            - `external_app_url` string, uri, nullable, required
            - `id` string, required
            - `image_media_type` 'image' | 'video' | 'html', nullable — Media type category of the token instance image URL
            - `image_url` string, uri, nullable, required
            - `is_unique` boolean, nullable, required
            - `media_type` string, nullable, required — Mime type of the media in media_url
            - `media_url` string, uri, nullable, required
            - `metadata` object, nullable, required
            - `owner` Address, required — Address
              - …
            - `thumbnails` object, nullable, required
              - …
            - `token` Token, required — Token struct
              - …
            - `token_type` 'ERC-20' | 'ERC-721' | 'ERC-1155' | 'ERC-404' | 'ERC-7984'
            - `value` string, nullable
        - TotalERC1155
          - `decimals` string, nullable, required
          - `token_id` string, nullable, required
          - `token_instance` TokenInstance, required
            - `animation_media_type` 'image' | 'video' | 'html', nullable — Media type category of the token instance animation URL
            - `animation_url` string, uri, nullable, required
            - `external_app_url` string, uri, nullable, required
            - `id` string, required
            - `image_media_type` 'image' | 'video' | 'html', nullable — Media type category of the token instance image URL
            - `image_url` string, uri, nullable, required
            - `is_unique` boolean, nullable, required
            - `media_type` string, nullable, required — Mime type of the media in media_url
            - `media_url` string, uri, nullable, required
            - `metadata` object, nullable, required
            - `owner` Address, required — Address
              - …
            - `thumbnails` object, nullable, required
              - …
            - `token` Token, required — Token struct
              - …
            - `token_type` 'ERC-20' | 'ERC-721' | 'ERC-1155' | 'ERC-404' | 'ERC-7984'
            - `value` string, nullable
          - `value` string, nullable, required
        - TotalERC7984
          - `decimals` string, nullable, required
          - `value` string, nullable, required
        - Total
          - `decimals` string, nullable, required
          - `value` string, nullable, required
      - `transaction_hash` string, required
      - `type` 'token_burning' | 'token_minting' | 'token_spawning' | 'token_transfer', required
    - `token_transfers_overflow` boolean, nullable, required
    - `transaction_burnt_fee` string, nullable, required
    - `transaction_tag` string, nullable, required — Transaction tag set in My Account
    - `transaction_types` string[], required
    - `type` integer, nullable, required
    - `value` string, required
  - `next_page_params` object, nullable, required

## Other responses

- `422` — Unprocessable Entity

---

[API](https://skmtc.net/blockscout/apis/blockscout-pro-api.md) · [All operations](https://skmtc.net/blockscout/apis/blockscout-pro-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/blockscout/blockscout-pro-api/versions/59ac5466233b/schema)