Event payload reference

You can track and respond to events in Ripple Custody domains using one of the following methods:

Events do not provide a detailed description of a state change, but are a starting point for requesting further information from the API.

For more information about querying events with the API, see Events in the API reference.

The different event types available are described below.

The genesis event is triggered upon successful completion of the system setup genesis operation. The event contains the following important public keys:

• apiPublicKey: to be used to validate the data integrity at the API level.
• messagingPublicKey: to be used by vaults to authenticate transaction processing requests.

The payload also includes the following blocks:

• createdEntitiesReferences: a list of all entities created
• genesis: the full genesis payload, execution time, and signature

Payload example:

{
    "domainId": "5cd224fe-193e-8bce-c94c-c6c05245e2d1",
    "payload": {
        "apiPublicKey": "MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAET1BnSIvToEO6r5BMmaG+O3GL0/A7JilzCdmJ3trIWIsXDuv8jAcGizraMouqWIHTx2hi3rxoH7eABURbfSSryw==",
        "messagingPublicKey": "MCowBQYDK2VwAyEAUGkt+kcvAT4vh+XSEL5Azv4XjjN4e+RojV2gr+Bu0Uk=",
        "type": "GenesisSucceeded",
        "createdEntitiesReferences": {
          "domains": [
            {
              "id": "70fe2431-0c7e-4251-aa69-8c960a4303b5",
              "parentDomainId": null | "27aef9d4-c41f-496b-a84b-89a0982f230d"
            }
          ],
          "users": [
            {
              "domainId": "70fe2431-0c7e-4251-aa69-8c960a4303b5",
              "id": "b9e2a9ca-2eb5-4cc3-98b1-0e9d3ec09129"
            }
          ],
          "policies": [
            {
              "domainId": "70fe2431-0c7e-4251-aa69-8c960a4303b5",
              "id": "8e7a40d3-b255-4a0a-8b80-13596bf566ae"
            }
          ],
          "tickers": [
            {
              "id": "def26868-39e0-4ad3-8f02-22d388409544"
            }
          ],
          "systemProperties": [
            {
              "id": "STATE_REVIEW_AUTHORITY"
            }
          ]
        },
        "genesis": null | {
          "data": {
            "executedAt": "2019-08-24T14:15:10Z",
            "payload": {
              "rootDomainSetup": {
              },
              "cryptoSetup": {
              },
              "tickers": [
              ],
              "systemProperties": [
              ]
            }
          },
          "signature": "<SIGNATURE>",
        }
      },
    },
    "id": "d1553d40-fbd9-3e44-ac7b-8cd59fa20c77",
    "sequenceNumber": 1,
    "savedAt": "2021-11-26T12:16:23.027Z"
}

The creation, update (due to an approval or rejection), execution, or closure (after final decision or expiry) of an intent triggers a corresponding event. The event exposes the id of the intent, which you can retrieve independently to view more details of the intent.

Payload examples:

{
    "domainId": "5cd224fe-193e-8bce-c94c-c6c05245e2d1",
    "payload": {
        "id": "6a9a5cc0-3536-46e2-b9b5-7533ee25a0eb",
        "type": "IntentCreated"
    },
    "id": "117d8e91-7dd8-3e5d-8e5e-1d11ac57e148",
    "sequenceNumber": 1989,
    "savedAt": "2022-01-10T17:27:09.902Z"
}

The following events typically follow an IntentClosed event, as the creation or update of an entity often follows intent closure.

Some entities, such as an account, transaction, or vault, need special processing steps after creation until they are fully operational. An Updated type event is triggered upon full creation of the entity.

The payload format is the same for all of these events except ManifestCreated and ManifestUpdated, which contain an additional accountId field.

Payload examples:

{
    "domainId": "5cd224fe-193e-8bce-c94c-c6c05245e2d1",
    "payload": {
        "id": "f0048a50-3988-4e31-9cbf-c4b6582d338d",
        "type": "AccountCreated"
    },
    "id": "f2803e98-2980-3324-9c69-430dfc88b8bc",
    "sequenceNumber": 190,
    "savedAt": "2021-12-03T11:36:06.834Z"
}

The creation of a transaction, its first detection on the blockchain (that is, an outgoing transaction is broadcast, or an incoming transaction is captured), and any change of status (such as confirmation status) triggers a corresponding event. The event exposes the id of the transaction as well as the references to the accounts that are related to the transaction.

Payload examples:

{
    "domainId": "5cd224fe-193e-8bce-c94c-c6c05245e2d1",
    "payload": {
        "id": "77cd7e83-f884-46cc-a557-997cae558fb9",
        "senderReferences": [
            {
                "id": "632d9607-f523-446c-99a3-ad78fdd438e2",
                "domainId": "5cd224fe-193e-8bce-c94c-c6c05245e2d1"
            }
        ],
        "type": "TransactionCreated"
    },
    "id": "6422fdfa-558c-346f-9a2e-da6f45210ece",
    "sequenceNumber": 692,
    "savedAt": "2021-12-14T16:59:53.521Z"
}

The system triggers compliance-related events when compliance configuration changes or when a transfer skips quarantine. These events provide audit visibility into compliance decisions.

Payload examples:

{
    "domainId": "b22cfc18-df37-49a1-b7e9-1b6c3f83b32b",
    "payload": {
        "accountReference": {
            "id": "d664a3f3-d5f0-44c1-9588-326b0f00aced",
            "domainId": "b22cfc18-df37-49a1-b7e9-1b6c3f83b32b"
        },
        "skipQuarantineFrom": "Instance",
        "revision": 3,
        "modifiedBy": {
            "id": "6ac20654-450e-29e4-65e2-1bdecb7db7c4",
            "domainId": "b22cfc18-df37-49a1-b7e9-1b6c3f83b32b"
        },
        "type": "ComplianceConfigurationUpdated"
    },
    "id": "91cb7c39-880c-32f9-9ad5-51d5e14193d7",
    "sequenceNumber": 366,
    "savedAt": "2026-03-23T10:47:46.344Z"
}