> ## 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. If omitted, returns status for all datasets the user has read permission on - **pipeline** (List[str], optional): One or more pipeline names to check. - If omitted, defaults to **cognify_pipeline** (backward-compatible behavior) - If one pipeline is provided, response is a flat map - If multiple pipelines are provided, response is nested per dataset and pipeline - **Available options: add_pipeline, cognify_pipeline** ## Response Returns status information in one of two shapes: - Single pipeline (default): {dataset_id: status} - Multiple pipelines: {dataset_id: {pipeline_name: status}} Status values: - **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 - **409 Conflict**: Error retrieving status (e.g. requesting a dataset you don't have read permission for) ## 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: agent connections description: '' - name: agent management description: '' - 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: 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: schema description: '' - name: search description: Search endpoints for querying the knowledge graph. - name: sessions description: '' - name: settings description: Configuration endpoints for managing Cognee settings. - name: skills description: '' - 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. If omitted, returns status for all datasets the user has read permission on - **pipeline** (List[str], optional): One or more pipeline names to check. - If omitted, defaults to **cognify_pipeline** (backward-compatible behavior) - If one pipeline is provided, response is a flat map - If multiple pipelines are provided, response is nested per dataset and pipeline - **Available options: add_pipeline, cognify_pipeline** ## Response Returns status information in one of two shapes: - Single pipeline (default): {dataset_id: status} - Multiple pipelines: {dataset_id: {pipeline_name: status}} Status values: - **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 - **409 Conflict**: Error retrieving status (e.g. requesting a dataset you don't have read permission for) operationId: get_dataset_status_api_v1_datasets_status_get parameters: - name: dataset in: query required: false schema: type: array items: type: string format: uuid description: >- Dataset UUIDs to check (from GET /api/v1/datasets). Omit to get status for all datasets you can read. examples: - - b8a7c3de-4f5a-4b6c-8d9e-0f1a2b3c4d5e default: [] title: Dataset description: >- Dataset UUIDs to check (from GET /api/v1/datasets). Omit to get status for all datasets you can read. - name: pipeline in: query required: false schema: type: array items: type: string description: >- Pipeline names to check: 'add_pipeline' or 'cognify_pipeline'. Omit to default to cognify_pipeline. examples: - - cognify_pipeline default: [] title: Pipeline description: >- Pipeline names to check: 'add_pipeline' or 'cognify_pipeline'. Omit to default to cognify_pipeline. responses: '200': description: Successful Response content: application/json: schema: anyOf: - type: object additionalProperties: $ref: '#/components/schemas/PipelineRunStatus' - type: object additionalProperties: 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 ````