Skip to main content
GET
/
v1
/
datasets
List Datasets
curl --request GET \
  --url https://api.fltr.com/v1/datasets \
  --header 'Authorization: <authorization>'
{
  "datasets": [
    {}
  ],
  "total": 123,
  "limit": 123,
  "offset": 123,
  "has_more": true
}

​
Request

Returns a paginated list of datasets ordered by creation date (newest first).

​
Headers

​
Authorization
string
required
Bearer token for authentication

​
Query Parameters

​
limit
integer
default:20
Number of datasets to return (max: 100)
​
offset
integer
default:0
Number of datasets to skip
​
sort
string
default:"-created_at"
Sort order: name, created_at, -name, -created_at

​
Response

​
datasets
array
Array of dataset objects
​
total
integer
Total number of datasets
​
limit
integer
Limit used in request
​
offset
integer
Offset used in request
​
has_more
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
}