> For the complete documentation index, see [llms.txt](https://deepmode.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://deepmode.gitbook.io/docs/api-endpoints/handling-images/show-image-list.md).

# Show Image List

Retrieves a list of image URLs optionally filtered by model and ordered.

#### Endpoint

```
GET /api/images
```

#### Parameters

<table><thead><tr><th width="203">Parameter</th><th>Type</th><th>Required</th><th>Description</th></tr></thead><tbody><tr><td><code>model_id</code></td><td>string</td><td>No</td><td>Model ID to filter images.</td></tr><tr><td><code>order</code></td><td>string</td><td>No</td><td>Possible values: <code>desc</code>, <code>asc</code>. Default: <code>desc</code>.</td></tr><tr><td><code>page</code></td><td>integer</td><td>No</td><td>Page number for pagination.</td></tr><tr><td><code>page_size</code></td><td>integer</td><td>No</td><td>Page size for pagination.</td></tr></tbody></table>

#### Request Example

```bash
curl -X GET "https://api.deepmode.ai/api/images?model_id=a9f7e5d1c3a2f91e3d5c6&
order=desc" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_SECRET_API_KEY"
```

#### Response

Upon successful retrieval, the API returns the following response:

```json
{
  "images":
  [
    {
      "id": "93b5e1c7a4f2d6g8h9k1m",
      "file_name": "120e453f-3a73-4016-ad6a-5cd5e00ddd45.jpeg",
      "model_id": "a9f7e5d1c3a2f91e3d5c6"
      "image_url": "https://deepmodeimage.blob.core.windows.net/deepmode-user-image/120e453f-3a73-4016-ad6a-5cd5e00ddd45.jpeg?st=2024-04-29T14%3A28%3A02Z&se=2024-04-29T15%3A28%3A02Z&sp=r&sv=2023-11-03&sr=b&sig=NaLrBA8mqrBMiFL1e9gCbuQAvgEMmG39D6iyHkbuy2E%3D"
    },
    {    
      "id": "f7e5d1c3a2f91e3d5c6b8",
      "file_name": "b6084a21f6e-9421-49c2-8f4d-51b2c3d4e5f6.jpeg",
      "model_id": "a9f7e5d1c3a2f91e3d5c6",
      "image_url": "https://deepmodeimage.blob.core.windows.net/deepmode-user-image/b6084a21f6e-9421-49c2-8f4d-51b2c3d4e5f6.jpeg?st=2024-04-29T14%3A28%3A02Z&se=2024-04-29T15%3A28%3A02Z&sp=r&sv=2023-11-03&sr=b&sig=NaLrBA8mqrBMiFL1e9gCbuQAvgEMmG39D6iyHkbuy2E%3D"
    },
    {
      "id": "c6b8a9f7e5d1c3a2f91e3",
      "file_name": "2f6d914a-5b83-46c1-9f3e-721a4b8c9d1e.jpeg",
      "model_id": "a9f7e5d1c3a2f91e3d5c6",
      "image_url": "https://deepmodeimage.blob.core.windows.net/deepmode-user-image/2f6d914a-5b83-46c1-9f3e-721a4b8c9d1e.jpeg?st=2024-04-29T14%3A28%3A02Z&se=2024-04-29T15%3A28%3A02Z&sp=r&sv=2023-11-03&sr=b&sig=NaLrBA8mqrBMiFL1e9gCbuQAvgEMmG39D6iyHkbuy2E%3D"
    }
  ],
  "total_images": 3
}
```