Path Parameters

key

string

REQUIRED

The unique key associated with the list

Returns

data

object

The data object which contains the following fields:

items

array

Retrieves an array of items from a specific Key-Value Store list

Request

1
curl -X GET \
2
    "https://api.quicknode.com/kv/rest/v1/lists/{key}" \
3
    -H "accept: application/json" \
4
    -H "Content-Type: application/json" \
5
    -H "x-api-key: YOUR_API_KEY"    

1
curl -X GET \
2
    "https://api.quicknode.com/kv/rest/v1/lists/{key}" \
3
    -H "accept: application/json" \
4
    -H "Content-Type: application/json" \
5
    -H "x-api-key: YOUR_API_KEY"    

1
var myHeaders = new Headers();
2
myHeaders.append('accept', 'application/json');
3
myHeaders.append('Content-Type', 'application/json');
4
myHeaders.append('x-api-key', 'YOUR_API_KEY'); // Replace with your actual API key
5

6
var requestOptions = {
7
  method: 'GET',
8
  headers: myHeaders,
9
  redirect: 'follow'
10
};
11

12
fetch('https://api.quicknode.com/kv/rest/v1/lists/{key}', requestOptions)
13
  .then(response => response.text())
14
  .then(result => console.log(result))
15
  .catch(error => console.log('error', error));
16

1
var myHeaders = new Headers();
2
myHeaders.append('accept', 'application/json');
3
myHeaders.append('Content-Type', 'application/json');
4
myHeaders.append('x-api-key', 'YOUR_API_KEY'); // Replace with your actual API key
5

6
var requestOptions = {
7
  method: 'GET',
8
  headers: myHeaders,
9
  redirect: 'follow'
10
};
11

12
fetch('https://api.quicknode.com/kv/rest/v1/lists/{key}', requestOptions)
13
  .then(response => response.text())
14
  .then(result => console.log(result))
15
  .catch(error => console.log('error', error));
16

1
import requests
2

3
url = "https://api.quicknode.com/kv/rest/v1/lists/{key}"
4

5
headers = {
6
    "accept": "application/json",
7
    "Content-Type": "application/json",
8
    "x-api-key": "YOUR_API_KEY"  # Replace with your actual API key
9
}
10

11
response = requests.get(url, headers=headers)
12

13
print(response.text)
14

1
import requests
2

3
url = "https://api.quicknode.com/kv/rest/v1/lists/{key}"
4

5
headers = {
6
    "accept": "application/json",
7
    "Content-Type": "application/json",
8
    "x-api-key": "YOUR_API_KEY"  # Replace with your actual API key
9
}
10

11
response = requests.get(url, headers=headers)
12

13
print(response.text)
14

1
require "uri"
2
require "net/http"
3
require "json"
4

5
# Set up the URL for the request
6
url = URI("https://api.quicknode.com/kv/rest/v1/lists/{key}")
7

8
https = Net::HTTP.new(url.host, url.port)
9
https.use_ssl = true
10

11
request = Net::HTTP::Get.new(url)
12
request["accept"] = "application/json"
13
request["Content-Type"] = "application/json"
14
request["x-api-key"] = "YOUR_API_KEY"  # Replace with your actual API key
15

16
response = https.request(request)
17
puts response.body
18

1
require "uri"
2
require "net/http"
3
require "json"
4

5
# Set up the URL for the request
6
url = URI("https://api.quicknode.com/kv/rest/v1/lists/{key}")
7

8
https = Net::HTTP.new(url.host, url.port)
9
https.use_ssl = true
10

11
request = Net::HTTP::Get.new(url)
12
request["accept"] = "application/json"
13
request["Content-Type"] = "application/json"
14
request["x-api-key"] = "YOUR_API_KEY"  # Replace with your actual API key
15

16
response = https.request(request)
17
puts response.body
18

1
qn kv list get {list_key} --limit 100 -o json

1
qn kv list get {list_key} --limit 100 -o json

1
import { QuicknodeSdk } from "@quicknode/sdk"
2

3
const qn = new QuicknodeSdk({ apiKey: "YOUR_API_KEY" })
4

5
const response = await qn.kvstore.getList("watchlist", { limit: 20 })
6
console.log(response)
7

1
import { QuicknodeSdk } from "@quicknode/sdk"
2

3
const qn = new QuicknodeSdk({ apiKey: "YOUR_API_KEY" })
4

5
const response = await qn.kvstore.getList("watchlist", { limit: 20 })
6
console.log(response)
7

1
import asyncio
2
from quicknode_sdk import QuicknodeSdk, SdkFullConfig
3

4

5
async def main():
6
    qn = QuicknodeSdk(SdkFullConfig(api_key="YOUR_API_KEY"))
7
    response = await qn.kvstore.get_list("watchlist", limit=20)
8
    print(response)
9

10

11
asyncio.run(main())
12

1
import asyncio
2
from quicknode_sdk import QuicknodeSdk, SdkFullConfig
3

4

5
async def main():
6
    qn = QuicknodeSdk(SdkFullConfig(api_key="YOUR_API_KEY"))
7
    response = await qn.kvstore.get_list("watchlist", limit=20)
8
    print(response)
9

10

11
asyncio.run(main())
12

1
require "quicknode_sdk"
2

3
qn = QuicknodeSdk::SDK.from_config(api_key: "YOUR_API_KEY")
4

5
response = qn.kvstore.get_list(key: "watchlist", limit: 20)
6
puts response
7

1
require "quicknode_sdk"
2

3
qn = QuicknodeSdk::SDK.from_config(api_key: "YOUR_API_KEY")
4

5
response = qn.kvstore.get_list(key: "watchlist", limit: 20)
6
puts response
7

1
use quicknode_sdk::{QuicknodeSdk, SdkFullConfig};
2

3
#[tokio::main]
4
async fn main() -> Result<(), Box<dyn std::error::Error>> {
5
    let qn = QuicknodeSdk::new(&SdkFullConfig::builder().api_key("YOUR_API_KEY").build())?;
6
    let response = qn.kvstore.get_list("watchlist", &Default::default()).await?;
7

8
    println!("{:?}", response);
9
    Ok(())
10
}
11

1
use quicknode_sdk::{QuicknodeSdk, SdkFullConfig};
2

3
#[tokio::main]
4
async fn main() -> Result<(), Box<dyn std::error::Error>> {
5
    let qn = QuicknodeSdk::new(&SdkFullConfig::builder().api_key("YOUR_API_KEY").build())?;
6
    let response = qn.kvstore.get_list("watchlist", &Default::default()).await?;
7

8
    println!("{:?}", response);
9
    Ok(())
10
}
11

Try in Swagger

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free