> For the complete documentation index, see [llms.txt](https://docs.fonscan.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.fonscan.io/scanapi/rpc-api-endpoints/logs.md).

# Logs

{% hint style="success" %}

### &#x20;`https://fonscan.io/api?module=logs`

{% endhint %}

## Get Event Logs by Address and/or Topic(s)

`getLogs`

Event logs for an address and topic. Use **and/or** with the topic operator to specify topic retrieval options when adding multiple topics. Up to a maximum of 1,000 event logs.

**Example:**

```
https://fonscan.io/api
   ?module=logs
   &action=getLogs
   &fromBlock=1379224
   &toBlock=13792288
   &address=0x33990122638b9132ca29c723bdf037f1a891a70c
   &topic0=0xf63780e752c6a54a94fc52715dbc5518a3b4c3c2833d301a204226548a2a8545
   &topic1=0x72657075746174696f6e00000000000000000000000000000000000000000000
   &topic0_1_opr=or
```

{% tabs %}
{% tab title="Request params" %}
***\*=required field***

<table><thead><tr><th width="286">Parameter</th><th>Description</th></tr></thead><tbody><tr><td>fromBlock*</td><td><code>integer</code> block number to start searching for logs. <code>latest</code> is also supported</td></tr><tr><td>toBlock*</td><td><code>integer</code> block number to stop searching for logs. <code>latest</code> is also supported.<br><br><em>Note can be same as fromBlock if looking at logs for a single block</em></td></tr><tr><td>address*</td><td><code>string</code> 160-bit code used for identifying contracts. An address and/or topic is required.</td></tr><tr><td>topic0*</td><td><code>string</code> for first required topic.</td></tr><tr><td>topic1</td><td><code>string</code> for 2nd optional topic.</td></tr><tr><td>topic2</td><td><code>string</code> for 3rd optional topic.</td></tr><tr><td>topic3</td><td><code>string</code> for 4th optional topic.</td></tr><tr><td>topic0_1_opr</td><td>operator when topic 0 and 1 are used. Either <code>and</code> or <code>or</code></td></tr><tr><td>topic0_2_opr</td><td>operator for topic 0 and topic 2. Either <code>and</code> or <code>or</code></td></tr><tr><td>topic0_3_opr</td><td>operator for topic 0 and topic 3. Either <code>and</code> or <code>or</code></td></tr><tr><td>topic1_2_opr</td><td>operator for topic 1 and topic 2. Either <code>and</code> or <code>or</code></td></tr><tr><td>topic1_3_opr</td><td>the topic operator for topic 1 and topic 3. Either <code>and</code> or <code>or</code></td></tr><tr><td>topic2_3_opr</td><td>the topic operator for topic 2 and topic 3. Either <code>and</code> or <code>or</code></td></tr></tbody></table>
{% endtab %}

{% tab title="Example  Result" %}

```
{
  "message": "OK",
  "result": [
    {
      "address": "0x33990122638b9132ca29c723bdf037f1a891a70c",
      "blockNumber": "0x5c958",
      "data": "0x",
      "gasPrice": "0xba43b7400",
      "gasUsed": "0x10682",
      "logIndex": "0x",
      "timeStamp": "0x561d688c",
      "topics": [
        "0xf63780e752c6a54a94fc52715dbc5518a3b4c3c2833d301a204226548a2a8545",
        "0x72657075746174696f6e00000000000000000000000000000000000000000000",
        "0x000000000000000000000000d9b2f59f3b5c7b3c67047d2f03c3e8052470be92"
      ],
      "transactionHash": "0x0b03498648ae2da924f961dda00dc6bb0a8df15519262b7e012b7d67f4bb7e83",
      "transactionIndex": "0x"
    }
  ],
  "status": "1"
}
```

{% endtab %}
{% endtabs %}
