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

# List images

`GET /v2/images`

## Request

- Base URL: `https://api-photos.icons8.com/api`
- URL: `https://api-photos.icons8.com/api/v2/images`
- Auth: API key in header `api-key`

Get list of images

## Query parameters

- `type` 'photo' | 'collage' | 'background'
- `page` integer
- `perPage` integer
- `fields` string
- `orderBy` 'latest' | 'oldest' | 'random'
- `locale` 'en' | 'ru' | 'fr' | 'de' | 'it' | 'jp' | 'es' | 'br' | 'cn' | 'ko'

## Response `200`

List images

- MainImages: Main_Images model
  - `total` integer
  - `images` MainImage[]
    - `id` string
    - `type` string
    - `free` string
    - `title` string: first description
    - `urls` object
      - `thumb` MainAsset: Main_Asset model
        - `width` integer
        - `height` integer
        - `url` string
      - `small` MainAsset: Main_Asset model
        - `width` integer
        - `height` integer
        - `url` string
      - `medium` MainAsset: Main_Asset model
        - `width` integer
        - `height` integer
        - `url` string
      - `large` MainAsset: Main_Asset model
        - `width` integer
        - `height` integer
        - `url` string
      - `thumb1xWebp` MainAsset: Main_Asset model
        - `width` integer
        - `height` integer
        - `url` string
      - `thumb2xWebp` MainAsset: Main_Asset model
        - `width` integer
        - `height` integer
        - `url` string
    - `assets` object
      - `models` string[]
      - `objects` string[]
      - `background` string
    - `categories` string[]
    - `descriptions` string[]
    - `tags` string[]

---

[API](https://skmtc.dev/icons8/apis/photos-api.md) · [All operations](https://skmtc.dev/icons8/apis/photos-api/llms.txt) · [OpenAPI document](https://skmtc.dev/icons8/apis/photos-api/revisions/76ea7419d720?raw)