Skip to main content
GET
/
v1
/
datasets
/
{dataset_id}
Get Dataset
curl --request GET \
  --url https://api.fltr.com/v1/datasets/{dataset_id} \
  --header 'Authorization: <authorization>'
{
  "id": "<string>",
  "name": "<string>",
  "description": "<string>",
  "is_public": true,
  "document_count": 123,
  "created_at": "<string>",
  "updated_at": "<string>",
  "metadata": {}
}

​
Request

Returns detailed information about a dataset including document count and metadata.

​
Path Parameters

​
dataset_id
string
required
The unique dataset identifier (e.g., ds_abc123)

​
Headers

​
Authorization
string
required
Bearer token for authentication

​
Response

​
id
string
Dataset identifier
​
name
string
Dataset name
​
description
string
Dataset description
​
is_public
boolean
Public accessibility status
​
document_count
integer
Number of documents in dataset
​
created_at
string
ISO 8601 creation timestamp
​
updated_at
string
ISO 8601 last update timestamp
​
metadata
object
Custom metadata

​
Examples

cURL
curl https://api.fltr.com/v1/datasets/ds_abc123 \
  -H "Authorization: Bearer fltr_sk_abc123..."
Python
response = requests.get(
    "https://api.fltr.com/v1/datasets/ds_abc123",
    headers={"Authorization": "Bearer fltr_sk_abc123..."}
)
dataset = response.json()

​
Response

{
  "id": "ds_abc123",
  "name": "Product Documentation",
  "description": "All product docs and guides",
  "is_public": false,
  "document_count": 42,
  "created_at": "2024-01-10T12:00:00Z",
  "updated_at": "2024-01-10T15:30:00Z",
  "metadata": {
    "category": "documentation",
    "team": "product"
  }
}

​
Errors

{
  "error": "Dataset not found",
  "code": "dataset_not_found",
  "details": {
    "dataset_id": "ds_invalid"
  }
}