# list_generated_images (https://sellersheetai.com/docs/mcp-api/tools/list_generated_images)

> List images already generated and saved for a store — newest first.

Access: **READ** · toolset sellersheet · family null

Use this to FIND an image you or the user made earlier instead of regenerating it (a regeneration is billed again and returns a different image; the library is free and returns the exact one). Also the way to answer "what images do we have for this SKU?".

## Call it

MCP tool call:

```json
{
  "name": "list_generated_images",
  "arguments": {
    "store": "myStore-US"
  }
}
```

Tool API (early access — contact us):

```bash
curl -X POST https://api.sellersheetai.com/api/v1/tools/list_generated_images \
  -H "Authorization: Bearer $SELLERSHEET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"store":"myStore-US"}'
```

## Arguments

| Name | Type | Required | Description |
|---|---|---|---|
| `store` | string | yes | the store ref `<store>-<CC>` (name-country, e.g. 'myStore-US') — one of get_user_context's store_refs, verbatim. Required. |
| `parent_sku` | string |  | narrow to one product family. |
| `sku` | string |  | narrow to one SKU — matches parent OR child, so pass whichever you have. |
| `slot` | string |  | narrow to one position ('s0'-'s8', 'a1'-'a5', 'p1'-'p5'). |
| `limit` | integer |  | page size, 1-200 (default 50). Above 200 is REJECTED (422), not clamped — ask for 200 and page with before_id. |
| `before_id` | integer |  | paging cursor — pass the previous response's `next_before_id`. Do NOT compute an offset: rows are keyset- paged by id, so an offset would skip or repeat images when new ones land while you page. |

## Result

- `data.images` — newest first; each carries id (pass it to set_synthetic_performer), parent_sku, child_sku, slot, version, lang, cdn_url, thumbnail_url, source, created_at and synthetic_performer.
- `data.next_before_id` — pass as before_id for the next page; null on the last page — stop there.