List dataset items
curl --request GET \
--url https://api.zespan.com/v1/datasets/{datasetId}/items \
--header 'x-api-key: <api-key>'import requests
url = "https://api.zespan.com/v1/datasets/{datasetId}/items"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://api.zespan.com/v1/datasets/{datasetId}/items', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.zespan.com/v1/datasets/{datasetId}/items",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.zespan.com/v1/datasets/{datasetId}/items"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.zespan.com/v1/datasets/{datasetId}/items")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.zespan.com/v1/datasets/{datasetId}/items")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"items": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"datasetId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"input": "<unknown>",
"expectedOutput": "<unknown>",
"metadata": {},
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
}
],
"nextCursor": "<string>"
}{
"error": "Unauthorized",
"code": "rate_limit_exceeded",
"message": "Rate limit exceeded",
"requestId": "5f0c9a4e-3b1d-4e7a-9c2f-8d6b1a0e7c34",
"details": "<unknown>"
}{
"error": "Unauthorized",
"code": "rate_limit_exceeded",
"message": "Rate limit exceeded",
"requestId": "5f0c9a4e-3b1d-4e7a-9c2f-8d6b1a0e7c34",
"details": "<unknown>"
}{
"error": "Unauthorized",
"code": "rate_limit_exceeded",
"message": "Rate limit exceeded",
"requestId": "5f0c9a4e-3b1d-4e7a-9c2f-8d6b1a0e7c34",
"details": "<unknown>"
}List dataset items
List the items in a dataset, oldest first, one page at a time. Pass the previous response’s nextCursor as cursor to get the next page; nextCursor is null on the last page. The SDKs’ getItems / get_items follow the cursor for you.
GET
/
v1
/
datasets
/
{datasetId}
/
items
List dataset items
curl --request GET \
--url https://api.zespan.com/v1/datasets/{datasetId}/items \
--header 'x-api-key: <api-key>'import requests
url = "https://api.zespan.com/v1/datasets/{datasetId}/items"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://api.zespan.com/v1/datasets/{datasetId}/items', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.zespan.com/v1/datasets/{datasetId}/items",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.zespan.com/v1/datasets/{datasetId}/items"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.zespan.com/v1/datasets/{datasetId}/items")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.zespan.com/v1/datasets/{datasetId}/items")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"items": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"datasetId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"input": "<unknown>",
"expectedOutput": "<unknown>",
"metadata": {},
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
}
],
"nextCursor": "<string>"
}{
"error": "Unauthorized",
"code": "rate_limit_exceeded",
"message": "Rate limit exceeded",
"requestId": "5f0c9a4e-3b1d-4e7a-9c2f-8d6b1a0e7c34",
"details": "<unknown>"
}{
"error": "Unauthorized",
"code": "rate_limit_exceeded",
"message": "Rate limit exceeded",
"requestId": "5f0c9a4e-3b1d-4e7a-9c2f-8d6b1a0e7c34",
"details": "<unknown>"
}{
"error": "Unauthorized",
"code": "rate_limit_exceeded",
"message": "Rate limit exceeded",
"requestId": "5f0c9a4e-3b1d-4e7a-9c2f-8d6b1a0e7c34",
"details": "<unknown>"
}Authorizations
Project API key. Manage keys in the Zespan dashboard under project settings.
Path Parameters
Dataset id.
Query Parameters
Project id. Optional and ignored when authenticating with an API key, since the key already scopes the request to one project.
Maximum number of items to return.
Required range:
1 <= x <= 1000Opaque value from the previous response's nextCursor.
Was this page helpful?

