---
title: "Get Image Validation Tests"
method: GET
path: "/v1/inspect/images"
tags: ["Image Validation"]
---

# Get Image Validation Tests

`GET /v1/inspect/images`

## Request

- Base URL: `https://api.mailgun.net`
- URL: `https://api.mailgun.net/v1/inspect/images`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/mailgun/apis/email-preview-api/docs/v1/inspect/images/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve a paginated list of all image validation tests that have been submitted. The response is paginated, with a limit of up to 1000 items per page.  The total count of records will display in the meta object under the key, 'count'.

## Query parameters

- `limit` integer
- `skip` integer

## Response `200`

A 200 response

- GithubComMailgunInspectInternalImagevalidationGetImageValidationTestsJSONAPIResponse
  - `meta` object, nullable
  - `paging` GithubComMailgunScaffoldHttpapiPagingPagingResponse
    - `previous` string, required: Previous page URL
    - `first` string, required: First page URL
    - `next` string, required: Next page URL
    - `last` string, required: Last page URL
  - `items` GithubComMailgunInspectInternalImagevalidationImageValidation[]
    - `id` string, required
    - `total_load_time_ms` integer, nullable
    - `images` GithubComMailgunInspectInternalImagevalidationImageValidationResult[]
      - `id` string, required
      - `url` string
      - `status` string, required
      - `line` integer
      - `column` integer
      - `selector` string
      - `absolute_index` integer
      - `passes` GithubComMailgunInspectInternalImagevalidationRuleEvaluation[]
        - `id` string, required
        - `rule` string, required
        - `description` string, required
        - `impact` string
        - `recommendation` string
        - `details` object[], required
      - `failures` GithubComMailgunInspectInternalImagevalidationRuleEvaluation[]
        - `id` string, required
        - `rule` string, required
        - `description` string, required
        - `impact` string
        - `recommendation` string
        - `details` object[], required
      - `informational` GithubComMailgunInspectInternalImagevalidationRuleEvaluation[]
        - `id` string, required
        - `rule` string, required
        - `description` string, required
        - `impact` string
        - `recommendation` string
        - `details` object[], required
    - `image_optimization` GithubComMailgunInspectInternalImagevalidationImageOptimization
      - `id` string, required
      - `error_message` string
      - `optimized_images` GithubComMailgunInspectInternalImagevalidationOptimizedImage[]
        - `id` string, required
        - `original_image_id` string, required
        - `image_url` string, required
        - `optimized_url` string
        - `optimized_file_size` string
        - `optimized_format` string
        - `optimized_mime_type` string
        - `load_time_ms` integer, nullable
        - `status` 'Complete' | 'Error' | 'Processing', required: Status of the optimized image processing
        - `error_message` string
    - `gif_processing_job` GithubComMailgunInspectInternalImagevalidationGifProcessingJob
      - `id` string, required
      - `gif_frames` GithubComMailgunInspectInternalImagevalidationGifFrameDetails[]
        - `id` string, required
        - `original_image_id` string, required
        - `frame_details` GithubComMailgunInspectInternalImagevalidationFrameDetails[], required
          - `frame_id` integer, required
          - `frame_url` string, required
      - `reordered_gif` GithubComMailgunInspectInternalImagevalidationReorderedGiF[]
        - `id` string, required
        - `original_image_id` string, required
        - `frame_id` integer, required
        - `url` string, required
      - `created_at` string, date-time, required
      - `completed_at` string, date-time

## Other responses

- `400`: A 400 response
- `401`: A 401 response

---

[API](https://skmtc.dev/mailgun/apis/email-preview-api.md) - [All operations](https://skmtc.dev/mailgun/apis/email-preview-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mailgun/apis/email-preview-api/revisions/c8a18f02bc8b?raw)
