# Get Dataset by ID

Retrieve a specific dataset

Endpoint: GET /tailored-gen/datasets/{dataset_id}

## Path parameters:

  - `dataset_id` (string, required)
    Dataset ID

## Header parameters:

  - `api_token` (string, required)

## Query parameters:

  - `max_images` (integer)
    The maximum number of images to retrieve. activate this parameter to make your calls more effective.

## Response 200 fields (application/json):

  - `id` (integer)
    Unique identifier for the dataset

  - `project_id` (integer)
    Associated project ID

  - `name` (string)
    Dataset name

  - `caption_prefix` (string)
    Text automatically prepended to all image captions in the dataset. Each image caption should naturally continues this prefix. A default prefix is automatically created but can be modified, and this same prefix is later used as the default generation prefix during image generation.

  - `status` (string)
    Status of the dataset
    Enum: "draft", "completed"

  - `captions_update_status` (string)
    Status of captions update process
    Enum: "empty", "in_progress", "completed"

  - `upload_type` (string)
    The method used to upload images to the dataset. 'basic' is the default.
    Enum: "basic", "advanced"

  - `captions_source` (string)
    The source of the captions. For 'basic' datasets, this is a null. For 'advanced' datasets, this indicates if captions were generated 'automatic' or provided 'manual'.
    Enum: "automatic", "manual"

  - `images_count` (integer)
    Number of images in the dataset

  - `images` (array)
    Array of images in the dataset (up to 200, controlled by the max_images query)

  - `images.id` (integer)
    Unique identifier for the image

  - `images.dataset_id` (integer)
    ID of the dataset this image belongs to

  - `images.caption` (string)
    Once an image is uploaded, a caption is generated automatically. The caption is a natural continuation of the caption_prefix.

  - `images.caption_source` (string,null)
    Source of the caption. 'unknown' value only appears for images that were uploaded using an old version of Tailored Generation.
    Enum: "automatic", "manual", "unknown"

  - `images.upload_source_url` (string,null)
    The original URL provided by the user for the image.

  - `images.image_name` (string)
    Name of the image

  - `images.image_url` (string)
    URL of the original image file

  - `images.thumbnail_url` (string)
    URL of the image thumbnail

  - `images.created_at` (string)
    Timestamp when the image was created

  - `images.updated_at` (string)
    Timestamp when the image was last updated

  - `created_at` (string)
    Timestamp when the dataset was created

  - `updated_at` (string)
    Timestamp when the dataset was last updated