Comment on page


Get events by creation number
Event types are globally identifiable by an account address and monotonically increasing creation_number, one per event type emitted to the given account. This API returns events corresponding to that event type.


  • address REQUIRED: (string) - Hex-encoded 32-byte Aptos account, with or without a 0x prefix, for which events are queried. This refers to the account that events were emitted to, not the account hosting the move module that emits that event type.
  • creation_number REQUIRED: (string<uint64>)- Creation number corresponding to the event stream originating from the given account.
  • limit OPTIONAL: (string<uint64>) - Max number of events to retrieve.
  • start OPTIONAL: (string<uint64>) - Starting sequence number of events.


array of:
  • version (string<uint64>): A string containing a 64-bit unsigned integer.
  • guid (object)
    • creation_number (string<uint64>): A string containing a 64-bit unsigned integer.
    • account_address (string<hex>): A hex-encoded 32 byte Aptos account address.
  • sequence_number (string<uint64>): A string containing a 64-bit unsigned integer.
  • type (string): String representation of an on-chain Move type tag that is exposed in transaction payload. Values: - bool - u8 - u64 - u128 - address - signer - vector: vector<{non-reference MoveTypeId}> - struct: {address}::{module_name}::{struct_name}::<{generic types}>
Vector type value examples:
- `vector<u8>`
- `vector<vector<u64>>`
- `vector<0x1::coin::CoinStore<0x1::aptos_coin::AptosCoin>>`
Struct type value examples:
- `0x1::coin::CoinStore<0x1::aptos_coin::AptosCoin>
- `0x1::account::Account`
1. Empty chars should be ignored when comparing 2 struct tag ids.
2. When used in an URL path, should be encoded by url-encoding (AKA percent-encoding).
  • data The JSON representation of the event


curl --request GET \
--url<project-id>/v1/accounts/0xc32f662cd9718f02d8a8e5628f8f642fa27cd9b5f457b406ed734901a4939e34/events/32425224034 \
--header 'Content-Type: application/json'
"guid": {
"creation_number": "32425224034",
"account_address": "0xc32f662cd9718f02d8a8e5628f8f642fa27cd9b5f457b406ed734901a4939e34"
"sequence_number": "32425224034",
"type": "string",
"data": null