---
title: "Get Images"
method: POST
path: "/images"
---

# Get Images

`POST /images`

Returns a paginated list of images for a given organization, along with their EOL status.

Args:
    organization_id (UUID4): The ID of the organization to retrieve images for.
    search (str, optional): A search string to filter images by name. Defaults to None.
    filter (EOLFilterOptions, optional): An EOL filter option to filter images by EOL status. Defaults to None.

Returns:
    Page[ProjectImage]: A paginated list of images for the given organization, along with their EOL status.

## Query parameters

- `search` string, nullable
- `verified` string, nullable
- `eol_filter` 'All' | 'EOL' | 'EOL LESS THAN 6MO' | 'EOL LESS THAN 12MO' | 'EOL MORE THAN 12MO'
- `page` integer — Page number
- `size` integer — Page size

## Request body

- LabelFilter
  - `key` string, required
  - `operator` 'IN' | 'NOT_IN', required
  - `value` string, required

## Response `200`

Successful Response

- PageProjectImage
  - `items` ProjectImage[], required
    - `id` string, uuid, required
    - `name` string, required
    - `tag` string, required
    - `eol` EolCount
      - `low` integer, required
      - `med` integer, required
      - `high` integer, required
    - `projectName` string, required
    - `imageVerified` boolean, required
    - `latestScanDate` string, date-time, required
    - `digest` string, nullable
    - `labels` object, nullable
  - `total` integer, required
  - `page` integer, nullable, required
  - `size` integer, nullable, required
  - `pages` integer, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/xeol/apis/fastapi.md) · [All operations](https://skmtc.dev/xeol/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/xeol/fastapi/revisions/545d83b42156/schema)