Get Dataset Data

Get a page of data items in a dataset.

This endpoint retrieves data items (documents, files, etc.) that belong to a specific dataset. Each data item includes metadata such as name, type, creation time, and storage location.

Results are paginated. The response is capped at limit items (100 by default), so this endpoint stays fast on datasets with many documents; page through with offset. Use GET /{dataset_id}/data/count for the total. That total is uncapped; offsets above 1,000,000 are rejected, so datasets larger than 1,001,000 items cannot be fully traversed by this endpoint. Concurrent inserts/deletes can shift offsets; this is not a snapshot.

Path Parameters

• dataset_id (UUID): The unique identifier of the dataset

Query Parameters

• limit (int, 1-1000, default 100): Maximum number of items to return
• offset (int, default 0): Number of items to skip

Response

Returns a list of data objects containing:

• id: Unique data item identifier
• name: Data item name
• created_at: When the data was added
• updated_at: When the data was last updated
• extension: File extension
• mime_type: MIME type of the data
• raw_data_location: Storage location of the raw data
• dataset_id: ID of the containing dataset
• label: Label attached to the data item at upload, if any
• external_metadata: Stored metadata dict (upload-provided keys merged over loader-derived ones), if any

Error Codes

• 404 Not Found: Dataset doesn’t exist or user doesn’t have access
• 500 Internal Server Error: Error retrieving data

GET /api/v1/datasets/{dataset_id}/data

Get Dataset Data

cURL

curl --request GET \
  --url https://{tenant}.aws.cognee.ai/api/v1/datasets/{dataset_id}/data \
  --header 'Authorization: Bearer <token>'

200

[
  {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "<string>",
    "extension": "<string>",
    "mimeType": "<string>",
    "rawDataLocation": "<string>",
    "datasetId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "createdAt": "2023-11-07T05:31:56Z",
    "updatedAt": "2023-11-07T05:31:56Z",
    "label": "<string>",
    "externalMetadata": {},
    "dataSize": 123
  }
]

Authorizations

BearerAuthApiKeyAuth

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

dataset_id · string<uuid> · required

Dataset UUID, the id field from GET /api/v1/datasets (not the name)

Example:

"b8a7c3de-4f5a-4b6c-8d9e-0f1a2b3c4d5e"

Query Parameters

limit · integer · default: 100

Maximum number of data items to return.

Required range: 1 <= x <= 1000

offset · integer · default: 0

Number of data items to skip before returning results.

Required range: 0 <= x <= 1000000

Response

200

application/json

Successful Response

id · string<uuid> · required

name · string · required

extension · string · required

mimeType · string · required

rawDataLocation · string · required

datasetId · string<uuid> · required

createdAt · string<date-time> | null

updatedAt · string<date-time> | null

label · string | null

externalMetadata · Externalmetadata · object | null

dataSize · integer | null