---
title: "This organization's images, newest first, optionally by status; paged with next_cursor"
method: GET
path: "/v1/images"
tags: ["platform-api"]
---

# This organization's images, newest first, optionally by status; paged with next_cursor

`GET /v1/images`

## Request

- Base URL: `https://api.cuddler.ai`
- URL: `https://api.cuddler.ai/v1/images`
- Auth: HTTP bearer

## Query parameters

- `status` 'queued' | 'running' | 'succeeded' | 'failed' | 'canceled'
- `limit` integer
- `cursor` string

## Response `200`

One page, newest first; pass next_cursor for the next

- object
  - `object` 'list', required
  - `data` object[], required
    - `object` 'image', required
    - `id` string, required
    - `status` 'queued' | 'running' | 'succeeded' | 'failed' | 'canceled', required
    - `model` 'seedream-5' | 'seedream-5-pro' | 'qwen-image-3' | 'z-image-turbo' | 'grok-imagine-2.0' | 'ideogram-4' | 'ideogram-4.5' | 'recraft-4.1' | 'nano-banana-2.1' | 'nano-banana-2' | 'nano-banana-2-lite' | 'nano-banana-pro' | 'imagen-4-ultra' | 'imagen-4' | 'imagen-4-fast' | 'imagen-3' | 'imagen-3-fast' | 'gpt-image-2.5-sunburst' | 'gpt-image-2.5-flare' | 'gpt-image-2' | 'gpt-image-1.5' | 'gpt-image-1-mini' | 'gpt-image-1', required
    - `prompt` string, required
    - `resolution` '0.5K' | '1K' | '2K' | '4K', required
    - `aspect_ratio` '1:1' | '4:3' | '3:4' | '16:9' | '9:16', required
    - `created_at` string, required
    - `started_at` string, nullable, required
    - `completed_at` string, nullable, required
    - `queue_position` integer, nullable, required
    - `estimate` object, required
      - `usd` string, required
      - `hold_usd` string, required
    - `usage` object, nullable, required
      - `images` integer, required
      - `usd` string, required
      - `usd_micros` integer, required
    - `output` object, nullable, required
      - `url` string, uri, required
      - `url_expires_at` string, required
      - `retained_until` string, required
      - `width` integer, nullable, required
      - `height` integer, nullable, required
      - `content_type` string, required
    - `error` object, nullable, required
      - `code` 'content_policy' | 'reference_rejected' | 'invalid_parameters' | 'upstream_error' | 'timeout' | 'internal_error', required
      - `message` string, required
    - `metadata` object, required
    - `price_version` string, required
    - `api_key_id` string, required
  - `next_cursor` string, nullable, required

## Other responses

- `400`: invalid_request — a bad status, limit or cursor
- `401`: unauthorized — no key, or an unknown or revoked one (WWW-Authenticate: Bearer)
- `403`: organization_suspended — the organization is not active; forbidden — a test key on a live-only route
- `404`: not_found — the Platform API is switched off, or the object does not exist
- `429`: rate_limited — over this key's requests per minute (Retry-After)
- `500`: internal_error — quote request_id when contacting support

---

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