datasets

Get Dataset Status

Get the processing status of datasets.

This endpoint retrieves the current processing status of one or more datasets, indicating whether they are being processed, have completed processing, or encountered errors during pipeline execution.

Query Parameters

dataset (List[UUID]): List of dataset UUIDs to check status for

Response

Returns a dictionary mapping dataset IDs to their processing status:

pending: Dataset is queued for processing
running: Dataset is currently being processed
completed: Dataset processing completed successfully
failed: Dataset processing encountered an error

Error Codes

500 Internal Server Error: Error retrieving status information

GET

api

datasets

status

Get Dataset Status

curl --request GET \
  --url https://api.cognee.ai/api/v1/datasets/status

{}

Query Parameters

dataset

string<uuid>[]

Response

Successful Response

{key}

enum<string>

Available options:

DATASET_PROCESSING_INITIATED,

DATASET_PROCESSING_STARTED,

DATASET_PROCESSING_COMPLETED,

DATASET_PROCESSING_ERRORED

Get Raw DataDownload the raw data file for a specific data item. This endpoint allows users to download the original, unprocessed data file for a specific data item within a dataset. The file is returned as a direct download with appropriate headers. ## Path Parameters - **dataset_id** (UUID): The unique identifier of the dataset containing the data - **data_id** (UUID): The unique identifier of the data item to download ## Response Returns the raw data file as a downloadable response. ## Error Codes - **404 Not Found**: Dataset or data item doesn't exist, or user doesn't have access - **500 Internal Server Error**: Error accessing the raw data file

Get Dataset Status

curl --request GET \
  --url https://api.cognee.ai/api/v1/datasets/status

{}

Getting Started

API Reference

auth

add

cognify

search

permissions

datasets

settings

visualize

delete

responses

code-pipeline

users

Get Dataset Status

Query Parameters

Response

Error Codes

Query Parameters

Response