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

# eth_getFilterLogs | Arc

> Arc API method that returns an array of all logs matching the filter with the given ID. eth_getFilterLogs on Arc via Chainstack.

Arc API method that returns an array of all logs matching the filter with the given ID. Unlike `eth_getFilterChanges`, this returns all matching logs, not just new ones since the last poll.

## Parameters

* `filterId` — the filter ID returned from `eth_newFilter`

## Response

* `result` — array of log objects matching the filter:
  * `address` — contract address that emitted the log
  * `topics` — array of indexed log parameters
  * `data` — non-indexed log parameters
  * `blockNumber` — block number containing the log
  * `blockHash` — hash of the block
  * `transactionHash` — hash of the transaction that emitted the log
  * `transactionIndex` — index of the transaction in the block
  * `logIndex` — position of the log in the block
  * `removed` — `true` if the log was removed due to a chain reorganization

## `eth_getFilterLogs` code examples

<CodeGroup>
  ```javascript ethers.js theme={"system"}
  const ethers = require('ethers');
  const NODE_URL = "CHAINSTACK_NODE_URL";
  const provider = new ethers.JsonRpcProvider(NODE_URL);

  // pathUSD token address
  const PATHUSD = "0x20c0000000000000000000000000000000000000";
  const TRANSFER_TOPIC = ethers.id("Transfer(address,address,uint256)");

  const getFilterLogs = async () => {
      // Create a log filter
      const filterId = await provider.send("eth_newFilter", [{
        address: PATHUSD,
        topics: [TRANSFER_TOPIC],
        fromBlock: "0x560000"
      }]);
      console.log(`Created filter: ${filterId}`);

      // Get all matching logs
      const logs = await provider.send("eth_getFilterLogs", [filterId]);
      console.log(`Found ${logs.length} Transfer events`);

      for (const log of logs.slice(0, 5)) {
        console.log(`\nBlock ${parseInt(log.blockNumber, 16)}:`);
        console.log(`  Tx: ${log.transactionHash}`);
        console.log(`  From: 0x${log.topics[1].slice(26)}`);
        console.log(`  To: 0x${log.topics[2].slice(26)}`);
      }

      // Clean up
      await provider.send("eth_uninstallFilter", [filterId]);
    };

  getFilterLogs();
  ```

  ```python web3.py theme={"system"}
  from web3 import Web3

  node_url = "CHAINSTACK_NODE_URL"
  web3 = Web3(Web3.HTTPProvider(node_url))

  # pathUSD token address
  PATHUSD = "0x20c0000000000000000000000000000000000000"
  TRANSFER_TOPIC = web3.keccak(text="Transfer(address,address,uint256)").hex()

  # Create a log filter
  filter_result = web3.provider.make_request("eth_newFilter", [{
      "address": PATHUSD,
      "topics": [TRANSFER_TOPIC],
      "fromBlock": "0x560000"
  }])
  filter_id = filter_result['result']
  print(f"Created filter: {filter_id}")

  # Get all matching logs
  logs_result = web3.provider.make_request("eth_getFilterLogs", [filter_id])
  logs = logs_result['result']
  print(f"Found {len(logs)} Transfer events")

  for log in logs[:5]:
      print(f"\nBlock {int(log['blockNumber'], 16)}:")
      print(f"  Tx: {log['transactionHash']}")
      print(f"  From: 0x{log['topics'][1][26:]}")
      print(f"  To: 0x{log['topics'][2][26:]}")

  # Clean up
  web3.provider.make_request("eth_uninstallFilter", [filter_id])
  ```

  ```bash cURL theme={"system"}
  # First create a filter
  curl -X POST "CHAINSTACK_NODE_URL" \
    -H "Content-Type: application/json" \
    -d '{
      "jsonrpc": "2.0",
      "method": "eth_newFilter",
      "params": [{"address": "0x20c0000000000000000000000000000000000000", "fromBlock": "0x560000"}],
      "id": 1
    }'

  # Then get all logs using the returned filter ID
  curl -X POST "CHAINSTACK_NODE_URL" \
    -H "Content-Type: application/json" \
    -d '{"jsonrpc": "2.0", "method": "eth_getFilterLogs", "params": ["0x1"], "id": 1}'
  ```
</CodeGroup>


## OpenAPI

````yaml openapi/arc_node_api/filter_handling/eth_getFilterLogs.json POST /
openapi: 3.0.0
info:
  title: Chainstack Node API
  version: 1.0.0
  description: This is an API for interacting with a Chainstack node.
servers:
  - url: https://arc-testnet.core.chainstack.com/6caa7fd90475ac9214f7521dd460fa7c
security: []
paths:
  /:
    post:
      tags:
        - upload
      summary: eth_getFilterLogs
      operationId: eth_getFilterLogs
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                id:
                  type: integer
                  default: 1
                jsonrpc:
                  type: string
                  default: '2.0'
                method:
                  type: string
                  default: eth_getFilterLogs
                params:
                  type: array
                  default:
                    - '0x1'
      responses:
        '200':
          description: Returns the result of eth_getFilterLogs.
          content:
            application/json:
              schema:
                type: object
                properties:
                  jsonrpc:
                    type: string
                  id:
                    type: integer
                  result:
                    type: array
                    items:
                      type: object
                      properties:
                        address:
                          type: string
                        topics:
                          type: array
                          items:
                            type: string
                        data:
                          type: string
                        blockHash:
                          type: string
                        blockNumber:
                          type: string
                        blockTimestamp:
                          type: string
                        transactionHash:
                          type: string
                        transactionIndex:
                          type: string
                        logIndex:
                          type: string
                        removed:
                          type: boolean
              example:
                jsonrpc: '2.0'
                id: 1
                result:
                  - address: '0xfffffffffffffffffffffffffffffffffffffffe'
                    topics:
                      - >-
                        0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef
                      - >-
                        0x0000000000000000000000005d20879655df3c1e04ab111af0009ad650e762f0
                      - >-
                        0x0000000000000000000000007798f2eb73c1dd8fa8086d780d5cf114a10f528e
                    data: >-
                      0x000000000000000000000000000000000000000000000000016345785d8a0000
                    blockHash: >-
                      0x6dabcf7ed4cf53e05054a4d671b19b7597740bce1042019ff31af68dde9c98a9
                    blockNumber: '0x34808ff'
                    blockTimestamp: '0x6a7026be'
                    transactionHash: >-
                      0x2ed866a63cf1fcc052779d3e3edc6bd6dc2e8378b23c23031f479c5fc0897313
                    transactionIndex: '0x0'
                    logIndex: '0x0'
                    removed: false
                  - address: '0xfffffffffffffffffffffffffffffffffffffffe'
                    topics:
                      - >-
                        0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef
                      - >-
                        0x0000000000000000000000007798f2eb73c1dd8fa8086d780d5cf114a10f528e
                      - >-
                        0x000000000000000000000000ad4c0bf78ce754d5d4d045e37783e95834b900fe
                    data: >-
                      0x000000000000000000000000000000000000000000000000016345785d8a0000
                    blockHash: >-
                      0x6dabcf7ed4cf53e05054a4d671b19b7597740bce1042019ff31af68dde9c98a9
                    blockNumber: '0x34808ff'
                    blockTimestamp: '0x6a7026be'
                    transactionHash: >-
                      0x2ed866a63cf1fcc052779d3e3edc6bd6dc2e8378b23c23031f479c5fc0897313
                    transactionIndex: '0x0'
                    logIndex: '0x1'
                    removed: false
                  - address: '0xad4c0bf78ce754d5d4d045e37783e95834b900fe'
                    topics:
                      - >-
                        0x5548c837ab068cf56a2c2479df0882a4922fd203edb7517321831d95078c5f62
                      - >-
                        0x0000000000000000000000007798f2eb73c1dd8fa8086d780d5cf114a10f528e
                      - >-
                        0x0000000000000000000000000a3111263a39fa77d1a931a2aeb028314b73fb7e
                    data: >-
                      0x000000000000000000000000000000000000000000000000016345785d8a0000
                    blockHash: >-
                      0x6dabcf7ed4cf53e05054a4d671b19b7597740bce1042019ff31af68dde9c98a9
                    blockNumber: '0x34808ff'
                    blockTimestamp: '0x6a7026be'
                    transactionHash: >-
                      0x2ed866a63cf1fcc052779d3e3edc6bd6dc2e8378b23c23031f479c5fc0897313
                    transactionIndex: '0x0'
                    logIndex: '0x2'
                    removed: false
                  - address: '0x6c415c8567bf7c2761d623c41f57668ddbad939b'
                    topics:
                      - >-
                        0xbc7cd75a20ee27fd9adebab32041f755214dbc6bffa90cc0225b39da2e5c2d3b
                      - >-
                        0x0000000000000000000000006610cb88385996ca4e121954f07ee3a0c95e5aa8
                    data: 0x
                    blockHash: >-
                      0x6dabcf7ed4cf53e05054a4d671b19b7597740bce1042019ff31af68dde9c98a9
                    blockNumber: '0x34808ff'
                    blockTimestamp: '0x6a7026be'
                    transactionHash: >-
                      0x2ed866a63cf1fcc052779d3e3edc6bd6dc2e8378b23c23031f479c5fc0897313
                    transactionIndex: '0x0'
                    logIndex: '0x3'
                    removed: false

````