Sign in

POST /v2/updates/get-updates-page

Read a page of ledger's filtered updates. It returns the event types in accordance with the specified contents and filters. Additionally, the selection criteria for individual events depends on the transaction shape chosen.

  • ACS delta: an event is included only if the requesting party is a stakeholder.
  • ledger effects: an event is included if the requesting party is a witness.
post/v2/updates/get-updates-page

Request body

beginOffsetExclusiveinteger

Exclusive lower bound offset of the requested ledger section (non-negative integer). The response page will only contain updates whose offset is strictly greater than this. If set to zero or not defined, the lower bound is set to the actual pruning offset or to the beginning of the ledger if the participant was not pruned yet. If set to positive and the ledger has been pruned, this parameter must be greater or equal than the pruning offset.

Optional

endOffsetInclusiveinteger

Inclusive upper bound offset of the requested ledger section. If specified the response will only contain updates whose offset is less than or equal to this. If not specified response will only contain updates whose offset is less than the current ledger-end.

Optional

maxPageSizeinteger

The result page will contain the first max_page_size Updates of all matching updates. The server may reject queries with max_page_size above server specified limits. If not specified, the default max_page_size is determined by the server.

Optional

descendingOrderboolean

If set, the page will populate the elements in descending order starting from the end_offset_inclusive.

Optional

pageTokenstring

To get the next page of updates, the page_token should be set to the next_page_token of the last GetUpdatesPageResponse. To achieve correct paging: subsequent requests must

  • be executed on the same participant,
  • have the same begin_offset_exclusive,
  • have the same end_offset_inclusive,
  • have the same update_format and
  • have the same descending_order.

If not specified, the first page of updates will be returned.

Optional: can be empty

Response

lowestPageOffsetExclusiveinteger required

Represents the lower bound of this page.

Required

highestPageOffsetInclusiveinteger required

Represents the upper bound of the page.

Required

nextPageTokenstring

If the value is not populated, this is the last page. If the value is populated, this token can be used to get the next page. If the original GetFirstUpdatePageRequest end_offset_inclusive was not specified and the request uses ascending order, then this token will always be populated, so you can use it to "tail" the ledger by repeatedly polling with the new page token returned.

Optional: can be empty

Changes

No recorded changes to this endpoint across all 1 revision of this API.