# Logs

## Get Event Logs by Address

Returns the event logs from an address, with optional filtering by block range.

```
https://api.xdcscan.io/api
   ?module=logs
   &action=getLogs
   &address=0xbd3531da5cf5857e7cfaa92426877b022e612cf8
   &fromBlock=12878196
   &toBlock=12878196
   &page=1
   &offset=1000
   &apikey=YourApiKeyToken
```

> Try this endpoint in your [**browser**](https://api.xdcscan.io/api?module=logs\&action=getLogs\&address=0xbd3531da5cf5857e7cfaa92426877b022e612cf8\&fromBlock=12878196\&toBlock=12878196\&page=1\&offset=1000\&apikey=YourApiKeyToken) :link:

{% tabs %}
{% tab title="Request" %}
Query Parameters

| Parameter    | Description                                                                                                                                                                |
| ------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| address      | the `string` representing the address to check for logs                                                                                                                    |
| fromBlock    | the `integer` block number to start searching for logs eg. `12878196`                                                                                                      |
| toBlock      | the `integer` block number to stop searching for logs eg. `12879196`                                                                                                       |
| page         | the `integer` page number, if pagination is enabled                                                                                                                        |
| offset       | <p>the number of transactions displayed per page<br><br>limited to <strong>1000 records</strong> per query, use the <code>page</code> parameter for subsequent records</p> |
| {% endtab %} |                                                                                                                                                                            |

{% tab title="Response" %}
Sample Response

```
{
   "status":"1",
   "message":"OK",
   "result":[
      {
         "address":"0xbd3531da5cf5857e7cfaa92426877b022e612cf8",
         "topics":[
            "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
            "0x0000000000000000000000000000000000000000000000000000000000000000",
            "0x000000000000000000000000c45a4b3b698f21f88687548e7f5a80df8b99d93d",
            "0x00000000000000000000000000000000000000000000000000000000000000b5"
         ],
         "data":"0x",
         "blockNumber":"0xc48174",
         "timeStamp":"0x60f9ce56",
         "gasPrice":"0x2e90edd000",
         "gasUsed":"0x247205",
         "logIndex":"0x",
         "transactionHash":"0x4ffd22d986913d33927a392fe4319bcd2b62f3afe1c15a2c59f77fc2cc4c20a9",
         "transactionIndex":"0x"
      },
      {
         "address":"0xbd3531da5cf5857e7cfaa92426877b022e612cf8",
         "topics":[
            "0x645f26e653c951cec836533f8fe0616d301c20a17153debc17d7c3dbe4f32b28",
            "0x00000000000000000000000000000000000000000000000000000000000000b5"
         ],
         "data":"0x",
         "blockNumber":"0xc48174",
         "timeStamp":"0x60f9ce56",
         "gasPrice":"0x2e90edd000",
         "gasUsed":"0x247205",
         "logIndex":"0x1",
         "transactionHash":"0x4ffd22d986913d33927a392fe4319bcd2b62f3afe1c15a2c59f77fc2cc4c20a9",
         "transactionIndex":"0x"
      }
   ]
}
```

{% endtab %}
{% endtabs %}

## Get Event Logs by Topics

Returns the events log in a block range, filtered by topics.

```
https://api.xdcscan.io/api
   ?module=logs
   &action=getLogs
   &fromBlock=12878196
   &toBlock=12879196
   &topic0=0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef
   &topic0_1_opr=and
   &topic1=0x0000000000000000000000000000000000000000000000000000000000000000
   &page=1
   &offset=1000
   &apikey=YourApiKeyToken
```

Usage:

* For a single topic, specify the topic number such as `topic0`, `topic1`, `topic2`, `topic3`
* For multiple topics, specify the topic numbers **and** topic operator either `and` or `or` such as below\
  \
  topic0\_1\_opr (and|or between topic0 & topic1), topic1\_2\_opr (and|or between topic1 & topic2) topic2\_3\_opr (and|or between topic2 & topic3), topic0\_2\_opr (and|or between topic0 & topic2) topic0\_3\_opr (and|or between topic0 & topic3), topic1\_3\_opr (and|or between topic1 & topic3)

> Try this endpoint in your [**browser**](https://api.xdcscan.io/api?module=logs\&action=getLogs\&fromBlock=12878196\&toBlock=12879196\&topic0=0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef\&topic0_1_opr=and\&topic1=0x0000000000000000000000000000000000000000000000000000000000000000\&page=1\&offset=1000\&apikey=YourApiKeyToken) :link:

{% tabs %}
{% tab title="Request" %}
Query Parameters

| Parameter     | Description                                                                                                                                                                |
| ------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| fromBlock     | the `integer` block number to start searching for logs eg. `12878196`                                                                                                      |
| toBlock       | the `integer` block number to stop searching for logs eg. `12879196`                                                                                                       |
| topic         | <p>the topic numbers to search for<br><br>limited to<code>topic0</code>, <code>topic1</code>, <code>topic2</code>, <code>topic3</code></p>                                 |
| topicOperator | <p>the topic operator when multiple topic combinations are used<br><br>limited to <code>and</code> or <code>or</code></p>                                                  |
| page          | the `integer` page number, if pagination is enabled                                                                                                                        |
| offset        | <p>the number of transactions displayed per page<br><br>limited to <strong>1000 records</strong> per query, use the <code>page</code> parameter for subsequent records</p> |
| {% endtab %}  |                                                                                                                                                                            |

{% tab title="Response" %}
Sample Response

```
{
   "status":"1",
   "message":"OK",
   "result":[
      {
         "address":"0xbd3531da5cf5857e7cfaa92426877b022e612cf8",
         "topics":[
            "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
            "0x0000000000000000000000000000000000000000000000000000000000000000",
            "0x000000000000000000000000c45a4b3b698f21f88687548e7f5a80df8b99d93d",
            "0x00000000000000000000000000000000000000000000000000000000000000b5"
         ],
         "data":"0x",
         "blockNumber":"0xc48174",
         "timeStamp":"0x60f9ce56",
         "gasPrice":"0x2e90edd000",
         "gasUsed":"0x247205",
         "logIndex":"0x",
         "transactionHash":"0x4ffd22d986913d33927a392fe4319bcd2b62f3afe1c15a2c59f77fc2cc4c20a9",
         "transactionIndex":"0x"
      },
      {
         "address":"0xbd3531da5cf5857e7cfaa92426877b022e612cf8",
         "topics":[
            "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
            "0x0000000000000000000000000000000000000000000000000000000000000000",
            "0x000000000000000000000000c45a4b3b698f21f88687548e7f5a80df8b99d93d",
            "0x00000000000000000000000000000000000000000000000000000000000000b6"
         ],
         "data":"0x",
         "blockNumber":"0xc48174",
         "timeStamp":"0x60f9ce56",
         "gasPrice":"0x2e90edd000",
         "gasUsed":"0x247205",
         "logIndex":"0x2",
         "transactionHash":"0x4ffd22d986913d33927a392fe4319bcd2b62f3afe1c15a2c59f77fc2cc4c20a9",
         "transactionIndex":"0x"
      }
   ]
}
```

{% endtab %}
{% endtabs %}

## Get Event Logs by Address filtered by Topics

Returns the event logs from an address, filtered by topics and block range.

```
https://api.xdcscan.io/api
   ?module=logs
   &action=getLogs
   &fromBlock=15073139
   &toBlock=15074139
   &address=0x59728544b08ab483533076417fbbb2fd0b17ce3a
   &topic0=0x27c4f0403323142b599832f26acd21c74a9e5b809f2215726e244a4ac588cd7d
   &topic0_1_opr=and
   &topic1=0x00000000000000000000000023581767a106ae21c074b2276d25e5c3e136a68b
   &page=1
   &offset=1000
   &apikey=YourApiKeyToken
```

> Try this endpoint in your [**browser**](https://api.xdcscan.io/api?module=logs\&action=getLogs\&fromBlock=15073139\&toBlock=15074139\&address=0x59728544b08ab483533076417fbbb2fd0b17ce3a\&topic0=0x27c4f0403323142b599832f26acd21c74a9e5b809f2215726e244a4ac588cd7d\&topic0_1_opr=and\&topic1=0x00000000000000000000000023581767a106ae21c074b2276d25e5c3e136a68b\&page=1\&offset=1000\&apikey=YourApiKeyToken) :link:

{% tabs %}
{% tab title="Request" %}
Query Parameters

| Parameter     | Description                                                                                                                                                                |
| ------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| fromBlock     | the `integer` block number to start searching for logs eg. `12878196`                                                                                                      |
| toBlock       | the `integer` block number to stop searching for logs eg. `12879196`                                                                                                       |
| address       | the `string` representing the address to check for logs                                                                                                                    |
| topic         | <p>the topic numbers to search for<br><br>limited to<code>topic0</code>, <code>topic1</code>, <code>topic2</code>, <code>topic3</code></p>                                 |
| topicOperator | <p>the topic operator when multiple topic combinations are used<br><br>limited to <code>and</code> or <code>or</code></p>                                                  |
| page          | the `integer` page number, if pagination is enabled                                                                                                                        |
| offset        | <p>the number of transactions displayed per page<br><br>limited to <strong>1000 records</strong> per query, use the <code>page</code> parameter for subsequent records</p> |
| {% endtab %}  |                                                                                                                                                                            |

{% tab title="Response" %}
Sample Response

```
{
"message": "OK",
"status": "1"
}
```

{% endtab %}
{% endtabs %}