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

***

## 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": "0x3a64324",
    "toBlock": "0x3a64324",
    "address": "0x3c3a8a41e095c76b03f79f70955fff3b03cf753e"
  }
]
```

## 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": "0x3c3a8a41e095c76b03f79f70955fff3b03cf753e",
      "topics": [
        "0xfaddd0b06e793a583e92393ad3f98637e560462ee98db1f2888f141124ee64ca"
      ],
      "data": "0x0000000000000000000000000000000000000000000000000000000006e7df93",
      "blockHash": "0x801f9b08c43e9363292af641cd5a950bfa74e248314f2967a1bbc9693ed8089e",
      "blockNumber": "0x3a64324",
      "blockTimestamp": "0x6acf62eb",
      "transactionHash": "0x6e5622e0ac8197fe0b6e3f6f18d015fcf007c8f7bc697b0dc2b047ed1158221e",
      "transactionIndex": "0x2",
      "logIndex": "0x0",
      "removed": false
    },
    {
      "address": "0x3c3a8a41e095c76b03f79f70955fff3b03cf753e",
      "topics": [
        "0xfaddd0b06e793a583e92393ad3f98637e560462ee98db1f2888f141124ee64ca"
      ],
      "data": "0x0000000000000000000000000000000000000000000000000000000006e7df94",
      "blockHash": "0x801f9b08c43e9363292af641cd5a950bfa74e248314f2967a1bbc9693ed8089e",
      "blockNumber": "0x3a64324",
      "blockTimestamp": "0x6acf62eb",
      "transactionHash": "0x670a424d884fecb95b495dd19948025552a538c0563142d4c9cb7371d6899c1f",
      "transactionIndex": "0x3",
      "logIndex": "0x1",
      "removed": false
    },
    {
      "address": "0x3c3a8a41e095c76b03f79f70955fff3b03cf753e",
      "topics": [
        "0xfaddd0b06e793a583e92393ad3f98637e560462ee98db1f2888f141124ee64ca"
      ],
      "data": "0x0000000000000000000000000000000000000000000000000000000006e7df95",
      "blockHash": "0x801f9b08c43e9363292af641cd5a950bfa74e248314f2967a1bbc9693ed8089e",
      "blockNumber": "0x3a64324",
      "blockTimestamp": "0x6acf62eb",
      "transactionHash": "0xc63fe14bc9d7027b5a10444c5c161d8d91be856dced598673d993eb0ad72558c",
      "transactionIndex": "0x4",
      "logIndex": "0x2",
      "removed": false
    },
    {
      "address": "0x3c3a8a41e095c76b03f79f70955fff3b03cf753e",
      "topics": [
        "0xfaddd0b06e793a583e92393ad3f98637e560462ee98db1f2888f141124ee64ca"
      ],
      "data": "0x0000000000000000000000000000000000000000000000000000000006e7df96",
      "blockHash": "0x801f9b08c43e9363292af641cd5a950bfa74e248314f2967a1bbc9693ed8089e",
      "blockNumber": "0x3a64324",
      "blockTimestamp": "0x6acf62eb",
      "transactionHash": "0x9c32848d7d789b588ec7cc046afcc4082d90e43e5201ebf76172e85e71e9ff7b",
      "transactionIndex": "0x5",
      "logIndex": "0x3",
      "removed": false
    },
    {
      "address": "0x3c3a8a41e095c76b03f79f70955fff3b03cf753e",
      "topics": [
        "0xfaddd0b06e793a583e92393ad3f98637e560462ee98db1f2888f141124ee64ca"
      ],
      "data": "0x0000000000000000000000000000000000000000000000000000000006e7df97",
      "blockHash": "0x801f9b08c43e9363292af641cd5a950bfa74e248314f2967a1bbc9693ed8089e",
      "blockNumber": "0x3a64324",
      "blockTimestamp": "0x6acf62eb",
      "transactionHash": "0xd67cbf7e2578c7395d5a3fee940aea1d202cfd6dfeb836d924354dccdc3591ae",
      "transactionIndex": "0x6",
      "logIndex": "0x4",
      "removed": false
    }
  ]
}
```

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


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