---
title: "List events"
method: GET
path: "/v1/domains/{domainId}/events"
tags: ["Events"]
---

# List events

`GET /v1/domains/{domainId}/events`

## Path parameters

- `domainId` string, uuid, required

## Query parameters

- `limit` integer
- `startingAfter` string, uuid
- `sortBy` 'sequenceNumber'
- `sortOrder` 'ASC' | 'DESC'
- `scope` 'Self' | 'SelfAndDescendants'

## Response `200`

- CoreEventsCollection
  - `items` CoreHarmonizeEvent[], required
    - `domainId` string, uuid, required
    - `payload` union, required
      - CoreAccountCreated
        - `id` string, uuid, required
        - `type` 'AccountCreated', required
      - CoreAccountUpdated
        - `id` string, uuid, required
        - `type` 'AccountUpdated', required
      - CoreAddressCreated
        - `id` string, uuid, required
        - `accountReference` CoreAccountReference, required
          - `id` string, uuid, required
          - `domainId` string, uuid, required
        - `type` 'AddressCreated', required
      - CoreBackupCreated
        - `id` string, uuid, required
        - `type` 'BackupCreated', required
      - CoreBackupUpdated
        - `id` string, uuid, required
        - `type` 'BackupUpdated', required
      - CoreBalancesUpdated
        - `accountReference` CoreAccountReference, required
          - `id` string, uuid, required
          - `domainId` string, uuid, required
        - `tickerIds` string[], required
        - `type` 'BalancesUpdated', required
      - CoreComplianceConfigurationUpdated
        - `accountReference` CoreAccountReference, required
          - `id` string, uuid, required
          - `domainId` string, uuid, required
        - `skipQuarantineFrom` 'None' | 'Domain' | 'Instance', required
        - `revision` integer, required
        - `modifiedBy` CoreUserReference
          - `id` string, uuid, required
          - `domainId` string, uuid, required
        - `type` 'ComplianceConfigurationUpdated', required
      - CoreDomainCreated
        - `id` string, uuid, required
        - `parentId` string, uuid, required
        - `type` 'DomainCreated', required
      - CoreDomainUpdated
        - `id` string, uuid, required
        - `parentId` string, uuid
        - `type` 'DomainUpdated', required
      - CoreEndpointCreated
        - `id` string, uuid, required
        - `type` 'EndpointCreated', required
      - CoreEndpointUpdated
        - `id` string, uuid, required
        - `type` 'EndpointUpdated', required
      - CoreGenesisSucceeded
        - `apiPublicKey` string, base64, required
        - `messagingPublicKey` string, base64, required
        - `genesis` CoreGenesis — Complete genesis payload, copied in and signed by the notary at genesis.
          - `data` CoreGenesisData, required
            - `executedAt` string, date-time, required
            - `payload` CoreGenesisPayload, required
              - …
          - `signature` string, base64, required
        - `createdEntitiesReferences` CoreCreatedEntitiesReferences — A list of all entities created during genesis.
          - `rootUsers` CoreCreatedEntitiesReferencesUser[], required
            - `id` string, uuid, required
          - `rootPolicies` CoreCreatedEntitiesReferencesPolicy[], required
            - `id` string, uuid, required
        - `systemSignaturesPublicKey` string, base64
        - `type` 'GenesisSucceeded', required
      - CoreIntentClosed
        - `id` string, uuid, required
        - `type` 'IntentClosed', required
      - CoreIntentCreated
        - `id` string, uuid, required
        - `type` 'IntentCreated', required
      - CoreIntentExecuted
        - `id` string, uuid, required
        - `type` 'IntentExecuted', required
      - CoreIntentUpdated
        - `id` string, uuid, required
        - `type` 'IntentUpdated', required
      - CoreLedgerCreated
        - `id` string, required
        - `type` 'LedgerCreated', required
      - CoreLedgerUpdated
        - `id` string, required
        - `type` 'LedgerUpdated', required
      - CoreManifestCreated
        - `id` string, uuid, required
        - `accountId` string, uuid
        - `type` 'ManifestCreated', required
      - CoreManifestUpdated
        - `id` string, uuid, required
        - `accountId` string, uuid
        - `type` 'ManifestUpdated', required
      - CorePolicyCreated
        - `id` string, uuid, required
        - `type` 'PolicyCreated', required
      - CorePolicyUpdated
        - `id` string, uuid, required
        - `type` 'PolicyUpdated', required
      - CoreQuarantineApplied
        - `transferId` string, uuid, required
        - `type` 'QuarantineApplied', required
      - CoreQuarantineSkipped
        - `transferId` string, uuid, required
        - `type` 'QuarantineSkipped', required
      - CoreSystemPropertySet
        - `id` 'NOTARY_COMMUNICATION_KEY' | 'NOTARY_COLLECTIONS_KEY' | 'NOTARY_API_KEY' | 'STATE_REVIEW_AUTHORITY' | 'NOTARY_SYSTEM_SIGNING_KEY' | 'NOTARY_SYSTEM_SIGNED_INTENTS_ENABLED', required
        - `type` 'SystemPropertySet', required
      - CoreTickerCreated
        - `id` string, uuid, required
        - `type` 'TickerCreated', required
      - CoreTickerUpdated
        - `id` string, uuid, required
        - `type` 'TickerUpdated', required
      - CoreTransactionCreated
        - `id` string, uuid, required
        - `senderReferences` CoreAccountReference[], required
          - `id` string, uuid, required
          - `domainId` string, uuid, required
        - `type` 'TransactionCreated', required
      - CoreTransactionDetected
        - `id` string, uuid, required
        - `accountReferences` CoreAccountReference[], required
          - `id` string, uuid, required
          - `domainId` string, uuid, required
        - `type` 'TransactionDetected', required
      - CoreTransactionUpdated
        - `id` string, uuid, required
        - `accountReferences` CoreAccountReference[], required
          - `id` string, uuid, required
          - `domainId` string, uuid, required
        - `type` 'TransactionUpdated', required
      - CoreTransferUpdated
        - `id` string, uuid, required
        - `type` 'TransferUpdated', required
      - CoreTrustedPublicKeyAdded
        - `publicKey` string, base64, required
        - `signingPurpose` 'ApiSignatures' | 'TrustedCollectionSignatures' | 'MessagingSignatures' | 'SystemSignatures', required
        - `type` 'TrustedPublicKeyAdded', required
      - CoreTrustedPublicKeyUpdated
        - `publicKey` string, base64, required
        - `signingPurpose` 'ApiSignatures' | 'TrustedCollectionSignatures' | 'MessagingSignatures' | 'SystemSignatures', required
        - `type` 'TrustedPublicKeyUpdated', required
      - CoreUserCreated
        - `id` string, uuid, required
        - `type` 'UserCreated', required
      - CoreUserUpdated
        - `id` string, uuid, required
        - `type` 'UserUpdated', required
      - CoreVaultCreated
        - `id` string, uuid, required
        - `type` 'VaultCreated', required
      - CoreVaultKeyMaterialRewrapCompleted
        - `id` string, uuid, required
        - `type` 'VaultKeyMaterialRewrapCompleted', required
      - CoreVaultKeyMaterialRewrapFailed
        - `id` string, uuid, required
        - `type` 'VaultKeyMaterialRewrapFailed', required
      - CoreVaultUpdated
        - `id` string, uuid, required
        - `type` 'VaultUpdated', required
    - `id` string, uuid, required
    - `sequenceNumber` integer, required
    - `savedAt` string, date-time, required
  - `count` integer, required
  - `currentStartingAfter` string
  - `nextStartingAfter` string

## Other responses

- `400` — One of: Domain locked (DomainLockedError); Requester locked (RequesterLockedError)
- `401` — One of: Invalid JWT (InvalidJwtError); User not authorized (PermissionDeniedError)
- `404` — Entity or Domain not found (EntityNotFoundError)

---

[API](https://skmtc.net/ripple/apis/ripple-custody-api.md) · [All operations](https://skmtc.net/ripple/apis/ripple-custody-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ripple/ripple-custody-api/revisions/0b55c0ddf07a/schema)