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

Base API method `eth_getFilterLogs` retrieves all logs matching a previously created filter. This method is essential for applications that need to fetch historical log data based on specific criteria.

<Warning>
  **Disclaimer**

  Note that the default interactive example in this page will not work as the filter will be expired.

  To test `eth_getFilterLogs` in this page, first create a new filter using one of the following:

  * [eth\_newFilter](/reference/base-newfilter)
  * [eth\_newBlockFilter](/reference/base-newblockfilter)

  Then use the fresh filter ID as the parameter for `eth_getFilterChanges`.
</Warning>

<Check>
  **Get your own node endpoint today**

  [Start for free](https://console.chainstack.com/) and get your app to production levels immediately. No credit card required.

  You can sign up with your GitHub, X, Google, or Microsoft account.
</Check>

## Parameters

* `filterId` — the ID of the filter for which logs are being fetched. This ID is returned by filter creation methods such as `eth_newBlockFilter`, or `eth_newFilter`. For this example, a random value `"0x5a6b7c"` is used.

## Response

* `result` — an array of log objects. Each log object contains details such as whether the log was removed (due to a chain reorganization), log index, transaction index, transaction hash, block hash, block number, address from which the log originated, data contained in the log, and topics associated with the log.

## Use case

The `eth_getFilterLogs` method is essential for:

* DApps that require access to historical log data for analysis or display purposes.
* Services that monitor smart contract interactions over time, needing to retrieve all past events that match certain criteria.
* Analytical tools that process and visualize blockchain data based on logs from specific contracts or transactions.


## OpenAPI

````yaml /openapi/base_node_api/eth_getFilterLogs.json POST /2fc1de7f08c0465f6a28e3c355e0cb14
openapi: 3.0.0
info:
  title: eth_getFilterLogs example
  version: 1.0.0
  description: >-
    This is an API example for eth_getFilterLogs, a method to retrieve all logs
    matching a filter.
servers:
  - url: https://base-mainnet.core.chainstack.com
security: []
paths:
  /2fc1de7f08c0465f6a28e3c355e0cb14:
    post:
      tags:
        - Ethereum Operations
      summary: eth_getFilterLogs
      operationId: getFilterLogs
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                jsonrpc:
                  type: string
                  default: '2.0'
                method:
                  type: string
                  default: eth_getFilterLogs
                id:
                  type: integer
                  default: 1
                params:
                  type: array
                  items:
                    type: string
                  default:
                    - '0x5a6b7c'
      responses:
        '200':
          description: All logs matching the filter
          content:
            application/json:
              schema:
                type: object
                properties:
                  jsonrpc:
                    type: string
                  id:
                    type: integer
                  result:
                    type: array
                    items:
                      type: object
                      properties:
                        removed:
                          type: boolean
                        logIndex:
                          type: string
                        transactionIndex:
                          type: string
                        transactionHash:
                          type: string
                        blockHash:
                          type: string
                        blockNumber:
                          type: string
                        address:
                          type: string
                        data:
                          type: string
                        topics:
                          type: array
                          items:
                            type: string

````