datasets

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
content_hash (str, optional): Return only the items you added holding this content (MD5 hex digest of the added text/bytes, as recorded in each item’s content_hash; case-insensitive, anything but 32 hex characters is a 422). Scoped to your own rows like ingestion dedup, so another user’s copy in a shared dataset is not returned. limit/offset page the matches exactly as they page the listing; an empty first page means you added no such content.

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
content_hash: MD5 hex digest of the ingested payload

Error Codes

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

GET

api

datasets

{dataset_id}

data

Get Dataset Data

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

import requests

url = "https://{tenant}.aws.cognee.ai/api/v1/datasets/{dataset_id}/data"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

[
  {
    "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,
    "contentHash": "<string>"
  }
]

{
  "message": "<string>"
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

Authorizations

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

content_hash

string | null

Return only your data items whose content_hash equals this MD5 hex digest (the hash of the text/bytes that were added; case-insensitive). Scoped to rows you added; limit/offset page the matches.

Pattern: ^[0-9a-fA-F]{32}$

Response

Successful Response

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

contentHash

string | null

⌘I

Get Dataset Data

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

import requests

url = "https://{tenant}.aws.cognee.ai/api/v1/datasets/{dataset_id}/data"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

[
  {
    "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,
    "contentHash": "<string>"
  }
]

{
  "message": "<string>"
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}