# List events

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

## Security:

  - `httpAuth` (unknown)
    http bearer

## 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.

  - `sortOrder` (string)
    Sort order applied to the query results.

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

## Response 200 fields (application/json):

  - `items` (array, required)

  - `items.domainId` (string, required)

  - `items.payload` (any, required)

  - `items.payload.id` (string, required)

  - `items.payload.type` (string, required)
    Enum: "AccountCreated", "AccountUpdated", "AddressCreated", "BackupCreated", "BackupUpdated", "BalancesUpdated", "ComplianceConfigurationUpdated", "DomainCreated", "DomainUpdated", "EndpointCreated", "EndpointUpdated", "GenesisSucceeded", "IntentClosed", "IntentCreated", "IntentExecuted", "IntentUpdated", "LedgerCreated", "LedgerUpdated", "ManifestCreated", "ManifestUpdated", "PolicyCreated", "PolicyUpdated", "QuarantineApplied", "QuarantineSkipped", "SystemPropertySet", "TickerCreated", "TickerUpdated", "TransactionCreated", "TransactionDetected", "TransactionUpdated", "TransferUpdated", "TrustedPublicKeyAdded", "TrustedPublicKeyUpdated", "UserCreated", "UserUpdated", "VaultCreated", "VaultKeyMaterialRewrapCompleted", "VaultKeyMaterialRewrapFailed", "VaultUpdated"

  - `items.payload.accountReference` (object, required)

  - `items.payload.accountReference.id` (string, required)

  - `items.payload.accountReference.domainId` (string, required)

  - `items.payload.tickerIds` (array, required)

  - `items.payload.skipQuarantineFrom` (string, required)
    Enum: "None", "Domain", "Instance"

  - `items.payload.revision` (integer, required)

  - `items.payload.modifiedBy` (object)

  - `items.payload.modifiedBy.id` (string, required)

  - `items.payload.modifiedBy.domainId` (string, required)

  - `items.payload.parentId` (string, required)

  - `items.payload.apiPublicKey` (string, required)

  - `items.payload.messagingPublicKey` (string, required)

  - `items.payload.genesis` (object)
    Complete genesis payload, copied in and signed by the notary at genesis.

  - `items.payload.genesis.data` (object, required)

  - `items.payload.genesis.data.executedAt` (string, required)

  - `items.payload.genesis.data.payload` (object, required)

  - `items.payload.genesis.data.payload.rootDomainSetup` (object, required)

  - `items.payload.genesis.data.payload.rootDomainSetup.id` (string, required)

  - `items.payload.genesis.data.payload.rootDomainSetup.alias` (string, required)

  - `items.payload.genesis.data.payload.rootDomainSetup.lock` (string, required)
    Enum: "Unlocked", "Locked"

  - `items.payload.genesis.data.payload.rootDomainSetup.governingStrategy` (string)
    Enum: "ConsiderDescendants", "CoerceDescendants"

  - `items.payload.genesis.data.payload.rootDomainSetup.permissions` (object, required)

  - `items.payload.genesis.data.payload.rootDomainSetup.permissions.readAccess` (object, required)

  - `items.payload.genesis.data.payload.rootDomainSetup.permissions.readAccess.domains` (array, required)

  - `items.payload.genesis.data.payload.rootDomainSetup.permissions.readAccess.users` (array, required)

  - `items.payload.genesis.data.payload.rootDomainSetup.permissions.readAccess.endpoints` (array, required)

  - `items.payload.genesis.data.payload.rootDomainSetup.permissions.readAccess.policies` (array, required)

  - `items.payload.genesis.data.payload.rootDomainSetup.permissions.readAccess.accounts` (array, required)

  - `items.payload.genesis.data.payload.rootDomainSetup.permissions.readAccess.transactions` (array, required)

  - `items.payload.genesis.data.payload.rootDomainSetup.permissions.readAccess.requests` (array, required)

  - `items.payload.genesis.data.payload.rootDomainSetup.permissions.readAccess.events` (array, required)

  - `items.payload.genesis.data.payload.rootDomainSetup.description` (string)

  - `items.payload.genesis.data.payload.rootDomainSetup.customProperties` (object, required)

  - `items.payload.genesis.data.payload.rootDomainSetup.users` (array, required)

  - `items.payload.genesis.data.payload.rootDomainSetup.users.id` (string, required)

  - `items.payload.genesis.data.payload.rootDomainSetup.users.alias` (string, required)

  - `items.payload.genesis.data.payload.rootDomainSetup.users.publicKey` (string, required)

  - `items.payload.genesis.data.payload.rootDomainSetup.users.roles` (array, required)

  - `items.payload.genesis.data.payload.rootDomainSetup.users.description` (string)

  - `items.payload.genesis.data.payload.rootDomainSetup.users.loginIds` (array)
    Domain-unique `loginId`-`loginProviderId` pairs. Must be specified for login and match pre-configured values.

  - `items.payload.genesis.data.payload.rootDomainSetup.policies` (array, required)

  - `items.payload.genesis.data.payload.rootDomainSetup.policies.id` (string, required)

  - `items.payload.genesis.data.payload.rootDomainSetup.policies.alias` (string, required)

  - `items.payload.genesis.data.payload.rootDomainSetup.policies.rank` (integer, required)

  - `items.payload.genesis.data.payload.rootDomainSetup.policies.intentTypes` (array)

  - `items.payload.genesis.data.payload.rootDomainSetup.policies.scope` (string, required)
    Enum: "Self", "Descendants", "SelfAndDescendants"

  - `items.payload.genesis.data.payload.rootDomainSetup.policies.scriptingEngine` (string, required)
    Enum: "Javascript_v0"

  - `items.payload.genesis.data.payload.rootDomainSetup.policies.condition` (any)
    Example: {"left":{"left":{"expression":"true == true","type":"Expression"},"right":{"expression":"false == true","type":"Expression"},"type":"And"},"right":{"left":{"expression":"true == false","type":"Express…

  - `items.payload.genesis.data.payload.rootDomainSetup.policies.workflow` (array)

  - `items.payload.genesis.data.payload.rootDomainSetup.policies.description` (string)

  - `items.payload.genesis.data.payload.rootDomainSetup.policies.intentOrigin` (string)
    Enum: "UserSigned", "SystemSigned"

  - `items.payload.genesis.data.payload.rootDomainSetup.descendants` (array)

  - `items.payload.genesis.data.payload.rootDomainSetup.descendants.id` (string, required)

  - `items.payload.genesis.data.payload.rootDomainSetup.descendants.alias` (string, required)

  - `items.payload.genesis.data.payload.rootDomainSetup.descendants.description` (string)

  - `items.payload.genesis.data.payload.rootDomainSetup.descendants.users` (array, required)

  - `items.payload.genesis.data.payload.rootDomainSetup.descendants.policies` (array, required)

  - `items.payload.genesis.data.payload.rootDomainSetup.descendants.descendants` (array, required)

  - `items.payload.genesis.data.payload.cryptoSetup` (object, required)

  - `items.payload.genesis.data.payload.cryptoSetup.apiSigning` (string, required)
    Enum: "Secp256r1", "Secp256k1", "Ed25519"

  - `items.payload.genesis.data.payload.tickers` (array)

  - `items.payload.genesis.data.payload.tickers.id` (string, required)

  - `items.payload.genesis.data.payload.tickers.ledgerId` (string, required)

  - `items.payload.genesis.data.payload.tickers.kind` (string, required)
    Enum: "Native", "Contract", "Token"

  - `items.payload.genesis.data.payload.tickers.name` (string, required)

  - `items.payload.genesis.data.payload.tickers.decimals` (integer)

  - `items.payload.genesis.data.payload.tickers.symbol` (string)

  - `items.payload.genesis.data.payload.tickers.ledgerDetails` (any, required)

  - `items.payload.genesis.data.payload.tickers.description` (string)

  - `items.payload.genesis.data.payload.systemProperties` (array)

  - `items.payload.genesis.data.payload.systemProperties.value` (object, required)

  - `items.payload.genesis.data.payload.systemProperties.type` (string, required)
    Enum: "AntiRewindModeProperty", "NotarySystemSignedIntentsEnabledProperty", "StateReviewAuthorityProperty"

  - `items.payload.genesis.data.payload.ledgers` (array)

  - `items.payload.genesis.data.payload.ledgers.id` (string, required)

  - `items.payload.genesis.data.payload.ledgers.alias` (string, required)

  - `items.payload.genesis.data.payload.ledgers.parameters` (any, required)

  - `items.payload.genesis.data.payload.ledgers.description` (string)

  - `items.payload.genesis.data.payload.systemSignaturesPublicKey` (string)

  - `items.payload.genesis.data.payload.antiRewindMode` (string)
    Enum: "STRICT", "BALANCED", "DISABLED"

  - `items.payload.genesis.signature` (string, required)

  - `items.payload.createdEntitiesReferences` (object)
    A list of all entities created during genesis.

  - `items.payload.createdEntitiesReferences.rootUsers` (array, required)

  - `items.payload.createdEntitiesReferences.rootUsers.id` (string, required)

  - `items.payload.createdEntitiesReferences.rootPolicies` (array, required)

  - `items.payload.createdEntitiesReferences.rootPolicies.id` (string, required)

  - `items.payload.systemSignaturesPublicKey` (string)

  - `items.payload.accountId` (string)

  - `items.payload.transferId` (string, required)

  - `items.payload.id` (string, required)
    Enum: "NOTARY_COMMUNICATION_KEY", "NOTARY_COLLECTIONS_KEY", "NOTARY_API_KEY", "STATE_REVIEW_AUTHORITY", "NOTARY_SYSTEM_SIGNING_KEY", "NOTARY_SYSTEM_SIGNED_INTENTS_ENABLED", "ANTI_REWIND_MODE"

  - `items.payload.senderReferences` (array, required)

  - `items.payload.accountReferences` (array, required)

  - `items.payload.publicKey` (string, required)

  - `items.payload.signingPurpose` (string, required)
    Enum: "ApiSignatures", "TrustedCollectionSignatures", "MessagingSignatures", "SystemSignatures"

  - `items.id` (string, required)

  - `items.sequenceNumber` (integer, required)

  - `items.savedAt` (string, required)

  - `count` (integer, required)

  - `currentStartingAfter` (string)

  - `nextStartingAfter` (string)

## Response 400:

  - `400` (unknown)
    One of: Domain locked (DomainLockedError); Requester locked (RequesterLockedError)

## Response 400 fields (application/json):

  - `reason` (string, required)

  - `message` (string)

## Response 401:

  - `401` (unknown)
    One of: Invalid JWT (InvalidJwtError); User not authorized (PermissionDeniedError)

## Response 401 fields (application/json):

  - `reason` (string, required)

  - `message` (string)

## Response 404:

  - `404` (unknown)
    Entity or Domain not found (EntityNotFoundError)

## Response 404 fields (application/json):

  - `reason` (string, required)

  - `message` (string)