Skip to main content
GET
/
v1
/
datasets
/
{dataset_id}
/
documents
List Documents
curl --request GET \
  --url https://api.fltr.com/v1/datasets/{dataset_id}/documents

​
Request

Returns a paginated list of documents in a dataset.

​
Path Parameters

​
dataset_id
string
required
The dataset to list documents from

​
Query Parameters

​
limit
integer
default:20
Number of documents to return (max: 100)
​
offset
integer
default:0
Number of documents to skip
​
status
string
Filter by status: processing, ready, failed

​
Examples

cURL
curl https://api.fltr.com/v1/datasets/ds_abc123/documents?limit=10 \
  -H "Authorization: Bearer fltr_sk_abc123..."

​
Response

{
  "documents": [
    {
      "document_id": "doc_xyz789",
      "dataset_id": "ds_abc123",
      "filename": "guide.pdf",
      "status": "ready",
      "chunks_created": 47,
      "created_at": "2024-01-10T12:00:00Z",
      "metadata": {
        "title": "Product Guide"
      }
    }
  ],
  "total": 1,
  "limit": 10,
  "offset": 0,
  "has_more": false
}