# List events

Endpoint: GET /v1/domains/{domainId}/events
Security: httpAuth

## Path parameters:

  - `domainId` (string, required)
    Unique identifier for the domain.

## Query parameters:

  - `limit` (integer)
    The number of entities to return.

  - `startingAfter` (string)
    Entity id used to the determine beginning of query results.

  - `sortBy` (string)
    Property name used to sort the query results.
    Enum: "sequenceNumber"

  - `sortOrder` (string)
    Sort order applied to the query results.
    Enum: "ASC", "DESC"

  - `scope` (string)
    Return events for scope of own domain, Self (default), or including subdomains, SelfAndDescendants.
    Enum: "Self", "SelfAndDescendants"

## Response 200 fields (application/json):

  - `items` (array, required)

  - `items.domainId` (string, required)

  - `items.payload` (any, required)

  - `items.id` (string, required)

  - `items.sequenceNumber` (integer, required)

  - `items.savedAt` (string, required)

  - `count` (integer, required)

  - `currentStartingAfter` (string)

  - `nextStartingAfter` (string)

## Response 400 fields (application/json):

  - `reason` (string, required)

  - `message` (string)