v1

latestOpenAPI 3.0.0MIT2026-07-17301524.5 KB

Get events matching the interest stored on the node

get/experimental/events/{sep}/{sepValue}

Path parameters

sepstring required

Name of the field in the Events header that holds the separator value e.g. 'model'

sepValuestring required

The value of the field in the Events header indicated by the separator key e.g. multibase encoded model ID

Query parameters

controllerstring

the controller to filter (DID string)

streamIdstring

the stream to filter (multibase encoded stream ID)

offsetinteger

token that designates the point to resume from, that is find keys added after this point

limitinteger

the maximum number of events to return, default is 10000.

Response

success

resumeOffsetinteger required

An integer specifying where to resume the request. Only works correctly for the same input parameters.

isCompleteboolean required

A boolean specifying if there are more events to be fetched. Repeat with the resumeOffset to get next set.

Example response

{
  "resumeOffset": 0,
  "events": [
    {
      "data": "data",
      "id": "id"
    },
    {
      "data": "data",
      "id": "id"
    }
  ],
  "isComplete": true
}