# List Images

`GET /v1/images`

List the images your account has generated.

These are exactly the URLs accepted as inputs elsewhere in the API. Use this to look up what you can edit or animate.

Base URL: `https://api.spicyapi.com`

## Authorizations

- `Authorization` (string, header, required): Bearer authentication header of the form `Bearer <token>`, where `<token>` is your SpicyAPI key (`sk-spicy-…`). Create one in the dashboard under API Keys.

## Query parameters

- `limit` (integer, optional): How many to return, newest first. Defaults to 50.

## Request

```bash
curl --request GET \
  --url 'https://api.spicyapi.com/v1/images?limit=50' \
  --header 'Authorization: Bearer $SPICYAPI_KEY'
```

## Response: 200 application/json

Successful Response

- `data` (Asset · object[], required): Your generated images, newest first.
  - `url` (string, required): Durable CDN URL.
  - `source` (string, required): `image` or `image-edit`.
  - `created_at` (string | null, optional): ISO 8601 timestamp.

```json
{
  "data": [
    {
      "url": "https://cdn.spicyapi.com/outputs/a1b2/req_8f2a91c4-0.png",
      "source": "image",
      "created_at": "2026-08-23T10:14:02.000Z"
    }
  ]
}
```