Datasets
List Datasets
Retrieve a list of all datasets in your account
GET
/
v1
/
datasets
List Datasets
curl --request GET \
--url https://api.fltr.com/v1/datasets \
--header 'Authorization: <authorization>'import requests
url = "https://api.fltr.com/v1/datasets"
headers = {"Authorization": "<authorization>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: '<authorization>'}};
fetch('https://api.fltr.com/v1/datasets', 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.fltr.com/v1/datasets",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: <authorization>"
],
]);
$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.fltr.com/v1/datasets"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "<authorization>")
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.fltr.com/v1/datasets")
.header("Authorization", "<authorization>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.fltr.com/v1/datasets")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = '<authorization>'
response = http.request(request)
puts response.read_body{
"datasets": [
{}
],
"total": 123,
"limit": 123,
"offset": 123,
"has_more": true
}Request
Returns a paginated list of datasets ordered by creation date (newest first).Headers
string
required
Bearer token for authentication
Query Parameters
integer
default:20
Number of datasets to return (max: 100)
integer
default:0
Number of datasets to skip
string
default:"-created_at"
Sort order:
name, created_at, -name, -created_atResponse
array
Array of dataset objects
integer
Total number of datasets
integer
Limit used in request
integer
Offset used in request
boolean
Whether there are more datasets to fetch
Examples
cURL
curl https://api.fltr.com/v1/datasets?limit=10&offset=0 \
-H "Authorization: Bearer fltr_sk_abc123..."
Python
import requests
response = requests.get(
"https://api.fltr.com/v1/datasets",
headers={"Authorization": "Bearer fltr_sk_abc123..."},
params={"limit": 10, "offset": 0}
)
data = response.json()
for dataset in data['datasets']:
print(f"{dataset['name']} - {dataset['document_count']} documents")
Response
{
"datasets": [
{
"id": "ds_abc123",
"name": "Product Documentation",
"description": "All product docs",
"is_public": false,
"document_count": 42,
"created_at": "2024-01-10T12:00:00Z",
"updated_at": "2024-01-10T15:30:00Z"
}
],
"total": 1,
"limit": 10,
"offset": 0,
"has_more": false
}
⌘I
List Datasets
curl --request GET \
--url https://api.fltr.com/v1/datasets \
--header 'Authorization: <authorization>'import requests
url = "https://api.fltr.com/v1/datasets"
headers = {"Authorization": "<authorization>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: '<authorization>'}};
fetch('https://api.fltr.com/v1/datasets', 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.fltr.com/v1/datasets",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: <authorization>"
],
]);
$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.fltr.com/v1/datasets"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "<authorization>")
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.fltr.com/v1/datasets")
.header("Authorization", "<authorization>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.fltr.com/v1/datasets")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = '<authorization>'
response = http.request(request)
puts response.read_body{
"datasets": [
{}
],
"total": 123,
"limit": 123,
"offset": 123,
"has_more": true
}