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

## 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": "0xb8ce59fc3717ada4c02eadf9682a9e934f625ebb",
      "topics": [
        "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
        "0x0000000000000000000000000740557b450b5a8a2154af30f75c7f4c4aa03c33",
        "0x000000000000000000000000fa1711c6513b09b13ee8aeef0dff266114b4e97c"
      ],
      "data": "0x0000000000000000000000000000000000000000000000000000000005638799",
      "blockHash": "0xfea405cc05c207915fd74418090b6cdf203b0700fd0c7f3aa127d9a7cc02bbe5",
      "blockNumber": "0x2214aa3",
      "blockTimestamp": "0x6ada16f5",
      "transactionHash": "0x0c2ab0695470c319a7eeac948d30ceebbfcc0a93858ba657541ffaa589c54fa7",
      "transactionIndex": "0x0",
      "logIndex": "0x0",
      "removed": false
    },
    {
      "address": "0xb8ce59fc3717ada4c02eadf9682a9e934f625ebb",
      "topics": [
        "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
        "0x00000000000000000000000065df770cadc47ff6889c818965fe48da670c7ad5",
        "0x000000000000000000000000fa1711c6513b09b13ee8aeef0dff266114b4e97c"
      ],
      "data": "0x0000000000000000000000000000000000000000000000000000000002faf080",
      "blockHash": "0xfea405cc05c207915fd74418090b6cdf203b0700fd0c7f3aa127d9a7cc02bbe5",
      "blockNumber": "0x2214aa3",
      "blockTimestamp": "0x6ada16f5",
      "transactionHash": "0xc4eb2a65ecf4e5ae869319864b4771a14d51491463b8cd8f26764db08def87f9",
      "transactionIndex": "0x1",
      "logIndex": "0x1",
      "removed": false
    },
    {
      "address": "0xb8ce59fc3717ada4c02eadf9682a9e934f625ebb",
      "topics": [
        "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
        "0x0000000000000000000000006fe717864674af94e5c7c8ff2ac83ee5c343bb87",
        "0x000000000000000000000000fa1711c6513b09b13ee8aeef0dff266114b4e97c"
      ],
      "data": "0x000000000000000000000000000000000000000000000000000000000050aeb0",
      "blockHash": "0xfea405cc05c207915fd74418090b6cdf203b0700fd0c7f3aa127d9a7cc02bbe5",
      "blockNumber": "0x2214aa3",
      "blockTimestamp": "0x6ada16f5",
      "transactionHash": "0x59037c58c1b18bd54e1b291431e4ecf82fb950b3737bcd630c7110d64d2f166b",
      "transactionIndex": "0x2",
      "logIndex": "0x2",
      "removed": false
    },
    {
      "address": "0xb8ce59fc3717ada4c02eadf9682a9e934f625ebb",
      "topics": [
        "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
        "0x0000000000000000000000000ae9d37cb1bbe5788154de94cf61bac7955205e4",
        "0x0000000000000000000000008454d827b30df013932f921c48e21b1ea2e79181"
      ],
      "data": "0x000000000000000000000000000000000000000000000000000000000011b340",
      "blockHash": "0xfea405cc05c207915fd74418090b6cdf203b0700fd0c7f3aa127d9a7cc02bbe5",
      "blockNumber": "0x2214aa3",
      "blockTimestamp": "0x6ada16f5",
      "transactionHash": "0xf56d10f47c9c70ec91fef85b9e88f5e54aec650a8c185a0cecad11ef9c467a7f",
      "transactionIndex": "0x3",
      "logIndex": "0x3",
      "removed": false
    },
    {
      "address": "0xb8ce59fc3717ada4c02eadf9682a9e934f625ebb",
      "topics": [
        "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
        "0x0000000000000000000000002a4a9a6c89f2de942c8e2938c1d8495495720a17",
        "0x000000000000000000000000cb44d8be5aa5b4dddcd6ef5948a2cc83412a1433"
      ],
      "data": "0x0000000000000000000000000000000000000000000000000000000000000116",
      "blockHash": "0xfea405cc05c207915fd74418090b6cdf203b0700fd0c7f3aa127d9a7cc02bbe5",
      "blockNumber": "0x2214aa3",
      "blockTimestamp": "0x6ada16f5",
      "transactionHash": "0xb4abdf4261a56707385e8141c6ba0c25ff968d040f6d0ffd1bcbae55db36e26b",
      "transactionIndex": "0x6",
      "logIndex": "0x8d5",
      "removed": false
    },
    {
      "address": "0xb8ce59fc3717ada4c02eadf9682a9e934f625ebb",
      "topics": [
        "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
        "0x000000000000000000000000cb44d8be5aa5b4dddcd6ef5948a2cc83412a1433",
        "0x000000000000000000000000a0926801a2abc718822a60d8fa1bc2a51fa09f1e"
      ],
      "data": "0x0000000000000000000000000000000000000000000000000000000000000116",
      "blockHash": "0xfea405cc05c207915fd74418090b6cdf203b0700fd0c7f3aa127d9a7cc02bbe5",
      "blockNumber": "0x2214aa3",
      "blockTimestamp": "0x6ada16f5",
      "transactionHash": "0xb4abdf4261a56707385e8141c6ba0c25ff968d040f6d0ffd1bcbae55db36e26b",
      "transactionIndex": "0x6",
      "logIndex": "0x8d7",
      "removed": false
    },
    {
      "address": "0xb8ce59fc3717ada4c02eadf9682a9e934f625ebb",
      "topics": [
        "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
        "0x000000000000000000000000a0926801a2abc718822a60d8fa1bc2a51fa09f1e",
        "0x000000000000000000000000e98c1e28805a06f23b41cf6d356dfc7709db9385"
      ],
      "data": "0x0000000000000000000000000000000000000000000000000000000000000000",
      "blockHash": "0xfea405cc05c207915fd74418090b6cdf203b0700fd0c7f3aa127d9a7cc02bbe5",
      "blockNumber": "0x2214aa3",
      "blockTimestamp": "0x6ada16f5",
      "transactionHash": "0xb4abdf4261a56707385e8141c6ba0c25ff968d040f6d0ffd1bcbae55db36e26b",
      "transactionIndex": "0x6",
      "logIndex": "0x8d8",
      "removed": false
    },
    {
      "address": "0xb8ce59fc3717ada4c02eadf9682a9e934f625ebb",
      "topics": [
        "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
        "0x000000000000000000000000a0926801a2abc718822a60d8fa1bc2a51fa09f1e",
        "0x000000000000000000000000539b388171d6be78cad937f5b0aaf9670f801574"
      ],
      "data": "0x0000000000000000000000000000000000000000000000000000000000000000",
      "blockHash": "0xfea405cc05c207915fd74418090b6cdf203b0700fd0c7f3aa127d9a7cc02bbe5",
      "blockNumber": "0x2214aa3",
      "blockTimestamp": "0x6ada16f5",
      "transactionHash": "0xb4abdf4261a56707385e8141c6ba0c25ff968d040f6d0ffd1bcbae55db36e26b",
      "transactionIndex": "0x6",
      "logIndex": "0x8d9",
      "removed": false
    }
  ]
}
```

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


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