# Image library

> List generated images, design sessions, ratings and reference data.

## List images

```text
GET https://api-design.prosecaptain.com/api/images?limit=50&offset=0
```

Returns images from your library, newest first. `limit` up to 100. The `designSessionId` parameter narrows the list to one session.

```json
{
  "success": true,
  "count": 1,
  "total_count": 42,
  "images": [
    { "id": "b1e2…", "filename": "image-….jpeg", "url": "https://api.paqshot.com/assets/…", "timestamp": "2026-10-19T09:00:00Z", "params": { "sceneType": "product_packshot", "aspectRatio": "1:1" } }
  ]
}
```

## Session state

```text
GET https://api-design.prosecaptain.com/api/design-sessions/SESSION_ID/state
```

Returns the image versions in a design session.

## Rate an image

```text
POST https://api-design.prosecaptain.com/api/images/IMAGE_ID/rating
```

```json
{ "rating": 5 }
```

A rating from 1 to 5 helps us improve generation quality.

## Reference data

| Endpoint | Returns |
|---|---|
| `GET /api/templates` | Infographic templates and your workspace templates |
| `GET /api/presets` | Scene presets |
| `GET /api/locations` | Available lifestyle locations |