> ## Documentation Index
> Fetch the complete documentation index at: https://docs.uniblock.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# suix_queryEvents

> Return list of events for a specified query criteria.

### Parameters

<ParamField query="chainId" type="string" default="sui" required>
  Unique identifier for a blockchain network.
</ParamField>

<ParamField body="id" type="number" default={1} required>
  Request identifier used to match responses.
</ParamField>

<ParamField body="jsonrpc" type="string" default="2.0" required>
  JSON-RPC version.
</ParamField>

<ParamField body="method" type="string" default="suix_queryEvents" required>
  JSON-RPC method name.
</ParamField>

<ParamField body="params" type="object" default={[{"MoveModule":{"package":"0xa395759ca37c6e1ffc179184e98a6f9a2da5d78f6e34b0e5044ed52a6bc0a1bc","module":"test"}},{"txDigest":"Eg3ynETJfTfPKyvJzq3VLG6MngURYHPMjjUJ3Xt1t7tf","eventSeq":"1"},100,false]} placeholder="[{&#x22;MoveModule&#x22;:{&#x22;package&#x22;:&#x22;0xa395759ca37c6e1ffc179184e98a6f9a2da5d78f6e34b0e5044ed52a6bc0a1bc&#x22;,&#x22;module&#x22;:&#x22;test&#x22;}},{&#x22;txDigest&#x22;:&#x22;Eg3ynETJfTfPKyvJzq3VLG6MngURYHPMjjUJ3Xt1t7tf&#x22;,&#x22;eventSeq&#x22;:&#x22;1&#x22;},100,false]" required>
  Parameters for suix\_queryEvents: \[query, cursor, limit, descending\_order]. The query object specifies event filter criteria. Cursor, limit, and descending\_order are optional.

  Positional parameters for <code>suix\_queryEvents</code>:

  <ul>
    <li><code>params\[0]</code>: Event query criteria object. See Event filter documentation for examples.</li>
    <li><code>params\[1]</code>: Optional paging cursor. If provided, the query will start from the next item after this cursor.</li>
    <li><code>params\[2]</code>: Maximum number of items per page. Defaults to QUERY\_MAX\_RESULT\_LIMIT if not specified.</li>
    <li><code>params\[3]</code>: Query result ordering. Default is false (ascending order, oldest record first).</li>
  </ul>
</ParamField>

### Returns

<ResponseField name="result" type="object">
  The response object for suix\_queryEvents. Contains an array of event objects and pagination information.

  <Expandable title="properties">
    <ResponseField name="data" type="array">
      An array of event objects matching the specified query criteria.

      <Expandable title="items">
        <ResponseField name="items[]" type="object">
          Event object with event details.
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="hasNextPage" type="boolean">
      Indicates whether there are more pages available beyond the current page.
    </ResponseField>

    <ResponseField name="nextCursor" type="oneOf">
      Paging cursor for the next page. If present, use it to fetch the next page; if null, the current page is the last one.

      <Expandable title="variants">
        <ResponseField name="variant1" type="string" />

        <ResponseField name="variant2" type="string" />
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash Curl theme={null}
  curl --request POST \
    --url https://api.uniblock.dev/uni/v1/json-rpc?chainId=sui \
    --header 'content-type: application/json' \
    --data '{
      "id": 1,
      "jsonrpc": "2.0",
      "method": "suix_queryEvents",
      "params": [
        {
          "MoveModule": {
            "package": "0xa395759ca37c6e1ffc179184e98a6f9a2da5d78f6e34b0e5044ed52a6bc0a1bc",
            "module": "test"
          }
        },
        {
          "txDigest": "Eg3ynETJfTfPKyvJzq3VLG6MngURYHPMjjUJ3Xt1t7tf",
          "eventSeq": "1"
        },
        100,
        false
      ]
    }'
  ```
</RequestExample>

<ResponseExample>
  ```json Success theme={null}
  {
    "jsonrpc": "2.0",
    "id": 1,
    "result": {
      "data": [
        {
          "id": {
            "__truncated": true
          },
          "packageId": "0xb2fd632992b01aa25900867288b63d6255ff8223c12b0fd985c49d5777a0d65a",
          "transactionModule": "test",
          "sender": "0xcceee09f44d558691334ec0aff47af033f57162a2f33056e2585e2c46863ac02",
          "type": "0x3::test::Test<0x3::test::Test>",
          "parsedJson": "some_value",
          "bcsEncoding": "base64",
          "bcs": ""
        },
        {
          "id": {
            "__truncated": true
          },
          "packageId": "0xb2fd632992b01aa25900867288b63d6255ff8223c12b0fd985c49d5777a0d65a",
          "transactionModule": "test",
          "sender": "0x84bd999f9ff7a1804872957fafa528628a24386298faa98850887f64da841b87",
          "type": "0x3::test::Test<0x3::test::Test>",
          "parsedJson": "some_value",
          "bcsEncoding": "base64",
          "bcs": ""
        },
        {
          "id": {
            "__truncated": true
          },
          "packageId": "0xb2fd632992b01aa25900867288b63d6255ff8223c12b0fd985c49d5777a0d65a",
          "transactionModule": "test",
          "sender": "0x279efd098d59a66a3d9adc87cce81fe9ec69dc8105b2b60140589ec8be44c29f",
          "type": "0x3::test::Test<0x3::test::Test>",
          "parsedJson": "some_value",
          "bcsEncoding": "base64",
          "bcs": ""
        },
        {
          "id": {
            "__truncated": true
          },
          "packageId": "0xb2fd632992b01aa25900867288b63d6255ff8223c12b0fd985c49d5777a0d65a",
          "transactionModule": "test",
          "sender": "0x289be027d2a94f744b4c59fda7b528f9c59f430eaba84b8bee9b43a30f9cc83f",
          "type": "0x3::test::Test<0x3::test::Test>",
          "parsedJson": "some_value",
          "bcsEncoding": "base64",
          "bcs": ""
        }
      ],
      "nextCursor": {
        "txDigest": "Eg3ynETJfTfPKyvJzq3VLG6MngURYHPMjjUJ3Xt1t7tf",
        "eventSeq": "1"
      },
      "hasNextPage": false
    }
  }
  ```
</ResponseExample>