---
title: "Get Images"
method: GET
path: "/tailored-gen/datasets/{dataset_id}/images"
tags: ["Tailored Generation"]
---

# Get Images

`GET /tailored-gen/datasets/{dataset_id}/images`

## Request

- Base URL: `https://engine.prod.bria-api.com/v1`
- URL: `https://engine.prod.bria-api.com/v1/tailored-gen/datasets/{dataset_id}/images`
- Auth: none declared. Required headers: `api_token`

Retrieve all images in a specific dataset. If there are no images, returns an empty array.

## Path parameters

- `dataset_id` string, required

## Headers

- `api_token` string, required

## Response `200`

Successfully retrieved images

- object[]
  - `id` integer: Unique identifier for the image
  - `dataset_id` integer: ID of the dataset this image belongs to
  - `caption` string: Caption describing the image
  - `caption_source` 'automatic' | 'manual' | 'unknown': Source of the caption. 'unknown' value only appears for images that were uploaded using an old version of Tailored Generation.
  - `image_name` string: Name of the image
  - `image_url` string: URL of the original image file
  - `thumbnail_url` string: URL of the image thumbnail
  - `created_at` string, date-time: Timestamp when the image was created
  - `updated_at` string, date-time: Timestamp when the image was last updated

## Other responses

- `401`: Unauthorized
- `404`: Dataset not found
- `429`: Request limit exceeded. Your account has reached its maximum allowed requests. Please upgrade your plan or try again later.
- `500`: Internal server error

## Changes

- **2026-07-13** `2768230345a5`: 1 info
  - endpoint added
- **2021-07-29** `817f5bbbd013`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/bria-ai/apis/the-bria-api/changes/tailored-gen/datasets/:dataset_id/images/get.md)

---

[API](https://skmtc.dev/bria-ai/apis/the-bria-api.md) · [All operations](https://skmtc.dev/bria-ai/apis/the-bria-api/llms.txt) · [OpenAPI document](https://skmtc.dev/bria-ai/apis/the-bria-api/revisions/2768230345a5?raw)