---
title: "List cross-chain messages."
method: GET
path: "/{chain_id}/api/v2/arbitrum/messages/{direction}"
tags: ["arbitrum"]
---

# List cross-chain messages.

`GET /{chain_id}/api/v2/arbitrum/messages/{direction}`

Retrieves a paginated list of Arbitrum cross-chain messages filtered by the specified direction.

## Path parameters

- `direction` 'from-rollup' | 'to-rollup', required
- `chain_id` string, required

## Query parameters

- `items_count` integer
- `id` integer

## Response `200`

Paginated list of cross-chain messages.

- object
  - `items` ArbitrumMessage[], required
    - `completion_transaction_hash` string, nullable, required — Hash of the transaction on the destination chain that executed this message.
    - `id` integer, required — Unique cross-chain message identifier assigned by the protocol.
    - `origination_address_hash` string, nullable, required — Address that initiated the message on the originating chain.
    - `origination_timestamp` string, date-time, nullable, required
    - `origination_transaction_block_number` integer, nullable, required — Block number on the originating chain containing the initiation transaction.
    - `origination_transaction_hash` string, nullable, required — Hash of the transaction on the originating chain that initiated this message.
    - `status` 'initiated' | 'sent' | 'confirmed' | 'relayed', required — Cross-chain message lifecycle. For Rollup→Parent messages: `initiated` (L2ToL1Tx event emitted on Rollup) → `sent` (included in a batch committed to Parent chain) → `confirmed` (batch state root posted to the Outbox contract) → `relayed` (executed on Parent chain). For Parent→Rollup messages only `initiated` and `relayed` apply.
  - `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)