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

# 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



## OpenAPI

````yaml /cognee_openapi_spec.json get /api/v1/datasets/status
openapi: 3.1.0
info:
  title: Cognee API
  description: Cognee API with Bearer token and Cookie auth
  version: 1.0.0
servers:
  - url: https://api.cognee.ai
    description: Production server (full functionality)
  - url: http://localhost:8000
    description: Local development server (requires local setup)
security:
  - BearerAuth: []
  - ApiKeyAuth: []
tags:
  - name: activity
    description: ''
  - name: add
    description: Data ingestion endpoints for adding text, files, and structured data.
  - name: auth
    description: >-
      Authentication endpoints for user registration, login, and token
      management.
  - name: checks
    description: ''
  - name: cognify
    description: >-
      Knowledge processing endpoints to transform raw data into knowledge
      graphs.
  - name: configuration
    description: ''
  - name: datasets
    description: Dataset management endpoints for listing, creating, and deleting datasets.
  - name: delete
    description: Data deletion endpoints (deprecated — use datasets endpoints instead).
  - name: forget
    description: ''
  - name: health
    description: ''
  - name: improve
    description: ''
  - name: llm
    description: ''
  - name: memify
    description: ''
  - name: notebooks
    description: ''
  - name: ontologies
    description: ''
  - name: permissions
    description: Permission management for multi-user access control.
  - name: recall
    description: ''
  - name: remember
    description: ''
  - name: responses
    description: Response generation endpoints using the knowledge graph.
  - name: search
    description: Search endpoints for querying the knowledge graph.
  - name: sessions
    description: ''
  - name: settings
    description: Configuration endpoints for managing Cognee settings.
  - name: sync
    description: ''
  - name: update
    description: ''
  - name: users
    description: User management endpoints.
  - name: visualize
    description: Graph visualization endpoints.
paths:
  /api/v1/datasets/status:
    get:
      tags:
        - datasets
      summary: Get Dataset Status
      description: >-
        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
      operationId: get_dataset_status_api_v1_datasets_status_get
      parameters:
        - name: dataset
          in: query
          required: false
          schema:
            type: array
            items:
              type: string
              format: uuid
            default: []
            title: Dataset
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  $ref: '#/components/schemas/PipelineRunStatus'
                title: Response Get Dataset Status Api V1 Datasets Status Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - BearerAuth: []
        - ApiKeyAuth: []
components:
  schemas:
    PipelineRunStatus:
      type: string
      enum:
        - DATASET_PROCESSING_INITIATED
        - DATASET_PROCESSING_STARTED
        - DATASET_PROCESSING_COMPLETED
        - DATASET_PROCESSING_ERRORED
      title: PipelineRunStatus
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-Api-Key

````