List Images

Retrieve a list of all images generated by your API key, including try-on results and style suggestions.

Endpoint

GET /images

Request

No request body. Authentication via X-API-Key header.

curl https://mcll3bnfubyazfg6wekv3xc6fi0dgpyk.lambda-url.us-east-1.on.aws/images \
  -H "X-API-Key: YOUR_API_KEY"

Response

Field	Type	Description
images	array	List of image records

Image object

Field	Type	Description
image_id	string	Unique image identifier (e.g. "img_a1b2c3...")
image_url	string	Direct URL to the image
mime_type	string	Image MIME type (e.g. "image/jpeg")
category	string	Image category ("try-on", "style-me")
endpoint	string	Endpoint that generated this image
created_at	string	ISO 8601 creation timestamp
persistent	boolean	Whether the image is stored permanently

Example response

{
  "images": [
    {
      "image_id": "img_a1b2c3d4e5f6a1b2c3d4e5f6",
      "image_url": "https://superstyle-user-images.s3.us-east-1.amazonaws.com/usr_123/try-on/20260228T153000Z_a1b2c3.jpg",
      "mime_type": "image/jpeg",
      "category": "try-on",
      "endpoint": "/try_on_outfit",
      "created_at": "2026-02-28T15:30:00.000Z",
      "persistent": true
    },
    {
      "image_id": "img_d4e5f6a1b2c3d4e5f6a1b2c3",
      "image_url": "https://superstyle-user-images.s3.us-east-1.amazonaws.com/temp/usr_123/style-me/20260228T140000Z_d4e5f6.jpg",
      "mime_type": "image/jpeg",
      "category": "style-me",
      "endpoint": "/style_me",
      "created_at": "2026-02-28T14:00:00.000Z",
      "persistent": false
    }
  ]
}

Notes

• This endpoint is free and unlimited — it does not count toward rate limits
• Non-persistent images (where persistent: false) have URLs that expire after 24 hours
• Images are returned newest-first
• Only images generated by your API keys are returned