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

# List datasets

> Use the returned dataset IDs in the other Robotics Data Quality endpoints. The
`metrics` array shows which measurements are currently available.



## OpenAPI

````yaml https://api.hebbianrobotics.com/public-openapi.json get /api/v1beta/quality/datasets
openapi: 3.1.0
info:
  description: >-
    Use content diversity, frame-quality, and hand-activity metrics to evaluate
    robot and egocentric video datasets. Start with `GET /api/v1beta/access`,
    then list available datasets with `GET /api/v1beta/quality/datasets`.
  license:
    identifier: Apache-2.0
    name: Apache-2.0
  title: Robotics Data Quality API
  version: v1beta
servers:
  - description: Production API
    url: https://api.hebbianrobotics.com
security:
  - {}
  - bearer_token: []
tags:
  - description: >-
      Content diversity, frame-quality, and hand-activity metrics for robotics
      video data.
    name: quality
  - description: Scope and capabilities granted by a bearer token.
    name: access
paths:
  /api/v1beta/quality/datasets:
    get:
      tags:
        - quality
      summary: List datasets
      description: >-
        Use the returned dataset IDs in the other Robotics Data Quality
        endpoints. The

        `metrics` array shows which measurements are currently available.
      operationId: listQualityDatasets
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/QualityDatasetsResponse'
          description: Readable datasets and available metrics
          headers:
            x-request-id:
              description: >-
                Request correlation identifier supplied by the caller or
                generated by the API
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorBody'
          description: A valid bearer token is required
          headers:
            WWW-Authenticate:
              description: Bearer authentication challenge
              schema:
                type: string
            x-request-id:
              description: >-
                Request correlation identifier supplied by the caller or
                generated by the API
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorBody'
          description: The bearer token cannot read quality measurements
          headers:
            x-request-id:
              description: >-
                Request correlation identifier supplied by the caller or
                generated by the API
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorBody'
          description: The server could not list quality measurements
          headers:
            x-request-id:
              description: >-
                Request correlation identifier supplied by the caller or
                generated by the API
              schema:
                type: string
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorBody'
          description: The server is temporarily unavailable or overloaded
          headers:
            Retry-After:
              description: Seconds to wait before retrying an overloaded request
              schema:
                type: string
            x-request-id:
              description: >-
                Request correlation identifier supplied by the caller or
                generated by the API
              schema:
                type: string
        '504':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorBody'
          description: The request exceeded the server processing deadline
          headers:
            x-request-id:
              description: >-
                Request correlation identifier supplied by the caller or
                generated by the API
              schema:
                type: string
      security:
        - bearer_token: []
components:
  schemas:
    QualityDatasetsResponse:
      description: Response of `GET /api/v1beta/quality/datasets`.
      properties:
        datasets:
          description: Datasets the bearer token can read.
          items:
            $ref: '#/components/schemas/QualityDatasetDto'
          type: array
      required:
        - datasets
      type: object
    ApiErrorBody:
      description: Error payload returned for handled API failures.
      properties:
        code:
          description: Machine-readable error code, e.g. `dataset_not_found`.
          type: string
        message:
          description: Human-readable message.
          type: string
      required:
        - code
        - message
      type: object
    QualityDatasetDto:
      description: Dataset available to the caller and its available measurements.
      properties:
        dataset:
          description: Dataset ID to pass to the other Robotics Data Quality endpoints.
          type: string
        metrics:
          description: |-
            Available metrics. An empty array means the dataset has not been
            measured yet.
          items:
            $ref: '#/components/schemas/QualityMetric'
          type: array
      required:
        - dataset
        - metrics
      type: object
    QualityMetric:
      description: |-
        Measurement currently available for a dataset.

        If a value is absent, that measurement is not available yet.
      enum:
        - content_diversity
        - frame_quality
        - hand_activity
      type: string
  securitySchemes:
    bearer_token:
      description: Bearer access token issued through OAuth 2.0 client credentials.
      scheme: bearer
      type: http

````