---
title: "Get raw table item"
method: POST
path: "/tables/{table_handle}/raw_item"
tags: ["Tables"]
---

# Get raw table item

`POST /tables/{table_handle}/raw_item`

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_handle` string, hex, required — 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.

## Query parameters

- `ledger_version` string, uint64 — 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.

## Request body

- RawTableItemRequest — Table Item request for the GetTableItemRaw API
  - `key` string, hex, required — All bytes (Vec<u8>) 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.

## Response `200`

- union — An enum of the possible Move value types
  - integer — Move u8 value
  - integer — Move u16 value
  - integer — Move u32 value
  - string, uint64 — Move u64 value
  - string, uint128 — Move u128 value
  - string, uint256 — Move u256 value
  - boolean — Move bool value
  - string, hex — Move address value
  - unknown[] — Move vector value
    - unknown
  - string, hex — Move bytes value
  - object — Move struct value
  - string — Move string value

## Other responses

- `400`
- `403`
- `404`
- `410`
- `500`
- `503`

---

[API](https://skmtc.dev/aptos/apis/aptos-node-api.md) · [All operations](https://skmtc.dev/aptos/apis/aptos-node-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/aptos/aptos-node-api/revisions/811ada792a7a/schema)