> ## Documentation Index > Fetch the complete documentation index at: https://docs.promptlayer.com/llms.txt > Use this file to discover all available pages before exploring further. # List Datasets Retrieve a paginated list of datasets based on various filtering criteria. This endpoint allows you to retrieve datasets with various filtering options including dataset group, prompt, report, workspace, and name filters. ## OpenAPI ````yaml GET /api/public/v2/datasets openapi: 3.1.0 info: title: FastAPI version: 0.1.0 servers: [] security: - ApiKeyAuth: [] paths: /api/public/v2/datasets: get: tags: - datasets summary: List Datasets operationId: listDatasets parameters: - name: dataset_group_id in: query required: false schema: type: integer minimum: 1 description: Filter by specific dataset group ID - name: prompt_id in: query required: false schema: type: integer minimum: 1 description: Filter by specific prompt ID - name: prompt_version_id in: query required: false schema: type: integer minimum: 1 description: Filter by specific prompt version ID - name: prompt_label_id in: query required: false schema: type: integer minimum: 1 description: Filter by specific prompt label ID - name: workspace_id in: query required: false schema: type: integer minimum: 1 description: >- Filter by specific workspace ID. If not provided, uses the current user's workspace - name: report_id in: query required: false schema: type: integer minimum: 1 description: Filter by specific report ID (includes parent report ID) - name: name in: query required: false schema: type: string description: >- Filter datasets by name (case-insensitive partial match on dataset group name) - name: status in: query required: false schema: type: string enum: - active - deleted - all default: active description: >- Filter datasets by status: 'active' (default) returns only active datasets, 'deleted' returns only deleted/archived datasets, 'all' returns both - name: page in: query required: false schema: type: integer minimum: 1 default: 1 description: Page number for pagination - name: per_page in: query required: false schema: type: integer minimum: 1 maximum: 100 default: 10 description: Number of items per page - name: created_by_email in: query required: false schema: type: string description: Filter by the creator's email address. - name: created_after in: query required: false schema: type: string format: date-time description: Filter resources created at or after this timestamp. - name: created_before in: query required: false schema: type: string format: date-time description: Filter resources created at or before this timestamp. - name: updated_after in: query required: false schema: type: string format: date-time description: Filter resources updated at or after this timestamp. - name: updated_before in: query required: false schema: type: string format: date-time description: Filter resources updated at or before this timestamp. - name: external_source in: query required: false schema: type: string description: External ID source to filter by. Must be provided with external_id. - name: external_id in: query required: false schema: type: string description: >- External ID value to filter by. Must be provided with external_source. - name: sort_by in: query required: false schema: type: string enum: - created_at - updated_at - name - id description: Sort field. - name: sort_order in: query required: false schema: type: string enum: - asc - desc default: desc description: Sort direction. responses: '200': description: Successful response content: application/json: schema: type: object properties: success: type: boolean message: type: string datasets: type: array items: $ref: '#/components/schemas/Dataset' page: type: integer per_page: type: integer total: type: integer pages: type: integer required: - success - message - datasets - page - per_page - total - pages '400': description: Invalid workspace_id content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '401': $ref: '#/components/responses/UnauthorizedError' '422': $ref: '#/components/responses/ValidationError' components: schemas: Dataset: type: object properties: id: type: integer description: Dataset ID dataset_group_id: type: integer description: Associated dataset group ID version_number: type: integer description: Version number of the dataset column_names: type: array items: type: string description: Array of column names in the dataset filter_params: type: object nullable: true description: Filter parameters used to create the dataset is_deleted: type: boolean description: Whether the dataset is deleted user_id: type: integer description: ID of the user who created the dataset dataset_group: $ref: '#/components/schemas/DatasetGroup' description: Associated dataset group information external_ids: type: array items: $ref: '#/components/schemas/ExternalId' description: External ID mappings attached to this dataset group. required: - id - dataset_group_id - version_number - column_names - is_deleted - user_id title: Dataset ErrorResponse: type: object properties: success: type: boolean default: false description: Indicates that the request failed. message: type: string description: Human-readable error message. error: type: string description: Machine-readable or fallback error message. additionalProperties: true description: >- Standard error response. Some legacy endpoints may return either message or error. DatasetGroup: type: object properties: id: type: integer description: Dataset group ID name: type: string description: Dataset group name workspace_id: type: integer description: Associated workspace ID is_deleted: type: boolean description: Whether the dataset group is deleted required: - id - name - workspace_id - is_deleted title: DatasetGroup ExternalId: properties: source: type: string maxLength: 128 minLength: 1 title: Source description: The external system or namespace that owns the ID. external_id: type: string maxLength: 512 minLength: 1 title: External Id description: The identifier for this entity in the external system. type: object required: - source - external_id additionalProperties: false title: ExternalId description: >- Customer-defined mapping between a PromptLayer entity and an external system identifier. 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 type: object required: - loc - msg - type title: ValidationError responses: UnauthorizedError: description: Unauthorized - missing or invalid API key. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' ValidationError: description: Validation error - request parameters or body are invalid. content: application/json: schema: oneOf: - $ref: '#/components/schemas/HTTPValidationError' - $ref: '#/components/schemas/ErrorResponse' securitySchemes: ApiKeyAuth: type: apiKey in: header name: X-API-KEY ````