---
title: "List images"
method: GET
path: "/images"
tags: ["Images"]
---

# List images

`GET /images`

With this endpoint you can get a paginated list of images for a brand.

**Sorting:**
Supported sort fields: `createdAt` (default), `name`
Supported directions: `asc`, `desc` (default)

**Filtering:**
Use `nameContains` to filter images by name (case-insensitive, partial match)

**Pagination:**
This endpoint uses cursor-based pagination for efficient traversal of large datasets.
- Use the `cursors.after` value from the response to get the next page
- Use the `cursors.before` value from the response to get the previous page
- The `hasMore` field indicates if more results are available
- Do not use both `after` and `before` parameters simultaneously
- Maximum page size is 250 items (default 100)

**Scopes:**
`images.read`

## Query parameters

- `limit` integer
- `after` string
- `before` string
- `sort` 'createdAt' | 'name'
- `direction` 'asc' | 'desc'
- `nameContains` string

## Headers

- `Omnisend-Version` string, required

## Response `200`

List of images

- ListResponse — ListResponse is the paginated image list response.
  - `images` Image[] — Returned images.
    - `createdAt` string — Image creation timestamp.
    - `height` integer — Image height in pixels.
    - `id` string — Unique image identifier.
    - `name` string — Image name.
    - `size` integer — Image size in bytes.
    - `type` string — MIME type of the image.
    - `url` string — Public CDN URL of the image.
    - `width` integer — Image width in pixels.
  - `paging` PagingResponse — Cursor-based pagination metadata
    - `cursors` CursorsResponse — Cursor pointers for paginating forward and backward through results
      - `after` string, nullable — Opaque cursor for fetching the next page of results
      - `before` string, nullable — Opaque cursor for fetching the previous page of results
    - `hasMore` boolean — Whether there are more items available beyond the current page
    - `limit` integer — Maximum number of items returned per page

## Other responses

- `400` — Request contains invalid or missing fields
- `401` — Authentication is missing or invalid
- `403` — Insufficient permissions for this operation
- `410` — API version has been retired
- `429` — Rate limit exceeded
- `500` — Unexpected error occurred

---

[API](https://skmtc.net/omnisend/apis/events-api.md) · [All operations](https://skmtc.net/omnisend/apis/events-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/omnisend/events-api/versions/50214fbc283f/schema)