Get Raw Table iItem

Get a raw table item at a specific ledger version from the table.

This method will use 200 Compute Units.

---

Get raw table item

post

Get a table item at a specific ledger version from the table identified by {table_handle} in the path and the "key" (RawTableItemRequest) provided in the request body.

The get_raw_table_item requires only a serialized key comparing to the full move type information comparing to the get_table_item api, and can only return the query in the bcs format.

The Aptos nodes prune account state history, via a configurable time window. If the requested ledger version has been pruned, the server responds with a 410.

Path parameters

table_handlestring · hexRequired

A hex encoded 32 byte Aptos account address.

This is represented in a string as a 64 character hex string, sometimes shortened by stripping leading 0s, and adding a 0x.

For example, address 0x0000000000000000000000000000000000000000000000000000000000000001 is represented as 0x1.

Example: 0x88fbd33f54e1126269769780feb24480428179f552e2313fbe571b72e62a1ca1

Query parameters

ledger_versionstring · uint64Optional

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.

Example: 32425224034

Body

application/json

Table Item request for the GetTableItemRaw API

keystring · hexRequired

All bytes (Vec) data is represented as hex-encoded string prefixed with 0x and fulfilled with two hex digits per byte.

Unlike the Address type, HexEncodedBytes will not trim any zeros.

Example: 0x88fbd33f54e1126269769780feb24480428179f552e2313fbe571b72e62a1ca1

Responses

200Success

application/jsonapplication/x-bcs

400Error

application/json

403Error

application/json

404Error

application/json

410Error

application/json

500Error

application/json

503Error

application/json

post

/tables/{table_handle}/raw_item

HTTPcURLJavaScriptPython

POST /v1/<YOUR_API_KEY_HERE>/v1/tables/{table_handle}/raw_item HTTP/1.1
Host: mainnet.aptos.validationcloud.io/v1/<YOUR_API_KEY_HERE>/v1
Content-Type: application/json
Accept: */*
Content-Length: 77

{
  "key": "0x88fbd33f54e1126269769780feb24480428179f552e2313fbe571b72e62a1ca1 "
}

{}