# eth\_getLogs

### Parameters

`Object` - filter options:

1. `fromBlock`: `Quantity` or `tag` (optional, default is `"latest"` if not specified) 

   \- choose 1 of the following options:

   * A hexadecimal block number.
   * `"earliest"` - the earliest/genesis block.
   * `"latest"` - the latest mined block.
   * `"safe"` - the latest safe head block.
   * `"finalized"` - the latest finalized block.
   * `"pending"` - the pending state/transactions.
2. `toBlock`: `Quantity` or `tag` (optional, default is `"latest"` if not specified) 

   \- choose 1 of the following options:

   * A hexadecimal block number.
   * `"earliest"` - the earliest/genesis block.
   * `"latest"` - the latest mined block.
   * `"safe"` - the latest safe head block.
   * `"finalized"` - the latest finalized block.
   * `"pending"` - the pending state/transactions.
3. `address`:  (optional) Contract address or a list of addresses from which logs should originate.
4. `topics`: (optional) Array of `DATA` topics. Topics are order-dependent. Each topic can also be an array of DATA with "or" options.
5. `blockhash`: (optional) restricts the logs returned to the given block. is equivalent to setting `fromBlock` and `toBlock` to the block number referenced in the `blockhash` If `blockhash` is present in the filter criteria, then neither `fromBlock` nor `toBlock` are allowed.

#### Sample Request

{% code overflow="wrap" %}

```
curl https://lb.nodies.app/v1/<INSERT URL> \
   -H "x-api-key: <API-KEY>" \
   -X POST \
   -H "Content-Type: application/json" \
   -d '{ 
  "jsonrpc": "2.0",
  "method": "eth_getLogs",
  "params": [
    {
      "blockhash": "0x729eea5dd371632d98ceffaadefedc33d245374786c5d181c7b3eec63ee7b36c"
    }
  ],
  "id": 1
}'
```

{% endcode %}

#### Sample Response

{% code overflow="wrap" %}

```
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": [
    {
      "address": "0x2754b28227f041a66c46509d5620782bfc4766ef",
      "topics": [
        "0xa64da754fccf55aa65a1f0128a648633fade3884b236e879ee9f64c78df5d5d7",
        "0x000000000000000000000000efdaf1cd0d539896c06644ebe5d7f81c650bacc2",
        "0x000000000000000000000000f32682d5f99ba4143532618d6f516859a055ea06",
        "0x0000000000000000000000000000000000000000000000000000000000000000"
      ],
      "data": "0x00000000000000000000000000000000000000000000000000729b123e2f0400",
      "blockNumber": "0x9265cd",
      "transactionHash": "0x8fef048a4b01804ba49d2a58e3d436c1c2a2abc1977a36b723a5c096e3b6f84e",
      "transactionIndex": "0x0",
      "blockHash": "0x729eea5dd371632d98ceffaadefedc33d245374786c5d181c7b3eec63ee7b36c",
      "logIndex": "0x0",
      "removed": false
    },
    {
      "address": "0xaaaebe6fe48e54f431b0c390cfaf0b017d09d42d",
      "topics": [
        "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
        "0x000000000000000000000000c12ad9ea067619637fbc74a3ac319dbc312f72af",
        "0x0000000000000000000000007481f00e17e0784477c6f6de5c31fe3cd4a84e47"
      ],
      "data": "0x00000000000000000000000000000000000000000000000000000000005c0f6e",
      "blockNumber": "0x9265cd",
      "transactionHash": "0xfb03571f4c000312792535c9d10e09647768112447709a041913e92dbff334bb",
      "transactionIndex": "0x1",
      "blockHash": "0x729eea5dd371632d98ceffaadefedc33d245374786c5d181c7b3eec63ee7b36c",
      "logIndex": "0x1",
      "removed": false
    },
    {
      "address": "0xa22c1b5320108c19db53f58241fd64b105562296",
      "topics": [
        "0xce7dc747411ac40191c5335943fcc79d8c2d8c01ca5ae83d9fed160409fa6120",
        "0x000000000000000000000000cb6b973b93d4d4be2753e7dffc11e26a220f4122",
        "0x000000000000000000000000cea488bfd550f775427c32ccb4fc080ef996b7f3"
      ],
      "data": "0x0000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000005e5d84fb",
      "blockNumber": "0x9265cd",
      "transactionHash": "0x041265c8d4610cbac6f4e46084ae70de2c049fe7fc895ef635ba34e50b73bf8a",
      "transactionIndex": "0x2",
      "blockHash": "0x729eea5dd371632d98ceffaadefedc33d245374786c5d181c7b3eec63ee7b36c",
      "logIndex": "0x2",
      "removed": false
    },
    {
      "address": "0xa22c1b5320108c19db53f58241fd64b105562296",
      "topics": [
        "0x9ea70f0eb33d898c3336ecf2c0e3cf1c0195c13ad3fbcb34447777dbfd5ff2d0",
        "0x000000000000000000000000cea488bfd550f775427c32ccb4fc080ef996b7f3"
      ],
      "data": "0x0000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000005e5d84fb",
      "blockNumber": "0x9265cd",
      "transactionHash": "0x041265c8d4610cbac6f4e46084ae70de2c049fe7fc895ef635ba34e50b73bf8a",
      "transactionIndex": "x2",
      "blockHash": "0x729eea5dd371632d98ceffaadefedc33d245374786c5d181c7b3eec63ee7b36c",
      "logIndex": "0x3",
      "removed": false
    }
  ]
}
```

{% endcode %}