/v1/tables/{table_handle}/raw_item
Get a raw table item at a specific ledger version from the table identified by `{table_handle}` and the key provided in the request body.
The `get_raw_table_item` endpoint only requires a serialized key (hex string) and returns the value in binary canonical serialization (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_handle
Table handle — a hex encoded 32-byte Aptos address (with or without 0x prefix).
Headers
Accept
Must be set to application/x-bcs to receive the response in raw BCS format.
Allowed values:
Query Parameters
ledger_version
Ledger version to query state from. If omitted, the latest version will be used.
Request
This endpoint expects an object.
key
Serialized BCS key for the item, as a hex-encoded string prefixed with 0x.
The hex string must have an even number of characters (after 0x). If the BCS-encoded key results in an odd-length hex string, it must be left-padded with 0 to ensure valid decoding.
Response
Raw BCS response.
