---
title: "Search generated images"
method: GET
path: "/generated-images"
tags: ["Images"]
---

# Search generated images

`GET /generated-images`

## Request

- Base URL: `https://api.dynapictures.com`
- URL: `https://api.dynapictures.com/generated-images`
- Auth: HTTP bearer

Finds images generated by the caller's teams, oldest first, up to 200 per request. Narrow a large result with `startDate` and `endDate`.

## Query parameters

- `keyword` string
- `metadata` string
- `startDate` string, date-time
- `endDate` string, date-time

## Response `200`

The matching images.

- ImageSearchResult[]: The matching images.
  - `id` string, required: The ID of the generated image.
  - `templateId` string: The ID of the template.
  - `imageUrl` string, uri, required: URL of the generated image.
  - `thumbnailUrl` string, uri: Thumbnail URL of the generated image.
  - `metadata` string, nullable: The custom metadata stored on the image.
  - `params` string, nullable: The parameters the image was generated with.
  - `width` integer: Image width in pixels.
  - `height` integer: Image height in pixels.
  - `date` string, date-time: When the image was generated.

## Other responses

- `400`: The request is invalid. `message` says why.
- `401`: The API key is missing or wrong.

---

[API](https://skmtc.dev/dynapictures/apis/dynapictures-api.md) - [All operations](https://skmtc.dev/dynapictures/apis/dynapictures-api/llms.txt) - [OpenAPI document](https://skmtc.dev/dynapictures/apis/dynapictures-api/revisions/a9820777cfb3?raw)