APaptoslabs
General

Get ledger info

Changed on

Get the latest ledger information, including data such as chain ID, role type, ledger versions, epoch, etc.

get/

Request

  • Base URL
    /v1 (relative, and the document was published on a file host, not at the API’s origin)
  • URL
    /v1/
  • Auth
    none declared

Response

chain_idinteger required

Chain ID of the current chain

epochstring uint64 required

A string containing a 64-bit unsigned integer.

We represent u64 values as a string to ensure compatibility with languages such as JavaScript that do not parse u64s in JSON natively.

ledger_versionstring uint64 required

A string containing a 64-bit unsigned integer.

We represent u64 values as a string to ensure compatibility with languages such as JavaScript that do not parse u64s in JSON natively.

oldest_ledger_versionstring uint64 required

A string containing a 64-bit unsigned integer.

We represent u64 values as a string to ensure compatibility with languages such as JavaScript that do not parse u64s in JSON natively.

ledger_timestampstring uint64 required

A string containing a 64-bit unsigned integer.

We represent u64 values as a string to ensure compatibility with languages such as JavaScript that do not parse u64s in JSON natively.

node_role'validator' | 'full_node' required
oldest_block_heightstring uint64 required

A string containing a 64-bit unsigned integer.

We represent u64 values as a string to ensure compatibility with languages such as JavaScript that do not parse u64s in JSON natively.

block_heightstring uint64 required

A string containing a 64-bit unsigned integer.

We represent u64 values as a string to ensure compatibility with languages such as JavaScript that do not parse u64s in JSON natively.

git_hashstring

Git hash of the build of the API endpoint. Can be used to determine the exact software version used by the API endpoint.

encryption_keystring

Per-epoch transaction encryption key (hex-encoded)

Example response

{
  "epoch": "32425224034",
  "ledger_version": "32425224034",
  "oldest_ledger_version": "32425224034",
  "ledger_timestamp": "32425224034",
  "oldest_block_height": "32425224034",
  "block_height": "32425224034"
}

Changes

  • fddae5eeba26Revision changes
    • warning

      added the new node_not_bootstrapped enum value to the response property for the response status

    • warning

      added the new node_not_bootstrapped enum value to the response property for the response status

    • warning

      added the new node_not_bootstrapped enum value to the response property for the response status

    • warning

      added the new node_not_bootstrapped enum value to the response property for the response status

  • 10ecd1005697Revision changes
    • warning

      added the new rate_limited enum value to the response property for the response status

    • warning

      added the new rate_limited enum value to the response property for the response status

    • warning

      added the new rate_limited enum value to the response property for the response status

    • warning

      added the new rate_limited enum value to the response property for the response status