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

# Get a dataset import session



## OpenAPI

````yaml /openapi/model-distillation/management.openapi.yaml get /tasks/{alias}/dataset-imports/{importId}
openapi: 3.1.0
info:
  title: CoreWeave Model Distillation Management API
  version: 1.0.0
  description: |
    Manage providers, projects (called tasks in API paths), routing versions,
    datasets, relabeling, fine-tunes, evaluations, and analytics. This is the
    same API used by Model Distillation.
servers:
  - url: https://distillation.training.wandb.ai/v1
    description: Production
security:
  - WandbCredential: []
tags:
  - name: Providers
    description: OpenAI-compatible endpoints, credentials, model catalogs, and pricing.
  - name: Tasks
    description: Stable task identity and task-level information.
  - name: Routing
    description: Versioned model targets, weights, and request parameters.
  - name: Datasets
    description: >-
      Reproducible data snapshots, entries, relabeling, and reusable model
      outputs.
  - name: Fine-tunes
    description: Supervised fine-tuning jobs and hosted model artifacts.
  - name: Evaluations
    description: Head-to-head, exact-match, and categorization evaluations.
  - name: Analytics
    description: Task traffic, token, error, and estimated-cost read models.
  - name: UI preferences
    description: Per-task display preferences used by the UI.
paths:
  /tasks/{alias}/dataset-imports/{importId}:
    parameters:
      - $ref: '#/components/parameters/WandbEntity'
      - $ref: '#/components/parameters/TaskAlias'
      - $ref: '#/components/parameters/DatasetImportId'
    get:
      tags:
        - Datasets
      summary: Get a dataset import session
      operationId: getDatasetImport
      responses:
        '200':
          description: Transfer and processing state for the import.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DatasetImport'
        default:
          $ref: '#/components/responses/Error'
components:
  parameters:
    WandbEntity:
      name: Wandb-Entity
      in: header
      required: false
      description: >-
        Accessible personal or team entity. Omit to use the authenticated user's
        default entity.
      schema:
        type: string
    TaskAlias:
      name: alias
      in: path
      required: true
      schema:
        type: string
        pattern: ^[a-z0-9-]{1,64}$
    DatasetImportId:
      name: importId
      in: path
      required: true
      schema:
        type: string
        format: uuid
  schemas:
    DatasetImport:
      type: object
      required:
        - id
        - task_id
        - dataset_id
        - name
        - split_policy
        - duplicate_policy
        - state
        - total_bytes
        - counters
        - error
        - expires_at
        - created_at
        - updated_at
        - file
        - validation
      properties:
        id:
          type: string
          format: uuid
        task_id:
          type: string
          format: uuid
        dataset_id:
          type:
            - string
            - 'null'
          format: uuid
          description: >-
            Destination dataset ID, assigned when dataset creation begins. Wait
            for state ready before using the dataset. Null before creation or
            after the dataset is deleted.
        name:
          type: string
        split_policy:
          type: object
          additionalProperties: true
          description: The split policy accepted when the import was created.
        duplicate_policy:
          type: object
          additionalProperties: true
          description: The duplicate policy accepted when the import was created.
        state:
          type: string
          enum:
            - uploading
            - queued
            - validating
            - auditing
            - committing
            - ready
            - failed
            - cancelled
            - expired
        total_bytes:
          type: integer
          minimum: 1
        counters:
          type:
            - object
            - 'null'
          additionalProperties: true
          description: Validation totals when available; otherwise null.
          required:
            - staged_rows
            - rejected_rows
            - validation_errors
            - errors_by_code
            - rows_by_split
          properties:
            staged_rows:
              type: integer
              minimum: 0
            rejected_rows:
              type: integer
              minimum: 0
            validation_errors:
              type: integer
              minimum: 0
            errors_by_code:
              type: object
              description: Validation error counts keyed by error code.
              additionalProperties:
                type: integer
                minimum: 0
            rows_by_split:
              type: object
              description: >-
                Accepted row counts keyed by split: train, val, or unassigned.
                Splits with no accepted rows are omitted.
              additionalProperties:
                type: integer
                minimum: 0
        error:
          type:
            - string
            - 'null'
        expires_at:
          type: string
          format: date-time
        created_at:
          type: string
          format: date-time
        updated_at:
          type: string
          format: date-time
        file:
          $ref: '#/components/schemas/DatasetImportFile'
        validation:
          $ref: '#/components/schemas/DatasetImportValidation'
      additionalProperties: true
    DatasetImportFile:
      type: object
      required:
        - name
        - size_bytes
        - part_size_bytes
        - part_count
        - state
        - uploaded_bytes
        - parts
      properties:
        name:
          type: string
        size_bytes:
          type: integer
          minimum: 1
        part_size_bytes:
          type: integer
          minimum: 1
          description: >-
            Fixed by the server. Every part except the last must be exactly this
            size.
        part_count:
          type: integer
          minimum: 1
        state:
          type: string
          enum:
            - pending
            - uploading
            - completed
            - failed
            - cancelled
        uploaded_bytes:
          type: integer
          minimum: 0
        parts:
          type: array
          items:
            $ref: '#/components/schemas/DatasetImportPart'
          description: >-
            Uploaded parts reported by storage while the multipart upload is
            active. Use this inventory to resume an interrupted transfer. Empty
            before the upload starts and after it completes, fails, or is
            cancelled.
    DatasetImportValidation:
      type: object
      required:
        - validation_state
        - validated_bytes
        - validated_lines
        - validated_rows
        - raw_sha256
        - error_count
        - errors_truncated
        - errors
      properties:
        validation_state:
          type: string
          enum:
            - pending
            - running
            - valid
            - invalid
        validated_bytes:
          type: integer
          minimum: 0
        validated_lines:
          type: integer
          minimum: 0
        validated_rows:
          type: integer
          minimum: 0
        raw_sha256:
          type:
            - string
            - 'null'
        error_count:
          type: integer
          minimum: 0
        errors_truncated:
          type: boolean
          description: >-
            True when error_count exceeds the number of errors returned. At most
            100 errors are included.
        errors:
          type: array
          items:
            $ref: '#/components/schemas/DatasetImportValidationError'
    ErrorResponse:
      type: object
      required:
        - error
      properties:
        error:
          type: object
          required:
            - message
            - type
          properties:
            message:
              type: string
            type:
              type: string
      example:
        error:
          message: Task 'missing' not found in entity 'your-team'
          type: not_found
    DatasetImportPart:
      type: object
      required:
        - part_number
        - size_bytes
        - etag
      properties:
        part_number:
          type: integer
          minimum: 1
        size_bytes:
          type: integer
          minimum: 0
        etag:
          type: string
    DatasetImportValidationError:
      type: object
      required:
        - physical_line
        - source_byte_offset
        - code
        - message
      properties:
        physical_line:
          type: integer
          minimum: 1
        source_byte_offset:
          type: integer
          minimum: 0
        code:
          type: string
        message:
          type: string
  responses:
    Error:
      description: Request failed.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
  securitySchemes:
    WandbCredential:
      type: http
      scheme: bearer
      bearerFormat: W&B API key
      description: A W&B API key.

````

## Related topics

- [Upload a Dataset](/model-distillation/studio/datasets-upload.md)
