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

# eth_getLogs

Returns an array of all logs matching a given filter object.

This method will use `80` [Compute Units](/nodeapi/about/billing.md).

***

## Reference: [Here](https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_getlogs)

## **Parameters**

1. `Object` - The filter options:

* `fromBlock`: `QUANTITY|TAG` - (optional, default: `"latest"`) Integer block number, or `"latest"` for the last mined block, `"safe"` or `"finalized"` for the latest safe or finalized block, `"pending"` for the pending block, or `"earliest"` for the genesis block.
* `toBlock`: `QUANTITY|TAG` - (optional, default: `"latest"`) Integer block number, or `"latest"` for the last mined block, `"safe"` or `"finalized"` for the latest safe or finalized block, `"pending"` for the pending block, or `"earliest"` for the genesis block.
* `address`: `DATA|Array`, 20 Bytes - (optional) Contract address or a list of addresses from which logs should originate.
* `topics`: `Array of DATA`, - (optional) Array of 32 Bytes `DATA` topics. Topics are order-dependent. Each topic can also be an array of DATA with "or" options.
* `blockHash`: `DATA`, 32 Bytes - (optional) Restricts the logs returned to the single block with the 32-byte hash `blockHash` (EIP-234). Using `blockHash` is equivalent to `fromBlock` = `toBlock` = the block number with hash `blockHash`. If `blockHash` is present in the filter criteria, then neither `fromBlock` nor `toBlock` are allowed.

```javascript theme={"theme":{"light":"github-light","dark":"github-dark-default"}}
params: [
  {
    "fromBlock": "0x618a700",
    "toBlock": "0x618a700",
    "address": "0xdeaddeaddeaddeaddeaddeaddeaddeaddead1111"
  }
]
```

## Returns

See [eth\_getFilterChanges:](https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_getfilterchanges)

`Array` - Array of log objects matching the filter, or an empty array if none match. Each log object has the following fields:

* `removed`: `Boolean` - `true` when the log was removed, due to a chain reorganization. `false` if its a valid log.
* `logIndex`: `QUANTITY` - integer of the log index position in the block. `null` when its pending log.
* `transactionIndex`: `QUANTITY` - integer of the transactions index position log was created from. `null` when its pending log.
* `transactionHash`: `DATA`, 32 Bytes - hash of the transactions this log was created from. `null` when its pending log.
* `blockHash`: `DATA`, 32 Bytes - hash of the block where this log was in. `null` when its pending. `null` when its pending log.
* `blockNumber`: `QUANTITY` - the block number where this log was in. `null` when its pending. `null` when its pending log.
* `address`: `DATA`, 20 Bytes - address from which this log originated.
* `data`: `DATA` - contains one or more 32 Bytes non-indexed arguments of the log.
* `topics`: `Array of DATA` - Array of 0 to 4 32 Bytes `DATA` of indexed log arguments. (In *solidity*: The first topic is the *hash* of the signature of the event (e.g. `Deposit(address,bytes32,uint256)`), except you declared the event with the `anonymous` specifier.)

```json theme={"theme":{"light":"github-light","dark":"github-dark-default"}}
// Result
{
  "jsonrpc": "2.0",
  "id": 74,
  "result": [
    {
      "address": "0xdeaddeaddeaddeaddeaddeaddeaddeaddead1111",
      "topics": [
        "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
        "0x000000000000000000000000a7c728c4be834ddaf5c49ee4ced678d8aff49de6",
        "0x000000000000000000000000e7cac669cc341bae5edda780538d2dcd5ba37bdc"
      ],
      "data": "0x00000000000000000000000000000000000000000000000029a2241b03935645",
      "blockNumber": "0x618a700",
      "transactionHash": "0x1ecda3069718c657ba153c9bb5b6c6551eed60024ccd129162eea5643d1c7eb5",
      "transactionIndex": "0x1",
      "blockHash": "0x0e9f8b25705acb6e4eee68d5b43e6565827fbd2976ab27f7e7ed0704e3c9eaca",
      "blockTimestamp": "0x6ada4008",
      "logIndex": "0x0",
      "removed": false
    }
  ]
}
```

```bash title="mainnet" theme={"theme":{"light":"github-light","dark":"github-dark-default"}}
curl https://mainnet.mantle.validationcloud.io/v1/<YOUR_API_KEY_HERE> \
    -X POST \
    -H "Content-Type: application/json" \
    -d '{"jsonrpc":"2.0","method":"eth_getLogs","params":[{"fromBlock":"0x618a700","toBlock":"0x618a700","address":"0xdeaddeaddeaddeaddeaddeaddeaddeaddead1111"}],"id":74}'
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.