# 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) — one of (discriminator: type):
    - AccountCreated:
      - `id` (string, required)
      - `type` (string, required)
        Enum: "AccountCreated"
    - AccountUpdated:
      - `id` (string, required)
      - `type` (string, required)
        Enum: "AccountUpdated"
    - AddressCreated:
      - `id` (string, required)
      - `accountReference` (object, required)
      - `accountReference.id` (string, required)
      - `accountReference.domainId` (string, required)
      - `type` (string, required)
        Enum: "AddressCreated"
    - BackupCreated:
      - `id` (string, required)
      - `type` (string, required)
        Enum: "BackupCreated"
    - BackupUpdated:
      - `id` (string, required)
      - `type` (string, required)
        Enum: "BackupUpdated"
    - BalancesUpdated:
      - `accountReference` (object, required)
      - `accountReference.id` (string, required)
      - `accountReference.domainId` (string, required)
      - `tickerIds` (array, required)
      - `type` (string, required)
        Enum: "BalancesUpdated"
    - DomainCreated:
      - `id` (string, required)
      - `parentId` (string, required)
      - `type` (string, required)
        Enum: "DomainCreated"
    - DomainUpdated:
      - `id` (string, required)
      - `parentId` (string)
      - `type` (string, required)
        Enum: "DomainUpdated"
    - EndpointCreated:
      - `id` (string, required)
      - `type` (string, required)
        Enum: "EndpointCreated"
    - EndpointUpdated:
      - `id` (string, required)
      - `type` (string, required)
        Enum: "EndpointUpdated"
    - GenesisSucceeded:
      - `apiPublicKey` (string, required)
      - `messagingPublicKey` (string, required)
      - `genesis` (object)
        Complete genesis payload, copied in and signed by the notary at genesis.
      - `genesis.data` (object, required)
      - `genesis.data.executedAt` (string, required)
      - `genesis.data.payload` (object, required)
      - `genesis.data.payload.rootDomainSetup` (object, required)
      - `genesis.data.payload.rootDomainSetup.id` (string, required)
      - `genesis.data.payload.rootDomainSetup.alias` (string, required)
      - `genesis.data.payload.rootDomainSetup.lock` (string, required)
        Enum: "Unlocked", "Locked"
      - `genesis.data.payload.rootDomainSetup.governingStrategy` (string)
        Enum: "ConsiderDescendants", "CoerceDescendants"
      - `genesis.data.payload.rootDomainSetup.permissions` (object, required)
      - `genesis.data.payload.rootDomainSetup.permissions.readAccess` (object, required)
      - `genesis.data.payload.rootDomainSetup.description` (string)
      - `genesis.data.payload.rootDomainSetup.customProperties` (object, required)
      - `genesis.data.payload.rootDomainSetup.users` (array, required)
      - `genesis.data.payload.rootDomainSetup.policies` (array, required)
      - `genesis.data.payload.rootDomainSetup.descendants` (array)
      - `genesis.data.payload.cryptoSetup` (object, required)
      - `genesis.data.payload.cryptoSetup.apiSigning` (string, required)
        Enum: "Secp256r1", "Secp256k1", "Ed25519"
      - `genesis.data.payload.cryptoSetup.collectionSigning` (string, required)
        Enum: same as `genesis.data.payload.cryptoSetup.apiSigning` in "GenesisSucceeded" (3 values)
      - `genesis.data.payload.cryptoSetup.messageSigning` (string, required)
        Enum: same as `genesis.data.payload.cryptoSetup.apiSigning` in "GenesisSucceeded" (3 values)
      - `genesis.data.payload.tickers` (array)
      - `genesis.data.payload.tickers.id` (string, required)
      - `genesis.data.payload.tickers.ledgerId` (string, required)
      - `genesis.data.payload.tickers.kind` (string, required)
        Enum: "Native", "Contract", "Token"
      - `genesis.data.payload.tickers.name` (string, required)
      - `genesis.data.payload.tickers.decimals` (integer)
      - `genesis.data.payload.tickers.symbol` (string)
      - `genesis.data.payload.tickers.ledgerDetails` (any, required)
      - `genesis.data.payload.tickers.lock` (string, required)
        Enum: same as `genesis.data.payload.rootDomainSetup.lock` in "GenesisSucceeded" (2 values)
      - `genesis.data.payload.tickers.description` (string)
      - `genesis.data.payload.tickers.customProperties` (object, required)
      - `genesis.data.payload.systemProperties` (array)
        - `value` (object, required)
        - `value.publicKey` (any, required)
        - `type` (string, required)
          Enum: "StateReviewAuthorityProperty"
      - `genesis.data.payload.ledgers` (array)
      - `genesis.data.payload.ledgers.id` (string, required)
      - `genesis.data.payload.ledgers.alias` (string, required)
      - `genesis.data.payload.ledgers.parameters` (any, required)
      - `genesis.data.payload.ledgers.description` (string)
      - `genesis.data.payload.ledgers.customProperties` (object, required)
      - `genesis.signature` (string, required)
      - `createdEntitiesReferences` (object)
        A list of all entities created during genesis.
      - `createdEntitiesReferences.rootUsers` (array, required)
      - `createdEntitiesReferences.rootUsers.id` (string, required)
      - `createdEntitiesReferences.rootPolicies` (array, required)
      - `createdEntitiesReferences.rootPolicies.id` (string, required)
      - `type` (string, required)
        Enum: "GenesisSucceeded"
    - IntentClosed:
      - `id` (string, required)
      - `type` (string, required)
        Enum: "IntentClosed"
    - IntentCreated:
      - `id` (string, required)
      - `type` (string, required)
        Enum: "IntentCreated"
    - IntentExecuted:
      - `id` (string, required)
      - `type` (string, required)
        Enum: "IntentExecuted"
    - IntentUpdated:
      - `id` (string, required)
      - `type` (string, required)
        Enum: "IntentUpdated"
    - LedgerCreated:
      - `id` (string, required)
      - `type` (string, required)
        Enum: "LedgerCreated"
    - LedgerUpdated:
      - `id` (string, required)
      - `type` (string, required)
        Enum: "LedgerUpdated"
    - ManifestCreated:
      - `id` (string, required)
      - `accountId` (string)
      - `type` (string, required)
        Enum: "ManifestCreated"
    - ManifestUpdated:
      - `id` (string, required)
      - `accountId` (string)
      - `type` (string, required)
        Enum: "ManifestUpdated"
    - PolicyCreated:
      - `id` (string, required)
      - `type` (string, required)
        Enum: "PolicyCreated"
    - PolicyUpdated:
      - `id` (string, required)
      - `type` (string, required)
        Enum: "PolicyUpdated"
    - SystemPropertySet:
      - `id` (string, required)
        Enum: "NOTARY_COMMUNICATION_KEY", "NOTARY_COLLECTIONS_KEY", "NOTARY_API_KEY", "STATE_REVIEW_AUTHORITY"
      - `type` (string, required)
        Enum: "SystemPropertySet"
    - TickerCreated:
      - `id` (string, required)
      - `type` (string, required)
        Enum: "TickerCreated"
    - TickerUpdated:
      - `id` (string, required)
      - `type` (string, required)
        Enum: "TickerUpdated"
    - TransactionCreated:
      - `id` (string, required)
      - `senderReferences` (array, required)
      - `senderReferences.id` (string, required)
      - `senderReferences.domainId` (string, required)
      - `type` (string, required)
        Enum: "TransactionCreated"
    - TransactionDetected:
      - `id` (string, required)
      - `accountReferences` (array, required)
      - `accountReferences.id` (string, required)
      - `accountReferences.domainId` (string, required)
      - `type` (string, required)
        Enum: "TransactionDetected"
    - TransactionUpdated:
      - `id` (string, required)
      - `accountReferences` (array, required)
      - `accountReferences.id` (string, required)
      - `accountReferences.domainId` (string, required)
      - `type` (string, required)
        Enum: "TransactionUpdated"
    - TransferUpdated:
      - `id` (string, required)
      - `type` (string, required)
        Enum: "TransferUpdated"
    - TrustedPublicKeyAdded:
      - `publicKey` (string, required)
      - `signingPurpose` (string, required)
        Enum: "ApiSignatures", "TrustedCollectionSignatures", "MessagingSignatures"
      - `type` (string, required)
        Enum: "TrustedPublicKeyAdded"
    - TrustedPublicKeyUpdated:
      - `publicKey` (string, required)
      - `signingPurpose` (string, required)
        Enum: same as `signingPurpose` in "TrustedPublicKeyAdded" (3 values)
      - `type` (string, required)
        Enum: "TrustedPublicKeyUpdated"
    - UserCreated:
      - `id` (string, required)
      - `type` (string, required)
        Enum: "UserCreated"
    - UserUpdated:
      - `id` (string, required)
      - `type` (string, required)
        Enum: "UserUpdated"
    - VaultCreated:
      - `id` (string, required)
      - `type` (string, required)
        Enum: "VaultCreated"
    - VaultUpdated:
      - `id` (string, required)
      - `type` (string, required)
        Enum: "VaultUpdated"

  - `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)