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

# Get dataset

> One dataset with its item count. Items themselves come from GET /v1/datasets/{id}/items.



## OpenAPI

````yaml /api-reference/openapi.json get /v1/datasets/{id}
openapi: 3.1.0
info:
  title: Sidenet API
  version: 1.0.0
  description: >-
    Sidenet HTTP endpoints exposed by the Sidenet Studio. All routes require an
    api key that can be generated through the studio in studio.sidenet.ai.
servers:
  - url: https://api.sidenet.ai
security:
  - bearerAuth: []
paths:
  /v1/datasets/{id}:
    get:
      tags:
        - Datasets
      summary: Get dataset
      description: >-
        One dataset with its item count. Items themselves come from GET
        /v1/datasets/{id}/items.
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
            example: ds_orders_v3
          description: Dataset id.
      responses:
        '200':
          description: The dataset
          content:
            application/json:
              schema:
                type: object
                properties:
                  dataset:
                    type: object
                    properties:
                      id:
                        type: string
                      name:
                        type: string
                      description:
                        type: string
                        nullable: true
                      agentId:
                        type: string
                        nullable: true
                        description: >-
                          The agent this dataset was written for, when one was
                          set. Informational — an experiment names its agent
                          explicitly.
                      tags:
                        type: array
                        items:
                          type: string
                      metadata:
                        type: object
                        additionalProperties: true
                      version:
                        type: integer
                        description: >-
                          Bumped on every item change. Pin it on POST
                          /v1/experiments to rerun exactly this content.
                      itemCount:
                        type: integer
                        description: >-
                          Items at the current version. Present on reads of one
                          dataset.
                      createdAt:
                        type: string
                        format: date-time
                      updatedAt:
                        type: string
                        format: date-time
              example:
                dataset:
                  id: ds_orders_v3
                  name: Refund questions
                  description: Twelve refund questions with the policy answer for each
                  agentId: 6f1c0f4e-2b7a-4a51-9a2f-0c9d1b3e5a10
                  tags:
                    - support
                    - refunds
                  metadata: {}
                  version: 2
                  itemCount: 12
                  createdAt: '2026-08-04T10:22:05.117Z'
                  updatedAt: '2026-08-04T10:31:48.006Z'
        '404':
          description: No such dataset in this organization
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: The class of failure.
                  details:
                    type: string
                    description: What specifically went wrong.
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Organization API key, generated in studio.sidenet.ai. Backend only —
        never in a browser.

````