Home
POST
https://eos.nownodes.io/v1/chain/get_kv_table_rows

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns an object containing rows from the specified kv table.

Body

application/json
codestringrequired

The name of the smart contract that controls the provided kv table

tablestringrequired

The name of the kv table to query

index_namestringrequired

The name of primary or secondary index

encode_typestring

Encoding type to use for index_value, lower_bound, and upper_bound. Valid values are "bytes", "string", "name", "dec", or "hex"'. If not provided, the appropriate value based on the index_name's abi indicated type, for integers "dec" is the default. "bytes" are encoded as hexidecimal strings and can be used for any type of field. Example values for each type "bytes" => "0000000000000e1a", "string" => "Some value!", "name" => "eosio", "dec" => "3610", and "hex" => "e1a".

index_valuestring

Index value used for point query encoded as 'encode_type'. Cannot be used with either lower_bound or upper_bound.

lower_boundstring

Lower bound index value for ranged query. Query result includes rows specified with lower_bound. Cannot be used with index_value. If index_value and lower_bound are not provided, then lower_bound is defaulted to be the lowest value in the table for that index_name.

upper_boundstring

Upper bound index value for ranged query. Query result includes rows specified with upper_bound. Cannot be used with index_value. If index_value and upper_bound are not provided, then upper_bound is defaulted to be the highest value in the table for that index_name.

limitinteger<int32>

Limit number of results returned

reverseboolean

Reverse the order of returned results

show_payerboolean

Provide the ram payer for each row

Response

200OK

OK