> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pathors.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Datasets

> List datasets in a knowledgebase

## Request

```bash theme={null}
GET https://api.pathors.com/v1/projects/{projectId}/knowledgebases/{knowledgebaseId}/datasets
```

### Path Parameters

<ParamField path="projectId" type="string" required>The project ID</ParamField>
<ParamField path="knowledgebaseId" type="string" required>The knowledgebase ID</ParamField>

### Headers

<ParamField header="Authorization" type="string" required>
  Bearer token using your developer key
</ParamField>

## Response

Returns an array of datasets, ordered by creation date (most recent first).

<ResponseField name="id" type="string">Unique identifier for the dataset</ResponseField>
<ResponseField name="filename" type="string">Original uploaded filename</ResponseField>
<ResponseField name="fileUrl" type="string">URL to download the original file</ResponseField>
<ResponseField name="extensionType" type="string">File extension (e.g. `pdf`, `txt`)</ResponseField>
<ResponseField name="size" type="number">File size in bytes</ResponseField>

<ResponseField name="isParsed" type="boolean">
  `true` once the dataset has been chunked and embedded; `false` while still processing.
</ResponseField>

<ResponseField name="createdAt" type="string">ISO timestamp when the dataset was created</ResponseField>
<ResponseField name="updatedAt" type="string">ISO timestamp when the dataset was last updated</ResponseField>

### Example

```bash theme={null}
curl https://api.pathors.com/v1/projects/{projectId}/knowledgebases/kb_abc123/datasets \
  -H "Authorization: Bearer dk_your_key"
```

```json theme={null}
[
  {
    "id": "dataset_abc123",
    "filename": "company-handbook.pdf",
    "fileUrl": "https://api.pathors.com/datasets/dataset_abc123.pdf",
    "extensionType": "pdf",
    "size": 2048000,
    "isParsed": true,
    "createdAt": "2026-01-15T10:30:00Z",
    "updatedAt": "2026-01-15T10:35:00Z"
  }
]
```