> ## Documentation Index > Fetch the complete documentation index at: https://docs.orq.ai/llms.txt > Use this file to discover all available pages before exploring further. # List datasets > Retrieves a paginated list of datasets for the current workspace. Results can be paginated using cursor-based pagination. ## OpenAPI ````yaml get /v2/datasets openapi: 3.1.0 info: title: orq.ai API version: '2.0' description: orq.ai API documentation servers: - url: https://api.orq.ai security: - ApiKey: [] tags: - description: List models available through the AI Router. name: Models - name: Guardrail Rules - name: Policies - name: Routing Rules - name: API keys description: >- API keys authenticate programmatic access to the workspace. The unified key model exposes opaque tokens, per-domain access grants, and budget / rate-limit constraints (see ADR 0001 and ADR 0002). - name: Budgets description: >- Budgets govern spend, token usage, and request rate across six scopes: workspace, project, identity, api-key, provider, and model. A budget is hierarchical and defense-in-depth — every applicable budget is a hard gate, and the most restrictive one wins per dimension (see ADR 0007). - name: Documentation description: >- Search the orq.ai documentation. Proxies the workspace's query to the hosted docs search index. - name: Files description: File upload and retrieval operations. - name: Identities description: >- Identities represent end users from your system for usage and engagement tracking. - name: Projects description: Projects organize resources within a workspace - name: Skills description: >- Skills are modular instructions you can use to codify processes and conventions - name: Responses - description: >- Run agents on a cadence — cron, interval, or one-off. Minimum firing interval is 1 hour. name: Agent Schedules - name: Embeddings - name: Reporting description: >- GenAI reporting API over canonical analytics rollups. Accepts a metric name, time range, grain, group-by, and filters; returns a typed time series and optional totals. externalDocs: url: https://docs.orq.ai description: orq.ai Documentation paths: /v2/datasets: get: tags: - Datasets summary: List datasets description: >- Retrieves a paginated list of datasets for the current workspace. Results can be paginated using cursor-based pagination. operationId: ListDatasets parameters: - schema: type: integer minimum: 1 maximum: 200 default: 10 description: >- A limit on the number of objects to be returned. Limit can range between 1 and 50, and the default is 10 required: false description: >- A limit on the number of objects to be returned. Limit can range between 1 and 50, and the default is 10 name: limit in: query - schema: type: string description: >- A cursor for use in pagination. `starting_after` is an object ID that defines your place in the list. For instance, if you make a list request and receive 20 objects, ending with `01JJ1HDHN79XAS7A01WB3HYSDB`, your subsequent call can include `after=01JJ1HDHN79XAS7A01WB3HYSDB` in order to fetch the next page of the list. required: false description: >- A cursor for use in pagination. `starting_after` is an object ID that defines your place in the list. For instance, if you make a list request and receive 20 objects, ending with `01JJ1HDHN79XAS7A01WB3HYSDB`, your subsequent call can include `after=01JJ1HDHN79XAS7A01WB3HYSDB` in order to fetch the next page of the list. name: starting_after in: query - schema: type: string description: >- A cursor for use in pagination. `ending_before` is an object ID that defines your place in the list. For instance, if you make a list request and receive 20 objects, starting with `01JJ1HDHN79XAS7A01WB3HYSDB`, your subsequent call can include `before=01JJ1HDHN79XAS7A01WB3HYSDB` in order to fetch the previous page of the list. required: false description: >- A cursor for use in pagination. `ending_before` is an object ID that defines your place in the list. For instance, if you make a list request and receive 20 objects, starting with `01JJ1HDHN79XAS7A01WB3HYSDB`, your subsequent call can include `before=01JJ1HDHN79XAS7A01WB3HYSDB` in order to fetch the previous page of the list. name: ending_before in: query responses: '200': description: Datasets Retrieved Successfully content: application/json: schema: type: object properties: object: type: string enum: - list data: type: array items: type: object properties: _id: anyOf: - type: string format: uuid pattern: >- ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$ readOnly: true description: The id of the resource - type: string format: ulid pattern: ^[0-9A-HJKMNP-TV-Z]{26}$ readOnly: true description: The id of the resource description: The unique identifier of the dataset display_name: type: string minLength: 1 maxLength: 128 description: The display name of the dataset project_id: anyOf: - type: string format: uuid pattern: >- ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$ readOnly: true description: The id of the resource - type: string format: ulid pattern: ^[0-9A-HJKMNP-TV-Z]{26}$ readOnly: true description: The id of the resource description: The unique identifier of the project it belongs to workspace_id: anyOf: - type: string format: uuid pattern: >- ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$ readOnly: true description: The id of the resource - type: string format: ulid pattern: ^[0-9A-HJKMNP-TV-Z]{26}$ readOnly: true description: The id of the resource description: The unique identifier of the workspace it belongs to metadata: type: object properties: total_versions: type: number datapoints_count: type: number required: - total_versions - datapoints_count created_by_id: anyOf: - type: string format: uuid pattern: >- ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$ readOnly: true description: The id of the resource - type: string format: ulid pattern: ^[0-9A-HJKMNP-TV-Z]{26}$ readOnly: true description: The id of the resource - type: 'null' description: >- The unique identifier of the user who created the dataset updated_by_id: anyOf: - type: string format: uuid pattern: >- ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$ readOnly: true description: The id of the resource - type: string format: ulid pattern: ^[0-9A-HJKMNP-TV-Z]{26}$ readOnly: true description: The id of the resource - type: 'null' description: >- The unique identifier of the user who last updated the dataset created: anyOf: - format: date-time type: string - format: date-time type: string default: '2026-06-10T10:08:14.953Z' readOnly: true format: date-time description: The date and time the resource was created updated: anyOf: - type: string format: date-time default: '2026-06-10T10:08:14.954Z' - format: date-time type: string readOnly: true format: date-time description: The date and time the resource was last updated required: - _id - display_name - project_id - workspace_id - metadata has_more: type: boolean required: - object - data - has_more components: securitySchemes: ApiKey: type: http scheme: bearer bearerFormat: JWT ````