> ## 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.

# Get withdrawal messages for a transaction.

> Returns the list of Rollup withdrawal messages (L2ToL1Tx events) emitted by the given transaction.



## OpenAPI

````yaml /openapi-specs/pro-api-v11.yaml get /v2/arbitrum/messages/withdrawals/{transaction_hash}
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/arbitrum/messages/withdrawals/{transaction_hash}:
    get:
      tags:
        - arbitrum
      summary: Get withdrawal messages for a transaction.
      description: >-
        Returns the list of Rollup withdrawal messages (L2ToL1Tx events) emitted
        by the given transaction.
      operationId: BlockScoutWeb.API.V2.ArbitrumController.withdrawals
      parameters:
        - description: Transaction hash.
          in: path
          name: transaction_hash
          required: true
          schema:
            $ref: '#/components/schemas/FullHash'
        - 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
      responses:
        '200':
          content:
            application/json:
              schema:
                additionalProperties: false
                properties:
                  items:
                    items:
                      $ref: '#/components/schemas/Arbitrum.Withdrawal'
                    type: array
                    x-struct: null
                    x-validate: null
                required:
                  - items
                type: object
                x-struct: null
                x-validate: null
          description: Withdrawal messages for the transaction.
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JsonErrorResponse'
          description: Unprocessable Entity
      callbacks: {}
components:
  schemas:
    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
    Arbitrum.Withdrawal:
      additionalProperties: false
      description: Arbitrum Rollup withdrawal message.
      properties:
        arb_block_number:
          description: Rollup block number.
          minimum: 0
          type: integer
          x-struct: null
          x-validate: null
        caller_address_hash:
          allOf:
            - $ref: '#/components/schemas/AddressHash'
          description: Address of the account that initiated the withdrawal on the Rollup.
          x-struct: null
          x-validate: null
        callvalue:
          allOf:
            - $ref: '#/components/schemas/IntegerString'
          description: Native coin amount in wei attached to the withdrawal message.
          x-struct: null
          x-validate: null
        completion_transaction_hash:
          $ref: '#/components/schemas/FullHashNullable'
        data:
          allOf:
            - $ref: '#/components/schemas/HexString'
          description: >-
            ABI-encoded calldata passed to the destination address when the
            withdrawal is executed on the Parent chain. Empty (`0x`) for plain
            native coin transfers.
          x-struct: null
          x-validate: null
        destination_address_hash:
          allOf:
            - $ref: '#/components/schemas/AddressHash'
          description: >-
            Recipient address on the Parent chain that will receive funds when
            the withdrawal is executed.
          x-struct: null
          x-validate: null
        eth_block_number:
          description: Parent chain block number.
          minimum: 0
          type: integer
          x-struct: null
          x-validate: null
        id:
          description: Withdrawal message ID.
          minimum: 0
          type: integer
          x-struct: null
          x-validate: null
        l2_timestamp:
          description: Unix timestamp of the originating transaction.
          minimum: 0
          type: integer
          x-struct: null
          x-validate: null
        status:
          description: >-
            Withdrawal lifecycle status. Progresses from `initiated` (L2ToL1Tx
            event emitted) through `sent` (included in an RBlock) and
            `confirmed` (RBlock confirmed on Parent chain) to `relayed`
            (executed on Parent chain). `unknown` indicates the status could not
            be determined, e.g. when the Parent chain RPC is unavailable.
          enum:
            - unknown
            - initiated
            - sent
            - confirmed
            - relayed
          type: string
          x-struct: null
          x-validate: null
        token:
          additionalProperties: false
          description: >-
            Token withdrawal details. Present when the withdrawal is for a
            bridged token, null for native coin.
          nullable: true
          properties:
            address_hash:
              allOf:
                - $ref: '#/components/schemas/AddressHashNullable'
              description: Token contract address on the Parent chain.
              x-struct: null
              x-validate: null
            amount:
              allOf:
                - $ref: '#/components/schemas/IntegerString'
              description: Token amount in the token's smallest unit.
              x-struct: null
              x-validate: null
            decimals:
              minimum: 0
              nullable: true
              type: integer
              x-struct: null
              x-validate: null
            destination_address_hash:
              allOf:
                - $ref: '#/components/schemas/AddressHashNullable'
              description: Token recipient address on the Parent chain.
              x-struct: null
              x-validate: null
            name:
              nullable: true
              type: string
              x-struct: null
              x-validate: null
            symbol:
              nullable: true
              type: string
              x-struct: null
              x-validate: null
          required:
            - address_hash
            - destination_address_hash
            - amount
            - decimals
            - name
            - symbol
          type: object
          x-struct: null
          x-validate: null
      required:
        - id
        - status
        - caller_address_hash
        - destination_address_hash
        - arb_block_number
        - eth_block_number
        - l2_timestamp
        - callvalue
        - data
        - token
        - completion_transaction_hash
      title: Arbitrum.Withdrawal
      type: object
      x-struct: Elixir.BlockScoutWeb.Schemas.API.V2.Arbitrum.Withdrawal
      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
    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
    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
    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
    HexString:
      nullable: false
      pattern: ^0x([A-Fa-f0-9]*)$
      title: HexString
      type: string
      x-struct: Elixir.BlockScoutWeb.Schemas.API.V2.General.HexString
      x-validate: null
    AddressHashNullable:
      nullable: true
      pattern: ^0x([A-Fa-f0-9]{40})$
      title: AddressHashNullable
      type: string
      x-struct: Elixir.BlockScoutWeb.Schemas.API.V2.General.AddressHashNullable
      x-validate: null

````